Properties
<TextureMap>.name
All the TextureMap subclasses can access the name property and specify it as a constructor parameter.
Methods
Modifies the name of the specified texture to make it unique. The name is of the form "Map #1" where the number is incremented as required to make ensure it's unique.
renderMap <TextureMap> [ into:<bitmap> ] \
[ size:<point2> ] \
[ filename:<string> ] \
[ scale:<float> ] \
[ filter:<boolean> ] \
[ display:<boolean> ]
Provides access the Render Map function available in the Material Editor. The function returns a Bitmap value containing a rendering of the given texture map. If you specify the optional into: argument, the function renders the map into the supplied bitmap, taking size and other attributes from the existing bitmap. If you don't, a new bitmap value is created using the size: and fileName: arguments in its creation. Default size value is [200,200].
The scale: argument is a scale factor applied to 3D TextureMaps. This is the scale of the surface in 3d space that is mapped to UV and controls how much of the texture appears in the bitmap representation. Default scale value is 1.
If the filter: argument is true, the bitmap is filtered. It is quite a bit slower to rescale bitmaps with filtering on. Defaults filter value is false/off.
If the display: argument is true, the resulting bitmap is displayed using the virtual frame buffer; otherwise it is not. Default display value is false/off.
Example:
rm = renderMap $foo.material.diffuseMap size:[640,480] \
fileName:"foodif.bmp"
save rm
close rm
The above will render a map to a bitmap and save it as a .bmp file.
Associated Methods
showTextureMap <material> <TextureMap> <boolean>
This method provides control over the visibility of textures in the shaded viewport. You specify the material containing the texture map, the texture map in that material to be controlled, and a boolean to turn the display on or off. For example:
showTextureMap $foo.material $foo.material.diffuseMap on
tm = checker()
mat = standardMaterial diffuseMap:tm
mm = multimaterial()
mm[1] = mat
$box01.material = mm
showTextureMap mm[1] tm on
Note that for multimaterials, you need to specify the appropriate sub-material (using [] indexing, for example).
See also
Material Common Properties, Operators, and Methods