pass.h
Go to the documentation of this file.
1 //
2 // Copyright 2016 Pixar
3 //
4 // Licensed under the Apache License, Version 2.0 (the "Apache License")
5 // with the following modification; you may not use this file except in
6 // compliance with the Apache License and the following modification to it:
7 // Section 6. Trademarks. is deleted and replaced with:
8 //
9 // 6. Trademarks. This License does not grant permission to use the trade
10 // names, trademarks, service marks, or product names of the Licensor
11 // and its affiliates, except as required to comply with Section 4(c) of
12 // the License and to reproduce the content of the NOTICE file.
13 //
14 // You may obtain a copy of the Apache License at
15 //
16 // http://www.apache.org/licenses/LICENSE-2.0
17 //
18 // Unless required by applicable law or agreed to in writing, software
19 // distributed under the Apache License with the above modification is
20 // distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
21 // KIND, either express or implied. See the Apache License for the specific
22 // language governing permissions and limitations under the Apache License.
23 //
24 #ifndef USDRENDER_GENERATED_PASS_H
25 #define USDRENDER_GENERATED_PASS_H
26 
28 
29 #include "pxr/pxr.h"
30 #include "pxr/usd/usdRender/api.h"
31 #include "pxr/usd/usd/typed.h"
32 #include "pxr/usd/usd/prim.h"
33 #include "pxr/usd/usd/stage.h"
35 
37 
38 #include "pxr/base/vt/value.h"
39 
40 #include "pxr/base/gf/vec3d.h"
41 #include "pxr/base/gf/vec3f.h"
42 #include "pxr/base/gf/matrix4d.h"
43 
44 #include "pxr/base/tf/token.h"
45 #include "pxr/base/tf/type.h"
46 
47 PXR_NAMESPACE_OPEN_SCOPE
48 
49 class SdfAssetPath;
50 
51 // -------------------------------------------------------------------------- //
52 // RENDERPASS //
53 // -------------------------------------------------------------------------- //
54 
89 class UsdRenderPass : public UsdTyped
90 {
91 public:
96 
101  explicit UsdRenderPass(const UsdPrim& prim=UsdPrim())
102  : UsdTyped(prim)
103  {
104  }
105 
109  explicit UsdRenderPass(const UsdSchemaBase& schemaObj)
110  : UsdTyped(schemaObj)
111  {
112  }
113 
115  USDRENDER_API
116  virtual ~UsdRenderPass();
117 
121  USDRENDER_API
122  static const TfTokenVector &
123  GetSchemaAttributeNames(bool includeInherited=true);
124 
134  USDRENDER_API
135  static UsdRenderPass
136  Get(const UsdStagePtr &stage, const SdfPath &path);
137 
160  USDRENDER_API
161  static UsdRenderPass
162  Define(const UsdStagePtr &stage, const SdfPath &path);
163 
164 protected:
168  USDRENDER_API
169  UsdSchemaKind _GetSchemaKind() const override;
170 
171 private:
172  // needs to invoke _GetStaticTfType.
173  friend class UsdSchemaRegistry;
174  USDRENDER_API
175  static const TfType &_GetStaticTfType();
176 
177  static bool _IsTypedSchema();
178 
179  // override SchemaBase virtuals.
180  USDRENDER_API
181  const TfType &_GetTfType() const override;
182 
183 public:
184  // --------------------------------------------------------------------- //
185  // PASSTYPE
186  // --------------------------------------------------------------------- //
202  USDRENDER_API
204 
210  USDRENDER_API
211  UsdAttribute CreatePassTypeAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
212 
213 public:
214  // --------------------------------------------------------------------- //
215  // COMMAND
216  // --------------------------------------------------------------------- //
240  USDRENDER_API
242 
248  USDRENDER_API
249  UsdAttribute CreateCommandAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
250 
251 public:
252  // --------------------------------------------------------------------- //
253  // FILENAME
254  // --------------------------------------------------------------------- //
265  USDRENDER_API
267 
273  USDRENDER_API
274  UsdAttribute CreateFileNameAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
275 
276 public:
277  // --------------------------------------------------------------------- //
278  // DENOISEENABLE
279  // --------------------------------------------------------------------- //
288  USDRENDER_API
290 
296  USDRENDER_API
297  UsdAttribute CreateDenoiseEnableAttr(VtValue const &defaultValue = VtValue(), bool writeSparsely=false) const;
298 
299 public:
300  // --------------------------------------------------------------------- //
301  // RENDERSOURCE
302  // --------------------------------------------------------------------- //
315  USDRENDER_API
317 
320  USDRENDER_API
322 
323 public:
324  // --------------------------------------------------------------------- //
325  // INPUTPASSES
326  // --------------------------------------------------------------------- //
348  USDRENDER_API
350 
353  USDRENDER_API
355 
356 public:
357  // --------------------------------------------------------------------- //
358  // DENOISEPASS
359  // --------------------------------------------------------------------- //
364  USDRENDER_API
366 
369  USDRENDER_API
371 
372 public:
373  // ===================================================================== //
374  // Feel free to add custom code below this line, it will be preserved by
375  // the code generator.
376  //
377  // Just remember to:
378  // - Close the class declaration with };
379  // - Close the namespace with PXR_NAMESPACE_CLOSE_SCOPE
380  // - Close the include guard with #endif
381  // ===================================================================== //
382  // --(BEGIN CUSTOM CODE)--
383 
386  // For more information, see
387  // \\ref usdRender_renderVisibility "Render Visibility"
388  USDRENDER_API
390 };
391 
392 PXR_NAMESPACE_CLOSE_SCOPE
393 
394 #endif
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 GetRenderSourceRel() const
The source prim to render from.
USDRENDER_API UsdAttribute GetPassTypeAttr() const
A string used to categorize differently structured or executed types of passes within a customized pi...
USDRENDER_API UsdCollectionAPI GetRenderVisibilityCollectionAPI() const
Return the UsdCollectionAPI interface used for examining and modifying the render visibility of this ...
USDRENDER_API UsdRelationship GetInputPassesRel() const
The set of other Passes that this Pass depends on in order to be constructed properly.
USDRENDER_API UsdAttribute CreateFileNameAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetFileNameAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDRENDER_API UsdRelationship CreateRenderSourceRel() const
See GetRenderSourceRel(), and also Create vs Get Property Methods for when to use Get vs Create.
static USDRENDER_API UsdRenderPass Get(const UsdStagePtr &stage, const SdfPath &path)
Return a UsdRenderPass holding the prim adhering to this schema at path on stage.
USDRENDER_API UsdAttribute CreateCommandAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetCommandAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
USDRENDER_API UsdAttribute CreateDenoiseEnableAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetDenoiseEnableAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdRenderPass(const UsdPrim &prim=UsdPrim())
Construct a UsdRenderPass on UsdPrim prim .
Definition: pass.h:101
Scenegraph object for authoring and retrieving numeric, string, and array valued data,...
Definition: attribute.h:176
USDRENDER_API UsdAttribute GetDenoiseEnableAttr() const
When True, this Pass pass should be denoised.
UsdSchemaKind
An enum representing which kind of schema a given schema class belongs to.
Definition: common.h:127
USDRENDER_API UsdRelationship CreateInputPassesRel() const
See GetInputPassesRel(), and also Create vs Get Property Methods for when to use Get vs Create.
UsdRenderPass(const UsdSchemaBase &schemaObj)
Construct a UsdRenderPass on the prim held by schemaObj .
Definition: pass.h:109
This is a general purpose API schema, used to describe a collection of heterogeneous objects within t...
static const UsdSchemaKind schemaKind
Compile time constant representing what kind of schema this class is.
Definition: pass.h:95
Represents a concrete typed schema.
UsdPrim is the sole persistent scenegraph object on a UsdStage, and is the embodiment of a "Prim" as ...
Definition: prim.h:135
The base class for all typed schemas (those that can impart a typeName to a UsdPrim),...
Definition: typed.h:61
static USDRENDER_API UsdRenderPass Define(const UsdStagePtr &stage, const SdfPath &path)
Attempt to ensure a UsdPrim adhering to this schema at path is defined (according to UsdPrim::IsDefin...
std::vector< TfToken > TfTokenVector
Convenience types.
Definition: token.h:442
A path value used to locate objects in layers or scenegraphs.
Definition: path.h:290
A UsdRelationship creates dependencies between scenegraph objects by allowing a prim to target other ...
Definition: relationship.h:128
USDRENDER_API UsdSchemaKind _GetSchemaKind() const override
Returns the kind of schema this class belongs to.
Contains an asset path and an optional resolved path.
Definition: assetPath.h:47
USDRENDER_API UsdAttribute GetFileNameAttr() const
The asset that contains the rendering prims or other information needed to render this pass.
USDRENDER_API UsdAttribute GetCommandAttr() const
The command to run in order to generate renders for this pass.
A RenderPass prim encapsulates the necessary information to generate multipass renders.
Definition: pass.h:89
USDRENDER_API UsdAttribute CreatePassTypeAttr(VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
See GetPassTypeAttr(), and also Create vs Get Property Methods for when to use Get vs Create.
TfType represents a dynamic runtime type.
Definition: type.h:64
Singleton registry that provides access to schema type information and the prim definitions for regis...
virtual USDRENDER_API ~UsdRenderPass()
Destructor.
USDRENDER_API UsdRelationship CreateDenoisePassRel() const
See GetDenoisePassRel(), and also Create vs Get Property Methods for when to use Get vs Create.
The base class for all schema types in Usd.
Definition: schemaBase.h:56
Provides a container which may hold any type, and provides introspection and iteration over array typ...
Definition: value.h:166
USDRENDER_API UsdRelationship GetDenoisePassRel() const
The The UsdRenderDenoisePass prim from which to source denoise settings.
TfToken class for efficient string referencing and hashing, plus conversions to and from stl string c...