Object Hierarchy




The UserDataItem object represents a single instance of user data that has been attached to a Softimage component. For example, each polygon on a Cluster with a UserDataMap will have its own instance of this UserDataItem object.

This object is provided for convenience but it is also possible to manipulate the user data using the methods UserDataMap.ItemValue, UserDataMap.ItemSize and UserDataMap.IsEmpty provided directly on the UserDataMap.


IsEmpty operator Size operator Value operator  


VBScript Example

' Example demonstrating the properties and methods on the
' UserDataItem object
dim oRoot, oTorus, oCluster, oUserDataMap, oUserData
set oRoot = Application.ActiveProject.ActiveScene.Root
set oTorus = oRoot.AddGeometry("Torus","NurbsSurface")
set oCluster = oTorus.ActivePrimitive.Geometry.AddCluster( siBoundaryCluster )
set oUserDataMap = oCluster.AddProperty("UserDataMap",, "NameOfProperty")
set oUserData = oUserDataMap.Item( 0 )
Application.LogMessage oUserData.IsEmpty & "/" & oUserData.Size & "/" & oUserData.Value
' We can save strings in the user data
oUserData.Value = "Some content"
Application.LogMessage oUserData.IsEmpty & "/" & oUserData.Size & "/" & oUserData.Value
' Output of this script is:
'INFO : "True/0/"
'INFO : "False/24/Some content"

See Also