Package com.jme3.shadow

Class AbstractShadowRendererVR

java.lang.Object
com.jme3.shadow.AbstractShadowRendererVR
All Implemented Interfaces:
Savable, SceneProcessor
Direct Known Subclasses:
DirectionalLightShadowRendererVR
@Deprecated public abstract class AbstractShadowRendererVR extends Object implements SceneProcessor, Savable
Deprecated.
The jme3-vr module is deprecated and will be removed in a future version (as it only supports OpenVR). For new Virtual Reality projects, use user libraries that provide OpenXR support. See Virtual Reality JME wiki section for more information.
Abstract shadow renderer that holds commons feature to have for a shadow renderer.

  • Field Details

    • nbShadowMaps

      protected int nbShadowMaps
      Deprecated.

    • shadowMapSize

      protected float shadowMapSize
      Deprecated.

    • shadowIntensity

      protected float shadowIntensity
      Deprecated.

    • renderManager

      protected RenderManager renderManager
      Deprecated.

    • viewPort

      protected ViewPort viewPort
      Deprecated.

    • shadowFB

      protected FrameBuffer[] shadowFB
      Deprecated.

    • shadowMaps

      protected Texture2D[] shadowMaps
      Deprecated.

    • dummyTex

      protected Texture2D dummyTex
      Deprecated.

    • preshadowMat

      protected Material preshadowMat
      Deprecated.

    • postshadowMat

      protected Material postshadowMat
      Deprecated.

    • lightViewProjectionsMatrices

      protected Matrix4f[] lightViewProjectionsMatrices
      Deprecated.

    • assetManager

      protected AssetManager assetManager
      Deprecated.

    • debug

      protected boolean debug
      Deprecated.

    • edgesThickness

      protected float edgesThickness
      Deprecated.

    • edgeFilteringMode

      protected EdgeFilteringMode edgeFilteringMode
      Deprecated.

    • shadowCompareMode

      protected CompareMode shadowCompareMode
      Deprecated.

    • dispPic

      protected Picture[] dispPic
      Deprecated.

    • forcedRenderState

      protected RenderState forcedRenderState
      Deprecated.

    • renderBackFacesShadows

      protected boolean renderBackFacesShadows
      Deprecated.

    • profiler

      protected AppProfiler profiler
      Deprecated.

    • needsfallBackMaterial

      protected boolean needsfallBackMaterial
      Deprecated.
      true if the fallback material should be used, otherwise false

    • postTechniqueName

      protected String postTechniqueName
      Deprecated.
      name of the post material technique

    • matCache

      protected List<Material> matCache
      Deprecated.
      list of materials for post shadow queue geometries

    • lightReceivers

      protected GeometryList lightReceivers
      Deprecated.

    • shadowMapOccluders

      protected GeometryList shadowMapOccluders
      Deprecated.

    • zFarOverride

      protected float zFarOverride
      Deprecated.
      fade shadows at distance

    • fadeInfo

      protected Vector2f fadeInfo
      Deprecated.

    • fadeLength

      protected float fadeLength
      Deprecated.

    • frustumCam

      protected Camera frustumCam
      Deprecated.

    • skipPostPass

      protected boolean skipPostPass
      Deprecated.
      true to skip the post pass when there are no shadow casters

  • Constructor Details

    • AbstractShadowRendererVR

      protected AbstractShadowRendererVR()
      Deprecated.
      used for serialization

    • AbstractShadowRendererVR

      protected AbstractShadowRendererVR(AssetManager assetManager, int shadowMapSize, int nbShadowMaps)
      Deprecated.
      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 Details

    • initForcedRenderState

      protected void initForcedRenderState()
      Deprecated.

    • setPostShadowMaterial

      protected final void setPostShadowMaterial(Material postShadowMat)
      Deprecated.
      set the post shadow material for this renderer
      Parameters:
      postShadowMat -

    • setEdgeFilteringMode

      public final void setEdgeFilteringMode(EdgeFilteringMode filterMode)
      Deprecated.
      Sets the filtering mode for shadow edges. See EdgeFilteringMode for more info.
      Parameters:
      filterMode - the desired filter mode (not null)

    • getEdgeFilteringMode

      public EdgeFilteringMode getEdgeFilteringMode()
      Deprecated.
      Get the edge filtering mode.
      Returns:
      the edge filtering mode.

    • setShadowCompareMode

      public final void setShadowCompareMode(CompareMode compareMode)
      Deprecated.
      Sets the shadow compare mode. See CompareMode for more info.
      Parameters:
      compareMode - the desired compare mode (not null)

    • getShadowCompareMode

      public CompareMode getShadowCompareMode()
      Deprecated.
      returns the shadow compare mode
      Returns:
      the shadowCompareMode
      See Also:

    • createFrustum

      protected Geometry createFrustum(Vector3f[] pts, int i)
      Deprecated.
      debug function to create a visible frustum

    • initialize

      public void initialize(RenderManager rm, ViewPort vp)
      Deprecated.
      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()
      Deprecated.
      delegates the initialization of the frustum cam to child renderers

    • isInitialized

      public boolean isInitialized()
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      responsible for displaying the frustum of the shadow cam for debug purpose
      Parameters:
      shadowMapIndex -

    • postQueue

      public void postQueue(RenderQueue rq)
      Deprecated.
      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)
      Deprecated.

    • displayFrustum

      public void displayFrustum()
      Deprecated.
      Force the frustum to be displayed.

    • displayShadowMap

      protected void displayShadowMap(Renderer r)
      Deprecated.
      For debugging purposes, display depth shadow maps.

    • displayDebug

      public void displayDebug()
      Deprecated.
      For debugging purposes, "snapshot" the current frustum to the scene.

    • getReceivers

      protected abstract void getReceivers(GeometryList lightReceivers)
      Deprecated.

    • postFrame

      public void postFrame(FrameBuffer out)
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      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()
      Deprecated.
      for internal use only

    • getShadowZExtend

      public float getShadowZExtend()
      Deprecated.
      How far the shadows are rendered in the view
      Returns:
      shadowZExtend
      See Also:

    • setShadowZExtend

      public void setShadowZExtend(float zFar)
      Deprecated.
      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)
      Deprecated.
      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()
      Deprecated.
      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)
      Deprecated.
      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)
      Deprecated.
      Description copied from interface: SceneProcessor
      Called before a frame
      Specified by:
      preFrame in interface SceneProcessor
      Parameters:
      tpf - Time per frame

    • cleanup

      public void cleanup()
      Deprecated.
      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)
      Deprecated.
      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()
      Deprecated.
      Returns the shadow intensity.
      Returns:
      shadowIntensity
      See Also:

    • setShadowIntensity

      public final void setShadowIntensity(float shadowIntensity)
      Deprecated.
      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()
      Deprecated.
      returns the edges thickness
      Returns:
      edgesThickness
      See Also:

    • setEdgesThickness

      public void setEdgesThickness(int edgesThickness)
      Deprecated.
      Sets the shadow edge thickness. Default is 1. Setting it to lower values can help to reduce the jagged effect of the shadow edges.
      Parameters:
      edgesThickness - the shadow edge 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

    • getPreShadowForcedRenderState

      public RenderState getPreShadowForcedRenderState()
      Deprecated.
      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(Boolean renderBackFacesShadows)
      Deprecated.
      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()
      Deprecated.
      if this processor renders back faces shadows
      Returns:
      true if this processor renders back faces shadows

    • read

      public void read(JmeImporter im) throws IOException
      Deprecated.
      De-serialize this instance, for example when loading from a J3O file.
      Specified by:
      read in interface Savable
      Parameters:
      im - importer (not null)
      Throws:
      IOException

    • write

      public void write(JmeExporter ex) throws IOException
      Deprecated.
      Serialize this instance, for example when saving to a J3O file.
      Specified by:
      write in interface Savable
      Parameters:
      ex - exporter (not null)
      Throws:
      IOException