SetThumbnailFromRegion
v4.0
Saves a thumbnail taken from the render region (if open) and then sets that thumbnail on each object in the specified list. Note: If there is no region open the History Pane displays the error message 'ERROR : "2000-VIEW-SetThumbnailFromRegion - No region is open]] - [line 1]" and the command fails.
SetThumbnailFromRegion( [InputObjs], [FileName], [Overwrite] ); |
| Parameter | Type | Description |
|---|---|---|
| InputObjs | String | List of elements (such as
objects, models) on which to set the thumbnail
Default Value: Selected objects |
| FileName | String | File name (path not needed) of file to write thumbnail (from
region) to.
Default Value: User is prompted for filename (with path set to the default Thumbnails sub-folder under the current project). |
| Overwrite | Boolean | Specifies whether to overwrite the thumbnail file if it already
exists.
Default Value: False |
' This example demonstrates how to use the SetThumbnailFromRegion command by ' creating an object, manually creating a RenderRegion, and then setting the ' thumbnail from that region. ' ' INSTRUCTIONS: ' ============= ' This example must be run in 3 parts: ' 1) Create an object on which to set the thumbnail ' 2) User manually creates a render region ' 3) Set a thumbnail (from region) onto the object ' ' Run this script normally in the Script Editor. NewScene , False CreatePrim "Cylinder", "MeshSurface" ApplyShader , , , , siLetLocalMaterialsOverlap SetValue "cylinder.Material.Phong.diffuse.red", 1 SetValue "cylinder.Material.Phong.diffuse.green", 0 SetValue "cylinder.Material.Phong.diffuse.blue", 1 ' ' Create a Render Region by pressing Q and drawing a box around the cylinder ' ' Paste this line (uncommented) in the Script Editor and run it to set the actual thumbnail: ' ' SetThumbnailFromRegion "cylinder", "MyThumbnail.jpg" ' |