PhysxSchemaPhysxMaterialAPI Class Reference

PhysX material extended parameters. More...

Inherits UsdAPISchemaBase.

Public Member Functions
	PhysxSchemaPhysxMaterialAPI (const UsdPrim &prim=UsdPrim())
	Construct a PhysxSchemaPhysxMaterialAPI on UsdPrim prim . More...
	PhysxSchemaPhysxMaterialAPI (const UsdSchemaBase &schemaObj)
	Construct a PhysxSchemaPhysxMaterialAPI on the prim held by schemaObj . More...
virtual PHYSXSCHEMA_API	~PhysxSchemaPhysxMaterialAPI ()
	Destructor. More...
PHYSXSCHEMA_API UsdAttribute	GetFrictionCombineModeAttr () const
	Determines the way in which two material properties will be combined to yield a friction or restitution coefficient for a collision. More...
PHYSXSCHEMA_API UsdAttribute	CreateFrictionCombineModeAttr (VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
	See GetFrictionCombineModeAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create. More...
PHYSXSCHEMA_API UsdAttribute	GetRestitutionCombineModeAttr () const
	Determines the way in which two material properties will be combined to yield a friction or restitution coefficient for a collision. More...
PHYSXSCHEMA_API UsdAttribute	CreateRestitutionCombineModeAttr (VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
	See GetRestitutionCombineModeAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create. More...
PHYSXSCHEMA_API UsdAttribute	GetImprovePatchFrictionAttr () const
	Flag only has an effect if physxScene:frictionType "patch" friction model is used. More...
PHYSXSCHEMA_API UsdAttribute	CreateImprovePatchFrictionAttr (VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
	See GetImprovePatchFrictionAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create. More...
PHYSXSCHEMA_API UsdAttribute	GetCompliantContactStiffnessAttr () const
	Spring stiffness for a compliant contact model using implicit springs. More...
PHYSXSCHEMA_API UsdAttribute	CreateCompliantContactStiffnessAttr (VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
	See GetCompliantContactStiffnessAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create. More...
PHYSXSCHEMA_API UsdAttribute	GetCompliantContactDampingAttr () const
	Damping coefficient for a compliant contact model using implicit springs. More...
PHYSXSCHEMA_API UsdAttribute	CreateCompliantContactDampingAttr (VtValue const &defaultValue=VtValue(), bool writeSparsely=false) const
	See GetCompliantContactDampingAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create. More...

Static Public Member Functions
static PHYSXSCHEMA_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 classes. More...
static PHYSXSCHEMA_API PhysxSchemaPhysxMaterialAPI	Get (const UsdStagePtr &stage, const SdfPath &path)
	Return a PhysxSchemaPhysxMaterialAPI holding the prim adhering to this schema at path on stage. More...
static PHYSXSCHEMA_API PhysxSchemaPhysxMaterialAPI	Apply (const UsdPrim &prim)
	Applies this single-apply API schema to the given prim. More...

Static Public Attributes
static const UsdSchemaType	schemaType = UsdSchemaType::SingleApplyAPI
	Compile time constant representing what kind of schema this class is. More...

Protected Member Functions
PHYSXSCHEMA_API UsdSchemaType	_GetSchemaType () const override
	Returns the type of schema this class belongs to. More...

Friends
class	UsdSchemaRegistry

Detailed Description

PhysX material extended parameters.

For any described attribute Fallback Value or Allowed Values below that are text/tokens, the actual token is published and defined in PhysxSchemaTokens. So to set an attribute to the value "rightHanded", use PhysxSchemaTokens->rightHanded as the value.

Definition at line 62 of file physxMaterialAPI.h.

Constructor & Destructor Documentation

PhysxSchemaPhysxMaterialAPI ( const UsdPrim &  prim = UsdPrim() )

inlineexplicit

Construct a PhysxSchemaPhysxMaterialAPI on UsdPrim prim .

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

Definition at line 74 of file physxMaterialAPI.h.

PhysxSchemaPhysxMaterialAPI ( const UsdSchemaBase &  schemaObj )

inlineexplicit

Construct a PhysxSchemaPhysxMaterialAPI on the prim held by schemaObj .

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

Definition at line 82 of file physxMaterialAPI.h.

virtual PHYSXSCHEMA_API ~PhysxSchemaPhysxMaterialAPI ( )

virtual

Destructor.

Member Function Documentation

PHYSXSCHEMA_API UsdSchemaType _GetSchemaType ( ) const

overrideprotected

Returns the type of schema this class belongs to.

See Also

UsdSchemaType

static PHYSXSCHEMA_API PhysxSchemaPhysxMaterialAPI Apply ( const UsdPrim &  prim )

static

Applies this single-apply API schema to the given prim.

This information is stored by adding "PhysxMaterialAPI" to the token-valued, listOp metadata apiSchemas on the prim.

Returns

A valid PhysxSchemaPhysxMaterialAPI object is returned upon success. An invalid (or empty) PhysxSchemaPhysxMaterialAPI object is returned upon failure. See UsdPrim::ApplyAPI() for conditions resulting in failure.

See Also

UsdPrim::GetAppliedSchemas()

UsdPrim::HasAPI()

UsdPrim::ApplyAPI()

UsdPrim::RemoveAPI()

PHYSXSCHEMA_API UsdAttribute CreateCompliantContactDampingAttr	(	VtValue const &	defaultValue = VtValue(),
		bool	writeSparsely = false
	)		const

See GetCompliantContactDampingAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create.

If specified, author defaultValue as the attribute's default, sparsely (when it makes sense to do so) if writeSparsely is true - the default for writeSparsely is false.

PHYSXSCHEMA_API UsdAttribute CreateCompliantContactStiffnessAttr	(	VtValue const &	defaultValue = VtValue(),
		bool	writeSparsely = false
	)		const

See GetCompliantContactStiffnessAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create.

If specified, author defaultValue as the attribute's default, sparsely (when it makes sense to do so) if writeSparsely is true - the default for writeSparsely is false.

PHYSXSCHEMA_API UsdAttribute CreateFrictionCombineModeAttr	(	VtValue const &	defaultValue = VtValue(),
		bool	writeSparsely = false
	)		const

See GetFrictionCombineModeAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create.

If specified, author defaultValue as the attribute's default, sparsely (when it makes sense to do so) if writeSparsely is true - the default for writeSparsely is false.

PHYSXSCHEMA_API UsdAttribute CreateImprovePatchFrictionAttr	(	VtValue const &	defaultValue = VtValue(),
		bool	writeSparsely = false
	)		const

See GetImprovePatchFrictionAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create.

If specified, author defaultValue as the attribute's default, sparsely (when it makes sense to do so) if writeSparsely is true - the default for writeSparsely is false.

PHYSXSCHEMA_API UsdAttribute CreateRestitutionCombineModeAttr	(	VtValue const &	defaultValue = VtValue(),
		bool	writeSparsely = false
	)		const

See GetRestitutionCombineModeAttr(), and also Usd_Create_Or_Get_Property for when to use Get vs Create.

If specified, author defaultValue as the attribute's default, sparsely (when it makes sense to do so) if writeSparsely is true - the default for writeSparsely is false.

static PHYSXSCHEMA_API PhysxSchemaPhysxMaterialAPI Get ( const UsdStagePtr &  stage, const SdfPath &  path  )

static

Return a PhysxSchemaPhysxMaterialAPI 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:

*  PhysxSchemaPhysxMaterialAPI(stage->GetPrimAtPath(path));
*  

PHYSXSCHEMA_API UsdAttribute GetCompliantContactDampingAttr

(

)

const

Damping coefficient for a compliant contact model using implicit springs.

Irrelevant if compliant contacts are disabled when compliantContactStiffness is set to zero and rigid contacts are active. Range: [0, inf) Units: force / (distance / seconds) = mass / seconds

Declaration	float physxMaterial:compliantContactDamping = 0
C++ Type	float
Usd Type	SdfValueTypeNames->Float

PHYSXSCHEMA_API UsdAttribute GetCompliantContactStiffnessAttr

(

)

const

Spring stiffness for a compliant contact model using implicit springs.

A higher stiffness results in behavior closer to a rigid contact. The compliant contact model is only enabled if the stiffness is larger than 0. Range: [0, inf) Units: force/distance = mass / seconds / seconds

Declaration	float physxMaterial:compliantContactStiffness = 0
C++ Type	float
Usd Type	SdfValueTypeNames->Float

PHYSXSCHEMA_API UsdAttribute GetFrictionCombineModeAttr

(

)

const

Determines the way in which two material properties will be combined to yield a friction or restitution coefficient for a collision.

Declaration	uniform token physxMaterial:frictionCombineMode = "average"
C++ Type	TfToken
Usd Type	SdfValueTypeNames->Token
Variability	SdfVariabilityUniform
Allowed Values	average, min, multiply, max

PHYSXSCHEMA_API UsdAttribute GetImprovePatchFrictionAttr

(

)

const

Flag only has an effect if physxScene:frictionType "patch" friction model is used.

Declaration	bool physxMaterial:improvePatchFriction = 1
C++ Type	bool
Usd Type	SdfValueTypeNames->Bool

PHYSXSCHEMA_API UsdAttribute GetRestitutionCombineModeAttr

(

)

const

Determines the way in which two material properties will be combined to yield a friction or restitution coefficient for a collision.

Declaration	uniform token physxMaterial:restitutionCombineMode = "average"
C++ Type	TfToken
Usd Type	SdfValueTypeNames->Token
Variability	SdfVariabilityUniform
Allowed Values	average, min, multiply, max

static PHYSXSCHEMA_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.

Member Data Documentation

const UsdSchemaType schemaType = UsdSchemaType::SingleApplyAPI

static

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

See Also

UsdSchemaType

Definition at line 68 of file physxMaterialAPI.h.

---

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

• W:/919a5455eee1e83c/src/physxSchema/physxMaterialAPI.h