Interface: INodeGIProperties

This represents a Node Interface to the node’s GI Properties. These properties correspond to the UI controls found in the Adv. Lighting tab of the Object Properties dialog in 3ds Max 5 and higher.

In Autodesk VIZ, the supported controls are located under the Radiosity tab.

Properties:

.isGIExcluded : boolean : Read|Write

Corresponds to the Exclude from Radiosity Processing checkbox in the Object Properties > Adv. Lighting tab

Note:

Since hidden objects are NEVER considered by the radiosity processing, setting isGIExcluded to false for hidden objects will have no practical effect on them - they will NOT be processed unless unhidden!

.GIByLayer : boolean : Read|Write

Corresponds to the By Layer / By Object checkbutton in the Object Properties > Adv. Lighting tab

Adv.Lighting General Properties

.isGIOccluder : boolean : Read|Write

Corresponds to the Cast Shadows checkbox in the Object Properties > Adv. Lighting tab

.isGIReceiver : boolean : Read|Write

Corresponds to the Receive Illumination checkbox in the Object Properties > Adv. Lighting tab

.GIRayMult : float : Read|Write

Corresponds to the Num. Regathering Rays Multiplier value in the Object Properties > Adv. Lighting tab

Radiosity-only Properties

.isGIDiffuse : boolean : Read|Write

Corresponds to the Diffuse (reflective & translucent) checkbox in the Object Properties > Adv. Lighting tab

.isGISpecular : boolean : Read|Write

Corresponds to the Specular (reflective & translucent) checkbox in the Object Properties > Adv. Lighting tab

.isGIExcludedFromRegather : boolean : Read|Write

Corresponds to the Exclude from Regathering checkbox in the Object Properties > Adv. Lighting tab

Object Subdivision Settings

.GIUseGlobalMeshing : boolean : Read|Write

Corresponds to the Use Global Subdivision Settings checkbox in the Object Properties > Adv. Lighting tab

.GIMeshingEnabled : boolean : Read|Write

Corresponds to the Subdivide checkbox in the Object Properties > Adv. Lighting tab

.GIUseAdaptiveSubdivision : boolean : Read|Write

Corresponds to the Use Adaptive Subdivision checkbox in the Object Properties > Adv. Lighting tab. Available in 3ds Max 8 and higher.

Mesh Settings

.GIMeshSize : worldUnits : Read|Write|Validated by Range: 0.01 to 1e+009

Corresponds to the Max.Mesh Size value in the Object Properties > Adv. Lighting tab

.GIMinMeshSize : float : Read|Write

Corresponds to the Min.Mesh Size value in the Object Properties > Adv. Lighting tab. Available in 3ds Max 8 and higher.

.GIContrastThreshold : float : Read|Write

Corresponds to the Contrast Threshold value in the Object Properties > Adv. Lighting tab. Available in 3ds Max 8 and higher.

.GIInitialMeshSize : float : Read|Write

Corresponds to the Initial Mesh Size value in the Object Properties > Adv. Lighting tab. Available in 3ds Max 8 and higher.

 

.nbGIRefineSteps : integer : Read|Write|Validated by Range: 0 to 65535

Corresponds to the Refine Iterations value in the Object Properties > Adv. Lighting tab

.nbGIRefineStepsDone : integer : Read|Write|Validated by Range: 0 to 65535

Corresponds to the Iterations Done value in the Object Properties > Adv. Lighting tab

Light Object Radiosity Properties

.storeIllumToMesh : boolean : Read|Write

Corresponds to the Store Direct Illumination in Mesh checkbox in the Object Properties > Adv. Lighting tab

 

 

Examples:

--Create a box which is excluded from Radiosity Processing

b = box isGIExcluded:true

$Box:Box01 @ [0.000000,0.000000,0.000000]

--Include the box in Radiosity Processing again

b.isGIExcluded = false

false

--Uncheck the Receive Illumination property

b.isGIReceiver = false

false

 

See also

Node Interfaces

Interface: SceneRadiosity