com.jme3.shadow

Class PointLightShadowRenderer

java.lang.Object

com.jme3.shadow.AbstractShadowRenderer

com.jme3.shadow.PointLightShadowRenderer

All Implemented Interfaces:

Savable, SceneProcessor, JmeCloneable, java.lang.Cloneable

public class PointLightShadowRenderer
extends AbstractShadowRenderer

PointLightShadowRenderer renders shadows for a point light

Field Summary

Fields

Modifier and Type	Field and Description
static int	CAM_NUMBER
protected PointLight	light
protected Camera[]	shadowCams

Fields inherited from class com.jme3.shadow.AbstractShadowRenderer

assetManager, debug, dispPic, dummyTex, edgeFilteringMode, edgesThickness, fadeInfo, fadeLength, forcedRenderState, frustumCam, lightReceivers, lightViewProjectionsMatrices, logger, matCache, nbShadowMaps, needsfallBackMaterial, postshadowMat, postTechniqueName, preshadowMat, prof, renderBackFacesShadows, renderManager, shadowCompareMode, shadowFB, shadowIntensity, shadowMapOccluders, shadowMaps, shadowMapSize, skipPostPass, viewPort, zFarOverride

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	PointLightShadowRenderer() Used for serialization.
	PointLightShadowRenderer(AssetManager assetManager, int shadowMapSize) Creates a PointLightShadowRenderer

Method Summary

Modifier and Type	Method and Description
protected boolean	checkCulling(Camera viewCam)
protected void	clearMaterialParameters(Material material) This method is called once per frame and is responsible for clearing any material parameters that subclasses may need to clear on the post material.
void	cloneFields(Cloner cloner, java.lang.Object original) Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner.
protected void	doDisplayFrustumDebug(int shadowMapIndex) responsible for displaying the frustum of the shadow cam for debug purpose
PointLight	getLight() gets the point light used to cast shadows with this processor
protected GeometryList	getOccludersToRender(int shadowMapIndex, GeometryList shadowMapOccluders) Returns a subclass-specific geometryList containing the occluders to be rendered in the shadow map
protected void	getReceivers(GeometryList lightReceivers)
protected Camera	getShadowCam(int shadowMapIndex) return the shadow camera to use for rendering the shadow map according the given index
protected void	initFrustumCam() delegates the initialization of the frustum cam to child renderers
void	read(JmeImporter im) De-serialize this instance, for example when loading from a J3O file.
void	setLight(PointLight light) sets the light to use for casting shadows with this processor
protected void	setMaterialParameters(Material material) This method is called once per frame and is responsible for setting any material parameters that subclasses may need to set on the post material.
protected void	updateShadowCams(Camera viewCam) Invoked once per frame to update the shadow cams according to the light view.
void	write(JmeExporter ex) Serialize this instance, for example when saving to a J3O file.

Methods inherited from class com.jme3.shadow.AbstractShadowRenderer

cleanup, createFrustum, displayDebug, displayFrustum, displayShadowMap, getEdgeFilteringMode, getEdgesThickness, getNumShadowMaps, getPreShadowForcedRenderState, getShadowCompareMode, getShadowIntensity, getShadowMapSize, getShadowZExtend, getShadowZFadeLength, initForcedRenderState, initialize, isFlushQueues, isInitialized, isRenderBackFacesShadows, jmeClone, postFrame, postQueue, preFrame, renderShadowMap, reshape, setEdgeFilteringMode, setEdgesThickness, setFlushQueues, setPostShadowMaterial, setPostShadowParams, setProfiler, setRenderBackFacesShadows, setShadowCompareMode, setShadowIntensity, setShadowZExtend, setShadowZFadeLength

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

CAM_NUMBER

public static final int CAM_NUMBER

See Also:

Constant Field Values

light

protected PointLight light

shadowCams

protected Camera[] shadowCams

Constructor Detail

PointLightShadowRenderer

protected PointLightShadowRenderer()

Used for serialization. Use PointLightShadowRenderer#PointLightShadowRenderer(AssetManager assetManager, int shadowMapSize) instead.

PointLightShadowRenderer

public PointLightShadowRenderer(AssetManager assetManager,
                                int shadowMapSize)

Creates a PointLightShadowRenderer

Parameters:

assetManager - the application asset manager

shadowMapSize - the size of the rendered shadowmaps (512,1024,2048, etc...)

Method Detail

initFrustumCam

protected void initFrustumCam()

Description copied from class: AbstractShadowRenderer

delegates the initialization of the frustum cam to child renderers

Specified by:

initFrustumCam in class AbstractShadowRenderer

updateShadowCams

protected void updateShadowCams(Camera viewCam)

Description copied from class: AbstractShadowRenderer

Invoked once per frame to update the shadow cams according to the light view.

Specified by:

updateShadowCams in class AbstractShadowRenderer

Parameters:

viewCam - the scene cam

getOccludersToRender

protected GeometryList getOccludersToRender(int shadowMapIndex,
                                            GeometryList shadowMapOccluders)

Description copied from class: AbstractShadowRenderer

Returns a subclass-specific geometryList containing the occluders to be rendered in the shadow map

Specified by:

getOccludersToRender in class AbstractShadowRenderer

Parameters:

shadowMapIndex - the index of the shadow map being rendered

shadowMapOccluders - the list of occluders

Returns:

the geometryList

getReceivers

protected void getReceivers(GeometryList lightReceivers)

Specified by:

getReceivers in class AbstractShadowRenderer

getShadowCam

protected Camera getShadowCam(int shadowMapIndex)

Description copied from class: AbstractShadowRenderer

return the shadow camera to use for rendering the shadow map according the given index

Specified by:

getShadowCam in class AbstractShadowRenderer

Parameters:

shadowMapIndex - the index of the shadow map being rendered

Returns:

the shadowCam

doDisplayFrustumDebug

protected void doDisplayFrustumDebug(int shadowMapIndex)

Description copied from class: AbstractShadowRenderer

responsible for displaying the frustum of the shadow cam for debug purpose

Overrides:

doDisplayFrustumDebug in class AbstractShadowRenderer

Parameters:

shadowMapIndex - the index of the shadow map

setMaterialParameters

protected void setMaterialParameters(Material material)

Description copied from class: AbstractShadowRenderer

This method is called once per frame and is responsible for setting any material parameters that subclasses may need to set on the post material.

Specified by:

setMaterialParameters in class AbstractShadowRenderer

Parameters:

material - the material to use for the post shadow pass

clearMaterialParameters

protected void clearMaterialParameters(Material material)

Description copied from class: AbstractShadowRenderer

This method is called once per frame and is responsible for clearing any material parameters that subclasses may need to clear on the post material.

Specified by:

clearMaterialParameters in class AbstractShadowRenderer

Parameters:

material - the material that was used for the post shadow pass

getLight

public PointLight getLight()

gets the point light used to cast shadows with this processor

Returns:

the point light

setLight

public void setLight(PointLight light)

sets the light to use for casting shadows with this processor

Parameters:

light - the point light

cloneFields

public void cloneFields(Cloner cloner,
                        java.lang.Object original)

Description copied from interface: JmeCloneable

Implemented to perform deep cloning for this object, resolving local cloned references using the specified cloner. The object can call cloner.clone(fieldValue) to deep clone any of its fields.

Note: during normal clone operations the original object will not be needed as the clone has already had all of the fields shallow copied.

Specified by:

cloneFields in interface JmeCloneable

Overrides:

cloneFields in class AbstractShadowRenderer

Parameters:

cloner - The cloner that is performing the cloning operation. The cloneFields method can call back into the cloner to make clones of its subordinate fields.

original - The original object from which this object was cloned. This is provided for the very rare case that this object needs to refer to its original for some reason. In general, all of the relevant values should have been transferred during the shallow clone and this object need merely clone what it wants.

read

public void read(JmeImporter im)
          throws java.io.IOException

Description copied from class: AbstractShadowRenderer

De-serialize this instance, for example when loading from a J3O file.

Specified by:

read in interface Savable

Overrides:

read in class AbstractShadowRenderer

Parameters:

im - importer (not null)

Throws:

java.io.IOException - from the importer

write

public void write(JmeExporter ex)
           throws java.io.IOException

Description copied from class: AbstractShadowRenderer

Serialize this instance, for example when saving to a J3O file.

Specified by:

write in interface Savable

Overrides:

write in class AbstractShadowRenderer

Parameters:

ex - exporter (not null)

Throws:

java.io.IOException - from the exporter

checkCulling

protected boolean checkCulling(Camera viewCam)

Specified by:

checkCulling in class AbstractShadowRenderer

Parameters:

viewCam - a Camera to define the view frustum

Returns:

true if intersects