SoEnvironment

InventorModule

genre	InventorNodesAutomatic
author	Silicon Graphics Inc
package	MeVisLab/Standard
definition	inventor.def

Purpose

The node SoEnvironment describes global environmental attributes such as ambient lighting, light attenuation, and fog.

Ambient lighting refers to the amount of extra light impinging on each surface point when the lighting model is Phong (see SoLightModel).

Light attenuation affects all subsequent lights in a scene (see SoLightModel). It is a quadratic function of the distance from a light source to a surface point, with the three coefficients specified in the Attenuation field. Attenuation applies only to light sources with a fixed location, such as point and spot lights.

Fog has one of four types, each of which blends every surface point with the specified fog color. Each type interprets the Fog Visibility field as the distance at which fog completely obscures objects. A visibility value of 0 (the default) causes the SoEnvironment node to set up fog so that the visibility matches the distance to the far clipping plane of the current camera.

Note that this node has an effect only during rendering and does not inherit field values from other SoEnvironment nodes.

Windows

Default Panel

Output Fields

self

name: self, type: SoNode

Parameter Fields

Field Index

Ambient Color: Color

Ambient Intensity: Float

Attenuation: Vector3

Fog Color: Color

Fog Type: Enum

Fog Visibility: Float

Visible Fields

Ambient Intensity

name: ambientIntensity, type: Float, default: 0.2

Sets the intensity of ambient lighting (for Phong lighting).

Ambient Color

name: ambientColor, type: Color, default: 1 1 1

Sets the RGB color of ambient lighting (for Phong lighting).

Attenuation

name: attenuation, type: Vector3, default: 0 0 1

Sets the squared, linear, and constant light attenuation coefficients (in that order) concerning the distance of light from the surface (for Phong lighting).

Fog Type

name: fogType, type: Enum, default: NONE

Defines the fog type.

Values:

Title	Name	Description
None	NONE	No fog.
Haze	HAZE	Linear increase in opacity with distance.
Fog	FOG	Exponential increase in opacity.
Smoke	SMOKE	Exponential squared increase in opacity.

Fog Color

name: fogColor, type: Color, default: 1 1 1

Sets the color of the fog.

Fog Visibility

name: fogVisibility, type: Float, default: 0

Sets the visibility distance of the fog, which is the distance at which fog completely obscures objects.