ToggleValue

Introduced

v1.0

Description

Toggles the current value of some Boolean parameters that belong to the given property sets.

Scripting Syntax

ToggleValue( ParamName, [InputObjs] );

Parameters

Parameter Type Description
ParamName String List of parameters to toggle.
InputObjs String List of properties that contains the parameter.

Default Value: Selected properties

Examples

1. VBScript Example

NewScene , False

' Toggle Grid Visibility of User Camera in viewport A

ToggleValue "gridvis", "Views.ViewA.UserCamera.camvis"

' Toggle Grid Visibility for all cameras in all viewports

ToggleValue "gridvis", "*.camvis,Views.*.*.camvis"

' Toggle visibility of Nurbs Surfaces, Polygon Meshes, and Implicit Geometry for all cameras in all viewports

ToggleValue "objnurbssrf,objpolymesh,objimpgeometry", "*.camvis,Views.*.*.camvis"

' Toggle Active flag for local transforms of "cube"

CreatePrim "Cube", "MeshSurface"

ToggleValue "active", "cube.kine.local"

2. VBScript Example

DeleteAll False

' Toggle the floor grid Visibility for all cameras in all viewports.

ToggleValue "gridvis", "*.camvis,Views.*.*.camvis"

' The floor grid is no longer visible in any of the viewports.

' Create a NURBS sphere, a mesh cone and an implicit cube.

CreatePrim "Sphere", "NurbsSurface"

CreatePrim "Cone", "MeshSurface"

GetPrim "Cube"

' The sphere, the cone and the cube are visible in all the viewports.

' Toggle the visibility of NURBS Surfaces and Implicit Geometry for some cameras in some viewports.

ToggleValue "objnurbssrf,objimpgeometry", "Views.*.*.camvis"

' The sphere and the cube are no longer visible in the Top, Front and Right viewports.

' Toggle the Specular Enable flag of the scene material Phong shader.

ToggleValue "specular_inuse", "Sources.Materials.DefaultLib.Scene_Material.Phong"

' Open a render region in the Camera viewport.

' The sphere (and the code) specular highlight was toggled off.