Class TAbstractPositionalLightNode

This item has no description. Showing description inherited from TX3DNode.Create.

Constructor. Initializes various properties:

• Name, BaseUrl are initialized from given parameters.

• The Fields, Events lists are filled in every descendant, to have all the fields/events defined by the specification.

• DefaultContainerField, and other node-specific stuff, is filled in descendants. This is actually implemented in CreateNode, that is called at the end of this constructor.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 197).

Calculate light intensity drop because of the distance to the light. This follows the equation 1/max( attenuation[0] + ... ) from the VRML/X3D specification, it is the same as OpenGL attenuation.

Since calculating the DistanceToLight for the Attenuation method may be time-consuming in some situations, you can check DistanceNeededForAttenuation first. When the DistanceNeededForAttenuation returns False, then the value of DistanceToLight parameter is ignored (you can pass anything).

The DistanceToLight should be a distance in the light source local coordinate system. TODO: although our renderers currently ignore this: ray-tracer uses global coord system, OpenGL (fixed-function and shader) renderer uses eye coord system (should be equal to global coord system for normal cameras).

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 217).

This item has no description.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 218).

Is attenuation relevant. When False, you know that Attenuation function always returns 1, so there's no point in using it at all.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 223).

Should the "radius" field be taken into account.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 226).

This item has no description. Showing description inherited from TAbstractLightNode.UpdateLightInstance.

Update TLightInstance record when lighting location/direction (and other properties precalculated on TLightInstance) change. Assumes that LightInstance.Node = Self.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 228).

This item has no description. Showing description inherited from TAbstractPunctualLightNode.PositionAndDirection.

Position and direction expressed in homogeneous coordinates. For positional lights, the last component is always 1. For directional lights, the last component is always 0.

Note that this is expressed in the local light node coordinate system.

Source: scene/x3d/x3dnodes_standard_lighting.inc (line 229).

Create node fields and events.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 35).

This item has no description. Showing description inherited from TX3DNode.ClassX3DType.

Node type name in VRML/X3D, for this class. Normal VRML/X3D node classes should override this to return something non-empty, and then X3DType automatically will return the same value.

Empty for classes that don't have a hardcoded VRML/X3D node name, like a special TX3DUnknownNode. Such special classes should override then X3DType to return actual non-empty name there.

You usually should call X3DType. The only use of this method is that it works on classes (it's "class function"), without needing at actual instance.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 36).

Internal wrapper for property Attenuation. This wrapper API may change, we advise to access simpler Attenuation instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 40).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 42).

Internal wrapper for property Location. This wrapper API may change, we advise to access simpler Location instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 46).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 48).

Internal wrapper for property Radius. This wrapper API may change, we advise to access simpler Radius instead, if it is defined (TODO: for now, some field types do not have a simpler counterpart).

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 52).

This item has no description.

Source: scene/x3d/auto_generated_node_helpers/x3dnodes_x3dpositionallightnode.inc (line 54).