MaterialName

Returns or modifies a material's user-definable name.

Syntax

rhinoscriptsyntax.MaterialName (material_index, name=None)

rhinoscript.material.MaterialName (material_index, name=None)

Parameters

material_index

Required.  Number.  The zero-based source material index.

name

Optional.  String.  The new name.  If omitted, the current name is returned.

Returns

String

If name is not specified, the current material name if successful.

String

If name is specified, the previous material name if successful.

None

It not successful, or on error.

Example

import rhinoscriptsyntax as rs

obj = rs.GetObject("Select object")

if obj:

    index = rs.ObjectMaterialIndex(obj)

    if index>-1:

        rs.MaterialName( index, "Fancy_Material" )

Also See

MaterialBump

MaterialColor

MaterialReflectiveColor

MaterialShine

MaterialTexture

MaterialTransparency