showTextureMap() function



Your Ad Here

The showTextureMap() function allows control over both material and map level texture showing in the viewport.

The form is:

showTextureMap <material> [<texmap>|<material>] <boolean>

 

If the optional <texmap> or <material> is not specified, Show Map in Viewports is set for the argument 1 material to the <boolean> argument.

If the optional <texmap> is specified, it will be searched for in the argument 1 material. It must be a direct subtexture of the supplied argument 1 material. Its show-in-viewport state will be set on or off according to the <boolean> argument.

If the optional material is specified, it will be searched for in the argument 1 material. Its show-in-viewport state will be set on or off according to the <boolean> argument.

Example:

showTextureMap $foo.material on

showTextureMap $foo.material $foo.material.diffusemap off

Note:

Mapping coordinates aren't explicitly enabled for all objects at creation time. When a script is run in the Listener, using 'showTextureMap' is indirectly turning mapping coordinates on. This happens during the scene redraw which happens after each line is executed, if needed. If a script is run from a script editor, or if you put parenthesis around a script, no scene redraw is performed until the entire script is run. Since no redraw is performed, no mapping coordinates exist on the object when the script tries to access them. Solutions: explicitly perform a scene redraw [redrawViews()] after 'showTextureMap', or explicitly turn on mapping coordinates for the object.

See also

Material Editor

TextureMap Common Properties, Operators, and Methods

Accessing The Material Editor Active Slot

Material Editor Access

Return to Autodesk Index

Your Ad Here