UsdPayloads Class Reference

UsdPayloads provides an interface to authoring and introspecting payloads. More...

Public Member Functions
USD_API bool	AddPayload (const SdfPayload &payload, UsdListPosition position=UsdListPositionBackOfPrependList)
	Adds a payload to the payload listOp at the current EditTarget, in the position specified by position. More...
USD_API bool	AddPayload (const std::string &identifier, const SdfPath &primPath, const SdfLayerOffset &layerOffset=SdfLayerOffset(), UsdListPosition position=UsdListPositionBackOfPrependList)
USD_API bool	AddPayload (const std::string &identifier, const SdfLayerOffset &layerOffset=SdfLayerOffset(), UsdListPosition position=UsdListPositionBackOfPrependList)
	This is an overloaded member function, provided for convenience. It differs from the above function only in what argument(s) it accepts. More...
USD_API bool	AddInternalPayload (const SdfPath &primPath, const SdfLayerOffset &layerOffset=SdfLayerOffset(), UsdListPosition position=UsdListPositionBackOfPrependList)
	Add an internal payload to the specified prim. More...
USD_API bool	RemovePayload (const SdfPayload &ref)
	Removes the specified payload from the payloads listOp at the current EditTarget. More...
USD_API bool	ClearPayloads ()
	Removes the authored payload listOp edits at the current EditTarget. More...
USD_API bool	SetPayloads (const SdfPayloadVector &items)
	Explicitly set the payloads, potentially blocking weaker opinions that add or remove items. More...
const UsdPrim &	GetPrim () const
	Return the prim this object is bound to. More...
UsdPrim	GetPrim ()
	operator bool ()

Friends
class	UsdPrim

Detailed Description

UsdPayloads provides an interface to authoring and introspecting payloads.

Payloads behave the same as Usd references except that payloads can be optionally loaded.

Definition at line 43 of file payloads.h.

Member Function Documentation

USD_API bool AddInternalPayload	(	const SdfPath &	primPath,
		const SdfLayerOffset &	layerOffset = SdfLayerOffset(),
		UsdListPosition	position = UsdListPositionBackOfPrependList
	)

Add an internal payload to the specified prim.

See Also

Internal Payloads

USD_API bool AddPayload	(	const SdfPayload &	payload,
		UsdListPosition	position = UsdListPositionBackOfPrependList
	)

Adds a payload to the payload listOp at the current EditTarget, in the position specified by position.

See Also

Why adding references may fail for explanation of expectations on payload and what return values and errors to expect, and ListOps and List Editing for details on list editing and composition of listOps.

USD_API bool AddPayload	(	const std::string &	identifier,
		const SdfPath &	primPath,
		const SdfLayerOffset &	layerOffset = SdfLayerOffset(),
		UsdListPosition	position = UsdListPositionBackOfPrependList
	)

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

USD_API bool AddPayload	(	const std::string &	identifier,
		const SdfLayerOffset &	layerOffset = SdfLayerOffset(),
		UsdListPosition	position = UsdListPositionBackOfPrependList
	)

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

See Also

Payloads Without Prim Paths

USD_API bool ClearPayloads

(

)

Removes the authored payload listOp edits at the current EditTarget.

The same caveats for Remove() apply to Clear(). In fact, Clear() may actually increase the number of composed payloads, if the listOp being cleared contained the "remove" operator.

See Also

ListOps and List Editing

const UsdPrim& GetPrim ( ) const

inline

Return the prim this object is bound to.

Definition at line 106 of file payloads.h.

UsdPrim GetPrim ( )

inline

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

Definition at line 109 of file payloads.h.

USD_API bool RemovePayload

(

const SdfPayload &

ref

)

Removes the specified payload from the payloads listOp at the current EditTarget.

This does not necessarily eliminate the payload completely, as it may be added or set in another layer in the same LayerStack as the current EditTarget.

See Also

ListOps and List Editing

USD_API bool SetPayloads

(

const SdfPayloadVector &

items

)

Explicitly set the payloads, potentially blocking weaker opinions that add or remove items.

See Also

Why adding payloads may fail for explanation of expectations on items and what return values and errors to expect, and ListOps and List Editing for details on list editing and composition of listOps.

---

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

• pxr/usd/usd/payloads.h