#include <payloads.h>

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

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)

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

USD_API bool	RemovePayload (const SdfPayload &ref)

USD_API bool	ClearPayloads ()

USD_API bool	SetPayloads (const SdfPayloadVector &items)

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 UsdPayloads::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 UsdPayloads::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 Usd_OM_ListOps for details on list editing and composition of listOps.

USD_API bool UsdPayloads::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 UsdPayloads::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 UsdPayloads::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: Usd_OM_ListOps

const UsdPrim& UsdPayloads::GetPrim ( ) const

inline

Return the prim this object is bound to.

Definition at line 106 of file payloads.h.

UsdPrim UsdPayloads::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.

UsdPayloads::operator bool ( )

inlineexplicit

Definition at line 111 of file payloads.h.

USD_API bool UsdPayloads::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: Usd_OM_ListOps

USD_API bool UsdPayloads::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 Usd_OM_ListOps for details on list editing and composition of listOps.

Friends And Related Function Documentation

friend class UsdPrim

friend

Definition at line 44 of file payloads.h.

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

pxr/usd/usd/payloads.h

Public Member Functions

Friends

Detailed Description

Member Function Documentation

Friends And Related Function Documentation