SLLightDirect class for a directional light source. More...

#include <SLLightDirect.h>

Inheritance diagram for SLLightDirect:

Public Member Functions
	SLLightDirect (SLAssetManager assetMgr, SLScene s, SLfloat arrowLength=0.5f, SLbool hasMesh=true, SLbool doCascadedShadows=false)
	Construct a new SLLightDirect::SLLightDirect object. More...

	SLLightDirect (SLAssetManager assetMgr, SLScene s, SLfloat posx, SLfloat posy, SLfloat posz, SLfloat arrowLength=0.5f, SLfloat ambiPower=1.0f, SLfloat diffPower=10.0f, SLfloat specPower=10.0f, SLbool hasMesh=true, SLbool doCascadedShadows=false)
	Construct a new SLLightDirect::SLLightDirect object. More...

	~SLLightDirect () override

void	init (SLScene *s)

bool	hitRec (SLRay *ray) override

void	statsRec (SLNodeStats &stats) override
	SLLightDirect::statsRec updates the statistic parameters. More...

void	drawMesh (SLSceneView *sv) override

SLfloat	shadowTest (SLRay ray, const SLVec3f &L, SLfloat lightDist, SLNode root3D) override

SLfloat	shadowTestMC (SLRay ray, const SLVec3f &L, SLfloat lightDist, SLNode root3D) override

void	createShadowMap (float clipNear=0.1f, float clipFar=20.0f, SLVec2f size=SLVec2f(8, 8), SLVec2i texSize=SLVec2i(1024, 1024)) override

void	createShadowMapAutoSize (SLCamera *camera, SLVec2i texSize=SLVec2i(1024, 1024), int numCascades=4) override

SLCol4f	calculateSunLight (SLfloat standardPower)
	Calculates the sunlight color depending on the zenith angle. More...

void	doSunPowerAdaptation (SLbool enabled)

void	sunLightPowerMin (SLfloat minPower)

void	doCascadedShadows (bool b)

SLfloat	radius () const

SLfloat	dirLength () const

SLbool	doSunPowerAdaptation ()

SLTexColorLUT *	sunLightColorLUT ()

SLbool	doCascadedShadows () const override

SLVec4f	positionWS () const override

SLVec3f	spotDirWS () override

SLCol4f	ambient () override
	Returns the product of the ambient light color and the ambient light power. More...

SLCol4f	diffuse () override
	Returns the product of the diffuse light color and the diffuse light power. More...

SLCol4f	specular () override
	Returns the product of the specular light color and the specular light power. More...

Public Member Functions inherited from SLNode
	SLNode (const SLstring &name="Node")
	Construct a new SLNode::SLNode object. More...

	SLNode (SLMesh *mesh, const SLstring &name="Node")

	SLNode (SLMesh *mesh, const SLVec3f &translation, const SLstring &name)

	~SLNode () override

virtual void	cull3DRec (SLSceneView *sv)

virtual void	cullChildren3D (SLSceneView *sv)
	Initializer function to call SLNode::cull3DRec recursively. More...

virtual void	cull2DRec (SLSceneView *sv)

virtual SLNode *	copyRec ()

virtual SLAABBox &	updateAABBRec (SLbool updateAlsoAABBinOS)

virtual void	dumpRec ()

void	setDrawBitsRec (SLuint bit, SLbool state)

void	setPrimitiveTypeRec (SLGLPrimitiveType primitiveType)

virtual void	addMesh (SLMesh *mesh)

bool	removeMesh ()
	Returns true if a mesh was assigned and set it to nullptr. More...

bool	removeMesh (SLMesh *mesh)
	Returns true if the passed mesh was assigned and sets it to nullptr. More...

SLint	numChildren ()

void	addChild (SLNode *child)

bool	insertChild (SLNode insertC, SLNode afterC)

void	deleteChildren ()

bool	deleteChild ()

bool	deleteChild (SLNode *child)

bool	deleteChild (const SLstring &name)

bool	removeChild (SLNode *child)
	remove child from vector of children. Removes false if not found, else true. More...

template<typename T >
T *	find (const SLstring &name="", SLbool findRecursive=true)

template<typename T >
T *	findChild (const SLstring &name="", SLbool findRecursive=true)

template<typename T >
deque< T * >	findChildren (const SLstring &name="", SLbool findRecursive=true, SLbool canContain=false)

deque< SLNode * >	findChildren (const SLMesh *mesh, SLbool findRecursive=true)

deque< SLNode * >	findChildren (SLuint drawbit, SLbool findRecursive=true)

SLVec3f	translationOS () const

SLVec3f	forwardOS () const

SLVec3f	rightOS () const

SLVec3f	upOS () const

SLVec3f	axisXOS () const

SLVec3f	axisYOS () const

SLVec3f	axisZOS () const

SLVec3f	translationWS () const

SLVec3f	forwardWS () const

SLVec3f	rightWS () const

SLVec3f	upWS () const

SLVec3f	axisXWS () const

SLVec3f	axisYWS () const

SLVec3f	axisZWS () const

void	translation (const SLVec3f &pos, SLTransformSpace relativeTo=TS_parent)

void	translation (SLfloat x, SLfloat y, SLfloat z, SLTransformSpace relativeTo=TS_parent)

void	rotation (const SLQuat4f &rot, SLTransformSpace relativeTo=TS_parent)

void	rotation (SLfloat angleDeg, const SLVec3f &axis, SLTransformSpace relativeTo=TS_parent)

void	scaling (SLfloat s)

void	scaling (SLfloat x, SLfloat y, SLfloat z)

void	scaling (const SLVec3f &scaling)

void	lookAt (SLfloat targetX, SLfloat targetY, SLfloat targetZ, SLfloat upX=0, SLfloat upY=1, SLfloat upZ=0, SLTransformSpace relativeTo=TS_world)

void	lookAt (const SLVec3f &target, const SLVec3f &up=SLVec3f::AXISY, SLTransformSpace relativeTo=TS_world)

void	translate (const SLVec3f &vec, SLTransformSpace relativeTo=TS_object)

void	translate (SLfloat x, SLfloat y, SLfloat z, SLTransformSpace relativeTo=TS_object)

void	rotate (const SLQuat4f &rot, SLTransformSpace relativeTo=TS_object)

void	rotate (SLfloat angleDeg, const SLVec3f &axis, SLTransformSpace relativeTo=TS_object)

void	rotate (SLfloat angleDeg, SLfloat x, SLfloat y, SLfloat z, SLTransformSpace relativeTo=TS_object)

void	rotateAround (const SLVec3f &point, SLVec3f &axis, SLfloat angleDeg, SLTransformSpace relativeTo=TS_world)

void	scale (SLfloat s)

void	scale (SLfloat x, SLfloat y, SLfloat z)

void	scale (const SLVec3f &scale)

void	scaleToCenter (SLfloat maxDim)

void	setInitialState ()

void	resetToInitialState ()

void	parent (SLNode *p)

void	entityID (SLint entityID)

void	om (const SLMat4f &mat)

void	animation (SLAnimation *a)

void	castsShadows (SLbool castsShadows)

virtual void	needUpdate ()

void	needWMUpdate ()

void	needAABBUpdate ()

void	isSelected (bool isSelected)

void	minLodCoverage (SLfloat minLodCoverage)

void	levelForSM (SLubyte lfsm)

void	onUpdateCB (function< void()> callbackFunc)

SLNode *	parent ()

SLint	depth () const

SLint	entityID () const

const SLMat4f &	om ()

const SLMat4f &	initialOM ()

const SLMat4f &	updateAndGetWM () const

const SLMat4f &	updateAndGetWMI () const

SLDrawBits *	drawBits ()

SLbool	drawBit (SLuint bit)

SLAABBox *	aabb ()

SLAnimation *	animation ()

SLbool	castsShadows ()

SLMesh *	mesh ()

SLVNode &	children ()

const SLAnimSkeleton *	skeleton ()
	Returns the first skeleton found in the meshes. More...

void	updateRec ()

virtual void	doUpdate ()

bool	updateMeshSkins (bool forceCPUSkinning, const std::function< void(SLMesh *)> &cbInformNodes)
	Update all skinned meshes recursively. More...

void	updateMeshAccelStructs ()

void	updateMeshMat (std::function< void(SLMaterial *m)> setMat, bool recursive)
	Updates the mesh material recursively with a material lambda. More...

void	setMeshMat (SLMaterial *mat, bool recursive)
	Set the mesh material recursively. More...

bool	isSelected ()

SLfloat	minLodCoverage ()

SLubyte	levelForSM ()

Public Member Functions inherited from SLObject
	SLObject (const SLstring &Name="", const SLstring &url="")

virtual	~SLObject ()

void	name (const SLstring &Name)

void	url (const SLstring &url)

const SLstring &	name () const

const SLstring &	url () const

Public Member Functions inherited from SLEventHandler
	SLEventHandler ()

virtual	~SLEventHandler ()

virtual SLbool	onMouseDown (const SLMouseButton button, const SLint x, const SLint y, const SLKey mod)

virtual SLbool	onMouseUp (const SLMouseButton button, const SLint x, const SLint y, const SLKey mod)

virtual SLbool	onMouseMove (const SLMouseButton button, const SLint x, const SLint y, const SLKey mod)

virtual SLbool	onDoubleClick (const SLMouseButton button, const SLint x, const SLint y, const SLKey mod)

virtual SLbool	onMouseWheel (const SLint delta, const SLKey mod)

virtual SLbool	onTouch2Down (const SLint x1, const SLint y1, const SLint x2, const SLint y2)

virtual SLbool	onTouch2Move (const SLint x1, const SLint y1, const SLint x2, const SLint y2)

virtual SLbool	onTouch2Up (const SLint x1, const SLint y1, const SLint x2, const SLint y2)

virtual SLbool	onTouch3Down (const SLint x1, const SLint y1)

virtual SLbool	onTouch3Move (const SLint x1, const SLint y1)

virtual SLbool	onTouch3Up (const SLint x1, const SLint y1)

virtual SLbool	onKeyPress (const SLKey key, const SLKey mod)

virtual SLbool	onKeyRelease (const SLKey key, const SLKey mod)

virtual SLbool	onRotationPYR (const SLfloat pitchRAD, const SLfloat yawRAD, const SLfloat rollRAD)

void	mouseRotationFactor (SLfloat rf)

SLfloat	mouseRotationFactor ()

Public Member Functions inherited from SLLight
	SLLight (SLfloat ambiPower=0.1f, SLfloat diffPower=1.0f, SLfloat specPower=1.0f, SLint id=-1)
	Construct a new SLLight::SLLight object. More...

virtual	~SLLight ()=default

void	id (const SLint id)

void	isOn (const SLbool on)

void	powers (SLfloat ambiPow, SLfloat diffPow, SLfloat specPow, const SLCol4f &ambiDiffSpecCol=SLCol4f::WHITE)
	Sets the ambient, diffuse and specular powers all with the same color. More...

void	ambiDiffPowers (SLfloat ambiPow, SLfloat diffPow, const SLCol4f &ambiDiffCol=SLCol4f::WHITE)
	Sets the ambient and diffuse powers with the same color. More...

void	ambiDiffColor (const SLCol4f &ambiDiffCol)
	Sets the same color to the ambient and diffuse colors. More...

void	ambientColor (const SLCol4f &ambi)

void	ambientPower (const SLfloat ambPow)

void	diffuseColor (const SLCol4f &diff)

void	diffusePower (const SLfloat diffPow)

void	specularColor (const SLCol4f &spec)

void	specularPower (const SLfloat specPow)

void	spotExponent (const SLfloat exp)

void	spotCutOffDEG (SLfloat cutOffAngleDEG)

void	kc (SLfloat kc)

void	kl (SLfloat kl)

void	kq (SLfloat kq)

void	attenuation (const SLfloat kConstant, const SLfloat kLinear, const SLfloat kQuadratic)

void	createsShadows (SLbool createsShadows)

void	shadowMap (SLShadowMap *shadowMap)

void	doSmoothShadows (SLbool doSS)

void	smoothShadowLevel (SLuint ssLevel)

void	shadowMinBias (SLfloat minBias)

void	shadowMaxBias (SLfloat maxBias)

SLint	id () const

SLbool	isOn () const

SLCol4f	ambientColor ()

SLfloat	ambientPower () const

SLCol4f	diffuseColor ()

SLfloat	diffusePower () const

SLCol4f	specularColor ()

SLfloat	specularPower () const

SLfloat	spotCutOffDEG () const

SLfloat	spotCosCut () const

SLfloat	spotExponent () const

SLfloat	kc () const

SLfloat	kl () const

SLfloat	kq () const

SLbool	isAttenuated () const

SLfloat	attenuation (SLfloat dist) const

SLbool	createsShadows () const

SLShadowMap *	shadowMap ()

SLbool	doSoftShadows () const

SLuint	softShadowLevel () const

SLfloat	shadowMinBias () const

SLfloat	shadowMaxBias () const

Protected Member Functions
void	renderShadowMap (SLSceneView sv, SLNode root) override
	SLLight::renderShadowMap renders the shadow map of the light. More...

Private Attributes
SLfloat	_arrowRadius
	The sphere lights radius. More...

SLfloat	_arrowLength
	Length of direction line. More...

SLbool	_doSunPowerAdaptation
	Flag for sun power scaling. More...

SLfloat	_sunLightPowerMin
	Min. zenith power scale factor for sun. More...

SLTexColorLUT	_sunLightColorLUT
	Sun light color LUT. More...

bool	_doCascadedShadows
	Cascaded shadow. More...

Additional Inherited Members
Static Public Member Functions inherited from SLLight
static SLfloat	oneOverGamma ()

Static Public Attributes inherited from SLNode
static SLuint	numWMUpdates = 0
	NO. of calls to updateWMRec per frame. More...

static unsigned int	instanceIndex = 0
	??? More...

Static Public Attributes inherited from SLLight
static SLCol4f	globalAmbient = SLCol4f(0.1f, 0.1f, 0.1f, 1.0f)
	static global ambient light intensity More...

static SLfloat	gamma = 1.0f
	final output gamma value More...

static SLbool	doColoredShadows = false
	flag if shadows should be displayed with colors for debugging More...

Protected Attributes inherited from SLNode
SLNode *	_parent
	pointer to the parent node More...

SLVNode	_children
	vector of children nodes More...

SLMesh *	_mesh
	pointer to a single mesh More...

SLint	_depth
	depth of the node in a scene tree More...

SLint	_entityID
	ID in the SLVEntity graph for Data Oriented Design. More...

SLMat4f	_om
	object matrix for local transforms More...

SLMat4f	_initialOM
	the initial om state More...

SLMat4f	_wm
	world matrix for world transform More...

SLMat4f	_wmI
	inverse world matrix More...

SLbool	_isWMUpToDate
	is the WM of this node still valid More...

SLbool	_isWMIUpToDate
	is the inverse WM of this node still valid More...

SLbool	_isAABBUpToDate
	is the saved aabb still valid More...

bool	_castsShadows
	flag if meshes of node should cast shadows More...

bool	_isSelected
	flag if node and one or more of its meshes are selected More...

SLDrawBits	_drawBits
	node level drawing flags More...

SLAABBox	_aabb
	axis aligned bounding box More...

SLAnimation *	_animation
	animation of the node More...

SLfloat	_minLodCoverage
	Min. LOD coverage for visibility (0.0 < _minLodCoverage < 1.0) More...

SLubyte	_levelForSM
	Level of LOD to use for shadow mapping (0 = the visible one will be drawn) More...

function< void()>	_onUpdateCB
	Optional lambda callback once per update. More...

Protected Attributes inherited from SLObject
SLstring	_name
	name of an object More...

SLstring	_url
	uniform resource locator More...

Protected Attributes inherited from SLEventHandler
SLfloat	_mouseRotationFactor
	Mouse rotation sensibility. More...

SLfloat	_keyboardDeltaPos
	Delta dist. for keyboard translation. More...

Protected Attributes inherited from SLLight
SLint	_id
	OpenGL light number (0-7) More...

SLbool	_isOn
	Flag if light is on or off. More...

SLCol4f	_ambientColor
	Ambient light color (RGB 0-1) More...

SLfloat	_ambientPower
	Ambient light power (0-N) More...

SLCol4f	_diffuseColor
	Diffuse light color (RGB 0-1) More...

SLfloat	_diffusePower
	Diffuse light power (0-N) More...

SLCol4f	_specularColor
	Specular light color (RGB 0-1) More...

SLfloat	_specularPower
	Specular light power (0-N) More...

SLfloat	_spotCutOffDEG
	Half the spot cone angle. More...

SLfloat	_spotCosCutOffRAD
	cosine of spotCutoff angle More...

SLfloat	_spotExponent
	Spot attenuation from center to edge of cone. More...

SLfloat	_kc
	Constant light attenuation. More...

SLfloat	_kl
	Linear light attenuation. More...

SLfloat	_kq
	Quadratic light attenuation. More...

SLbool	_isAttenuated
	fast attenuation flag for ray tracing More...

SLbool	_createsShadows
	flag if light creates shadows or not More...

SLShadowMap *	_shadowMap
	Used for shadow mapping. More...

SLbool	_doSoftShadows
	flag if percentage-closer filtering for smooth shadows is enabled More...

SLuint	_softShadowLevel
	Radius to smoothing (1 = 3 * 3; 2 = 5 * 5; ...) More...

SLfloat	_shadowMinBias
	Min. bias at 0 deg. to use to prevent shadow acne. More...

SLfloat	_shadowMaxBias
	Max. bias at 90 deg. to use to prevent shadow acne. More...

Detailed Description

SLLightDirect class for a directional light source.

SLLightDirect is a node and a light that can have a sphere mesh with a line for its direction representation. For directional lights the position vector is in infinite distance. We use its homogeneous component w as zero as the directional light flag. The spot direction is used in the shaders for the light direction.
If a light node is added to the scene it stays fix in the scene.
If a light node is added to the camera it moves with the camera.
See the scene examples for Per-Vertex-Blinn or Per-Pixel-Blinn lighting where all light node types are used.
All light nodes inherited from SLLight work automatically together with the automatically generated shader in SLGLProgramGenerated.

Definition at line 37 of file SLLightDirect.h.

Constructor & Destructor Documentation

◆ SLLightDirect() [1/2]

SLLightDirect::SLLightDirect	(	SLAssetManager *	assetMgr,
		SLScene *	s,
		SLfloat	arrowLength = `0.5f`,
		SLbool	hasMesh = `true`,
		SLbool	doCascadedShadows = `false`
	)

Construct a new SLLightDirect::SLLightDirect object.

It is important that during instantiation NO OpenGL functions (gl*) get called because this constructor will be most probably called in a parallel thread from within a SLScene::assemble function. All objects that get rendered have to do their OpenGL initialization when they are used the first time during rendering in the main thread.

Parameters

assetMgr	AssetManager that will own the light mesh
s	SLScene pointer
arrowLength	Length of the arrow visualization mesh
hasMesh	Boolean if a mesh should be created and shown
doCascadedShadows	Boolean for doing cascaded shadow mapping

Definition at line 33 of file SLLightDirect.cpp.

   : SLNode("LightDirect Node"),
     _arrowRadius(arrowLength * 0.1f),
     _arrowLength(arrowLength),
     _doSunPowerAdaptation(false),
     _sunLightPowerMin(0),
     _sunLightColorLUT(nullptr, CLUT_DAYLIGHT),
     _doCascadedShadows(doCascadedShadows)
 {
     if (hasMesh)
     {
         SLMaterial* mat = new SLMaterial(assetMgr,
                                          "LightDirect Mesh Mat",
                                          SLCol4f::BLACK,
                                          SLCol4f::BLACK);
         addMesh(new SLArrow(assetMgr,
                             _arrowRadius,
                             _arrowLength,
                             _arrowLength * 0.3f,
                             _arrowRadius * 2.0f,
                             16,
                             "LightDirect Mesh",
                             mat));
         _castsShadows = false;
     }
  
     init(s);
 }

◆ SLLightDirect() [2/2]

SLLightDirect::SLLightDirect	(	SLAssetManager *	assetMgr,
		SLScene *	s,
		SLfloat	posx,
		SLfloat	posy,
		SLfloat	posz,
		SLfloat	arrowLength = `0.5f`,
		SLfloat	ambiPower = `1.0f`,
		SLfloat	diffPower = `10.0f`,
		SLfloat	specPower = `10.0f`,
		SLbool	hasMesh = `true`,
		SLbool	doCascadedShadows = `false`
	)

Construct a new SLLightDirect::SLLightDirect object.

Remarks: It is important that during instantiation NO OpenGL functions (gl*) get called because this constructor will be most probably called in a parallel thread from within an SLScene::registerAssetsToLoad or SLScene::assemble function. All objects that get rendered have to do their OpenGL initialization when they are used the first time during rendering in the main thread.

Parameters

assetMgr	AssetManager that will own the light mesh
s	SLScene pointer
posx	Light position x
posy	Light position y
posz	Light position z
arrowLength	Length of the arrow visualization mesh
ambiPower	Ambient light power
diffPower	Diffuse light power
specPower	Specular light power
hasMesh	Boolean if a mesh should be created and shown
doCascadedShadows	Boolean for doing cascaded shadow mapping

Definition at line 86 of file SLLightDirect.cpp.

   : SLNode("Directional Light"),
     SLLight(ambiPower, diffPower, specPower),
     _arrowRadius(arrowLength * 0.1f),
     _arrowLength(arrowLength),
     _doSunPowerAdaptation(false),
     _sunLightPowerMin(0),
     _sunLightColorLUT(nullptr, CLUT_DAYLIGHT),
     _doCascadedShadows(doCascadedShadows)
 {
     translate(posx, posy, posz, TS_object);
  
     if (hasMesh)
     {
         SLMaterial* mat = new SLMaterial(assetMgr,
                                          "LightDirect Mesh Mat",
                                          SLCol4f::BLACK,
                                          SLCol4f::BLACK);
         addMesh(new SLArrow(assetMgr,
                             _arrowRadius,
                             _arrowLength,
                             _arrowLength * 0.3f,
                             _arrowRadius * 2.0f,
                             16,
                             "LightDirect Mesh",
                             mat));
     }
     init(s);
 }

◆ ~SLLightDirect()

SLLightDirect::~SLLightDirect ( )

override

Definition at line 126 of file SLLightDirect.cpp.

 {
     delete _shadowMap;
  
     // Clear the color LUT that is also an OpenGL texture
     _sunLightColorLUT.deleteData(true);
 }

Member Function Documentation

◆ ambient()

SLCol4f SLLightDirect::ambient ( )

overridevirtual

Returns the product of the ambient light color and the ambient light power.

Implements SLLight.

Definition at line 324 of file SLLightDirect.cpp.

 {
     return _ambientColor * _ambientPower;
 }

◆ calculateSunLight()

SLCol4f SLLightDirect::calculateSunLight ( SLfloat standardPower )

Calculates the sunlight color depending on the zenith angle.

If the angle is 0 it return 1 and _sunLightPowerMin at 90 degrees or more. This can be used to the downscale the directional light to simulate the reduced power of the sun. The color is take from a color ramp that is white at 0 degree zenith angle.

Definition at line 309 of file SLLightDirect.cpp.

 {
     SLVec3f toSunDirWS = -forwardOS();
  
     // The sun power is equal to the cosine of the sun zenith angle
     SLfloat cosZenithAngle = std::max(toSunDirWS.dot(SLVec3f::AXISY),
                                       _sunLightPowerMin);
  
     // The color is take from a color ramp that is white at 0 degree zenith
     SLCol4f sunColor = _sunLightColorLUT.getTexelf(cosZenithAngle, 0);
  
     return sunColor * standardPower * cosZenithAngle;
 }

◆ createShadowMap()

void SLLightDirect::createShadowMap	(	float	clipNear = `0.1f`,
		float	clipFar = `20.0f`,
		SLVec2f	size = `SLVec2f(8, 8)`,
		SLVec2i	texSize = `SLVec2i(1024, 1024)`
	)

overridevirtual

Creates an fixed sized standard shadow map for a directional light.

Parameters

clipNear	The light frustums near clipping distance
clipFar	The light frustums near clipping distance
size	Width and height of the orthographic light frustum
texSize	Shadow texture map size

Implements SLLight.

Definition at line 212 of file SLLightDirect.cpp.

 {
     if (!_shadowMap)
         delete _shadowMap;
  
     _shadowMap = new SLShadowMap(this,
                                  clipNear,
                                  clipFar,
                                  size,
                                  texSize);
 }

◆ createShadowMapAutoSize()

void SLLightDirect::createShadowMapAutoSize	(	SLCamera *	camera,
		SLVec2i	texSize = `SLVec2i(1024, 1024)`,
		int	numCascades = `4`
	)

overridevirtual

Creates an automatic sized and cascaded shadow map for the directional light.

Parameters

camera	Pointer to the camera for witch the shadow map gets sized
texSize	Shadow texture map size (equal for all cascades)
numCascades	NO. of cascades shadow maps

Implements SLLight.

Definition at line 232 of file SLLightDirect.cpp.

 {
     if (!_shadowMap)
         delete _shadowMap;
  
     _doCascadedShadows = true;
     _shadowMap         = new SLShadowMap(this,
                                  camera,
                                  texSize,
                                  numCascades);
 }

◆ diffuse()

SLCol4f SLLightDirect::diffuse ( )

overridevirtual

Returns the product of the diffuse light color and the diffuse light power.

If the directional light is the sun the color and the power is depending from the zenith angle of the sun. At noon it is high and bright and at sunrise and sunset it is low and reddish.

Implements SLLight.

Definition at line 334 of file SLLightDirect.cpp.

 {
     if (_doSunPowerAdaptation)
         return calculateSunLight(_diffusePower);
     else
         return _diffuseColor * _diffusePower;
 }

◆ dirLength()

SLfloat SLLightDirect::dirLength ( ) const

inline

Definition at line 88 of file SLLightDirect.h.

88 { return _arrowLength; }

◆ doCascadedShadows() [1/2]

SLbool SLLightDirect::doCascadedShadows ( ) const

inlineoverridevirtual

Reimplemented from SLLight.

Definition at line 91 of file SLLightDirect.h.

91 { return _doCascadedShadows; }

◆ doCascadedShadows() [2/2]

void SLLightDirect::doCascadedShadows ( bool b )

inline

Definition at line 84 of file SLLightDirect.h.

84 { _doCascadedShadows = b; }

◆ doSunPowerAdaptation() [1/2]

SLbool SLLightDirect::doSunPowerAdaptation ( )

inline

Definition at line 89 of file SLLightDirect.h.

89 { return _doSunPowerAdaptation; }

◆ doSunPowerAdaptation() [2/2]

void SLLightDirect::doSunPowerAdaptation ( SLbool enabled )

inline

Definition at line 82 of file SLLightDirect.h.

82 { _doSunPowerAdaptation = enabled; }

◆ drawMesh()

void SLLightDirect::drawMesh ( SLSceneView * sv )

overridevirtual

SLLightDirect::drawMeshes sets the light states and calls then the drawMeshes method of its node.

Reimplemented from SLNode.

Definition at line 184 of file SLLightDirect.cpp.

 {
     if (_id != -1)
     {
         // Set emissive light material to the lights diffuse color
         if (_mesh)
             if (_mesh->mat())
                 _mesh->mat()->emissive(_isOn ? diffuse() : SLCol4f::BLACK);
  
         // now draw the meshes of the node
         SLNode::drawMesh(sv);
  
         // Draw the volume affected by the shadow map
         if (_createsShadows && _isOn && sv->s()->singleNodeSelected() == this)
         {
             if (sv->camera() != _shadowMap->camera())
                 _shadowMap->drawFrustum();
             _shadowMap->drawRays();
         }
     }
 }

◆ hitRec()

SLbool SLLightDirect::hitRec ( SLRay * ray )

overridevirtual

SLLightDirect::hitRec calls the recursive node intersection.

Reimplemented from SLNode.

Definition at line 160 of file SLLightDirect.cpp.

 {
     // do not intersect shadow rays
     if (ray->type == SHADOW) return false;
  
     // only allow intersection with primary rays (no lights in reflections)
     if (ray->type != PRIMARY) return false;
  
     // call the intersection routine of the node
     return SLNode::hitRec(ray);
 }

◆ init()

void SLLightDirect::init ( SLScene * s )

SLLightDirect::init sets the light id, the light states & creates an emissive material.

Definition at line 138 of file SLLightDirect.cpp.

 {
     // Check if OpenGL lights are available
     if (s->lights().size() >= SL_MAX_LIGHTS)
         SL_EXIT_MSG("Max. NO. of lights is exceeded!");
  
     // Add the light to the lights array of the scene
     if (_id == -1)
     {
         _id = (SLint)s->lights().size();
         s->lights().push_back(this);
     }
  
     // Set emissive light material to the lights diffuse color
     if (_mesh)
         if (_mesh->mat())
             _mesh->mat()->emissive(_isOn ? diffuseColor() : SLCol4f::BLACK);
 }

◆ positionWS()

SLVec4f SLLightDirect::positionWS ( ) const

inlineoverridevirtual

Implements SLLight.

Definition at line 95 of file SLLightDirect.h.

     {
         SLVec4f pos(updateAndGetWM().translation());
         pos.w = 0.0f;
         return pos;
     }

◆ radius()

SLfloat SLLightDirect::radius ( ) const

inline

Definition at line 87 of file SLLightDirect.h.

87 { return _arrowRadius; }

◆ renderShadowMap()

void SLLightDirect::renderShadowMap	(	SLSceneView *	sv,
		SLNode *	root
	)

overrideprotectedvirtual

SLLight::renderShadowMap renders the shadow map of the light.

Reimplemented from SLLight.

Definition at line 355 of file SLLightDirect.cpp.

 {
     // Check if no shadow map was created at load time
     if (!_shadowMap)
     {
         this->createShadowMap();
     }
     _shadowMap->renderShadows(sv, root);
 }

◆ shadowTest()

SLfloat SLLightDirect::shadowTest	(	SLRay *	ray,
		const SLVec3f &	L,
		SLfloat	lightDist,
		SLNode *	root3D
	)

overridevirtual

SLLightDirect::shadowTest returns 0.0 if the hit point is completely shaded and 1.0 if it is 100% lighted. A directional light can not generate soft shadows.

Implements SLLight.

Definition at line 249 of file SLLightDirect.cpp.

 {
     // define shadow ray and shoot
     SLRay shadowRay(lightDist, L, ray);
     root3D->hitRec(&shadowRay);
  
     if (shadowRay.length < lightDist)
     {
         // Handle shadow value of transparent materials
         if (shadowRay.hitMesh->mat()->hasAlpha())
         {
             shadowRay.hitMesh->preShade(&shadowRay);
             SLfloat shadowTransp = Utils::abs(shadowRay.dir.dot(shadowRay.hitNormal));
             return shadowTransp * shadowRay.hitMesh->mat()->kt();
         }
         else
             return 0.0f;
     }
     else
         return 1.0f;
 }

◆ shadowTestMC()

SLfloat SLLightDirect::shadowTestMC	(	SLRay *	ray,
		const SLVec3f &	L,
		SLfloat	lightDist,
		SLNode *	root3D
	)

overridevirtual

SLLightDirect::shadowTestMC returns 0.0 if the hit point is completely shaded and 1.0 if it is 100% lighted. A directional light can not generate soft shadows.

Implements SLLight.

Definition at line 278 of file SLLightDirect.cpp.

 {
     // define shadow ray and shoot
     SLRay shadowRay(lightDist, L, ray);
     root3D->hitRec(&shadowRay);
  
     if (shadowRay.length < lightDist)
     {
         // Handle shadow value of transparent materials
         if (shadowRay.hitMesh->mat()->hasAlpha())
         {
             shadowRay.hitMesh->preShade(&shadowRay);
             SLfloat shadowTransp = Utils::abs(shadowRay.dir.dot(shadowRay.hitNormal));
             return shadowTransp * shadowRay.hitMesh->mat()->kt();
         }
         else
             return 0.0f;
     }
     else
         return 1.0f;
 }

◆ specular()

SLCol4f SLLightDirect::specular ( )

overridevirtual

Returns the product of the specular light color and the specular light power.

If the directional light is the sun the color and the power is depending from the zenith angle of the sun. At noon it is high and bright and at sunrise and sunset it is low and reddish.

Implements SLLight.

Definition at line 347 of file SLLightDirect.cpp.

 {
     if (_doSunPowerAdaptation)
         return calculateSunLight(_specularPower);
     else
         return _specularColor * _specularPower;
 }

◆ spotDirWS()

SLVec3f SLLightDirect::spotDirWS ( )

inlineoverridevirtual

Implements SLLight.

Definition at line 101 of file SLLightDirect.h.

101 { return forwardOS(); }

◆ statsRec()

void SLLightDirect::statsRec ( SLNodeStats & stats )

overridevirtual

SLLightDirect::statsRec updates the statistic parameters.

Reimplemented from SLNode.

Definition at line 173 of file SLLightDirect.cpp.

 {
     stats.numBytes += sizeof(SLLightDirect);
     SLNode::statsRec(stats);
 }

◆ sunLightColorLUT()

SLTexColorLUT* SLLightDirect::sunLightColorLUT ( )

inline

Definition at line 90 of file SLLightDirect.h.

90 { return &_sunLightColorLUT; }

◆ sunLightPowerMin()

void SLLightDirect::sunLightPowerMin ( SLfloat minPower )

inline

Definition at line 83 of file SLLightDirect.h.

83 { _sunLightPowerMin = minPower; }

Member Data Documentation

◆ _arrowLength

SLfloat SLLightDirect::_arrowLength

private

Length of direction line.

Definition at line 111 of file SLLightDirect.h.

◆ _arrowRadius

SLfloat SLLightDirect::_arrowRadius

private

The sphere lights radius.

Definition at line 110 of file SLLightDirect.h.

◆ _doCascadedShadows

bool SLLightDirect::_doCascadedShadows

private

Cascaded shadow.

Definition at line 115 of file SLLightDirect.h.

◆ _doSunPowerAdaptation

SLbool SLLightDirect::_doSunPowerAdaptation

private

Flag for sun power scaling.

Definition at line 112 of file SLLightDirect.h.

◆ _sunLightColorLUT

SLTexColorLUT SLLightDirect::_sunLightColorLUT

private

Sun light color LUT.

Definition at line 114 of file SLLightDirect.h.

◆ _sunLightPowerMin

SLfloat SLLightDirect::_sunLightPowerMin

private

Min. zenith power scale factor for sun.

Definition at line 113 of file SLLightDirect.h.

The documentation for this class was generated from the following files:

Public Member Functions

Protected Member Functions

Private Attributes

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ SLLightDirect() [1/2]

◆ SLLightDirect() [2/2]

◆ ~SLLightDirect()

Member Function Documentation

◆ ambient()

◆ calculateSunLight()

◆ createShadowMap()

◆ createShadowMapAutoSize()

◆ diffuse()

◆ dirLength()

◆ doCascadedShadows() [1/2]

◆ doCascadedShadows() [2/2]

◆ doSunPowerAdaptation() [1/2]

◆ doSunPowerAdaptation() [2/2]

◆ drawMesh()

◆ hitRec()

◆ init()

◆ positionWS()

◆ radius()

◆ renderShadowMap()

◆ shadowTest()

◆ shadowTestMC()

◆ specular()

◆ spotDirWS()

◆ statsRec()

◆ sunLightColorLUT()

◆ sunLightPowerMin()

Member Data Documentation

◆ _arrowLength

◆ _arrowRadius

◆ _doCascadedShadows

◆ _doSunPowerAdaptation

◆ _sunLightColorLUT

◆ _sunLightPowerMin