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 java.util.List<com.jme3.renderer.Camera>	cameras
protected java.util.concurrent.ExecutorService	executor
protected java.util.concurrent.Future<java.util.HashMap<java.lang.String,UpdatedTerrainPatch>>	indexer
protected java.util.List<com.jme3.math.Vector3f>	lastCameraLocations
protected LodCalculator	lodCalculator

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

enabled, spatial

Constructor Summary

Constructors

Constructor and Description
TerrainLodControl()
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

Methods

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 java.util.concurrent.ExecutorService	createExecutorService()
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()
protected TerrainLodControl.UpdateLOD	getLodThread(java.util.List<com.jme3.math.Vector3f> locations, LodCalculator lodCalculator)
protected boolean	isLodCalcRunning()
java.lang.Object	jmeClone()
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	setExecutor(java.util.concurrent.ExecutorService executor) Set your own custom executor to be used.
protected void	setLodCalcRunning(boolean running)
void	setLodCalculator(LodCalculator lodCalculator)
void	setSpatial(com.jme3.scene.Spatial spatial)
void	setTerrain(Terrain terrain)
protected void	updateLOD(java.util.List<com.jme3.math.Vector3f> locations, 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 java.util.List<com.jme3.renderer.Camera> cameras

lodCalculator

protected LodCalculator lodCalculator

lastCameraLocations

protected java.util.List<com.jme3.math.Vector3f> lastCameraLocations

executor

protected java.util.concurrent.ExecutorService executor

indexer

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

Constructor Detail

TerrainLodControl

public TerrainLodControl()

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

controlRender

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

Specified by:

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

setExecutor

public void setExecutor(java.util.concurrent.ExecutorService executor)

Set your own custom executor to be used. The control will use this instead of creating its own.

createExecutorService

protected java.util.concurrent.ExecutorService createExecutorService()

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(java.util.List<com.jme3.math.Vector3f> locations,
             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()

getLodThread

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

isLodCalcRunning

protected boolean isLodCalcRunning()

setLodCalcRunning

protected void setLodCalcRunning(boolean running)

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