All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
HdCamera Class Reference

Hydra schema for a camera that pulls the params (see above) during Sync. More...

+ Inheritance diagram for HdCamera:

Public Types

enum  DirtyBits : HdDirtyBits {
  Clean = 0, DirtyTransform = 1 << 0, DirtyViewMatrix = DirtyTransform, DirtyProjMatrix = 1 << 1,
  DirtyWindowPolicy = 1 << 2, DirtyClipPlanes = 1 << 3, DirtyParams = 1 << 4, AllDirty
}
 
enum  Projection { Perspective = 0, Orthographic }
 
using ClipPlanesVector = std::vector< GfVec4d >
 

Public Member Functions

HD_API HdCamera (SdfPath const &id)
 
HD_API void Sync (HdSceneDelegate *sceneDelegate, HdRenderParam *renderParam, HdDirtyBits *dirtyBits) override
 Sprim API. More...
 
HD_API HdDirtyBits GetInitialDirtyBitsMask () const override
 Returns the minimal set of dirty bits to place in the change tracker for use in the first sync of this prim. More...
 
GfMatrix4d const & GetTransform () const
 Camera parameters accessor API. More...
 
Projection GetProjection () const
 Returns whether camera is orthographic and perspective. More...
 
float GetHorizontalAperture () const
 Returns horizontal aperture in world units. More...
 
float GetVerticalAperture () const
 Returns vertical aperture in world units. More...
 
float GetHorizontalApertureOffset () const
 Returns horizontal aperture offset in world units. More...
 
float GetVerticalApertureOffset () const
 Returns vertical aperture offset in world units. More...
 
float GetFocalLength () const
 Returns focal length in world units. More...
 
GfRange1f const & GetClippingRange () const
 Returns near and far plane in world units. More...
 
std::vector< GfVec4d > const & GetClipPlanes () const
 Returns any additional clipping planes defined in camera space. More...
 
float GetFStop () const
 Returns fstop of camera. More...
 
float GetFocusDistance () const
 Returns focus distance in world units. More...
 
double GetShutterOpen () const
 
double GetShutterClose () const
 
float GetExposure () const
 
CameraUtilConformWindowPolicy
const & 
GetWindowPolicy () const
 Returns the window policy of the camera. More...
 
HD_API GfMatrix4d GetViewMatrix () const
 Legacy camera parameters accessor API. More...
 
HD_API GfMatrix4d GetViewInverseMatrix () const
 Returns the matrix transformation from camera to world space. More...
 
HD_API GfMatrix4d GetProjectionMatrix () const
 Returns the projection matrix for the camera. More...
 
- Public Member Functions inherited from HdSprim
HD_API HdSprim (SdfPath const &id)
 
SdfPath const & GetId () const
 Returns the identifier by which this state is known. More...
 
virtual HD_API void Finalize (HdRenderParam *renderParam)
 Finalizes object resources. More...
 

Protected Attributes

GfMatrix4d _transform
 
Projection _projection
 
float _horizontalAperture
 
float _verticalAperture
 
float _horizontalApertureOffset
 
float _verticalApertureOffset
 
float _focalLength
 
GfRange1f _clippingRange
 
std::vector< GfVec4d_clipPlanes
 
float _fStop
 
float _focusDistance
 
double _shutterOpen
 
double _shutterClose
 
float _exposure
 
CameraUtilConformWindowPolicy _windowPolicy
 
GfMatrix4d _worldToViewMatrix
 
GfMatrix4d _worldToViewInverseMatrix
 
GfMatrix4d _projectionMatrix
 

Detailed Description

Hydra schema for a camera that pulls the params (see above) during Sync.

Backends that use additional camera parameters can inherit from HdCamera and pull on them.

Definition at line 85 of file camera.h.

Member Function Documentation

GfRange1f const& GetClippingRange ( ) const
inline

Returns near and far plane in world units.

Definition at line 174 of file camera.h.

std::vector<GfVec4d> const& GetClipPlanes ( ) const
inline

Returns any additional clipping planes defined in camera space.

Definition at line 179 of file camera.h.

float GetFocalLength ( ) const
inline

Returns focal length in world units.

Definition at line 169 of file camera.h.

float GetFocusDistance ( ) const
inline

Returns focus distance in world units.

Definition at line 189 of file camera.h.

float GetFStop ( ) const
inline

Returns fstop of camera.

Definition at line 184 of file camera.h.

float GetHorizontalAperture ( ) const
inline

Returns horizontal aperture in world units.

Definition at line 149 of file camera.h.

float GetHorizontalApertureOffset ( ) const
inline

Returns horizontal aperture offset in world units.

Definition at line 159 of file camera.h.

HD_API HdDirtyBits GetInitialDirtyBitsMask ( ) const
overridevirtual

Returns the minimal set of dirty bits to place in the change tracker for use in the first sync of this prim.

Typically this would be all dirty bits.

Implements HdSprim.

Projection GetProjection ( ) const
inline

Returns whether camera is orthographic and perspective.

Definition at line 144 of file camera.h.

HD_API GfMatrix4d GetProjectionMatrix ( ) const

Returns the projection matrix for the camera.

Deprecated:
Compute from above physically based attributes
GfMatrix4d const& GetTransform ( ) const
inline

Camera parameters accessor API.

Returns camera transform

Definition at line 139 of file camera.h.

float GetVerticalAperture ( ) const
inline

Returns vertical aperture in world units.

Definition at line 154 of file camera.h.

float GetVerticalApertureOffset ( ) const
inline

Returns vertical aperture offset in world units.

Definition at line 164 of file camera.h.

HD_API GfMatrix4d GetViewInverseMatrix ( ) const

Returns the matrix transformation from camera to world space.

Deprecated:
Use GetTransform and invert instead
HD_API GfMatrix4d GetViewMatrix ( ) const

Legacy camera parameters accessor API.

Returns the matrix transformation from world to camera space.

Deprecated:
Use GetTransform instead
CameraUtilConformWindowPolicy const& GetWindowPolicy ( ) const
inline

Returns the window policy of the camera.

If no opinion is authored, we default to "CameraUtilFit"

Definition at line 207 of file camera.h.

HD_API void Sync ( HdSceneDelegate sceneDelegate,
HdRenderParam renderParam,
HdDirtyBits *  dirtyBits 
)
overridevirtual

Sprim API.

Synchronizes state from the delegate to this object.

Implements HdSprim.

Reimplemented in HdPrmanCamera.


The documentation for this class was generated from the following file: