What's New in Director 8.5 > The 3D Cast Member > Model resources

 

Model resources

Model resources are pieces of 3D geometry that can be used to display 3D models. Model resources are visible only when they are used by a model. Model resources are reusable, and multiple models can share the same model resource.

The following commands and properties can be used to perform basic model resource operations:

Command

Function

Returns

modelResource.count

Returns the number of model resource objects included in the cast member.

Integer.

modelResource.(name)

Returns the model resource named name.

Returns the model resource object named name if it exists. Returns void if the object does not exist.

modelResource.[index]

Returns the model resource at the designated position in the index. The index number can change if model resources are added or deleted.

Returns the model resource object at that index number if it exists. Returns void if the object does not exist at that index number.

newMesh(name,numFaces, numVertices, numNormalsnumColors,numTextureCoordinates)

Creates a new mesh model resource.

numFaces is the user-specified number of triangles.

numVertices is the user-specified number of vertices. A vertex can be used by more than one face.

numNormals is the user-specified number of normals. Enter 0 or omit this step to use the generateNormals() method.

numColors is the user-specified number of colors. You can specify a color for each point of a triangle.

numTextureCoordinates is the number of user-specified texture coordinates. Enter 0 or omit this step to get the default coordinates.

Returns a new mesh model resource with a unique name. If the name isn't unique, returns a Lingo error.

newModelResource(name,type)

Creates a new model resource and adds it to the model resource object list. The type can be #plane, #box, #sphere, #cylinder, #extrusion, or #particle.

Returns a new model resource object with a unique name. If the name isn't unique, returns a Lingo error.

newModelResource(name,type, facing)

Creates a new model resource with the specified facing and adds it to the model resource object list. The type can be #plane, #box, #sphere, or #cylinder. The facing can be #front, #back, or #both.

Returns a new model resource object with a unique name. If the name isn't unique, returns a Lingo error.

deleteModelResource(name)

Deletes the model resource named name. Lingo references to this model resource persist but can do nothing.

TRUE (1) if the model resource named name exists. FALSE (0) if the model resource named name doesn't exist.

deletemodelResource(index)

Deletes the model resource with the given index number. Lingo references to this model resource persist but can do nothing.

TRUE (1) if the model resource with this index number exists. FALSE (0) if the model resource with this index number doesn't exist.