Unigine::LightProj Class

#include <UnigineLights.h>
using namespace Unigine;

/* .. */

// creating a projected light source and setting its color to white, attenuation distance to 10 units and FOV angle to 60 degrees
LightProjPtr projector = LightProj::create(Math::vec4(1.0f, 1.0f, 0.5f, 1.0f), 10.0f, 60.0f, "");

// setting position of the light source
projector->setWorldPosition(Math::Vec3(2.5f, 2.5f, 3.0f));

// setting the name of the light source
projector->setName("projector");

// setting rotation of the light source
projector->setNodeRotation(Math::quat(-45.0f, 45.0f, 0.0f));

// setting penumbra factor
projector->setPenumbra(0.425f);

// setting a texture named "mytexture.tga" for light modulation
projector->setTextureFilePath("mytexture.tga");

// setting light intensity
projector->setIntensity(1.0f);

LightProj Class

Members

void setTexture ( const const Ptr<Texture> && texture ) #

Arguments

• const const Ptr<Texture> && texture - The texture smart pointer.

const Ptr<Texture> & getTexture() const#

Return value

Current texture smart pointer.

void setTextureFilePath ( const char * path ) #

Arguments

• const char * path - The cubemap texture file path.

const char * getTextureFilePath() const#

Return value

Current cubemap texture file path.

void setPenumbra ( float penumbra ) #

Arguments

• float penumbra - The intensity of the shadow.

float getPenumbra() const#

Return value

Current intensity of the shadow.

void setFov ( float fov ) #

Arguments

• float fov - The field of view in degrees. The set value is saturated in range [1; 180].

float getFov() const#

Return value

Current field of view in degrees. The set value is saturated in range [1; 180].

void setShapeHeight ( float height ) #

Arguments

• float height - The height of the light source shape.

float getShapeHeight() const#

Return value

Current height of the light source shape.

void setShapeLength ( float length ) #

Arguments

• float length - The length of the light source shape.

float getShapeLength() const#

Return value

Current length of the light source shape.

void setShapeRadius ( float radius ) #

Arguments

• float radius - The radius of the light source shape.

float getShapeRadius() const#

Return value

Current radius of the light source shape.

void setShapeType ( Light::SHAPE type ) #

Arguments

• Light::SHAPE type - The shape of the light source (one of the SHAPE_* variables).

Light::SHAPE getShapeType() const#

Return value

Current shape of the light source (one of the SHAPE_* variables).

void setAttenuationDistance ( float distance ) #

Arguments

• float distance - The distance from the light source shape, at which the light source doesn't illuminate anything.

float getAttenuationDistance() const#

Return value

Current distance from the light source shape, at which the light source doesn't illuminate anything.

Math::mat4 getProjection() const#

Return value

Current projection matrix.

Math::vec2 getShadowDepthRange() const#

Return value

Current shadow depth range for the light source as a two-component vector (min, max).

void setIESRelativeToFov ( bool fov ) #

Arguments

• bool fov - Set true to enable scaling of IES texture; false - to disable it.

bool isIESRelativeToFov() const#

Return value

true if scaling of IES texture is enabled; otherwise false.

Math::mat4 getShadowProjection() const#

Return value

Current shadow projection matrix.

void setShadowNearClippingDistance ( float distance ) #

Arguments

• float distance - The distance from the light source shape, within which the object doesn't cast shadow under this light source.

float getShadowNearClippingDistance() const#

Return value

Current distance from the light source shape, within which the object doesn't cast shadow under this light source.

void setNearAttenuationGradientLength ( float length ) #

Arguments

• float length - The length of the gradient area smoothering the attenuation border near the light source.

float getNearAttenuationGradientLength() const#

Return value

Current length of the gradient area smoothering the attenuation border near the light source.

void setNearAttenuationDistance ( float distance ) #

Arguments

• float distance - The distance from the light source shape, within which the light source doesn't illuminate anything.

float getNearAttenuationDistance() const#

Return value

Current distance from the light source shape, within which the light source doesn't illuminate anything.

---

static LightProjPtr create ( const Math::vec4 & color, float attenuation_distance, float fov, const char * name = 0 ) #

Constructor. Creates a new projected light source with texture modulation based on given parameters.

Arguments

• const Math::vec4 & color - Color of the new light source.
• float attenuation_distance - Distance from the light source shape, at which the light source doesn't illuminate anything.
• float fov - Field of view of the new light source.
• const char * name - Path to a texture of the new light source.

int setTextureImage ( const Ptr<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

• const Ptr<Image> & image - Image.
• 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 ( const Ptr<Image> & image ) const#

Reads the light image texture into an Image instance.

Arguments

• const Ptr<Image> & image - Image, into which the texture is read.

Return value

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

static int type ( ) #

Returns the type of the node.

Return value

Light type identifier.