com.jme3.shadow

Class ShadowUtil

java.lang.Object

com.jme3.shadow.ShadowUtil

public class ShadowUtil
extends java.lang.Object

Includes various useful shadow mapping functions. See

• http://appsrv.cse.cuhk.edu.hk/~fzhang/pssm_vrcia/
• http://http.developer.nvidia.com/GPUGems3/gpugems3_ch10.html

for more info.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	ShadowUtil.OccludersExtractor OccludersExtractor is a helper class to collect splitOccluders from scene recursively.

Method Summary

Modifier and Type	Method and Description
static BoundingBox	computeBoundForPoints(Vector3f[] pts, Matrix4f mat) Compute bounds from an array of points
static BoundingBox	computeBoundForPoints(Vector3f[] pts, Transform transform) Compute bounds from an array of points
static BoundingBox	computeUnionBound(GeometryList list, Matrix4f mat) Compute bounds of a geomList
static BoundingBox	computeUnionBound(GeometryList list, Transform transform) Compute bounds of a geomList
static BoundingBox	computeUnionBound(java.util.List<BoundingVolume> bv) Computes the bounds of multiple bounding volumes
static void	getGeometriesInCamFrustum(GeometryList inputGeometryList, Camera camera, GeometryList outputGeometryList) Populates the outputGeometryList with the geometry of the inputGeometryList that are in the frustum of the given camera
static void	getGeometriesInCamFrustum(Spatial rootScene, Camera camera, RenderQueue.ShadowMode mode, GeometryList outputGeometryList) Populates the outputGeometryList with the rootScene children geometries that are in the frustum of the given camera
static void	getGeometriesInLightRadius(GeometryList inputGeometryList, Camera[] cameras, GeometryList outputGeometryList) Populates the outputGeometryList with the geometry of the inputGeometryList that are in the radius of a light.
static void	getLitGeometriesInViewPort(Spatial rootScene, Camera vpCamera, Camera[] cameras, RenderQueue.ShadowMode mode, GeometryList outputGeometryList) Populates the outputGeometryList with the geometries of the children of OccludersExtractor.rootScene node that are both in the frustum of the given vpCamera and some camera inside cameras array.
static void	updateFrustumPoints(Camera viewCam, float nearOverride, float farOverride, float scale, Vector3f[] points) Updates the points array to contain the frustum corners of the given camera.
static void	updateFrustumPoints2(Camera viewCam, Vector3f[] points) Updates a points arrays with the frustum corners of the provided camera.
static void	updateShadowCamera(Camera shadowCam, Vector3f[] points) Updates the shadow camera to properly contain the given points (which contain the eye camera frustum corners)
static void	updateShadowCamera(ViewPort viewPort, GeometryList receivers, Camera shadowCam, Vector3f[] points, GeometryList splitOccluders, float shadowMapSize) Updates the shadow camera to properly contain the given points (which contain the eye camera frustum corners) and the shadow occluder objects collected through the traverse of the scene hierarchy

Methods inherited from class java.lang.Object

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

Method Detail

updateFrustumPoints2

public static void updateFrustumPoints2(Camera viewCam,
                                        Vector3f[] points)

Updates a points arrays with the frustum corners of the provided camera.

Parameters:

viewCam -

points -

updateFrustumPoints

public static void updateFrustumPoints(Camera viewCam,
                                       float nearOverride,
                                       float farOverride,
                                       float scale,
                                       Vector3f[] points)

Updates the points array to contain the frustum corners of the given camera. The nearOverride and farOverride variables can be used to override the camera's near/far values with own values. TODO: Reduce creation of new vectors

Parameters:

viewCam -

nearOverride -

farOverride -

computeUnionBound

public static BoundingBox computeUnionBound(GeometryList list,
                                            Transform transform)

Compute bounds of a geomList

Parameters:

list -

transform -

Returns:

a new instance

computeUnionBound

public static BoundingBox computeUnionBound(GeometryList list,
                                            Matrix4f mat)

Compute bounds of a geomList

Parameters:

list -

mat -

Returns:

a new instance

computeUnionBound

public static BoundingBox computeUnionBound(java.util.List<BoundingVolume> bv)

Computes the bounds of multiple bounding volumes

Parameters:

bv -

Returns:

a new instance

computeBoundForPoints

public static BoundingBox computeBoundForPoints(Vector3f[] pts,
                                                Transform transform)

Compute bounds from an array of points

Parameters:

pts -

transform -

Returns:

a new instance

computeBoundForPoints

public static BoundingBox computeBoundForPoints(Vector3f[] pts,
                                                Matrix4f mat)

Compute bounds from an array of points

Parameters:

pts -

mat -

Returns:

a new BoundingBox

updateShadowCamera

public static void updateShadowCamera(Camera shadowCam,
                                      Vector3f[] points)

Updates the shadow camera to properly contain the given points (which contain the eye camera frustum corners)

Parameters:

shadowCam -

points -

updateShadowCamera

public static void updateShadowCamera(ViewPort viewPort,
                                      GeometryList receivers,
                                      Camera shadowCam,
                                      Vector3f[] points,
                                      GeometryList splitOccluders,
                                      float shadowMapSize)

Updates the shadow camera to properly contain the given points (which contain the eye camera frustum corners) and the shadow occluder objects collected through the traverse of the scene hierarchy

getGeometriesInCamFrustum

public static void getGeometriesInCamFrustum(GeometryList inputGeometryList,
                                             Camera camera,
                                             GeometryList outputGeometryList)

Populates the outputGeometryList with the geometry of the inputGeometryList that are in the frustum of the given camera

Parameters:

inputGeometryList - The list containing all geometries to check against the camera frustum

camera - the camera to check geometries against

outputGeometryList - the list of all geometries that are in the camera frustum

getGeometriesInCamFrustum

public static void getGeometriesInCamFrustum(Spatial rootScene,
                                             Camera camera,
                                             RenderQueue.ShadowMode mode,
                                             GeometryList outputGeometryList)

Populates the outputGeometryList with the rootScene children geometries that are in the frustum of the given camera

Parameters:

rootScene - the rootNode of the scene to traverse

camera - the camera to check geometries against

outputGeometryList - the list of all geometries that are in the camera frustum

getGeometriesInLightRadius

public static void getGeometriesInLightRadius(GeometryList inputGeometryList,
                                              Camera[] cameras,
                                              GeometryList outputGeometryList)

Populates the outputGeometryList with the geometry of the inputGeometryList that are in the radius of a light. The array of camera must be an array of 6 cameras initialized so they represent the light viewspace of a pointlight

Parameters:

inputGeometryList - The list containing all geometries to check against the camera frustum

cameras - the camera array to check geometries against

outputGeometryList - the list of all geometries that are in the camera frustum

getLitGeometriesInViewPort

public static void getLitGeometriesInViewPort(Spatial rootScene,
                                              Camera vpCamera,
                                              Camera[] cameras,
                                              RenderQueue.ShadowMode mode,
                                              GeometryList outputGeometryList)

Populates the outputGeometryList with the geometries of the children of OccludersExtractor.rootScene node that are both in the frustum of the given vpCamera and some camera inside cameras array. The array of cameras must be initialized to represent the light viewspace of some light like pointLight or spotLight

Parameters:

rootScene -

vpCamera - the viewPort camera

cameras - the camera array to check geometries against, representing the light viewspace

outputGeometryList - the output list of all geometries that are in the camera frustum