Houdini 19.0 VEX VEX Functions usd_addprimvar

usd_addprimvar VEX function

Creates a primvar of a given type on a primitive.

Since 18.0

int  usd_addprimvar(int stagehandle, string primpath, string name, string typename)

int  usd_addprimvar(int stagehandle, string primpath, string name, string typename, string interpolation)

This function adds a primvar of a given type to the primitive, if such primvar is not part of a schema. It is useful for controlling the exact type of a custom primvar. For primvars defined by primitive’s schema, this call has no effect, because the schema already determines their type.

stagehandle

A handle to the stage to write to. Currently the only valid value is 0, which means the current stage in a node. (This argument may be used in the future to allow writing to other stages.)

primpath

The path to the primitive.

name

Primvar name (without namespace).

typename

The name or an alias of the type.

interpolation

The name of the interpolation to be used for this primvar (e.g., “constant”, “vertex”, “faceVarying”, etc).

Returns

The value of stagehandle on success, or -1 on failure.

Examples

// Adds a half-precision float primvar and sets its falue.
usd_addprimvar(0, "/geo/sphere", "half_primvar", "half3");
usd_setprimvar(0, "/geo/sphere", "half_primvar", {1.25, 1.50, 1.75});

// Adds a color primitive with 'vertex' interpolation.
usd_addprimvar(0, pp, "color_primvar", "color3d[]", "vertex");
usd_setprimvar(0, pp, "color_primvar",  vector[](array({1,0,0}, {0,1,0}, {0,0,1})));
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_addprimvar