Houdini 19.0 VEX VEX Functions usd_iprimvarelementsize

usd_iprimvarelementsize VEX function

Returns the element size of the primvar directly from the USD primitive or from USD primitive’s ancestor.

Since 19.0

int  usd_iprimvarelementsize(<stage>stage, string primpath, string name)

This function returns the element size of a primvar found directly on the given primitive or inherited from primitive’s ancestor.

The primvar element size applies to array primvars, but it does not encode the length of the array. It specifies how many consecutive array elements should be taken as an atomic element to be interpolated over a gprim. So, on a mesh, array length relates to element size like this array_length = element_size * face_count.

In most cases, the element size is 1.

Note, element size is a USD concept and differs from the VEX tuple size obtained with usd_iprimvarsize or the VEX array length obtained with usd_iprimvarlen.

<stage>

When running in the context of a node (such as a wrangle LOP), this argument can be an integer representing the input number (starting at 0) to read the stage from. The integer is equivalent to the string form referencing a particular input, e.g., “opinput:0”.

primpath

The path to the primitive.

name

Primvar name (without namespace).

Returns

The primvar’s element size.

Examples

// Get the element size of a primvar on the cube primitive or its ancestor.
int element_size = usd_iprimvarelementsize(0, "/geo/cube", "primvar_name");
See also
usd

usd_addattrib

usd_addcollectionexclude

usd_addcollectioninclude

usd_addinversetotransformorder

usd_addorient

usd_addprim

usd_addprimvar

usd_addrelationshiptarget

usd_addrotate

usd_addscale

usd_addtotransformorder

usd_addtransform

usd_addtranslate

usd_attrib

usd_attribelement

usd_attriblen

usd_attribnames

usd_attribsize

usd_attribtimesamples

usd_attribtypename

usd_blockattrib

usd_blockprimvar

usd_blockprimvarindices

usd_blockrelationship

usd_boundmaterialpath

usd_clearmetadata

usd_cleartransformorder

usd_collectioncomputedpaths

usd_collectioncontains

usd_collectionexcludes

usd_collectionexpansionrule

usd_collectionincludes

usd_drawmode

usd_findtransformname

usd_flattenediprimvar

usd_flattenediprimvarelement

usd_flattenedprimvar

usd_flattenedprimvarelement

usd_getbbox

usd_getbbox_center

usd_getbbox_max

usd_getbbox_min

usd_getbbox_size

usd_getbounds

usd_getpointinstancebounds

usd_hasapi

usd_haspayload

usd_iprimvar

usd_iprimvarelement

usd_iprimvarelementsize

usd_iprimvarindices

usd_iprimvarinterpolation

usd_iprimvarlen

usd_iprimvarnames

usd_iprimvarsize

usd_iprimvartimesamples

usd_iprimvartypename

usd_isabstract

usd_isactive

usd_isarray

usd_isarrayiprimvar

usd_isarraymetadata

usd_isarrayprimvar

usd_isattrib

usd_iscollection

usd_iscollectionpath

usd_isindexediprimvar

usd_isindexedprimvar

usd_isinstance

usd_isiprimvar

usd_iskind

usd_ismetadata

usd_ismodel

usd_isprim

usd_isprimvar

usd_isrelationship

usd_isstage

usd_istransformreset

usd_istype

usd_isvisible

usd_kind

usd_localtransform

usd_makeattribpath

usd_makecollectionpath

usd_makepropertypath

usd_makerelationshippath

usd_makevalidprimname

usd_makevalidprimpath

usd_metadata

usd_metadataelement

usd_metadatalen

usd_metadatanames

usd_name

usd_parentpath

usd_pointinstance_getbbox

usd_pointinstance_getbbox_center

usd_pointinstance_getbbox_max

usd_pointinstance_getbbox_min

usd_pointinstance_getbbox_size

usd_pointinstance_relbbox

usd_pointinstancetransform

usd_primvar

usd_primvarattribname

usd_primvarelement

usd_primvarelementsize

usd_primvarindices

usd_primvarinterpolation

usd_primvarlen

usd_primvarnames

usd_primvarsize

usd_primvartimesamples

usd_primvartypename

usd_purpose

usd_relationshipforwardedtargets

usd_relationshipnames

usd_relationshiptargets

usd_relbbox

usd_removerelationshiptarget

usd_setactive

usd_setattrib

usd_setattribelement

usd_setcollectionexcludes

usd_setcollectionexpansionrule

usd_setcollectionincludes

usd_setdrawmode

usd_setkind

usd_setmetadata

usd_setmetadataelement

usd_setprimvar

usd_setprimvarelement

usd_setprimvarelementsize

usd_setprimvarindices

usd_setprimvarinterpolation

usd_setpurpose

usd_setrelationshiptargets

usd_settransformorder

usd_settransformreset

usd_setvariantselection

usd_setvisibility

usd_setvisible

usd_specifier

usd_transformname

usd_transformorder

usd_transformsuffix

usd_transformtype

usd_typename

usd_uniquetransformname

usd_variants

usd_variantselection

usd_variantsets

usd_worldtransform

usd_primvar

usd_iprimvarelementsize