## 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