Package com.jme3.shadow

Class SdsmDirectionalLightShadowRenderer

java.lang.Object
com.jme3.shadow.AbstractShadowRenderer
com.jme3.shadow.SdsmDirectionalLightShadowRenderer
All Implemented Interfaces:
Savable, SceneProcessor, JmeCloneable, Cloneable
public class SdsmDirectionalLightShadowRenderer extends AbstractShadowRenderer
See SdsmDirectionalLightShadowFilter

  • Constructor Details

    • SdsmDirectionalLightShadowRenderer

      protected SdsmDirectionalLightShadowRenderer()
      Used for serialization. Do not use.
      See Also:

    • SdsmDirectionalLightShadowRenderer

      public SdsmDirectionalLightShadowRenderer(AssetManager assetManager, int shadowMapSize, int nbShadowMaps)
      Creates an SDSM directional light shadow renderer. You likely should not use this directly, as it requires an SdsmDirectionalLightShadowFilter.

  • Method Details

    • getLight

      public DirectionalLight getLight()
      Returns the light used to cast shadows.

    • setLight

      public void setLight(DirectionalLight light)
      Sets the light to use for casting shadows.

    • setDepthTexture

      public void setDepthTexture(Texture depthTexture)

    • getFitExpansionFactor

      public float getFitExpansionFactor()
      Gets the fit expansion factor.
      Returns:
      the expansion factor

    • setFitExpansionFactor

      public void setFitExpansionFactor(float fitExpansionFactor)
      Sets the expansion factor for fitted shadow frustums.

      A value of 1.0 uses the exact computed bounds. Larger values (e.g., 1.05) add some margin to reduce artifacts from frame delay or precision issues.

      Parameters:
      fitExpansionFactor - the expansion factor (default 1.0)

    • getFitFrameDelayTolerance

      public float getFitFrameDelayTolerance()
      Gets the frame delay tolerance for reusing old fit results.
      Returns:
      the tolerance value

    • setFitFrameDelayTolerance

      public void setFitFrameDelayTolerance(float fitFrameDelayTolerance)
      Sets the tolerance for reusing old fit results.

      When the camera hasn't moved significantly (within this tolerance), old fit results can be reused to avoid GPU stalls.

      Parameters:
      fitFrameDelayTolerance - the tolerance (default 0.05)

    • initFrustumCam

      protected void initFrustumCam()
      Description copied from class: AbstractShadowRenderer
      Delegates the initialization of the frustum camera to child renderers. This camera defines the view for calculating shadow frustums.
      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 cameras according to the light view. Subclasses must implement this method to define how shadow cameras are positioned and oriented.
      Specified by:
      updateShadowCams in class AbstractShadowRenderer
      Parameters:
      viewCam - The main scene camera.

    • getOccludersToRender

      protected GeometryList getOccludersToRender(int shadowMapIndex, GeometryList shadowMapOccluders)
      Description copied from class: AbstractShadowRenderer
      Returns a subclass-specific GeometryList containing the occluders that should be rendered into the shadow map.
      Specified by:
      getOccludersToRender in class AbstractShadowRenderer
      Parameters:
      shadowMapIndex - The index of the shadow map being rendered.
      shadowMapOccluders - An existing GeometryList that can be reused or populated.
      Returns:
      A GeometryList containing the geometries that cast shadows for the given map.

    • getReceivers

      protected void getReceivers(GeometryList lightReceivers)
      Description copied from class: AbstractShadowRenderer
      Populates the provided GeometryList with geometries that are considered shadow receivers. Subclasses must implement this method.
      Specified by:
      getReceivers in class AbstractShadowRenderer
      Parameters:
      lightReceivers - The GeometryList to populate with shadow-receiving geometries.

    • getShadowCam

      protected Camera getShadowCam(int shadowMapIndex)
      Description copied from class: AbstractShadowRenderer
      Returns the shadow camera to use for rendering the shadow map according to the given index. Subclasses must implement this to provide the correct camera for each shadow map.
      Specified by:
      getShadowCam in class AbstractShadowRenderer
      Parameters:
      shadowMapIndex - The index of the shadow map being rendered.
      Returns:
      The Camera instance representing the shadow's viewpoint.

    • doDisplayFrustumDebug

      protected void doDisplayFrustumDebug(int shadowMapIndex)
      Description copied from class: AbstractShadowRenderer
      Responsible for displaying the frustum of the shadow camera for debugging purposes. Subclasses can override this method to provide specific debug visualizations.
      Overrides:
      doDisplayFrustumDebug in class AbstractShadowRenderer
      Parameters:
      shadowMapIndex - The index of the shadow map for which to display the frustum.

    • displayAllDebugFrustums

      public void displayAllDebugFrustums()

    • 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 have set on the post-shadow material. This ensures that parameters from previous frames or other renderers do not interfere.
      Specified by:
      clearMaterialParameters in class AbstractShadowRenderer
      Parameters:
      material - The material that was used for the post-shadow pass.

    • setPostShadowParams

      protected void setPostShadowParams()
      Description copied from class: AbstractShadowRenderer
      For internal use only. Sets the common shadow parameters on the internal post-shadow material. This is used when a fallback material is needed.
      Overrides:
      setPostShadowParams in class AbstractShadowRenderer

    • checkCulling

      protected boolean checkCulling(Camera viewCam)
      Description copied from class: AbstractShadowRenderer
      Abstract method to check if the light source's bounding box is within the view frustum of the given camera. This is used for culling to avoid unnecessary shadow computations.
      Specified by:
      checkCulling in class AbstractShadowRenderer
      Parameters:
      viewCam - A Camera to define the view frustum against which to check.
      Returns:
      True if the light source's bounding box is in the view frustum, otherwise false.

    • cleanup

      public void cleanup()
      Cleans up GPU resources used by the SDSM fitter.
      Specified by:
      cleanup in interface SceneProcessor
      Overrides:
      cleanup in class AbstractShadowRenderer

    • cloneFields

      public void cloneFields(Cloner cloner, 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 only clone what it wants.

    • read

      public void read(JmeImporter im) throws 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:
      IOException - from the importer

    • write

      public void write(JmeExporter ex) throws 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:
      IOException - from the exporter