settingsBase.h
Go to the documentation of this file.
1 //
2 // Copyright 2016 Pixar
3 //
4 // Licensed under the terms set forth in the LICENSE.txt file available at
5 // https://openusd.org/license.
6 //
7 #ifndef USDRENDER_GENERATED_SETTINGSBASE_H
8 #define USDRENDER_GENERATED_SETTINGSBASE_H
9 
11 
12 #include "pxr/pxr.h"
13 #include "pxr/usd/usdRender/api.h"
14 #include "pxr/usd/usd/typed.h"
15 #include "pxr/usd/usd/prim.h"
16 #include "pxr/usd/usd/stage.h"
18 
19 #include "pxr/base/vt/value.h"
20 
21 #include "pxr/base/gf/vec3d.h"
22 #include "pxr/base/gf/vec3f.h"
23 #include "pxr/base/gf/matrix4d.h"
24 
25 #include "pxr/base/tf/token.h"
26 #include "pxr/base/tf/type.h"
27 
28 PXR_NAMESPACE_OPEN_SCOPE
29 
30 class SdfAssetPath;
31 
32 // -------------------------------------------------------------------------- //
33 // RENDERSETTINGSBASE //
34 // -------------------------------------------------------------------------- //
35 
48 {
49 public:
54 
59  explicit UsdRenderSettingsBase(const UsdPrim& prim=UsdPrim())
60  : UsdTyped(prim)
61  {
62  }
63 
67  explicit UsdRenderSettingsBase(const UsdSchemaBase& schemaObj)
68  : UsdTyped(schemaObj)
69  {
70  }
71 
73  USDRENDER_API
74  virtual ~UsdRenderSettingsBase();
75 
79  USDRENDER_API
80  static const TfTokenVector &
81  GetSchemaAttributeNames(bool includeInherited=true);
82 
92  USDRENDER_API
94  Get(const UsdStagePtr &stage, const SdfPath &path);
95 
96 
97 protected:
101  USDRENDER_API
102  UsdSchemaKind _GetSchemaKind() const override;
103 
104 private:
105  // needs to invoke _GetStaticTfType.
106  friend class UsdSchemaRegistry;
107  USDRENDER_API
108  static const TfType &_GetStaticTfType();
109 
110  static bool _IsTypedSchema();
111 
112  // override SchemaBase virtuals.
113  USDRENDER_API
114  const TfType &_GetTfType() const override;
115 
116 public:
117  // --------------------------------------------------------------------- //
118  // RESOLUTION
119  // --------------------------------------------------------------------- //
129  USDRENDER_API
131 
137  USDRENDER_API
138  UsdAttribute CreateResolutionAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
139 
140 public:
141  // --------------------------------------------------------------------- //
142  // PIXELASPECTRATIO
143  // --------------------------------------------------------------------- //
153  USDRENDER_API
155 
161  USDRENDER_API
162  UsdAttribute CreatePixelAspectRatioAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
163 
164 public:
165  // --------------------------------------------------------------------- //
166  // ASPECTRATIOCONFORMPOLICY
167  // --------------------------------------------------------------------- //
201  USDRENDER_API
203 
209  USDRENDER_API
210  UsdAttribute CreateAspectRatioConformPolicyAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
211 
212 public:
213  // --------------------------------------------------------------------- //
214  // DATAWINDOWNDC
215  // --------------------------------------------------------------------- //
253  USDRENDER_API
255 
261  USDRENDER_API
262  UsdAttribute CreateDataWindowNDCAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
263 
264 public:
265  // --------------------------------------------------------------------- //
266  // INSTANTANEOUSSHUTTER
267  // --------------------------------------------------------------------- //
280  USDRENDER_API
282 
288  USDRENDER_API
289  UsdAttribute CreateInstantaneousShutterAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
290 
291 public:
292  // --------------------------------------------------------------------- //
293  // DISABLEMOTIONBLUR
294  // --------------------------------------------------------------------- //
305  USDRENDER_API
307 
313  USDRENDER_API
314  UsdAttribute CreateDisableMotionBlurAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
315 
316 public:
317  // --------------------------------------------------------------------- //
318  // DISABLEDEPTHOFFIELD
319  // --------------------------------------------------------------------- //
329  USDRENDER_API
331 
337  USDRENDER_API
338  UsdAttribute CreateDisableDepthOfFieldAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
339 
340 public:
341  // --------------------------------------------------------------------- //
342  // CAMERA
343  // --------------------------------------------------------------------- //
347  USDRENDER_API
349 
352  USDRENDER_API
354 
355 public:
356  // ===================================================================== //
357  // Feel free to add custom code below this line, it will be preserved by
358  // the code generator.
359  //
360  // Just remember to:
361  // - Close the class declaration with };
362  // - Close the namespace with PXR_NAMESPACE_CLOSE_SCOPE
363  // - Close the include guard with #endif
364  // ===================================================================== //
365  // --(BEGIN CUSTOM CODE)--
366 };
367 
368 PXR_NAMESPACE_CLOSE_SCOPE
369 
370 #endif
USDRENDER_API UsdAttribute CreateDataWindowNDCAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetDataWindowNDCAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdRenderSettingsBase(const UsdSchemaBase &schemaObj)
Construct a UsdRenderSettingsBase on the prim held by schemaObj .
Definition: settingsBase.h:67
USDRENDER_API UsdAttribute GetResolutionAttr() const
The image pixel resolution, corresponding to the camera's screen window.
USDRENDER_API UsdSchemaKind _GetSchemaKind() const override
Returns the kind of schema this class belongs to.
USDRENDER_API UsdAttribute GetInstantaneousShutterAttr() const
Deprecated - use disableMotionBlur instead.
USDRENDER_API UsdAttribute CreatePixelAspectRatioAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetPixelAspectRatioAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDRENDER_API UsdAttribute CreateInstantaneousShutterAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetInstantaneousShutterAttr(), and also Create vs Get Property Methods for when to use Get vs Cre...
Scenegraph object for authoring and retrieving numeric, string, and array valued data,...
Definition: attribute.h:183
USDRENDER_API UsdAttribute GetDisableMotionBlurAttr() const
Disable all motion blur by setting the shutter interval of the targeted camera to [0,...
USDRENDER_API UsdAttribute CreateDisableDepthOfFieldAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetDisableDepthOfFieldAttr(), and also Create vs Get Property Methods for when to use Get vs Crea...
Abstract base class that defines render settings that can be specified on either a RenderSettings pri...
Definition: settingsBase.h:47
static USDRENDER_API UsdRenderSettingsBase Get(const UsdStagePtr &stage, const SdfPath &path)
Return a UsdRenderSettingsBase holding the prim adhering to this schema at path on stage.
USDRENDER_API UsdAttribute GetAspectRatioConformPolicyAttr() const
Indicates the policy to use to resolve an aspect ratio mismatch between the camera aperture and image...
UsdSchemaKind
An enum representing which kind of schema a given schema class belongs to.
Definition: common.h:112
USDRENDER_API UsdRelationship CreateCameraRel() const
See GetCameraRel(), and also Create vs Get Property Methods for when to use Get vs Create.
static const UsdSchemaKind schemaKind
Compile time constant representing what kind of schema this class is.
Definition: settingsBase.h:53
virtual USDRENDER_API ~UsdRenderSettingsBase()
Destructor.
UsdPrim is the sole persistent scenegraph object on a UsdStage, and is the embodiment of a "Prim" as ...
Definition: prim.h:116
The base class for all typed schemas (those that can impart a typeName to a UsdPrim),...
Definition: typed.h:44
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:489
USDRENDER_API UsdAttribute GetDataWindowNDCAttr() const
dataWindowNDC specifies the axis-aligned rectangular region in the adjusted aperture window within wh...
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:280
UsdRenderSettingsBase(const UsdPrim &prim=UsdPrim())
Construct a UsdRenderSettingsBase on UsdPrim prim .
Definition: settingsBase.h:59
A UsdRelationship creates dependencies between scenegraph objects by allowing a prim to target other ...
Definition: relationship.h:111
Contains an asset path and optional evaluated and resolved paths.
Definition: assetPath.h:78
USDRENDER_API UsdAttribute CreateDisableMotionBlurAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetDisableMotionBlurAttr(), and also Create vs Get Property Methods for when to use Get vs Create...
Represents a non-concrete typed schema.
USDRENDER_API UsdAttribute CreateAspectRatioConformPolicyAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetAspectRatioConformPolicyAttr(), and also Create vs Get Property Methods for when to use Get vs...
TfType represents a dynamic runtime type.
Definition: type.h:47
Singleton registry that provides access to schema type information and the prim definitions for regis...
USDRENDER_API UsdAttribute GetPixelAspectRatioAttr() const
The aspect ratio (width/height) of image pixels.
static USDRENDER_API const TfTokenVector & GetSchemaAttributeNames(bool includeInherited=true)
Return a vector of names of all pre-declared attributes for this schema class and all its ancestor cl...
USDRENDER_API UsdRelationship GetCameraRel() const
The camera relationship specifies the primary camera to use in a render.
The base class for all schema types in Usd.
Definition: schemaBase.h:39
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:89
USDRENDER_API UsdAttribute GetDisableDepthOfFieldAttr() const
Disable all depth of field by setting F-stop of the targeted camera to infinity.
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...
USDRENDER_API UsdAttribute CreateResolutionAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetResolutionAttr(), and also Create vs Get Property Methods for when to use Get vs Create.