AbstractShadowRendererVR (jMonkeyEngine3)

java.lang.Object
- com.jme3.shadow.AbstractShadowRendererVR

All Implemented Interfaces:

Savable, SceneProcessor

Direct Known Subclasses:

DirectionalLightShadowRendererVR
```
public abstract class AbstractShadowRendererVR
extends java.lang.Object
implements SceneProcessor, Savable
```
Abstract shadow renderer that holds commons feature to have for a shadow renderer.

Field Summary

Fields
Modifier and Type	Field and Description
`protected AssetManager`	`assetManager`
`protected boolean`	`debug`
`protected Picture[]`	`dispPic`
`protected Texture2D`	`dummyTex`
`protected EdgeFilteringMode`	`edgeFilteringMode`
`protected float`	`edgesThickness`
`protected Vector2f`	`fadeInfo`
`protected float`	`fadeLength`
`protected RenderState`	`forcedRenderState`
`protected Camera`	`frustumCam`
`protected GeometryList`	`lightReceivers`
`protected Matrix4f[]`	`lightViewProjectionsMatrices`
`protected java.util.List<Material>`	`matCache` list of materials for post shadow queue geometries
`protected int`	`nbShadowMaps`
`protected boolean`	`needsfallBackMaterial` true if the fallback material should be used, otherwise false
`protected Material`	`postshadowMat`
`protected java.lang.String`	`postTechniqueName` name of the post material technique
`protected Material`	`preshadowMat`
`protected AppProfiler`	`profiler`
`protected boolean`	`renderBackFacesShadows`
`protected RenderManager`	`renderManager`
`protected CompareMode`	`shadowCompareMode`
`protected FrameBuffer[]`	`shadowFB`
`protected float`	`shadowIntensity`
`protected GeometryList`	`shadowMapOccluders`
`protected Texture2D[]`	`shadowMaps`
`protected float`	`shadowMapSize`
`protected boolean`	`skipPostPass` true to skip the post pass when there are no shadow casters
`protected ViewPort`	`viewPort`
`protected float`	`zFarOverride` fade shadows at distance

Constructor Summary

Constructors
Modifier	Constructor and Description
`protected`	`AbstractShadowRendererVR()` used for serialization
`protected`	`AbstractShadowRendererVR(AssetManager assetManager, int shadowMapSize, int nbShadowMaps)` Create an abstract shadow renderer.

Method Summary

All Methods Instance Methods Abstract Methods Concrete Methods Deprecated Methods
Modifier and Type	Method and Description
`protected abstract boolean`	`checkCulling(Camera viewCam)` returns true if the light source bounding box is in the view frustum
`void`	`cleanup()` Called when the SP is removed from the RM.
`protected abstract 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.
`protected Geometry`	`createFrustum(Vector3f[] pts, int i)` debug function to create a visible frustum
`void`	`displayDebug()` For debugging purposes, "snapshot" the current frustum to the scene.
`void`	`displayFrustum()` Force the frustum to be displayed.
`protected void`	`displayShadowMap(Renderer r)` For debugging purposes, display depth shadow maps.
`protected void`	`doDisplayFrustumDebug(int shadowMapIndex)` responsible for displaying the frustum of the shadow cam for debug purpose
`EdgeFilteringMode`	`getEdgeFilteringMode()` Get the edge filtering mode.
`int`	`getEdgesThickness()` returns the edges thickness
`protected abstract GeometryList`	`getOccludersToRender(int shadowMapIndex, GeometryList shadowMapOccluders)` Returns a subclass-specific geometryList containing the occluders to be rendered in the shadow map
`RenderState`	`getPreShadowForcedRenderState()` Returns the pre shadows pass render state.
`protected abstract void`	`getReceivers(GeometryList lightReceivers)`
`protected abstract Camera`	`getShadowCam(int shadowMapIndex)` return the shadow camera to use for rendering the shadow map according the given index
`CompareMode`	`getShadowCompareMode()` returns the shadow compare mode
`float`	`getShadowIntensity()` Returns the shadow intensity.
`float`	`getShadowZExtend()` How far the shadows are rendered in the view
`float`	`getShadowZFadeLength()` get the length over which the shadow will fade out when using a shadowZextend
`protected void`	`initForcedRenderState()`
`protected abstract void`	`initFrustumCam()` delegates the initialization of the frustum cam to child renderers
`void`	`initialize(RenderManager rm, ViewPort vp)` Initialize this shadow renderer prior to its first update.
`boolean`	`isFlushQueues()` Deprecated. This method does nothing now and is kept only for backward compatibility.
`boolean`	`isInitialized()` Test whether this shadow renderer has been initialized.
`boolean`	`isRenderBackFacesShadows()` if this processor renders back faces shadows
`void`	`postFrame(FrameBuffer out)` Called after a frame has been rendered and the queue flushed.
`void`	`postQueue(RenderQueue rq)` Called after the scene graph has been queued, but before it is flushed.
`void`	`preFrame(float tpf)` Called before a frame
`void`	`read(JmeImporter im)` De-serialize this instance, for example when loading from a J3O file.
`protected void`	`renderShadowMap(int shadowMapIndex)`
`void`	`reshape(ViewPort vp, int w, int h)` Called when the resolution of the viewport has been changed.
`void`	`setEdgeFilteringMode(EdgeFilteringMode filterMode)` Sets the filtering mode for shadow edges.
`void`	`setEdgesThickness(int edgesThickness)` Sets the shadow edges thickness.
`void`	`setFlushQueues(boolean flushQueues)` Deprecated. This method does nothing now and is kept only for backward compatibility.
`protected abstract 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`	`setPostShadowMaterial(Material postShadowMat)` set the post shadow material for this renderer
`protected void`	`setPostShadowParams()` for internal use only
`void`	`setProfiler(AppProfiler profiler)` Sets a profiler Instance for this processor.
`void`	`setRenderBackFacesShadows(java.lang.Boolean renderBackFacesShadows)` Set to true if you want back faces shadows on geometries.
`void`	`setShadowCompareMode(CompareMode compareMode)` Sets the shadow compare mode.
`void`	`setShadowIntensity(float shadowIntensity)` Set the shadowIntensity.
`void`	`setShadowZExtend(float zFar)` Set the distance from the eye where the shadows will be rendered default value is dynamically computed to the shadow casters/receivers union bound zFar, capped to view frustum far value.
`void`	`setShadowZFadeLength(float length)` Define the length over which the shadow will fade out when using a shadowZextend This is useful to make dynamic shadows fade into baked shadows in the distance.
`protected abstract 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 java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - nbShadowMaps
```
protected int nbShadowMaps
```
  - shadowMapSize
```
protected float shadowMapSize
```
  - shadowIntensity
```
protected float shadowIntensity
```
  - renderManager
```
protected RenderManager renderManager
```
  - viewPort
```
protected ViewPort viewPort
```
  - shadowFB
```
protected FrameBuffer[] shadowFB
```
  - shadowMaps
```
protected Texture2D[] shadowMaps
```
  - dummyTex
```
protected Texture2D dummyTex
```
  - preshadowMat
```
protected Material preshadowMat
```
  - postshadowMat
```
protected Material postshadowMat
```
  - lightViewProjectionsMatrices
```
protected Matrix4f[] lightViewProjectionsMatrices
```
  - assetManager
```
protected AssetManager assetManager
```
  - debug
```
protected boolean debug
```
  - edgesThickness
```
protected float edgesThickness
```
  - edgeFilteringMode
```
protected EdgeFilteringMode edgeFilteringMode
```
  - shadowCompareMode
```
protected CompareMode shadowCompareMode
```
  - dispPic
```
protected Picture[] dispPic
```
  - forcedRenderState
```
protected RenderState forcedRenderState
```
  - renderBackFacesShadows
```
protected boolean renderBackFacesShadows
```
  - profiler
```
protected AppProfiler profiler
```
  - needsfallBackMaterial
```
protected boolean needsfallBackMaterial
```
    true if the fallback material should be used, otherwise false
  - postTechniqueName
```
protected java.lang.String postTechniqueName
```
    name of the post material technique
  - matCache
```
protected java.util.List<Material> matCache
```
    list of materials for post shadow queue geometries
  - lightReceivers
```
protected GeometryList lightReceivers
```
  - shadowMapOccluders
```
protected GeometryList shadowMapOccluders
```
  - zFarOverride
```
protected float zFarOverride
```
    fade shadows at distance
  - fadeInfo
```
protected Vector2f fadeInfo
```
  - fadeLength
```
protected float fadeLength
```
  - frustumCam
```
protected Camera frustumCam
```
  - skipPostPass
```
protected boolean skipPostPass
```
    true to skip the post pass when there are no shadow casters
- Constructor Detail
  - AbstractShadowRendererVR
```
protected AbstractShadowRendererVR()
```
    used for serialization
  - AbstractShadowRendererVR
```
protected AbstractShadowRendererVR(AssetManager assetManager,
                                   int shadowMapSize,
                                   int nbShadowMaps)
```
    Create an abstract shadow renderer. Subclasses invoke this constructor.
    
    Parameters:
    
    assetManager - the application asset manager
    
    shadowMapSize - the size of the rendered shadow maps (512,1024,2048, etc...)
    
    nbShadowMaps - the number of shadow maps rendered (the more shadow maps the more quality, the fewer fps).
- Method Detail
  - initForcedRenderState
```
protected void initForcedRenderState()
```
  - setPostShadowMaterial
```
protected final void setPostShadowMaterial(Material postShadowMat)
```
    set the post shadow material for this renderer
    
    Parameters:
    
    postShadowMat -
  - setEdgeFilteringMode
```
public final void setEdgeFilteringMode(EdgeFilteringMode filterMode)
```
    Sets the filtering mode for shadow edges. See EdgeFilteringMode for more info.
    
    Parameters:
    
    filterMode - the desired filter mode (not null)
  - getEdgeFilteringMode
```
public EdgeFilteringMode getEdgeFilteringMode()
```
    Get the edge filtering mode.
    
    Returns:
    
    the edge filtering mode.
  - setShadowCompareMode
```
public final void setShadowCompareMode(CompareMode compareMode)
```
    Sets the shadow compare mode. See CompareMode for more info.
    
    Parameters:
    
    compareMode - the desired compare mode (not null)
  - getShadowCompareMode
```
public CompareMode getShadowCompareMode()
```
    returns the shadow compare mode
    
    Returns:
    
    the shadowCompareMode
    
    See Also:
    
    CompareMode
  - createFrustum
```
protected Geometry createFrustum(Vector3f[] pts,
                                 int i)
```
    debug function to create a visible frustum
  - initialize
```
public void initialize(RenderManager rm,
                       ViewPort vp)
```
    Initialize this shadow renderer prior to its first update.
    
    Specified by:
    
    initialize in interface SceneProcessor
    
    Parameters:
    
    rm - the render manager
    
    vp - the viewport
  - initFrustumCam
```
protected abstract void initFrustumCam()
```
    delegates the initialization of the frustum cam to child renderers
  - isInitialized
```
public boolean isInitialized()
```
    Test whether this shadow renderer has been initialized.
    
    Specified by:
    
    isInitialized in interface SceneProcessor
    
    Returns:
    
    true if initialized, otherwise false
  - updateShadowCams
```
protected abstract void updateShadowCams(Camera viewCam)
```
    Invoked once per frame to update the shadow cams according to the light view.
    
    Parameters:
    
    viewCam - the scene cam
  - getOccludersToRender
```
protected abstract GeometryList getOccludersToRender(int shadowMapIndex,
                                                     GeometryList shadowMapOccluders)
```
    Returns a subclass-specific geometryList containing the occluders to be rendered in the shadow map
    
    Parameters:
    
    shadowMapIndex - the index of the shadow map being rendered
    
    shadowMapOccluders - the list of occluders
    
    Returns:
    
    a list of occluders
  - getShadowCam
```
protected abstract Camera getShadowCam(int shadowMapIndex)
```
    return the shadow camera to use for rendering the shadow map according the given index
    
    Parameters:
    
    shadowMapIndex - the index of the shadow map being rendered
    
    Returns:
    
    the shadowCam
  - setProfiler
```
public void setProfiler(AppProfiler profiler)
```
    Description copied from interface: SceneProcessor
    
    Sets a profiler Instance for this processor.
    
    Specified by:
    
    setProfiler in interface SceneProcessor
    
    Parameters:
    
    profiler - the profiler instance.
  - doDisplayFrustumDebug
```
protected void doDisplayFrustumDebug(int shadowMapIndex)
```
    responsible for displaying the frustum of the shadow cam for debug purpose
    
    Parameters:
    
    shadowMapIndex -
  - postQueue
```
public void postQueue(RenderQueue rq)
```
    Description copied from interface: SceneProcessor
    
    Called after the scene graph has been queued, but before it is flushed.
    
    Specified by:
    
    postQueue in interface SceneProcessor
    
    Parameters:
    
    rq - The render queue
  - renderShadowMap
```
protected void renderShadowMap(int shadowMapIndex)
```
  - displayFrustum
```
public void displayFrustum()
```
    Force the frustum to be displayed.
  - displayShadowMap
```
protected void displayShadowMap(Renderer r)
```
    For debugging purposes, display depth shadow maps.
  - displayDebug
```
public void displayDebug()
```
    For debugging purposes, "snapshot" the current frustum to the scene.
  - getReceivers
```
protected abstract void getReceivers(GeometryList lightReceivers)
```
  - postFrame
```
public void postFrame(FrameBuffer out)
```
    Description copied from interface: SceneProcessor
    
    Called after a frame has been rendered and the queue flushed.
    
    Specified by:
    
    postFrame in interface SceneProcessor
    
    Parameters:
    
    out - The FB to which the scene was rendered.
  - clearMaterialParameters
```
protected abstract 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.
    
    Parameters:
    
    material - the material that was used for the post shadow pass
  - setMaterialParameters
```
protected abstract 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.
    
    Parameters:
    
    material - the material to use for the post shadow pass
  - setPostShadowParams
```
protected void setPostShadowParams()
```
    for internal use only
  - getShadowZExtend
```
public float getShadowZExtend()
```
    How far the shadows are rendered in the view
    
    Returns:
    
    shadowZExtend
    
    See Also:
    
    setShadowZExtend(float zFar)
  - setShadowZExtend
```
public void setShadowZExtend(float zFar)
```
    Set the distance from the eye where the shadows will be rendered default value is dynamically computed to the shadow casters/receivers union bound zFar, capped to view frustum far value.
    
    Parameters:
    
    zFar - the zFar values that override the computed one
  - setShadowZFadeLength
```
public void setShadowZFadeLength(float length)
```
    Define the length over which the shadow will fade out when using a shadowZextend This is useful to make dynamic shadows fade into baked shadows in the distance.
    
    Parameters:
    
    length - the fade length in world units
  - getShadowZFadeLength
```
public float getShadowZFadeLength()
```
    get the length over which the shadow will fade out when using a shadowZextend
    
    Returns:
    
    the fade length in world units
  - checkCulling
```
protected abstract boolean checkCulling(Camera viewCam)
```
    returns true if the light source bounding box is in the view frustum
    
    Returns:
    
    true if box in frustum
  - preFrame
```
public void preFrame(float tpf)
```
    Description copied from interface: SceneProcessor
    
    Called before a frame
    
    Specified by:
    
    preFrame in interface SceneProcessor
    
    Parameters:
    
    tpf - Time per frame
  - cleanup
```
public void cleanup()
```
    Description copied from interface: SceneProcessor
    
    Called when the SP is removed from the RM.
    
    Specified by:
    
    cleanup in interface SceneProcessor
  - reshape
```
public void reshape(ViewPort vp,
                    int w,
                    int h)
```
    Description copied from interface: SceneProcessor
    
    Called when the resolution of the viewport has been changed.
    
    Specified by:
    
    reshape in interface SceneProcessor
    
    Parameters:
    
    vp - the affected ViewPort
    
    w - the new width (in pixels)
    
    h - the new height (in pixels)
  - getShadowIntensity
```
public float getShadowIntensity()
```
    Returns the shadow intensity.
    
    Returns:
    
    shadowIntensity
    
    See Also:
    
    setShadowIntensity(float shadowIntensity)
  - setShadowIntensity
```
public final void setShadowIntensity(float shadowIntensity)
```
    Set the shadowIntensity. The value should be between 0 and 1. A 0 value gives a bright and invisible shadow, a 1 value gives a pitch black shadow. The default is 0.7
    
    Parameters:
    
    shadowIntensity - the darkness of the shadow
  - getEdgesThickness
```
public int getEdgesThickness()
```
    returns the edges thickness
    
    Returns:
    
    edgesThickness
    
    See Also:
    
    setEdgesThickness(int edgesThickness)
  - setEdgesThickness
```
public void setEdgesThickness(int edgesThickness)
```
    Sets the shadow edges thickness. default is 1, setting it to lower values can help to reduce the jagged effect of the shadow edges
    
    Parameters:
    
    edgesThickness - the shadow edges thickness.
  - isFlushQueues
```
@Deprecated
public boolean isFlushQueues()
```
    Deprecated. This method does nothing now and is kept only for backward compatibility.
    
    This method does nothing now and is kept only for backward compatibility.
    
    Returns:
    
    false
  - setFlushQueues
```
@Deprecated
public void setFlushQueues(boolean flushQueues)
```
    Deprecated. This method does nothing now and is kept only for backward compatibility.
    
    This method does nothing now and is kept only for backward compatibility.
    
    Parameters:
    
    flushQueues - any boolean.
  - getPreShadowForcedRenderState
```
public RenderState getPreShadowForcedRenderState()
```
    Returns the pre shadows pass render state. use it to adjust the RenderState parameters of the pre shadow pass. Note that this will be overridden if the preShadow technique in the material has a ForcedRenderState
    
    Returns:
    
    the pre shadow render state.
  - setRenderBackFacesShadows
```
public void setRenderBackFacesShadows(java.lang.Boolean renderBackFacesShadows)
```
    Set to true if you want back faces shadows on geometries. Note that back faces shadows will be blended over dark lighten areas and may produce overly dark lighting. Also note that setting this parameter will override this parameter for ALL materials in the scene. You can alternatively change this parameter on a single material using Material.setBoolean(String, boolean) This also will automatically adjust the faceCullMode and the PolyOffset of the pre shadow pass. You can modify them by using getPreShadowForcedRenderState()
    
    Parameters:
    
    renderBackFacesShadows - true or false.
  - isRenderBackFacesShadows
```
public boolean isRenderBackFacesShadows()
```
    if this processor renders back faces shadows
    
    Returns:
    
    true if this processor renders back faces shadows
  - read
```
public void read(JmeImporter im)
          throws java.io.IOException
```
    De-serialize this instance, for example when loading from a J3O file.
    
    Specified by:
    
    read in interface Savable
    
    Parameters:
    
    im - importer (not null)
    
    Throws:
    
    java.io.IOException
  - write
```
public void write(JmeExporter ex)
           throws java.io.IOException
```
    Serialize this instance, for example when saving to a J3O file.
    
    Specified by:
    
    write in interface Savable
    
    Parameters:
    
    ex - exporter (not null)
    
    Throws:
    
    java.io.IOException

Class AbstractShadowRendererVR

Field Summary

Constructor Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

nbShadowMaps

shadowMapSize

shadowIntensity

renderManager

viewPort

shadowFB

shadowMaps

dummyTex

preshadowMat

postshadowMat

lightViewProjectionsMatrices

assetManager

debug

edgesThickness

edgeFilteringMode

shadowCompareMode

dispPic

forcedRenderState

renderBackFacesShadows

profiler

needsfallBackMaterial

postTechniqueName

matCache

lightReceivers

shadowMapOccluders

zFarOverride

fadeInfo

fadeLength

frustumCam

skipPostPass

Constructor Detail

AbstractShadowRendererVR

AbstractShadowRendererVR

Method Detail

initForcedRenderState

setPostShadowMaterial

setEdgeFilteringMode

getEdgeFilteringMode

setShadowCompareMode

getShadowCompareMode

createFrustum

initialize

initFrustumCam

isInitialized

updateShadowCams

getOccludersToRender

getShadowCam

setProfiler

doDisplayFrustumDebug

postQueue

renderShadowMap

displayFrustum

displayShadowMap

displayDebug

getReceivers

postFrame

clearMaterialParameters

setMaterialParameters

setPostShadowParams

getShadowZExtend

setShadowZExtend

setShadowZFadeLength

getShadowZFadeLength

checkCulling

preFrame

cleanup

reshape

getShadowIntensity

setShadowIntensity

getEdgesThickness

setEdgesThickness

isFlushQueues

setFlushQueues

getPreShadowForcedRenderState