Package gaiasky.scenegraph

Class ModelBody

java.lang.Object

gaiasky.scenegraph.SceneGraphNode

gaiasky.scenegraph.CelestialBody

gaiasky.scenegraph.ModelBody

All Implemented Interfaces:

com.badlogic.gdx.utils.Disposable, I3DTextRenderable, IModelRenderable, IQuadRenderable, IRenderable, IFocus, IStarContainer, IVisibilitySwitch, IPosition

Direct Known Subclasses:

Billboard, Planet, Satellite

public abstract class ModelBody
extends CelestialBody

Abstract class with the basic functionality of bodies represented by a 3D model

Field Summary

Fields

Modifier and Type	Field	Description
protected float	fadeOpacity	Fade opacity, special to model bodies
String	inverseRefPlaneTransform
float	locThresholdLabel	thresholdLabel for children locations.
float	locVaMultiplier	Multiplier for Loc view angle.
ModelComponent	mc	MODEL
protected List<String>	randomize	The components to randomize---possible values are ["model", "cloud", "atmosphere"]
String	refPlane	Name of the reference plane for this object.
String	refPlaneTransform	Name of the transformation to the reference plane
protected List<Long>	seed	The seed for random components
int	shadow	State flag; whether to render the shadow (number of times left)
double[]	shadowMapValues	Array with shadow camera distance, cam near and cam far as a function of the radius of the object
float	sizeScaleFactor	Size factor, which can be set to scale model objects up or down
ITransform[]	transformations	TRANSFORMATIONS - are applied each cycle

Fields inherited from class gaiasky.scenegraph.CelestialBody

absmag, appmag, ccPale, colorbv, compalpha, coordinatesTimeOverflow, labelFactor, labelMax, primitiveRenderScale, rc, textScale, thresholdLabel, thresholdNone, thresholdPoint, thresholdQuad, wikiname

Fields inherited from class gaiasky.scenegraph.SceneGraphNode

B31, B32, B33, B34, cc, children, computed, coordinates, copy, ct, D31, D32, D33, D34, distToCamera, F31, F32, F33, F34, forceLabel, id, labelcolor, lastStateChangeTimeMs, localizedNameIndex, localTransform, names, numChildren, octant, octantId, opacity, orientation, parent, parentName, pos, posSph, ROOT_NAME, size, translation, viewAngle, viewAngleApparent, visible

Constructor Summary

Constructors

Constructor	Description
ModelBody()

Method Summary

Modifier and Type	Method	Description
void	addHit(int screenX, int screenY, int w, int h, int minPixDist, NaturalCamera camera, com.badlogic.gdx.utils.Array<IFocus> hits)	If we render the model, we set up a sphere at the object's position with its radius and check for intersections with the ray
void	addHit(Vector3d p0, Vector3d p1, NaturalCamera camera, com.badlogic.gdx.utils.Array<IFocus> hits)	Adds this focus to the hits list if it is hit by the given ray.
protected void	addToRenderLists(ICamera camera)	Adds this entity to the necessary render lists after the distance to the camera and the view angle have been determined.
void	dispose()
void	doneLoading(com.badlogic.gdx.assets.AssetManager manager)
float	getFuzzyRenderSize(ICamera camera)
double	getHeight(Vector3b camPos)	Returns the height of the projected position of the current camera on this focus object, which is usually the radius plus a value lookup in the height texture (if exists).
double	getHeight(Vector3b camPos, boolean useFuturePosition)	Same as IFocus.getHeight(Vector3b) but with the option to use the future position of the body instead of the current one.
double	getHeight(Vector3b camPos, Vector3b nextPos)	Same as IFocus.getHeight(Vector3b) but with the option to use the given future position of the body instead of the current one.
double	getHeightScale()	Returns the height scale of this focus, or 0 if it has no height info.
float	getInnerRad()
MaterialComponent	getMaterialComponent()
ModelComponent	getModelComponent()
Vector3b	getPositionAboveSurface(double longitude, double latitude, double distance, Vector3b out)	Returns the cartesian position in the internal reference system above the surface at the given longitude and latitude and distance.
double	getRadius()	Returns the radius in internal units
protected long	getSeed(String component)	Gets the seed corresponding to the given component by matching it using the position in the randomize vector.
double	getSize()	Returns the size (diameter) of this entity in internal units.
protected float	getViewAnglePow()
void	initialize()
protected boolean	isRandomizeAtmosphere()
protected boolean	isRandomizeCloud()
protected boolean	isRandomizeModel()
boolean	isShadow()	Whether shadows should be rendered for this object
protected float	labelSizeConcrete()
protected void	prepareShadowEnvironment()	Sets the shadow environment
void	render(IntModelBatch modelBatch, float alpha, double t, RenderingContext rc, SceneGraphRenderer.RenderGroup group)	Model rendering
void	render(IntModelBatch modelBatch, SceneGraphRenderer.RenderGroup group, float alpha, double t, boolean shadowEnv)	Model opaque rendering.
void	render(ExtShaderProgram shader, float alpha, IntMesh mesh, ICamera camera)	Billboard quad rendering
boolean	renderTessellated()
void	setLocthoverfactor(Double val)
void	setLocThresholdLabel(Double val)
void	setLocvamultiplier(Double val)
void	setLocViewAngleMultiplier(Double val)
void	setModel(ModelComponent mc)
void	setRandomize(String randomize)
void	setRandomize(String[] randomize)
void	setRefplane(String refplane)
void	setSeed(int[] seed)
void	setSeed(Long seed)
void	setShadowvalues(double[] shadowMapValues)	Sets the shadow mapping values for this object
void	setSizescalefactor(Double sizescalefactor)
void	setToLocalTransform(float size, float sizeFactor, com.badlogic.gdx.math.Matrix4 localTransform, boolean forceUpdate)
void	setToLocalTransform(float sizeFactor, com.badlogic.gdx.math.Matrix4 localTransform, boolean forceUpdate)
void	setTransformations(Object[] transformations)
float	textScale()	Returns the text scale for the scale varying in the shader
void	updateLocal(ITimeFrameProvider time, ICamera camera)	Updates the transform matrix with the transformations that will apply to the children and the local transform matrix with the transformations that will apply only to this object.
protected void	updateLocalTransform()	Update the local transform with the transform and the rotations/scales necessary.

Methods inherited from class gaiasky.scenegraph.CelestialBody

addFocusableObjects, checkClickDistance, checkHitCondition, computeViewAngle, getAbsmag, getAppmag, getCandidateId, getCandidateName, getCandidateViewAngleApparent, getClosestAbsolutePos, getClosestDistToCamera, getClosestName, getFocus, getOrientationQuaternion, getPmX, getPmY, getPmZ, getRotationComponent, getSimpleCopy, getTextOpacity, getViewAngle, getWikiname, hasAtmosphere, isActive, isCoordinatesTimeOverflow, isLabel, isStar, isValidPosition, makeFocus, render, renderText, setAbsmag, setAltname, setAppmag, setColor2Data, setColorbv, setLabelFactor, setLabelMax, setMag, setPrimitiveRenderScale, setRotation, setSize, setTextScale, setThresholdNone, setThresholdPoint, setThresholdQuad, setWikiname, text, textColour, textDepthBuffer, textPosition, textSize

Methods inherited from class gaiasky.scenegraph.SceneGraphNode

add, add, addChild, addChild, addName, addNodes, addToIndex, addToRender, computeFuturePosition, getAbsoluteOrientation, getAbsolutePosition, getAbsolutePosition, getAggregatedChildren, getAlpha, getChildByName, getChildByNameAndType, getChildrenByComponentType, getChildrenByType, getColor, getComponentType, getCoordinates, getCt, getDelta, getDescription, getDistToCamera, getFirstStarAncestor, getId, getLabelcolor, getLineCopy, getLocalizedName, getName, getNames, getNext, getNode, getNode, getOctant, getOpacity, getOrientation, getPos, getPosition, getPosition, getPosSph, getPredictedPosition, getRoot, getSceneGraphDepth, getStarCount, getUnrotatedPos, getVelocity, getViewAngleApparent, getVisibilityOpacityFactor, hasCt, hasName, hasName, insert, isCopy, isForceLabel, isForceLabel, isInRender, isInRender, isVisibilityOn, isVisible, isVisible, isVisible, isVisibleGroup, isVisibleGroup, msSinceStateChange, mustAddToIndex, mustUpdatePosition, namesConcat, removeChild, removeFromIndex, removeFromRender, render2DLabel, render2DLabel, render2DLabel, render2DLabel, render3DLabel, render3DLabel, returnToPool, setColor, setColor, setComputedFlag, setCoordinates, setCt, setCt, setDescription, setForcelabel, setForceLabel, setForceLabel, setId, setLabelcolor, setLabelcolor, setLabelcolor, setName, setName, setNames, setParent, setPos, setSize, setUp, setVisible, setVisible, setVisibleGroup, shouldRender, toString, update, update, updateLocalizedName, updateLocalizedNameRecursive, updateLocalValues

Methods inherited from class java.lang.Object

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

Methods inherited from interface gaiasky.scenegraph.IFocus

getAbsolutePosition, getAbsolutePosition, getAlpha, getColor, getCt, getDelta, getDistToCamera, getFirstStarAncestor, getId, getLocalizedName, getName, getNames, getNext, getOctant, getOrientation, getPos, getPosSph, getPredictedPosition, getSceneGraphDepth, getViewAngleApparent, hasName, hasName, isCopy

Methods inherited from interface gaiasky.render.IRenderable

getComponentType, getDistToCamera, getOpacity

Field Details

mc

public ModelComponent mc

MODEL

transformations

public ITransform[] transformations

TRANSFORMATIONS - are applied each cycle

locVaMultiplier

public float locVaMultiplier

Multiplier for Loc view angle.

locThresholdLabel

public float locThresholdLabel

thresholdLabel for children locations.

sizeScaleFactor

public float sizeScaleFactor

Size factor, which can be set to scale model objects up or down

fadeOpacity

protected float fadeOpacity

Fade opacity, special to model bodies

shadow

public int shadow

State flag; whether to render the shadow (number of times left)

refPlane

public String refPlane

Name of the reference plane for this object. Defaults to equator

refPlaneTransform

public String refPlaneTransform

Name of the transformation to the reference plane

inverseRefPlaneTransform

public String inverseRefPlaneTransform

shadowMapValues

public double[] shadowMapValues

Array with shadow camera distance, cam near and cam far as a function of the radius of the object

seed

protected List<Long> seed

The seed for random components

randomize

protected List<String> randomize

The components to randomize---possible values are ["model", "cloud", "atmosphere"]

Constructor Details

ModelBody

public ModelBody()

Method Details

initialize

public void initialize()

Overrides:

initialize in class SceneGraphNode

doneLoading

public void doneLoading(com.badlogic.gdx.assets.AssetManager manager)

Overrides:

doneLoading in class SceneGraphNode

updateLocal

public void updateLocal(ITimeFrameProvider time,
 ICamera camera)

Description copied from class: SceneGraphNode

Updates the transform matrix with the transformations that will apply to the children and the local transform matrix with the transformations that will apply only to this object.

Overrides:

updateLocal in class SceneGraphNode

updateLocalTransform

protected void updateLocalTransform()

Update the local transform with the transform and the rotations/scales necessary. Override if your model contains more than just the position and size.

setToLocalTransform

public void setToLocalTransform(float sizeFactor,
 com.badlogic.gdx.math.Matrix4 localTransform,
 boolean forceUpdate)

setToLocalTransform

public void setToLocalTransform(float size,
 float sizeFactor,
 com.badlogic.gdx.math.Matrix4 localTransform,
 boolean forceUpdate)

addToRenderLists

protected void addToRenderLists(ICamera camera)

Description copied from class: SceneGraphNode

Adds this entity to the necessary render lists after the distance to the camera and the view angle have been determined.

Overrides:

addToRenderLists in class SceneGraphNode

renderTessellated

public boolean renderTessellated()

getInnerRad

public float getInnerRad()

Specified by:

getInnerRad in class CelestialBody

dispose

public void dispose()

Specified by:

dispose in interface com.badlogic.gdx.utils.Disposable

Overrides:

dispose in class SceneGraphNode

render

public void render(ExtShaderProgram shader,
 float alpha,
 IntMesh mesh,
 ICamera camera)

Billboard quad rendering

Specified by:

render in interface IQuadRenderable

Overrides:

render in class CelestialBody

Parameters:

shader - The shader program

alpha - Opacity value

mesh - The mesh

camera - The camera

render

public void render(IntModelBatch modelBatch,
 float alpha,
 double t,
 RenderingContext rc,
 SceneGraphRenderer.RenderGroup group)

Model rendering

render

public void render(IntModelBatch modelBatch,
 SceneGraphRenderer.RenderGroup group,
 float alpha,
 double t,
 boolean shadowEnv)

Model opaque rendering. Disable shadow mapping

setModel

public void setModel(ModelComponent mc)

getFuzzyRenderSize

public float getFuzzyRenderSize(ICamera camera)

Overrides:

getFuzzyRenderSize in class CelestialBody

getViewAnglePow

protected float getViewAnglePow()

Overrides:

getViewAnglePow in class CelestialBody

textScale

public float textScale()

Description copied from interface: I3DTextRenderable

Returns the text scale for the scale varying in the shader

Specified by:

textScale in interface I3DTextRenderable

Overrides:

textScale in class CelestialBody

Returns:

The scale

labelSizeConcrete

protected float labelSizeConcrete()

Overrides:

labelSizeConcrete in class CelestialBody

setLocvamultiplier

public void setLocvamultiplier(Double val)

setLocViewAngleMultiplier

public void setLocViewAngleMultiplier(Double val)

setLocthoverfactor

public void setLocthoverfactor(Double val)

setLocThresholdLabel

public void setLocThresholdLabel(Double val)

setTransformations

public void setTransformations(Object[] transformations)

getPositionAboveSurface

public Vector3b getPositionAboveSurface(double longitude,
 double latitude,
 double distance,
 Vector3b out)

Returns the cartesian position in the internal reference system above the surface at the given longitude and latitude and distance.

Parameters:

longitude - The longitude in deg

latitude - The latitude in deg

distance - The distance in km

out - The vector to store the result

Returns:

The cartesian position above the surface of this body

getHeight

public double getHeight(Vector3b camPos)

Description copied from interface: IFocus

Returns the height of the projected position of the current camera on this focus object, which is usually the radius plus a value lookup in the height texture (if exists).

Specified by:

getHeight in interface IFocus

Overrides:

getHeight in class SceneGraphNode

Parameters:

camPos - The camera position.

Returns:

The height of the projected position of the current camera.

getHeight

public double getHeight(Vector3b camPos,
 boolean useFuturePosition)

Description copied from interface: IFocus

Same as IFocus.getHeight(Vector3b) but with the option to use the future position of the body instead of the current one.

Specified by:

getHeight in interface IFocus

Overrides:

getHeight in class SceneGraphNode

Parameters:

camPos - The camera position.

useFuturePosition - Whether to use the future position or the current one.

Returns:

The height of the projected position of the current camera on the surface.

getHeight

public double getHeight(Vector3b camPos,
 Vector3b nextPos)

Description copied from interface: IFocus

Same as IFocus.getHeight(Vector3b) but with the option to use the given future position of the body instead of the current one.

Specified by:

getHeight in interface IFocus

Overrides:

getHeight in class SceneGraphNode

Parameters:

camPos - The camera position.

nextPos - The future position of this body to use.

Returns:

The height of the projected position of the current camera on the surface.

getHeightScale

public double getHeightScale()

Description copied from interface: IFocus

Returns the height scale of this focus, or 0 if it has no height info.

Specified by:

getHeightScale in interface IFocus

Overrides:

getHeightScale in class SceneGraphNode

Returns:

The height scale in internal units.

prepareShadowEnvironment

protected void prepareShadowEnvironment()

Sets the shadow environment

addHit

public void addHit(int screenX,
 int screenY,
 int w,
 int h,
 int minPixDist,
 NaturalCamera camera,
 com.badlogic.gdx.utils.Array<IFocus> hits)

If we render the model, we set up a sphere at the object's position with its radius and check for intersections with the ray

Specified by:

addHit in interface IFocus

Overrides:

addHit in class CelestialBody

Parameters:

screenX - The x position of the hit.

screenY - The y position of the hit.

w - The viewport width.

h - The viewport height.

minPixDist - The minimum pixel distance to consider as hit.

camera - The camera.

hits - The list where to add the element.

addHit

public void addHit(Vector3d p0,
 Vector3d p1,
 NaturalCamera camera,
 com.badlogic.gdx.utils.Array<IFocus> hits)

Description copied from interface: IFocus

Adds this focus to the hits list if it is hit by the given ray.

Specified by:

addHit in interface IFocus

Overrides:

addHit in class CelestialBody

Parameters:

p0 - Start point of the ray.

p1 - End point of the ray.

camera - The camera.

hits - The list where the focus is to be added.

getSize

public double getSize()

Description copied from class: SceneGraphNode

Returns the size (diameter) of this entity in internal units.

Specified by:

getSize in interface IFocus

Overrides:

getSize in class SceneGraphNode

Returns:

The size in internal units.

getRadius

public double getRadius()

Description copied from class: SceneGraphNode

Returns the radius in internal units

Specified by:

getRadius in interface IFocus

Overrides:

getRadius in class SceneGraphNode

Returns:

The radius of the object, in internal units

isShadow

public boolean isShadow()

Whether shadows should be rendered for this object

Returns:

Whether shadows should be rendered for this object

setShadowvalues

public void setShadowvalues(double[] shadowMapValues)

Sets the shadow mapping values for this object

Parameters:

shadowMapValues - The values

setSizescalefactor

public void setSizescalefactor(Double sizescalefactor)

setRefplane

public void setRefplane(String refplane)

setSeed

public void setSeed(Long seed)

setSeed

public void setSeed(int[] seed)

setRandomize

public void setRandomize(String[] randomize)

setRandomize

public void setRandomize(String randomize)

isRandomizeModel

protected boolean isRandomizeModel()

getSeed

protected long getSeed(String component)

Gets the seed corresponding to the given component by matching it using the position in the randomize vector.

Parameters:

component - The component name.

Returns:

The seed.

isRandomizeAtmosphere

protected boolean isRandomizeAtmosphere()

isRandomizeCloud

protected boolean isRandomizeCloud()

getModelComponent

public ModelComponent getModelComponent()

getMaterialComponent

public MaterialComponent getMaterialComponent()