LightOmni Class

LightOmni Class

Properties

Texture Texture#

string TexturePath#

Light.SHAPE ShapeType#

float ShapeHeight#

float ShapeLength#

float ShapeRadius#

float AttenuationDistance#

Members

---

static LightOmni ( vec4 color, float attenuation_distance, string name = 0 ) #

Constructor. Creates a new omni light source with the given parameters.

Arguments

• vec4 color - Color of the new light source.
• float attenuation_distance - Attenuation distance
• string name - Name of the source.

int SetTextureImage ( Image image, bool dynamic = 0 ) #

Sets a given Image instance as the light image texture. If you need to set a texture of all the lights in the scene, set dynamic flag to 1.

Arguments

• Image image - New texture to set.
• bool dynamic - Dynamic texture flag.
  • If set to 0, changing a texture of the light instance will also affect all the lights in the scene.
  • If set to 1, an image will be successfully set only for the current light instance.

Return value

Returns 1 if the texture is set successfully; otherwise, 0.

int GetTextureImage ( Image image ) #

Reads the light image texture into an Image instance.

Arguments

• Image image - Image, into which the texture is read.

Return value

Returns 1 if the texture is read successfully; otherwise, 0.

void SetShadowSideEnabled ( int side, int enable ) #

Enables or disables shadows for the specified side of the omni light source's cube map. By default the light source casts shadows in all directions.

Arguments

• int side - Number of the side of the omni light source for which shadows are to be enabled or disabled. One of the following values:
  • 0 - positive X
  • 1 - negative X
  • 2 - positive Y
  • 3 - negative Y
  • 4 - positive Z
  • 5 - negative Z
• int enable - 1 to enable shadows for the specified side of the omni light source, 0 - to disable.

int IsShadowSideEnabled ( int side ) #

Returns a value indicating if shadows are to be cast for the specified side of the omni light source. By default the light source casts shadows in all directions.

Arguments

• int side - Number of the side of the omni light source for which shadows are to be enabled or disabled. One of the following values:
  • 0 - positive X
  • 1 - negative X
  • 2 - positive Y
  • 3 - negative Y
  • 4 - positive Z
  • 5 - negative Z

Return value

1 if shadows are to be cast for the specified side of the omni light source; otherwise, 0.

vec3 GetSize ( ) #

Returns the size of the area illuminated by the light source. Depending on the shape type, the size varies:

• If the light is point-shaped, each component of the vector will be equal to the attenuation distance:
  Source code (C++)

  vec3(attenuation_distance)

• If the light is spherical, each component of the vector will be equal to the attenuation distance + sphere radius:
  Source code (C++)

  vec3(attenuation_distance + sphere_radius)

• If the light is capsule-shaped, the 1st component of the vector will be equal to attenuation distance + capsule length:
  Source code (C++)

  vec3(attenuation_distance + capsule_length,attenuation_distance,attenuation_distance)

• If the light is rectangular, the 2nd component of the vector will be equal to attenuation distance + rectangle height:
  Source code (C++)

  vec3(attenuation_distance,attenuation_distance + rectangle_height,attenuation_distance)

Return value

A size of the illuminated area.

static int type ( ) #

Returns the type of the node.

Return value

Light type identifier.