Package gaiasky.scenegraph

Class Particle

java.lang.Object

gaiasky.scenegraph.SceneGraphNode

gaiasky.scenegraph.CelestialBody

gaiasky.scenegraph.Particle

All Implemented Interfaces:

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

Direct Known Subclasses:

Star

public class Particle
extends CelestialBody
implements IStarFocus, ILineRenderable

A single point particle.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
protected static class	Particle.ParamUpdater

Field Summary

Fields

Modifier and Type	Field	Description
byte	catalogSource	Source of this star: -1: Unknown 1: Gaia 2: Hipparcos (HYG) 3: Tycho
double	computedSize
protected static final float	DISC_FACTOR
protected static float	fovFactor
protected static float	innerRad
protected static Particle.ParamUpdater	paramUpdater
com.badlogic.gdx.math.Vector3	pm	Proper motion in cartesian coordinates [U/yr]
com.badlogic.gdx.math.Vector3	pmSph	MuAlpha [mas/yr], Mudelta [mas/yr], radvel [km/s]
protected static float	thdownOverFovfactor
protected static float	thpointTimesFovfactor
protected static float	thupOverFovfactor

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
Particle()
Particle(double thNone, double thPoint, double thQuad, float textScale, float labelFactor, float labelMax, float primitiveRenderScale, SceneGraphRenderer.RenderGroup bbRenderGroup)
Particle(Vector3b pos, float appmag, float absmag, float colorbv, String[] names, float ra, float dec, long starid)
Particle(Vector3b pos, float appmag, float absmag, float colorbv, String[] names, float ra, float dec, long starid, double thNone, double thPoint, double thQuad, float textScale, float labelFactor, float labelMax, float primitiveRenderScale, SceneGraphRenderer.RenderGroup bbRenderGroup)
Particle(Vector3b pos, float appmag, float absmag, float colorbv, String[] names, long starid)	Creates a new star.
Particle(Vector3b pos, com.badlogic.gdx.math.Vector3 pm, com.badlogic.gdx.math.Vector3 pmSph, float appmag, float absmag, float colorbv, String[] names, float ra, float dec, long starid)

Method Summary

Modifier and Type	Method	Description
protected boolean	addToRender(IRenderable renderable, SceneGraphRenderer.RenderGroup rg)	Adds the given renderable to the given render group list.
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.
protected boolean	checkHitCondition()
void	doneLoading(com.badlogic.gdx.assets.AssetManager manager)
protected void	forceUpdateLocalValues(ITimeFrameProvider time, boolean force)
int	getCatalogSource()	Gets the catalog source of this star.
Vector3b	getClosestAbsolutePos(Vector3b out)	Same as IFocus.getAbsolutePosition(Vector3b).
float[]	getClosestCol()	Returns the color of the closest star
double	getClosestDistToCamera()	Same as IFocus.getDistToCamera().
String	getClosestName()	Same as IFocus.getName().
Vector3d	getClosestPos(Vector3d out)	Returns the position of the closest star in camera coordinates
double	getClosestSize()	Returns the size of the closest star
float	getFuzzyRenderSize(ICamera camera)
int	getGlPrimitive()
int	getHip()	Returns the HIP number of this star, or negative if it has no HIP number
float	getInnerRad()
float	getLineWidth()
double	getMuAlpha()	Returns the mu alpha in mas/yr
double	getMuDelta()	Returns the mu delta in mas/yr
double	getRadialVelocity()	Returns the radial velocity in km/s
double	getRadius()	Returns the radius in internal units
<T extends SceneGraphNode> T	getSimpleCopy()	Gets a copy of this object but does not copy its parent or children.
int	getStarCount()
protected float	getThOverFactorScl()
void	initialize()
boolean	isStar()
float	labelSizeConcrete()
void	render(LineRenderSystem renderer, ICamera camera, float alpha)	Line renderer.
void	render(IntModelBatch modelBatch, float alpha, double t, RenderingContext rc, SceneGraphRenderer.RenderGroup group)	Model rendering
boolean	renderText()	Tells whether the text must be rendered or not for this entity
void	setBillboardRenderGroup(String bbRG)
protected void	setDerivedAttributes()
protected void	setRGB(float bv)	Sets the color
void	update(ITimeFrameProvider time, Vector3b parentTransform, ICamera camera)
void	update(ITimeFrameProvider time, Vector3b parentTransform, ICamera camera, float opacity)	Re-implementation of update method of CelestialBody and SceneGraphNode.
void	updateLocalValues(ITimeFrameProvider time, ICamera camera)	This function updates all the local values before the localTransform is updated.

Methods inherited from class gaiasky.scenegraph.CelestialBody

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

Methods inherited from class gaiasky.scenegraph.SceneGraphNode

add, add, addChild, addChild, addName, addNodes, addToIndex, computeFuturePosition, dispose, getAbsoluteOrientation, getAbsolutePosition, getAbsolutePosition, getAggregatedChildren, getAlpha, getChildByName, getChildByNameAndType, getChildrenByComponentType, getChildrenByType, getColor, getComponentType, getCoordinates, getCt, getDelta, getDescription, getDistToCamera, getFirstStarAncestor, getHeight, getHeight, getHeight, getHeightScale, getId, getLabelcolor, getLineCopy, getLocalizedName, getName, getNames, getNext, getNode, getNode, getOctant, getOpacity, getOrientation, getPos, getPosition, getPosition, getPosSph, getPredictedPosition, getRoot, getSceneGraphDepth, getSize, 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, updateLocal, updateLocalizedName, updateLocalizedNameRecursive

Methods inherited from class java.lang.Object

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

Methods inherited from interface gaiasky.scenegraph.IFocus

addHit, addHit, getAbsmag, getAbsolutePosition, getAbsolutePosition, getAlpha, getAppmag, getCandidateId, getCandidateName, getCandidateViewAngleApparent, getColor, getCt, getDelta, getDistToCamera, getFirstStarAncestor, getFocus, getHeight, getHeight, getHeight, getHeightScale, getLocalizedName, getName, getNames, getNext, getOctant, getOrientation, getOrientationQuaternion, getPos, getPosSph, getPredictedPosition, getRotationComponent, getSceneGraphDepth, getSize, getViewAngle, getViewAngleApparent, hasName, hasName, isActive, isCoordinatesTimeOverflow, isCopy, makeFocus

Methods inherited from interface gaiasky.render.IRenderable

getComponentType, getDistToCamera, getOpacity

Methods inherited from interface gaiasky.scenegraph.IStarFocus

getId

Field Details

DISC_FACTOR

protected static final float DISC_FACTOR

See Also:

• Constant Field Values

thpointTimesFovfactor

protected static float thpointTimesFovfactor

thupOverFovfactor

protected static float thupOverFovfactor

thdownOverFovfactor

protected static float thdownOverFovfactor

innerRad

protected static float innerRad

fovFactor

protected static float fovFactor

paramUpdater

protected static Particle.ParamUpdater paramUpdater

pm

public com.badlogic.gdx.math.Vector3 pm

Proper motion in cartesian coordinates [U/yr]

pmSph

public com.badlogic.gdx.math.Vector3 pmSph

MuAlpha [mas/yr], Mudelta [mas/yr], radvel [km/s]

catalogSource

public byte catalogSource

Source of this star:

• -1: Unknown
• 1: Gaia
• 2: Hipparcos (HYG)
• 3: Tycho

computedSize

public double computedSize

Constructor Details

Particle

public Particle()

Particle

public Particle(double thNone,
 double thPoint,
 double thQuad,
 float textScale,
 float labelFactor,
 float labelMax,
 float primitiveRenderScale,
 SceneGraphRenderer.RenderGroup bbRenderGroup)

Particle

public Particle(Vector3b pos,
 float appmag,
 float absmag,
 float colorbv,
 String[] names,
 float ra,
 float dec,
 long starid,
 double thNone,
 double thPoint,
 double thQuad,
 float textScale,
 float labelFactor,
 float labelMax,
 float primitiveRenderScale,
 SceneGraphRenderer.RenderGroup bbRenderGroup)

Particle

public Particle(Vector3b pos,
 float appmag,
 float absmag,
 float colorbv,
 String[] names,
 long starid)

Creates a new star.

Parameters:

pos - Cartesian position, in equatorial coordinates and in internal units.

appmag - Apparent magnitude.

absmag - Absolute magnitude.

colorbv - The B-V color index.

names - The labels or names.

starid - The star unique id.

Particle

public Particle(Vector3b pos,
 float appmag,
 float absmag,
 float colorbv,
 String[] names,
 float ra,
 float dec,
 long starid)

Particle

public Particle(Vector3b pos,
 com.badlogic.gdx.math.Vector3 pm,
 com.badlogic.gdx.math.Vector3 pmSph,
 float appmag,
 float absmag,
 float colorbv,
 String[] names,
 float ra,
 float dec,
 long starid)

Method Details

initialize

public void initialize()

Overrides:

initialize in class SceneGraphNode

setDerivedAttributes

protected void setDerivedAttributes()

update

public void update(ITimeFrameProvider time,
 Vector3b parentTransform,
 ICamera camera)

Overrides:

update in class SceneGraphNode

update

public void update(ITimeFrameProvider time,
 Vector3b parentTransform,
 ICamera camera,
 float opacity)

Re-implementation of update method of CelestialBody and SceneGraphNode.

Overrides:

update in class SceneGraphNode

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

addToRender

protected boolean addToRender(IRenderable renderable,
 SceneGraphRenderer.RenderGroup rg)

Description copied from class: SceneGraphNode

Adds the given renderable to the given render group list.

Overrides:

addToRender in class SceneGraphNode

Parameters:

renderable - The renderable to add.

rg - The render group that identifies the renderable list.

Returns:

True if added, false otherwise.

render

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

Model rendering

Specified by:

render in interface IModelRenderable

setRGB

protected void setRGB(float bv)

Sets the color

Parameters:

bv - B-V color index

getInnerRad

public float getInnerRad()

Specified by:

getInnerRad in class CelestialBody

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

isStar

public boolean isStar()

Overrides:

isStar in class CelestialBody

renderText

public boolean renderText()

Description copied from interface: I3DTextRenderable

Tells whether the text must be rendered or not for this entity

Specified by:

renderText in interface I3DTextRenderable

Overrides:

renderText in class CelestialBody

Returns:

True if text must be rendered

labelSizeConcrete

public float labelSizeConcrete()

Overrides:

labelSizeConcrete in class CelestialBody

getFuzzyRenderSize

public float getFuzzyRenderSize(ICamera camera)

Overrides:

getFuzzyRenderSize in class CelestialBody

doneLoading

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

Overrides:

doneLoading in class SceneGraphNode

updateLocalValues

public void updateLocalValues(ITimeFrameProvider time,
 ICamera camera)

Description copied from class: SceneGraphNode

This function updates all the local values before the localTransform is updated. Position, rotations and scale must be updated in here.

Overrides:

updateLocalValues in class SceneGraphNode

forceUpdateLocalValues

protected void forceUpdateLocalValues(ITimeFrameProvider time,
 boolean force)

getStarCount

public int getStarCount()

Specified by:

getStarCount in interface IStarContainer

Overrides:

getStarCount in class SceneGraphNode

getSimpleCopy

public <T extends SceneGraphNode> T getSimpleCopy()

Description copied from class: SceneGraphNode

Gets a copy of this object but does not copy its parent or children.

Overrides:

getSimpleCopy in class CelestialBody

Returns:

The copied object.

render

public void render(LineRenderSystem renderer,
 ICamera camera,
 float alpha)

Line renderer. Renders proper motions

Specified by:

render in interface ILineRenderable

getGlPrimitive

public int getGlPrimitive()

Specified by:

getGlPrimitive in interface ILineRenderable

getThOverFactorScl

protected float getThOverFactorScl()

checkHitCondition

protected boolean checkHitCondition()

Overrides:

checkHitCondition in class CelestialBody

getCatalogSource

public int getCatalogSource()

Description copied from interface: IStarFocus

Gets the catalog source of this star. Possible values are:

• -1: Unknown
• 1: Gaia
• 2: Hipparcos (HYG)
• 3: Tycho
• 4: Other

Specified by:

getCatalogSource in interface IStarFocus

Returns:

The catalog source number

getHip

public int getHip()

Description copied from interface: IStarFocus

Returns the HIP number of this star, or negative if it has no HIP number

Specified by:

getHip in interface IStarFocus

Returns:

The HIP number

getClosestDistToCamera

public double getClosestDistToCamera()

Description copied from interface: IFocus

Same as IFocus.getDistToCamera().

Specified by:

getClosestDistToCamera in interface IFocus

Specified by:

getClosestDistToCamera in interface IStarFocus

Overrides:

getClosestDistToCamera in class CelestialBody

Returns:

The distance to the camera in internal units.

getClosestName

public String getClosestName()

Description copied from interface: IFocus

Same as IFocus.getName().

Specified by:

getClosestName in interface IFocus

Specified by:

getClosestName in interface IStarFocus

Overrides:

getClosestName in class CelestialBody

Returns:

The name.

getClosestPos

public Vector3d getClosestPos(Vector3d out)

Description copied from interface: IStarFocus

Returns the position of the closest star in camera coordinates

Specified by:

getClosestPos in interface IStarFocus

Parameters:

out - The out vector

Returns:

The out vector with the position

getClosestAbsolutePos

public Vector3b getClosestAbsolutePos(Vector3b out)

Description copied from interface: IFocus

Same as IFocus.getAbsolutePosition(Vector3b).

Specified by:

getClosestAbsolutePos in interface IFocus

Specified by:

getClosestAbsolutePos in interface IStarFocus

Overrides:

getClosestAbsolutePos in class CelestialBody

Parameters:

out - Vector3d where to put the return value.

Returns:

The absolute position, same as aux.

getClosestCol

public float[] getClosestCol()

Description copied from interface: IStarFocus

Returns the color of the closest star

Specified by:

getClosestCol in interface IStarFocus

Returns:

The color in rgb

getClosestSize

public double getClosestSize()

Description copied from interface: IStarFocus

Returns the size of the closest star

Specified by:

getClosestSize in interface IStarFocus

Returns:

The size of the closest star

getMuAlpha

public double getMuAlpha()

Description copied from interface: IProperMotion

Returns the mu alpha in mas/yr

Specified by:

getMuAlpha in interface IProperMotion

Returns:

The mu alpha in mas/yr

getMuDelta

public double getMuDelta()

Description copied from interface: IProperMotion

Returns the mu delta in mas/yr

Specified by:

getMuDelta in interface IProperMotion

Returns:

The mu delta in mas/yr

getRadialVelocity

public double getRadialVelocity()

Description copied from interface: IProperMotion

Returns the radial velocity in km/s

Specified by:

getRadialVelocity in interface IProperMotion

Returns:

The radial velocity in km/s

getLineWidth

public float getLineWidth()

Specified by:

getLineWidth in interface ILineRenderable

setBillboardRenderGroup

public void setBillboardRenderGroup(String bbRG)