SelectObjectsUsingMaterial

Introduced

v5.0

Description

Selects all the objects being 'used by' the input material(s). For a material on a polygon cluster the 3DObject is selected.

Scripting Syntax

SelectObjectsUsingMaterial( InputObjs );

Parameters

Parameter Type Description
InputObjs String List of materials

Default Value: Current selection

Examples

1. VBScript Example

' The following example creates an object, adds a material and then

' demonstates this command.

' Create an object with a material

NewScene

CreatePrim "Cube", "MeshSurface"

ApplyShader , , , , siLetLocalMaterialsOverlap

DeselectAll

' Select the object(s) using the material

SelectObjectsUsingMaterial "cube.Material"

' The 'cube' should now be selected.

2. JScript Example

// The following example creates a couple of objects and places them in a group.

// Then it creates new material in the material library and assigns that material

// to the group.  Then it demonstates this command.

// Create a couple of objects

NewScene(null, null);

CreatePrim("Cube", "MeshSurface", null, null);

Translate(null, -7.53782097226927, -0.124316224318551, 1.24316224318551E-02, siRelative, siView, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 0, null);

CreatePrim("Cube", "MeshSurface", null, null);

Translate(null, 4.3311236525746, -1.31907686094078E-16, 1.31907686094078E-17, siRelative, siView, siObj, siXYZ, null, null, null, null, null, null, null, null, null, 0, null);

// Create a new material (make it red)

SICreateMaterial(null, null, "Sources.Materials.DefaultLib", "", null, null);

SetValue("Sources.Materials.DefaultLib.Material.Phong.diffuse.red", 1, null);

SetValue("Sources.Materials.DefaultLib.Material.Phong.diffuse.green", 0, null);

SetValue("Sources.Materials.DefaultLib.Material.Phong.diffuse.blue", 0, null);

// Assign the new material to the two objects

SelectObj("cube,cube1", null, true);

SIAssignMaterial(null, "Sources.Materials.DefaultLib.Material");

DeselectAll();

// Select the object(s) using the material

SelectObjectsUsingMaterial("Sources.Materials.DefaultLib.Material");

// The objects cube and cube1 should now be selected.

See Also

SelectMaterialsUsedBy