com.jme3.terrain.geomipmap

Class TerrainLodControl

java.lang.Object

com.jme3.scene.control.AbstractControl

com.jme3.terrain.geomipmap.TerrainLodControl

All Implemented Interfaces:

com.jme3.export.Savable, com.jme3.scene.control.Control, com.jme3.util.clone.JmeCloneable, java.lang.Cloneable

Direct Known Subclasses:

MultiTerrainLodControl, TerrainGridLodControl

public class TerrainLodControl
extends com.jme3.scene.control.AbstractControl

Tells the terrain to update its Level of Detail. It needs the cameras to do this, and there could possibly be several cameras in the scene, so it accepts a list of cameras. NOTE: right now it just uses the first camera passed in, in the future it will use all of them to determine what LOD to set. This control serializes, but it does not save the Camera reference. This camera reference has to be manually added in when you load the terrain to the scene! When the control or the terrain are removed from the scene, you should call TerrainLodControl.detachAndCleanUpControl() to remove any threads it created to handle the LOD processing. If you supply your own executor service, then you have to handle its thread termination yourself.

Author:

Brent Owens

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	TerrainLodControl.UpdateLOD Calculates the LOD of all child terrain patches.

Field Summary

Fields

Modifier and Type	Field and Description
protected com.jme3.renderer.Camera	camera The camera from render view port.
protected com.jme3.util.SafeArrayList<com.jme3.math.Vector3f>	cameraLocations
protected com.jme3.util.SafeArrayList<com.jme3.renderer.Camera>	cameras The list of cameras for when terrain supports multiple cameras (ie split screen)
protected boolean	forceUpdate
protected boolean	hasResetLod
protected java.util.concurrent.Future<java.util.HashMap<java.lang.String,UpdatedTerrainPatch>>	indexer
protected com.jme3.util.SafeArrayList<com.jme3.math.Vector3f>	lastCameraLocations
protected java.util.concurrent.atomic.AtomicBoolean	lodCalcRunning
protected LodCalculator	lodCalculator
protected com.jme3.math.Vector3f	previousCameraLocation The previous location of camera.
protected Terrain	terrain
protected boolean	useRenderCamera The flag of using a camera from render viewport instead cameras from cameras.

Fields inherited from class com.jme3.scene.control.AbstractControl

enabled, spatial

Constructor Summary

Constructors

Constructor and Description
TerrainLodControl()
TerrainLodControl(com.jme3.renderer.Camera camera)
TerrainLodControl(Terrain terrain)
TerrainLodControl(Terrain terrain, com.jme3.renderer.Camera camera)
TerrainLodControl(Terrain terrain, java.util.List<com.jme3.renderer.Camera> cameras) Only uses the first camera right now.

Method Summary

Modifier and Type	Method and Description
void	cloneFields(com.jme3.util.clone.Cloner cloner, java.lang.Object original)
com.jme3.scene.control.Control	cloneForSpatial(com.jme3.scene.Spatial spatial)
protected void	controlRender(com.jme3.renderer.RenderManager rm, com.jme3.renderer.ViewPort vp)
protected void	controlUpdate(float tpf)
protected TerrainLodControl.UpdateLOD	createLodUpdateTask(java.util.List<com.jme3.math.Vector3f> locations, LodCalculator lodCalculator)
void	detachAndCleanUpControl() Call this when you remove the terrain or this control from the scene.
void	forceUpdate() Force the LOD to update instantly, does not wait for the camera to move.
LodCalculator	getLodCalculator()
boolean	isUseRenderCamera()
java.lang.Object	jmeClone()
protected DistanceLodCalculator	makeLodCalculator()
protected void	prepareTerrain()
void	read(com.jme3.export.JmeImporter im)
void	setCamera(com.jme3.renderer.Camera camera)
void	setCameras(java.util.List<com.jme3.renderer.Camera> cameras)
void	setEnabled(boolean enabled)
void	setLodCalculator(LodCalculator lodCalculator)
void	setSpatial(com.jme3.scene.Spatial spatial)
void	setTerrain(Terrain terrain)
void	setUseRenderCamera(boolean useRenderCamera)
protected void	updateLOD(LodCalculator lodCalculator)
protected void	updateLOD(com.jme3.util.SafeArrayList<com.jme3.math.Vector3f> locations, LodCalculator lodCalculator)
protected boolean	updateLodOffCount(LodCalculator lodCalculator)
void	write(com.jme3.export.JmeExporter ex)

Methods inherited from class com.jme3.scene.control.AbstractControl

getSpatial, isEnabled, render, update

Methods inherited from class java.lang.Object

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

Field Detail

cameras

protected com.jme3.util.SafeArrayList<com.jme3.renderer.Camera> cameras

The list of cameras for when terrain supports multiple cameras (ie split screen)

cameraLocations

protected com.jme3.util.SafeArrayList<com.jme3.math.Vector3f> cameraLocations

lastCameraLocations

protected com.jme3.util.SafeArrayList<com.jme3.math.Vector3f> lastCameraLocations

lodCalcRunning

protected java.util.concurrent.atomic.AtomicBoolean lodCalcRunning

previousCameraLocation

protected com.jme3.math.Vector3f previousCameraLocation

The previous location of camera.

camera

protected com.jme3.renderer.Camera camera

The camera from render view port.

terrain

protected Terrain terrain

lodCalculator

protected LodCalculator lodCalculator

indexer

protected java.util.concurrent.Future<java.util.HashMap<java.lang.String,UpdatedTerrainPatch>> indexer

useRenderCamera

protected boolean useRenderCamera

The flag of using a camera from render viewport instead cameras from cameras.

forceUpdate

protected boolean forceUpdate

hasResetLod

protected boolean hasResetLod

Constructor Detail

TerrainLodControl

public TerrainLodControl()

TerrainLodControl

public TerrainLodControl(Terrain terrain)

TerrainLodControl

public TerrainLodControl(com.jme3.renderer.Camera camera)

TerrainLodControl

public TerrainLodControl(Terrain terrain,
                         com.jme3.renderer.Camera camera)

TerrainLodControl

public TerrainLodControl(Terrain terrain,
                         java.util.List<com.jme3.renderer.Camera> cameras)

Only uses the first camera right now.

Parameters:

terrain - to act upon (must be a Spatial)

cameras - one or more cameras to reference for LOD calc

Method Detail

makeLodCalculator

protected DistanceLodCalculator makeLodCalculator()

setUseRenderCamera

public void setUseRenderCamera(boolean useRenderCamera)

Parameters:

useRenderCamera - true if need to use a camera from render view port.

isUseRenderCamera

public boolean isUseRenderCamera()

Returns:

true if need to use a camera from render view port.

controlRender

protected void controlRender(com.jme3.renderer.RenderManager rm,
                             com.jme3.renderer.ViewPort vp)

Specified by:

controlRender in class com.jme3.scene.control.AbstractControl

controlUpdate

protected void controlUpdate(float tpf)

Specified by:

controlUpdate in class com.jme3.scene.control.AbstractControl

detachAndCleanUpControl

public void detachAndCleanUpControl()

Call this when you remove the terrain or this control from the scene. It will clear up any threads it had.

updateLOD

protected void updateLOD(LodCalculator lodCalculator)

updateLOD

protected void updateLOD(com.jme3.util.SafeArrayList<com.jme3.math.Vector3f> locations,
                         LodCalculator lodCalculator)

updateLodOffCount

protected boolean updateLodOffCount(LodCalculator lodCalculator)

forceUpdate

public void forceUpdate()

Force the LOD to update instantly, does not wait for the camera to move. It will reset once it has updated.

prepareTerrain

protected void prepareTerrain()

createLodUpdateTask

protected TerrainLodControl.UpdateLOD createLodUpdateTask(java.util.List<com.jme3.math.Vector3f> locations,
                                                          LodCalculator lodCalculator)

jmeClone

public java.lang.Object jmeClone()

Specified by:

jmeClone in interface com.jme3.util.clone.JmeCloneable

Overrides:

jmeClone in class com.jme3.scene.control.AbstractControl

cloneFields

public void cloneFields(com.jme3.util.clone.Cloner cloner,
                        java.lang.Object original)

Specified by:

cloneFields in interface com.jme3.util.clone.JmeCloneable

Overrides:

cloneFields in class com.jme3.scene.control.AbstractControl

cloneForSpatial

public com.jme3.scene.control.Control cloneForSpatial(com.jme3.scene.Spatial spatial)

Specified by:

cloneForSpatial in interface com.jme3.scene.control.Control

Overrides:

cloneForSpatial in class com.jme3.scene.control.AbstractControl

setCamera

public void setCamera(com.jme3.renderer.Camera camera)

setCameras

public void setCameras(java.util.List<com.jme3.renderer.Camera> cameras)

setSpatial

public void setSpatial(com.jme3.scene.Spatial spatial)

Specified by:

setSpatial in interface com.jme3.scene.control.Control

Overrides:

setSpatial in class com.jme3.scene.control.AbstractControl

setTerrain

public void setTerrain(Terrain terrain)

getLodCalculator

public LodCalculator getLodCalculator()

setLodCalculator

public void setLodCalculator(LodCalculator lodCalculator)

setEnabled

public void setEnabled(boolean enabled)

Overrides:

setEnabled in class com.jme3.scene.control.AbstractControl

write

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

Specified by:

write in interface com.jme3.export.Savable

Overrides:

write in class com.jme3.scene.control.AbstractControl

Throws:

java.io.IOException

read

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

Specified by:

read in interface com.jme3.export.Savable

Overrides:

read in class com.jme3.scene.control.AbstractControl

Throws:

java.io.IOException