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, LightBeam, 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	locThOverFactor	ThOverFactor for Locs
float	locVaMultiplier	Multiplier for Loc view angle
ModelComponent	mc	MODEL
String	refPlane	Name of the reference plane for this object.
String	refPlaneTransform	Name of the transformation to the reference plane
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
protected static double	TH_ANGLE_POINT
ITransform[]	transformations	TRANSFORMATIONS - are applied each cycle

Fields inherited from class gaiasky.scenegraph.CelestialBody

absmag, appmag, ccPale, ccTransit, colorbv, compalpha, coordinatesTimeOverflow, rc, TH_OVER_FACTOR, wikiname

Fields inherited from class gaiasky.scenegraph.SceneGraphNode

aux3b1, aux3b2, aux3b3, aux3b4, aux3d1, aux3d2, aux3d3, aux3d4, aux3f1, aux3f2, aux3f3, aux3f4, cc, children, computed, coordinates, copy, ct, distToCamera, id, lastStateChangeTimeMs, localTransform, namekey, names, numChildren, octant, octantId, opacity, orientation, parent, parentkey, parentName, pos, posSph, ROOT_NAME, sg, 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()
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
double	getSize()	Returns the size (diameter) of this entity in internal units.
protected float	getThOverFactor(ICamera camera)
protected float	getThOverFactorScl()
protected float	getViewAnglePow()
void	initialize()
boolean	isShadow()	Whether shadows should be rendered for this object
protected float	labelMax()
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	setLocvamultiplier(Double val)
void	setModel(ModelComponent mc)
void	setRefplane(String refplane)
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
double	THRESHOLD_POINT()	Angle limit for rendering as point.
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, labelFactor, makeFocus, render, renderText, setAbsmag, setAltname, setAppmag, setColor2Data, setColorbv, setMag, setRotation, setSize, setWikiname, text, textColour, textDepthBuffer, textPosition, textSize, THRESHOLD_NONE, THRESHOLD_QUAD

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, getCt, getDelta, getDescription, getDistToCamera, getFirstStarAncestor, getId, getLineCopy, getName, getNames, getNext, getNode, getNode, getOctant, getOpacity, getOrientation, getPos, getPosition, getPosition, getPosSph, getPredictedPosition, getRoot, getSceneGraphDepth, getStarCount, getUnrotatedPos, getVelocity, getViewAngleApparent, getVisibilityOpacityFactor, hasCt, hasName, hasName, insert, insert, isCopy, isInRender, isInRender, isVisibilityOn, isVisible, isVisible, isVisible, isVisibleGroup, msSinceStateChange, mustAddToIndex, mustUpdatePosition, namesConcat, removeChild, removeFromIndex, removeFromRender, render2DLabel, render2DLabel, render2DLabel, render2DLabel, render3DLabel, render3DLabel, returnToPool, setColor, setColor, setComputedFlag, setCoordinates, setCt, setCt, setDescription, setId, setLabelcolor, setLabelcolor, setName, setNamekey, setNames, setParent, setParentkey, setSize, setUp, setVisible, setVisible, setVisibleGroup, shouldRender, toString, update, update, updateLocalValues, updateNames, updateNamesRec

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, 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

TH_ANGLE_POINT

protected static final double TH_ANGLE_POINT

mc

public ModelComponent mc

MODEL

transformations

public ITransform[] transformations

TRANSFORMATIONS - are applied each cycle

locVaMultiplier

public float locVaMultiplier

Multiplier for Loc view angle

locThOverFactor

public float locThOverFactor

ThOverFactor for Locs

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

Constructor Details

ModelBody

public ModelBody()

Method Details

THRESHOLD_POINT

public double THRESHOLD_POINT()

Angle limit for rendering as point. If angle is any bigger, we render with shader.

Specified by:

THRESHOLD_POINT in class CelestialBody

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

labelMax

protected float labelMax()

Specified by:

labelMax in class CelestialBody

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

getThOverFactorScl

protected float getThOverFactorScl()

Overrides:

getThOverFactorScl in class CelestialBody

getThOverFactor

protected float getThOverFactor(ICamera camera)

Overrides:

getThOverFactor 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)

setLocthoverfactor

public void setLocthoverfactor(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)