Loading...
Searching...
No Matches
UsdClipsAPI Class Reference

UsdClipsAPI is an API schema that provides an interface to a prim's clip metadata. More...

#include <clipsAPI.h>

+ Inheritance diagram for UsdClipsAPI:

Public Member Functions

 UsdClipsAPI (const UsdPrim &prim=UsdPrim())
 Construct a UsdClipsAPI on UsdPrim prim .
 
 UsdClipsAPI (const UsdSchemaBase &schemaObj)
 Construct a UsdClipsAPI on the prim held by schemaObj .
 
virtual USD_API ~UsdClipsAPI ()
 Destructor.
 
- Public Member Functions inherited from UsdAPISchemaBase
 UsdAPISchemaBase (const UsdPrim &prim=UsdPrim())
 Construct a UsdAPISchemaBase on UsdPrim prim .
 
 UsdAPISchemaBase (const UsdSchemaBase &schemaObj)
 Construct a UsdAPISchemaBase on the prim held by schemaObj .
 
virtual USD_API ~UsdAPISchemaBase ()=0
 Destructor.
 
- Public Member Functions inherited from UsdSchemaBase
bool IsConcrete () const
 Returns whether or not this class corresponds to a concrete instantiable prim type in scene description.
 
bool IsTyped () const
 Returns whether or not this class inherits from UsdTyped.
 
bool IsAPISchema () const
 Returns whether this is an API schema or not.
 
bool IsAppliedAPISchema () const
 Returns whether this is an applied API schema or not.
 
bool IsMultipleApplyAPISchema () const
 Returns whether this is an applied API schema or not.
 
UsdSchemaKind GetSchemaKind () const
 Returns the kind of schema this class is.
 
USD_API UsdSchemaBase (const UsdPrim &prim=UsdPrim())
 Construct and store prim as the held prim.
 
USD_API UsdSchemaBase (const UsdSchemaBase &otherSchema)
 Construct and store for the same prim held by otherSchema.
 
virtual USD_API ~UsdSchemaBase ()
 Destructor.
 
UsdPrim GetPrim () const
 Return this schema object's held prim.
 
SdfPath GetPath () const
 Shorthand for GetPrim()->GetPath().
 
USD_API const UsdPrimDefinitionGetSchemaClassPrimDefinition () const
 Return the prim definition associated with this schema instance if one exists, otherwise return null.
 
USD_API operator bool () const
 Return true if this schema object is compatible with its held prim, false otherwise.
 

Static Public Member Functions

static USD_API const TfTokenVectorGetSchemaAttributeNames (bool includeInherited=true)
 Return a vector of names of all pre-declared attributes for this schema class and all its ancestor classes.
 
static USD_API UsdClipsAPI Get (const UsdStagePtr &stage, const SdfPath &path)
 Return a UsdClipsAPI holding the prim adhering to this schema at path on stage.
 
- Static Public Member Functions inherited from UsdAPISchemaBase
static USD_API const TfTokenVectorGetSchemaAttributeNames (bool includeInherited=true)
 Return a vector of names of all pre-declared attributes for this schema class and all its ancestor classes.
 
- Static Public Member Functions inherited from UsdSchemaBase
static const TfTokenVectorGetSchemaAttributeNames (bool includeInherited=true)
 

Static Public Attributes

static const UsdSchemaKind schemaKind = UsdSchemaKind::NonAppliedAPI
 Compile time constant representing what kind of schema this class is.
 
- Static Public Attributes inherited from UsdAPISchemaBase
static const UsdSchemaKind schemaKind = UsdSchemaKind::AbstractBase
 Compile time constant representing what kind of schema this class is.
 
- Static Public Attributes inherited from UsdSchemaBase
static const UsdSchemaKind schemaKind = UsdSchemaKind::AbstractBase
 Compile time constant representing what kind of schema this class is.
 

Protected Member Functions

USD_API UsdSchemaKind _GetSchemaKind () const override
 Returns the kind of schema this class belongs to.
 
- Protected Member Functions inherited from UsdAPISchemaBase
USD_API UsdSchemaKind _GetSchemaKind () const override
 Returns the kind of schema this class belongs to.
 
 UsdAPISchemaBase (const UsdPrim &prim, const TfToken &instanceName)
 Construct a multiple-apply UsdAPISchemaBase on UsdPrim prim with the specified instanceName.
 
 UsdAPISchemaBase (const UsdSchemaBase &schemaObj, const TfToken &instanceName)
 Construct a multiple-apply UsdAPISchemaBase on the prim held by schemaObj with the given instanceName.
 
const TfToken_GetInstanceName () const
 Returns the instance name of the API schema object belonging to a multiple-apply API schema.
 
USD_API bool _IsCompatible () const override
 Check whether this APISchema object is valid for the currently held
prim.
 
- Protected Member Functions inherited from UsdSchemaBase
virtual UsdSchemaKind _GetSchemaType () const
 
const TfType_GetType () const
 
USD_API UsdAttribute _CreateAttr (TfToken const &attrName, SdfValueTypeName const &typeName, bool custom, SdfVariability variability, VtValue const &defaultValue, bool writeSparsely) const
 

Friends

class UsdSchemaRegistry
 

Value Clip Info

Setters and getters for interacting with metadata that control value clip behavior.

USD_API bool GetClips (VtDictionary *clips) const
 Dictionary that contains the definition of the clip sets on this prim.
 
USD_API bool SetClips (const VtDictionary &clips)
 Set the clips dictionary for this prim.
 
USD_API bool GetClipSets (SdfStringListOp *clipSets) const
 ListOp that may be used to affect how opinions from clip sets are applied during value resolution.
 
USD_API bool SetClipSets (const SdfStringListOp &clipSets)
 Set the clip sets list op for this prim.
 
USD_API VtArray< SdfAssetPathComputeClipAssetPaths (const std::string &clipSet) const
 Computes and resolves the list of clip asset paths used by the clip set named clipSet.
 
USD_API VtArray< SdfAssetPathComputeClipAssetPaths () const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipAssetPaths (VtArray< SdfAssetPath > *assetPaths, const std::string &clipSet) const
 List of asset paths to the clips in the clip set named clipSet.
 
USD_API bool GetClipAssetPaths (VtArray< SdfAssetPath > *assetPaths) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipAssetPaths (const VtArray< SdfAssetPath > &assetPaths, const std::string &clipSet)
 Set the clip asset paths for the clip set named clipSet.
 
USD_API bool SetClipAssetPaths (const VtArray< SdfAssetPath > &assetPaths)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipPrimPath (std::string *primPath, const std::string &clipSet) const
 Path to the prim in the clips in the clip set named clipSet from which time samples will be read.
 
USD_API bool GetClipPrimPath (std::string *primPath) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipPrimPath (const std::string &primPath, const std::string &clipSet)
 Set the clip prim path for the clip set named clipSet.
 
USD_API bool SetClipPrimPath (const std::string &primPath)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipActive (VtVec2dArray *activeClips, const std::string &clipSet) const
 List of pairs (time, clip index) indicating the time on the stage at which the clip in the clip set named clipSet specified by the clip index is active.
 
USD_API bool GetClipActive (VtVec2dArray *activeClips) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipActive (const VtVec2dArray &activeClips, const std::string &clipSet)
 Set the active clip metadata for the clip set named clipSet.
 
USD_API bool SetClipActive (const VtVec2dArray &activeClips)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTimes (VtVec2dArray *clipTimes, const std::string &clipSet) const
 List of pairs (stage time, clip time) indicating the time in the active clip in the clip set named clipSet that should be consulted for values at the corresponding stage time.
 
USD_API bool GetClipTimes (VtVec2dArray *clipTimes) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTimes (const VtVec2dArray &clipTimes, const std::string &clipSet)
 Set the clip times metadata for this prim.
 
USD_API bool SetClipTimes (const VtVec2dArray &clipTimes)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipManifestAssetPath (SdfAssetPath *manifestAssetPath, const std::string &clipSet) const
 Asset path for the clip manifest for the clip set named clipSet.
 
USD_API bool GetClipManifestAssetPath (SdfAssetPath *manifestAssetPath) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipManifestAssetPath (const SdfAssetPath &manifestAssetPath, const std::string &clipSet)
 Set the clip manifest asset path for this prim.
 
USD_API bool SetClipManifestAssetPath (const SdfAssetPath &manifestAssetPath)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API SdfLayerRefPtr GenerateClipManifest (const std::string &clipSet, bool writeBlocksForClipsWithMissingValues=false) const
 Create a clip manifest containing entries for all attributes in the value clips for clip set clipSet.
 
USD_API SdfLayerRefPtr GenerateClipManifest (bool writeBlocksForClipsWithMissingValues=false) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetInterpolateMissingClipValues (bool *interpolate, const std::string &clipSet) const
 
USD_API bool GetInterpolateMissingClipValues (bool *interpolate) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetInterpolateMissingClipValues (bool interpolate, const std::string &clipSet)
 Set whether missing clip values are interpolated from surrounding clips.
 
USD_API bool SetInterpolateMissingClipValues (bool interpolate)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTemplateAssetPath (std::string *clipTemplateAssetPath, const std::string &clipSet) const
 A template string representing a set of assets to be used as clips for the clip set named clipSet.
 
USD_API bool GetClipTemplateAssetPath (std::string *clipTemplateAssetPath) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTemplateAssetPath (const std::string &clipTemplateAssetPath, const std::string &clipSet)
 Set the clip template asset path for the clip set named clipSet.
 
USD_API bool SetClipTemplateAssetPath (const std::string &clipTemplateAssetPath)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTemplateStride (double *clipTemplateStride, const std::string &clipSet) const
 A double representing the increment value USD will use when searching for asset paths for the clip set named clipSet.
 
USD_API bool GetClipTemplateStride (double *clipTemplateStride) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTemplateActiveOffset (const double clipTemplateActiveOffset, const std::string &clipSet)
 Set the clip template offset for the clip set named clipSet.
 
USD_API bool SetClipTemplateActiveOffset (const double clipTemplateActiveOffset)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTemplateActiveOffset (double *clipTemplateActiveOffset, const std::string &clipSet) const
 A double representing the offset value used by USD when determining the active period for each clip.
 
USD_API bool GetClipTemplateActiveOffset (double *clipTemplateActiveOffset) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTemplateStride (const double clipTemplateStride, const std::string &clipSet)
 Set the template stride for the clip set named clipSet.
 
USD_API bool SetClipTemplateStride (const double clipTemplateStride)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTemplateStartTime (double *clipTemplateStartTime, const std::string &clipSet) const
 A double which indicates the start of the range USD will use to search for asset paths for the clip set named clipSet.
 
USD_API bool GetClipTemplateStartTime (double *clipTemplateStartTime) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTemplateStartTime (const double clipTemplateStartTime, const std::string &clipSet)
 Set the template start time for the clip set named clipSet.
 
USD_API bool SetClipTemplateStartTime (const double clipTemplateStartTime)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool GetClipTemplateEndTime (double *clipTemplateEndTime, const std::string &clipSet) const
 A double which indicates the end of the range USD will use to to search for asset paths for the clip set named clipSet.
 
USD_API bool GetClipTemplateEndTime (double *clipTemplateEndTime) const
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
USD_API bool SetClipTemplateEndTime (const double clipTemplateEndTime, const std::string &clipSet)
 Set the template end time for the clipset named clipSet.
 
USD_API bool SetClipTemplateEndTime (const double clipTemplateEndTime)
 This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.
 
static USD_API SdfLayerRefPtr GenerateClipManifestFromLayers (const SdfLayerHandleVector &clipLayers, const SdfPath &clipPrimPath)
 Create a clip manifest containing entries for all attributes in the given clipLayers that belong to the prim at clipPrimPath and all descendants.
 

Additional Inherited Members

- Static Protected Member Functions inherited from UsdAPISchemaBase
static USD_API TfTokenVector _GetMultipleApplyInstanceNames (const UsdPrim &prim, const TfType &schemaType)
 Returns a vector of names of API schema objects belonging to a multiple-apply API schema applied to a given prim.
 

Detailed Description

UsdClipsAPI is an API schema that provides an interface to a prim's clip metadata.

Clips are a "value resolution" feature that allows one to specify a sequence of usd files (clips) to be consulted, over time, as a source of varying overrides for the prims at and beneath this prim in namespace.

SetClipAssetPaths() establishes the set of clips that can be consulted. SetClipActive() specifies the ordering of clip application over time (clips can be repeated), while SetClipTimes() specifies time-mapping from stage-time to clip-time for the clip active at a given stage-time, which allows for time-dilation and repetition of clips. Finally, SetClipPrimPath() determines the path within each clip that will map to this prim, i.e. the location within the clip at which we will look for opinions for this prim.

The clip asset paths, times and active metadata can also be specified through template clip metadata. This can be desirable when your set of assets is very large, as the template metadata is much more concise. SetClipTemplateAssetPath() establishes the asset identifier pattern of the set of clips to be consulted. SetClipTemplateStride(), SetClipTemplateEndTime(), and SetClipTemplateStartTime() specify the range in which USD will search, based on the template. From the set of resolved asset paths, times and active will be derived internally.

A prim may have multiple "clip sets" – named sets of clips that each have their own values for the metadata described above. For example, a prim might have a clip set named "Clips_1" that specifies some group of clip asset paths, and another clip set named "Clips_2" that uses an entirely different set of clip asset paths. These clip sets are composed across composition arcs, so clip sets for a prim may be defined in multiple sublayers or references, for example. Individual metadata for a given clip set may be sparsely overridden.

Important facts about clips:

  • Within the layerstack in which clips are established, the
    opinions within the clips will be weaker than any local opinions in the layerstack, but em stronger than varying opinions coming across references and variants.
  • We will never look for metadata or default opinions in clips
    when performing value resolution on the owning stage, since these
    quantities must be time-invariant.

This leads to the common structure in which we reference a model asset on a prim, and then author clips at the same site: the asset reference will provide the topology and unvarying data for the model, while the clips will provide the time-sampled animation.

For further information, see Sequencable, Re-timable Animated "Value Clips"

Definition at line 105 of file clipsAPI.h.

Constructor & Destructor Documentation

◆ UsdClipsAPI() [1/2]

UsdClipsAPI ( const UsdPrim prim = UsdPrim())
inlineexplicit

Construct a UsdClipsAPI on UsdPrim prim .

Equivalent to UsdClipsAPI::Get(prim.GetStage(), prim.GetPath()) for a valid prim, but will not immediately throw an error for an invalid prim

Definition at line 117 of file clipsAPI.h.

◆ UsdClipsAPI() [2/2]

UsdClipsAPI ( const UsdSchemaBase schemaObj)
inlineexplicit

Construct a UsdClipsAPI on the prim held by schemaObj .

Should be preferred over UsdClipsAPI(schemaObj.GetPrim()), as it preserves SchemaBase state.

Definition at line 125 of file clipsAPI.h.

◆ ~UsdClipsAPI()

virtual USD_API ~UsdClipsAPI ( )
virtual

Destructor.

Member Function Documentation

◆ _GetSchemaKind()

USD_API UsdSchemaKind _GetSchemaKind ( ) const
overrideprotectedvirtual

Returns the kind of schema this class belongs to.

See also
UsdSchemaKind

Reimplemented from UsdAPISchemaBase.

◆ ComputeClipAssetPaths() [1/2]

USD_API VtArray< SdfAssetPath > ComputeClipAssetPaths ( ) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

◆ ComputeClipAssetPaths() [2/2]

USD_API VtArray< SdfAssetPath > ComputeClipAssetPaths ( const std::string &  clipSet) const

Computes and resolves the list of clip asset paths used by the clip set named clipSet.

This is the same list of paths that would be used during value resolution.

If the clip set is defined using template clip metadata, this function will compute the asset paths based on the template parameters. Otherwise this function will use the authored clipAssetPaths.

◆ GenerateClipManifest() [1/2]

USD_API SdfLayerRefPtr GenerateClipManifest ( bool  writeBlocksForClipsWithMissingValues = false) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GenerateClipManifest() [2/2]

USD_API SdfLayerRefPtr GenerateClipManifest ( const std::string &  clipSet,
bool  writeBlocksForClipsWithMissingValues = false 
) const

Create a clip manifest containing entries for all attributes in the value clips for clip set clipSet.

This returns an anonymous layer that can be exported and reused (

See also
SetClipManifestAssetPath).

If writeBlocksForClipsWithMissingValues is true, the generated manifest will have value blocks authored for each attribute at the activation times of clips that do not contain time samples for that attribute. This accelerates searches done when the interpolation of missing clip values is enabled. See GetInterpolateMissingClipValues and Interpolating Missing Values in Clip Set for more details.

Returns an invalid SdfLayerRefPtr on failure.

◆ GenerateClipManifestFromLayers()

static USD_API SdfLayerRefPtr GenerateClipManifestFromLayers ( const SdfLayerHandleVector &  clipLayers,
const SdfPath clipPrimPath 
)
static

Create a clip manifest containing entries for all attributes in the given clipLayers that belong to the prim at clipPrimPath and all descendants.

This returns an anonymous layer that can be exported and reused (

See also
SetClipManifestAssetPath).

Returns an invalid SdfLayerRefPtr on failure.

◆ Get()

static USD_API UsdClipsAPI Get ( const UsdStagePtr &  stage,
const SdfPath path 
)
static

Return a UsdClipsAPI holding the prim adhering to this schema at path on stage.

If no prim exists at path on stage, or if the prim at that path does not adhere to this schema, return an invalid schema object. This is shorthand for the following:

UsdClipsAPI(stage->GetPrimAtPath(path));
UsdClipsAPI is an API schema that provides an interface to a prim's clip metadata.
Definition: clipsAPI.h:106

◆ GetClipActive() [1/2]

USD_API bool GetClipActive ( VtVec2dArray *  activeClips) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipActive() [2/2]

USD_API bool GetClipActive ( VtVec2dArray *  activeClips,
const std::string &  clipSet 
) const

List of pairs (time, clip index) indicating the time on the stage at which the clip in the clip set named clipSet specified by the clip index is active.

For instance, a value of [(0.0, 0), (20.0, 1)] indicates that clip 0 is active at time 0 and clip 1 is active at time 20.

◆ GetClipAssetPaths() [1/2]

USD_API bool GetClipAssetPaths ( VtArray< SdfAssetPath > *  assetPaths) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipAssetPaths() [2/2]

USD_API bool GetClipAssetPaths ( VtArray< SdfAssetPath > *  assetPaths,
const std::string &  clipSet 
) const

List of asset paths to the clips in the clip set named clipSet.

This list is unordered, but elements in this list are referred to by index in other clip-related fields.

◆ GetClipManifestAssetPath() [1/2]

USD_API bool GetClipManifestAssetPath ( SdfAssetPath manifestAssetPath) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipManifestAssetPath() [2/2]

USD_API bool GetClipManifestAssetPath ( SdfAssetPath manifestAssetPath,
const std::string &  clipSet 
) const

Asset path for the clip manifest for the clip set named clipSet.

The clip manifest indicates which attributes have time samples authored in the clips specified on this prim. During value resolution, clips will only be examined if the attribute exists and is declared as varying in the manifest. See Clip Manifest for more details.

For instance, if this prim's path is </Prim_1>, the clip prim path is </Prim>, and we want values for the attribute </Prim_1.size>, we will only look within this prim's clips if the attribute </Prim.size> exists and is varying in the manifest.

◆ GetClipPrimPath() [1/2]

USD_API bool GetClipPrimPath ( std::string *  primPath) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipPrimPath() [2/2]

USD_API bool GetClipPrimPath ( std::string *  primPath,
const std::string &  clipSet 
) const

Path to the prim in the clips in the clip set named clipSet from which time samples will be read.

This prim's path will be substituted with this value to determine the final path in the clip from which to read data. For instance, if this prims' path is '/Prim_1', the clip prim path is '/Prim', and we want to get values for the attribute '/Prim_1.size'. The clip prim path will be substituted in, yielding '/Prim.size', and each clip will be examined for values at that path.

◆ GetClips()

USD_API bool GetClips ( VtDictionary clips) const

Dictionary that contains the definition of the clip sets on this prim.

Each entry in this dictionary defines a clip set: the entry's key is the name of the clip set and the entry's value is a dictionary containing the metadata that specifies the clips in the set.

See UsdClipsAPIInfoKeys for the keys used for each clip set's dictionary, or use the other API to set or get values for a given clip set.

◆ GetClipSets()

USD_API bool GetClipSets ( SdfStringListOp *  clipSets) const

ListOp that may be used to affect how opinions from clip sets are applied during value resolution.

By default, clip sets in a layer stack are examined in lexicographical order by name for attribute values during value resolution. The clip sets listOp can be used to reorder the clip sets in a layer stack or remove them entirely from consideration during value resolution without modifying the clips dictionary.

This is not the list of clip sets that are authored on this prim. To retrieve that information, use GetClips to examine the clips dictionary directly.

This function returns the clip sets listOp from the current edit target.

◆ GetClipTemplateActiveOffset() [1/2]

USD_API bool GetClipTemplateActiveOffset ( double *  clipTemplateActiveOffset) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTemplateActiveOffset() [2/2]

USD_API bool GetClipTemplateActiveOffset ( double *  clipTemplateActiveOffset,
const std::string &  clipSet 
) const

A double representing the offset value used by USD when determining the active period for each clip.


◆ GetClipTemplateAssetPath() [1/2]

USD_API bool GetClipTemplateAssetPath ( std::string *  clipTemplateAssetPath) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTemplateAssetPath() [2/2]

USD_API bool GetClipTemplateAssetPath ( std::string *  clipTemplateAssetPath,
const std::string &  clipSet 
) const

A template string representing a set of assets to be used as clips for the clip set named clipSet.

This string can be of two forms:

integer frames: path/basename.###.usd

subinteger frames: path/basename.##.##.usd.

For the integer portion of the specification, USD will take a particular time, determined by the template start time, stride, and end time, and pad it with zeros up to the number of hashes provided so long as the number of hashes is greater than the digits required to specify the integer value.

For instance:

time = 12, template asset path = foo.##.usd => foo.12.usd time = 12, template asset path = foo.###.usd => foo.012.usd time = 333, template asset path = foo.#.usd => foo.333.usd

In the case of subinteger portion of a specifications, USD requires the specification to be exact.

For instance:

time = 1.15, template asset path = foo.#.###.usd => foo.1.150.usd time = 1.145, template asset path = foo.#.##.usd => foo.1.15.usd time = 1.1, template asset path = foo.#.##.usd => foo.1.10.usd

Note that USD requires that hash groups be adjacent in the string, and that there only be one or two such groups.

◆ GetClipTemplateEndTime() [1/2]

USD_API bool GetClipTemplateEndTime ( double *  clipTemplateEndTime) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTemplateEndTime() [2/2]

USD_API bool GetClipTemplateEndTime ( double *  clipTemplateEndTime,
const std::string &  clipSet 
) const

A double which indicates the end of the range USD will use to to search for asset paths for the clip set named clipSet.

This value is inclusive in that range.

See also
GetClipTemplateAssetPath.

◆ GetClipTemplateStartTime() [1/2]

USD_API bool GetClipTemplateStartTime ( double *  clipTemplateStartTime) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTemplateStartTime() [2/2]

USD_API bool GetClipTemplateStartTime ( double *  clipTemplateStartTime,
const std::string &  clipSet 
) const

A double which indicates the start of the range USD will use to search for asset paths for the clip set named clipSet.

This value is inclusive in that range.

See also
GetClipTemplateAssetPath.

◆ GetClipTemplateStride() [1/2]

USD_API bool GetClipTemplateStride ( double *  clipTemplateStride) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTemplateStride() [2/2]

USD_API bool GetClipTemplateStride ( double *  clipTemplateStride,
const std::string &  clipSet 
) const

A double representing the increment value USD will use when searching for asset paths for the clip set named clipSet.

See also
GetClipTemplateAssetPath.

◆ GetClipTimes() [1/2]

USD_API bool GetClipTimes ( VtVec2dArray *  clipTimes) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ GetClipTimes() [2/2]

USD_API bool GetClipTimes ( VtVec2dArray *  clipTimes,
const std::string &  clipSet 
) const

List of pairs (stage time, clip time) indicating the time in the active clip in the clip set named clipSet that should be consulted for values at the corresponding stage time.

During value resolution, this list will be sorted by stage time; times will then be linearly interpolated between consecutive entries. For instance, for clip times [(0.0, 0.0), (10.0, 20.0)], at stage time 0, values from the active clip at time 0 will be used, at stage time 5, values from the active clip at time 10, and at stage time 10, clip values at time 20.

◆ GetInterpolateMissingClipValues()

USD_API bool GetInterpolateMissingClipValues ( bool *  interpolate) const

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

◆ GetSchemaAttributeNames()

static USD_API const TfTokenVector & GetSchemaAttributeNames ( bool  includeInherited = true)
static

Return a vector of names of all pre-declared attributes for this schema class and all its ancestor classes.

Does not include attributes that may be authored by custom/extended methods of the schemas involved.

◆ SetClipActive() [1/2]

USD_API bool SetClipActive ( const VtVec2dArray &  activeClips)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipActive() [2/2]

USD_API bool SetClipActive ( const VtVec2dArray &  activeClips,
const std::string &  clipSet 
)

Set the active clip metadata for the clip set named clipSet.

See also
GetClipActive()

◆ SetClipAssetPaths() [1/2]

USD_API bool SetClipAssetPaths ( const VtArray< SdfAssetPath > &  assetPaths)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipAssetPaths() [2/2]

USD_API bool SetClipAssetPaths ( const VtArray< SdfAssetPath > &  assetPaths,
const std::string &  clipSet 
)

Set the clip asset paths for the clip set named clipSet.

See also
GetClipAssetPaths()

◆ SetClipManifestAssetPath() [1/2]

USD_API bool SetClipManifestAssetPath ( const SdfAssetPath manifestAssetPath)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipManifestAssetPath() [2/2]

USD_API bool SetClipManifestAssetPath ( const SdfAssetPath manifestAssetPath,
const std::string &  clipSet 
)

Set the clip manifest asset path for this prim.

See also
GetClipManifestAssetPath()

◆ SetClipPrimPath() [1/2]

USD_API bool SetClipPrimPath ( const std::string &  primPath)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipPrimPath() [2/2]

USD_API bool SetClipPrimPath ( const std::string &  primPath,
const std::string &  clipSet 
)

Set the clip prim path for the clip set named clipSet.

See also
GetClipPrimPath()

◆ SetClips()

USD_API bool SetClips ( const VtDictionary clips)

Set the clips dictionary for this prim.

See also
GetClips

◆ SetClipSets()

USD_API bool SetClipSets ( const SdfStringListOp &  clipSets)

Set the clip sets list op for this prim.

See also
GetClipSets

◆ SetClipTemplateActiveOffset() [1/2]

USD_API bool SetClipTemplateActiveOffset ( const double  clipTemplateActiveOffset)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTemplateActiveOffset() [2/2]

USD_API bool SetClipTemplateActiveOffset ( const double  clipTemplateActiveOffset,
const std::string &  clipSet 
)

Set the clip template offset for the clip set named clipSet.

See also
GetClipTemplateActiveOffset

◆ SetClipTemplateAssetPath() [1/2]

USD_API bool SetClipTemplateAssetPath ( const std::string &  clipTemplateAssetPath)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTemplateAssetPath() [2/2]

USD_API bool SetClipTemplateAssetPath ( const std::string &  clipTemplateAssetPath,
const std::string &  clipSet 
)

Set the clip template asset path for the clip set named clipSet.

See also
GetClipTemplateAssetPath

◆ SetClipTemplateEndTime() [1/2]

USD_API bool SetClipTemplateEndTime ( const double  clipTemplateEndTime)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTemplateEndTime() [2/2]

USD_API bool SetClipTemplateEndTime ( const double  clipTemplateEndTime,
const std::string &  clipSet 
)

Set the template end time for the clipset named clipSet.

See also
GetClipTemplateEndTime()

◆ SetClipTemplateStartTime() [1/2]

USD_API bool SetClipTemplateStartTime ( const double  clipTemplateStartTime)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTemplateStartTime() [2/2]

USD_API bool SetClipTemplateStartTime ( const double  clipTemplateStartTime,
const std::string &  clipSet 
)

Set the template start time for the clip set named clipSet.

See also
GetClipTemplateStartTime

◆ SetClipTemplateStride() [1/2]

USD_API bool SetClipTemplateStride ( const double  clipTemplateStride)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTemplateStride() [2/2]

USD_API bool SetClipTemplateStride ( const double  clipTemplateStride,
const std::string &  clipSet 
)

Set the template stride for the clip set named clipSet.

See also
GetClipTemplateStride()

◆ SetClipTimes() [1/2]

USD_API bool SetClipTimes ( const VtVec2dArray &  clipTimes)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

See also
UsdClipsAPISetNames

◆ SetClipTimes() [2/2]

USD_API bool SetClipTimes ( const VtVec2dArray &  clipTimes,
const std::string &  clipSet 
)

Set the clip times metadata for this prim.

See also
GetClipTimes()

◆ SetInterpolateMissingClipValues() [1/2]

USD_API bool SetInterpolateMissingClipValues ( bool  interpolate)

This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. This function operates on the default clip set.

◆ SetInterpolateMissingClipValues() [2/2]

USD_API bool SetInterpolateMissingClipValues ( bool  interpolate,
const std::string &  clipSet 
)

Set whether missing clip values are interpolated from surrounding clips.

Friends And Related Function Documentation

◆ UsdSchemaRegistry

friend class UsdSchemaRegistry
friend

Definition at line 164 of file clipsAPI.h.

Member Data Documentation

◆ schemaKind

const UsdSchemaKind schemaKind = UsdSchemaKind::NonAppliedAPI
static

Compile time constant representing what kind of schema this class is.

See also
UsdSchemaKind

Definition at line 111 of file clipsAPI.h.


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