Interface: INodeGIProperties

This Node Interface exposes the node’s Global Illumination 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.

Properties:

<node>.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!

<node>.GIByLayer : boolean : Read|Write

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

Adv.Lighting General Properties

<node>.isGIOccluder : boolean : Read|Write

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

<node>.isGIReceiver : boolean : Read|Write

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

<node>.GIRayMult : float : Read|Write

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

Radiosity-only Properties

<node>.isGIDiffuse : boolean : Read|Write

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

<node>.isGISpecular : boolean : Read|Write

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

<node>.isGIExcludedFromRegather : boolean : Read|Write

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

Object Subdivision Settings

<node>.GIUseGlobalMeshing : boolean : Read|Write

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

<node>.GIMeshingEnabled : boolean : Read|Write

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

<node>.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

<node>.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

<node>.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.

<node>.GIContrastThreshold : float : Read|Write

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

<node>.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.

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

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

<node>.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

<node>.storeIllumToMesh : boolean : Read|Write

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

EXAMPLE

--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