render
Regenerates the specified RenderMaps. This is the scripting
equivalent of clicking the Regenerate Map button in the RenderMap
property editor. To add a RenderMap, use the 'AddProp "RenderMap"' command.
RenderMaps allow you to 'bake' complex texturing and rendertree
information into a single texture image, which you can use for
previewing textures in the textured viewing modes, creating
textures for games and realtime rendering, or for generally
speeding up rendering.
Note: You cannot generate a rendermap for an object unless there is
a texture projection attached to the image and the texture
projection cannot be a spatial texture projection (use a UV
projection instead).
RegenerateMaps( [Properties], [TileSize] ); |
| Parameter | Type | Description |
|---|---|---|
| Properties | String | List of RenderMaps to
regenerate. RenderMaps are properties, for example,
"sphere.RenderMap".
Default Value: Current selection |
| TileSize | Integer | Increase or decrease the likelihood that satellite machines
will be used in the render (see
the Softimage user guide for more information about
tiles). Suggested values are 8, 16, 32, and 64. Accepted values are in the range of 8 to 512 inclusive. Default Value: 32 |
'
' This example creates a sphere with a rendermap, and then connects a rendermap
' using a UV projection to the sphere and regenerates the map.
'
NewScene , false
' Add a sphere to the scene
Set oSphere = CreatePrim( "Sphere", "NurbsSurface" )
' Create a rendermap on the sphere; the AddProp command returns the output
' object as an XSICollection of 1, so you can get the actual RenderMap as
' a Property object by resetting the object pointer to the first member
' of the returned collection
AddProp "RenderMap", oSphere, , , oRMap
Set oRMap = oRMap(0)
' Specify a destination directory and name for the new image file
' Note: You must specify the image filename with an extension
oRMap.Parameters( "imagefile" ).Value = InstallationPath( siUserPath ) _
& "\temp\rendermap.pic"
'
' Tip: You can also use the SetValue command instead of accessing the
' parameter through the object model:
' SetValue oSphere & ".RenderMap.imagefile", InstallationPath( siUserPath ) _
' & "\temp\rendermap.pic"
'
' Add a texture projection to the sphere and attach the rendermap to it
CreateProjection oSphere, siTxtUV, siTxtDefaultSpherical, sSupport, sProj
SetInstanceDataValue , oRMap.Parameters( "uvprop" ), sProj
'
' Tip: You can also use the SetInstanceDataValue command instead of
' accessing the parameter through the object model:
' SetInstanceDataValue , oSphere & ".RenderMap.uvprop", sProj
'
' Regenerate the rendermap with a tile size of 16
RegenerateMaps oRMap, 16
|