HDK
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Friends Macros Groups Pages
var.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_VAR_H
8 #define USDRENDER_GENERATED_VAR_H
9 
10 /// \file usdRender/var.h
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 
29 
30 class SdfAssetPath;
31 
32 // -------------------------------------------------------------------------- //
33 // RENDERVAR //
34 // -------------------------------------------------------------------------- //
35 
36 /// \class UsdRenderVar
37 ///
38 /// A UsdRenderVar describes a custom data variable for
39 /// a render to produce. The prim describes the source of the data, which
40 /// can be a shader output or an LPE (Light Path Expression), and also
41 /// allows encoding of (generally renderer-specific) parameters that
42 /// configure the renderer for computing the variable.
43 ///
44 /// \note The name of the RenderVar prim drives the name of the data
45 /// variable that the renderer will produce.
46 ///
47 /// \note In the future, UsdRender may standardize RenderVar representation
48 /// for well-known variables under the sourceType `intrinsic`,
49 /// such as _r_, _g_, _b_, _a_, _z_, or _id_.
50 ///
51 ///
52 /// For any described attribute \em Fallback \em Value or \em Allowed \em Values below
53 /// that are text/tokens, the actual token is published and defined in \ref UsdRenderTokens.
54 /// So to set an attribute to the value "rightHanded", use UsdRenderTokens->rightHanded
55 /// as the value.
56 ///
57 class UsdRenderVar : public UsdTyped
58 {
59 public:
60  /// Compile time constant representing what kind of schema this class is.
61  ///
62  /// \sa UsdSchemaKind
64 
65  /// Construct a UsdRenderVar on UsdPrim \p prim .
66  /// Equivalent to UsdRenderVar::Get(prim.GetStage(), prim.GetPath())
67  /// for a \em valid \p prim, but will not immediately throw an error for
68  /// an invalid \p prim
69  explicit UsdRenderVar(const UsdPrim& prim=UsdPrim())
70  : UsdTyped(prim)
71  {
72  }
73 
74  /// Construct a UsdRenderVar on the prim held by \p schemaObj .
75  /// Should be preferred over UsdRenderVar(schemaObj.GetPrim()),
76  /// as it preserves SchemaBase state.
77  explicit UsdRenderVar(const UsdSchemaBase& schemaObj)
78  : UsdTyped(schemaObj)
79  {
80  }
81 
82  /// Destructor.
84  virtual ~UsdRenderVar();
85 
86  /// Return a vector of names of all pre-declared attributes for this schema
87  /// class and all its ancestor classes. Does not include attributes that
88  /// may be authored by custom/extended methods of the schemas involved.
90  static const TfTokenVector &
91  GetSchemaAttributeNames(bool includeInherited=true);
92 
93  /// Return a UsdRenderVar holding the prim adhering to this
94  /// schema at \p path on \p stage. If no prim exists at \p path on
95  /// \p stage, or if the prim at that path does not adhere to this schema,
96  /// return an invalid schema object. This is shorthand for the following:
97  ///
98  /// \code
99  /// UsdRenderVar(stage->GetPrimAtPath(path));
100  /// \endcode
101  ///
103  static UsdRenderVar
104  Get(const UsdStagePtr &stage, const SdfPath &path);
105 
106  /// Attempt to ensure a \a UsdPrim adhering to this schema at \p path
107  /// is defined (according to UsdPrim::IsDefined()) on this stage.
108  ///
109  /// If a prim adhering to this schema at \p path is already defined on this
110  /// stage, return that prim. Otherwise author an \a SdfPrimSpec with
111  /// \a specifier == \a SdfSpecifierDef and this schema's prim type name for
112  /// the prim at \p path at the current EditTarget. Author \a SdfPrimSpec s
113  /// with \p specifier == \a SdfSpecifierDef and empty typeName at the
114  /// current EditTarget for any nonexistent, or existing but not \a Defined
115  /// ancestors.
116  ///
117  /// The given \a path must be an absolute prim path that does not contain
118  /// any variant selections.
119  ///
120  /// If it is impossible to author any of the necessary PrimSpecs, (for
121  /// example, in case \a path cannot map to the current UsdEditTarget's
122  /// namespace) issue an error and return an invalid \a UsdPrim.
123  ///
124  /// Note that this method may return a defined prim whose typeName does not
125  /// specify this schema class, in case a stronger typeName opinion overrides
126  /// the opinion at the current EditTarget.
127  ///
129  static UsdRenderVar
130  Define(const UsdStagePtr &stage, const SdfPath &path);
131 
132 protected:
133  /// Returns the kind of schema this class belongs to.
134  ///
135  /// \sa UsdSchemaKind
137  UsdSchemaKind _GetSchemaKind() const override;
138 
139 private:
140  // needs to invoke _GetStaticTfType.
141  friend class UsdSchemaRegistry;
143  static const TfType &_GetStaticTfType();
144 
145  static bool _IsTypedSchema();
146 
147  // override SchemaBase virtuals.
149  const TfType &_GetTfType() const override;
150 
151 public:
152  // --------------------------------------------------------------------- //
153  // DATATYPE
154  // --------------------------------------------------------------------- //
155  /// The type of this channel, as a USD attribute type.
156  ///
157  /// | ||
158  /// | -- | -- |
159  /// | Declaration | `uniform token dataType = "color3f"` |
160  /// | C++ Type | TfToken |
161  /// | \ref Usd_Datatypes "Usd Type" | SdfValueTypeNames->Token |
162  /// | \ref SdfVariability "Variability" | SdfVariabilityUniform |
165 
166  /// See GetDataTypeAttr(), and also
167  /// \ref Usd_Create_Or_Get_Property for when to use Get vs Create.
168  /// If specified, author \p defaultValue as the attribute's default,
169  /// sparsely (when it makes sense to do so) if \p writeSparsely is \c true -
170  /// the default for \p writeSparsely is \c false.
172  UsdAttribute CreateDataTypeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
173 
174 public:
175  // --------------------------------------------------------------------- //
176  // SOURCENAME
177  // --------------------------------------------------------------------- //
178  /// The renderer should look for an output of this name
179  /// as the computed value for the RenderVar.
180  ///
181  /// | ||
182  /// | -- | -- |
183  /// | Declaration | `uniform string sourceName = ""` |
184  /// | C++ Type | std::string |
185  /// | \ref Usd_Datatypes "Usd Type" | SdfValueTypeNames->String |
186  /// | \ref SdfVariability "Variability" | SdfVariabilityUniform |
189 
190  /// See GetSourceNameAttr(), and also
191  /// \ref Usd_Create_Or_Get_Property for when to use Get vs Create.
192  /// If specified, author \p defaultValue as the attribute's default,
193  /// sparsely (when it makes sense to do so) if \p writeSparsely is \c true -
194  /// the default for \p writeSparsely is \c false.
196  UsdAttribute CreateSourceNameAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
197 
198 public:
199  // --------------------------------------------------------------------- //
200  // SOURCETYPE
201  // --------------------------------------------------------------------- //
202  ///
203  /// Indicates the type of the source.
204  ///
205  /// - "raw": The name should be passed directly to the
206  /// renderer. This is the default behavior.
207  /// - "primvar": This source represents the name of a primvar.
208  /// Some renderers may use this to ensure that the primvar
209  /// is provided; other renderers may require that a suitable
210  /// material network be provided, in which case this is simply
211  /// an advisory setting.
212  /// - "lpe": Specifies a Light Path Expression in the
213  /// [OSL Light Path Expressions language](https://github.com/imageworks/OpenShadingLanguage/wiki/OSL-Light-Path-Expressions) as the source for
214  /// this RenderVar. Some renderers may use extensions to
215  /// that syntax, which will necessarily be non-portable.
216  /// - "intrinsic": This setting is currently unimplemented,
217  /// but represents a future namespace for UsdRender to provide
218  /// portable baseline RenderVars, such as camera depth, that
219  /// may have varying implementations for each renderer.
220  ///
221  ///
222  /// | ||
223  /// | -- | -- |
224  /// | Declaration | `uniform token sourceType = "raw"` |
225  /// | C++ Type | TfToken |
226  /// | \ref Usd_Datatypes "Usd Type" | SdfValueTypeNames->Token |
227  /// | \ref SdfVariability "Variability" | SdfVariabilityUniform |
228  /// | \ref UsdRenderTokens "Allowed Values" | raw, primvar, lpe, intrinsic |
231 
232  /// See GetSourceTypeAttr(), and also
233  /// \ref Usd_Create_Or_Get_Property for when to use Get vs Create.
234  /// If specified, author \p defaultValue as the attribute's default,
235  /// sparsely (when it makes sense to do so) if \p writeSparsely is \c true -
236  /// the default for \p writeSparsely is \c false.
238  UsdAttribute CreateSourceTypeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
239 
240 public:
241  // ===================================================================== //
242  // Feel free to add custom code below this line, it will be preserved by
243  // the code generator.
244  //
245  // Just remember to:
246  // - Close the class declaration with };
247  // - Close the namespace with PXR_NAMESPACE_CLOSE_SCOPE
248  // - Close the include guard with #endif
249  // ===================================================================== //
250  // --(BEGIN CUSTOM CODE)--
251 };
252 
254 
255 #endif
USDRENDER_API UsdAttribute GetDataTypeAttr() const
#define USDRENDER_API
Definition: api.h:23
GLsizei const GLchar *const * path
Definition: glcorearb.h:3341
USDRENDER_API UsdAttribute GetSourceTypeAttr() const
UsdRenderVar(const UsdPrim &prim=UsdPrim())
Definition: var.h:69
USDRENDER_API UsdAttribute CreateSourceNameAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
USDRENDER_API UsdAttribute GetSourceNameAttr() const
UsdRenderVar(const UsdSchemaBase &schemaObj)
Definition: var.h:77
virtual USDRENDER_API ~UsdRenderVar()
Destructor.
static const UsdSchemaKind schemaKind
Definition: var.h:63
Represents a concrete typed schema.
Definition: prim.h:116
Definition: typed.h:44
static USDRENDER_API UsdRenderVar Get(const UsdStagePtr &stage, const SdfPath &path)
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:440
static USDRENDER_API UsdRenderVar Define(const UsdStagePtr &stage, const SdfPath &path)
Definition: path.h:273
USDRENDER_API UsdSchemaKind _GetSchemaKind() const override
USDRENDER_API UsdAttribute CreateSourceTypeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
USDRENDER_API UsdAttribute CreateDataTypeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
UsdSchemaKind
Definition: common.h:112
PXR_NAMESPACE_CLOSE_SCOPE PXR_NAMESPACE_OPEN_SCOPE
Definition: path.h:1425
static USDRENDER_API const TfTokenVector & GetSchemaAttributeNames(bool includeInherited=true)
#define PXR_NAMESPACE_CLOSE_SCOPE
Definition: pxr.h:74
Definition: type.h:47
Definition: value.h:146