Class Proximity.NearbyRecord
java.lang.Object
gaiasky.util.camera.Proximity.NearbyRecord
- All Implemented Interfaces:
IFocus
- Enclosing class:
Proximity
-
Field Summary
Fields -
Constructor Summary
Constructors -
Method Summary
Modifier and TypeMethodDescriptionvoidaddEntityHitCoordinate(int screenX, int screenY, int w, int h, int pixelDist, NaturalCamera camera, com.badlogic.gdx.utils.Array<com.badlogic.ashley.core.Entity> hits) Add this focus to the hits list if it is hit by the [screenX, screenY] position.voidaddEntityHitRay(Vector3D p0, Vector3D p1, NaturalCamera camera, com.badlogic.gdx.utils.Array<com.badlogic.ashley.core.Entity> hits) floatGet the absolute magnitude.Return the absolute position of this entity in the native coordinates (equatorial system).getAbsolutePosition(String name, Vector3Q out) Return the absolute position of the entity identified by name within this entity in the native reference system.doublegetAlpha()Return the right ascension angle of this focus object.floatGet the apparent magnitude.longReturn the id of the focus candidate of this object.Return the name of the focus candidate of this object.doubleReturn the candidate apparent view angle (view angle corrected with the field of view) of this entity, in radians.Same asIFocus.getAbsolutePosition(Vector3Q).doubleSame asIFocus.getDistToCamera().Gets the name of the closest object, localized.Same asIFocus.getName().float[]getColor()Gets the color of this object.getCt()Return the component types of this focus.doublegetDelta()Return the declination angle of this focus object.doubleReturn the current distance to the camera in internal units.doublegetElevationAt(Vector3Q camPos) Return the surface elevation 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).doublegetElevationAt(Vector3Q camPos, boolean useFuturePosition) Same asIFocus.getElevationAt(Vector3Q)but with the option to use the future position of the body instead of the current one.doublegetElevationAt(Vector3Q camPos, Vector3Q nextPos) Same asIFocus.getElevationAt(Vector3Q)but with the option to use the given future position of the body instead of the current one.com.badlogic.ashley.core.EntityGets the first ancestor of this node that is a star.Prepare the candidate with the given name.doubleReturn the height scale of this focus, or 0 if it has no height info.longgetId()Return the unique id of this focus.Return the localized name of this focus.doublegetLogG()doublegetMh()getName()Return the first name of this focus.String[]getNames()Return all names of this focus.Get the octant this focus belongs to, if any.Return the orientation matrix of this focus.Return the orientation quaternion of this focus.getPos()Return the position.Gets the position in equatorial spherical coordinates.getPredictedPosition(Vector3Q aux, double deltaTime) Gets the position of this entity at the given delta time in the future in the internal reference system.getPredictedPosition(Vector3Q aux, ITimeFrameProvider time, ICamera camera, boolean force) Gets the position of this entity in the next time step in the internal reference system using the given time provider and the given camera.doubleReturn the radius of this focus object in internal units.Return the rotation component of this focus.intGet the depth of this focus object in the scene graph.doublegetSize()Return the size (diameter) of this entity in internal units.doubleReturn the current view angle of this entity, in radians.doubleReturn the current apparent view angle (view angle corrected with the field of view) of this entity, in radians.doublegetTEff()booleanhasId()Return whether the curent focus has a valid identifier number.booleanChecks whether the focus has the given name.booleanChecks whether the focus has the given name.booleanCheck whether this focus has camera collisions enabled.booleanCheck whether this focus is within its valid time range, so that it can be used as a focus.booleanisCopy()Check whether this is a copy or not.booleanisEmpty()Whether this focus object actually contains a focus.booleanCheck whether this focus is actually focusable.booleanReturn whether this focus object is active or not.booleanIs the label of the entity forced to display?booleanisForceLabel(String name) booleanisOther()booleanIs the label of the entity rendered?booleanisRenderLabel(String name) booleanisStar()booleanbooleanbooleanisValid()Whether this contains a valid focus object.voidHook that runs when the candidate is actually made focus.
-
Field Details
-
distToCamera
public double distToCamera -
size
public double size -
radius
public double radius -
pos
-
pm
-
absolutePos
-
col
public float[] col -
name
-
type
public byte type -
index
public int index
-
-
Constructor Details
-
NearbyRecord
public NearbyRecord()
-
-
Method Details
-
isStar
public boolean isStar() -
isStarGroup
public boolean isStarGroup() -
isOther
public boolean isOther() -
isUndefined
public boolean isUndefined() -
isEmpty
-
isValid
public boolean isValid()Description copied from interface:IFocusWhether this contains a valid focus object. This returns true in the case of focus views, and only when the focus view is correctly set up and initialized with a valid entity. -
getId
-
getCandidateId
public long getCandidateId()Description copied from interface:IFocusReturn the id of the focus candidate of this object. Defaults toIFocus.getId().- Specified by:
getCandidateIdin interfaceIFocus- Returns:
- The id of the candidate.
-
hasId
-
getLocalizedName
Description copied from interface:IFocusReturn the localized name of this focus. If it has no localized name, it returns the default name.- Specified by:
getLocalizedNamein interfaceIFocus- Returns:
- The localized name.
-
getName
-
getNames
-
hasName
-
hasName
Description copied from interface:IFocusChecks whether the focus has the given name. -
getClosestName
Description copied from interface:IFocusSame asIFocus.getName().- Specified by:
getClosestNamein interfaceIFocus- Returns:
- The name.
-
getClosestLocalizedName
Description copied from interface:IFocusGets the name of the closest object, localized.- Specified by:
getClosestLocalizedNamein interfaceIFocus- Returns:
- The localized name.
-
getCandidateName
Description copied from interface:IFocusReturn the name of the focus candidate of this object. Defaults toIFocus.getName().- Specified by:
getCandidateNamein interfaceIFocus- Returns:
- The name of the candidate.
-
getCt
Description copied from interface:IFocusReturn the component types of this focus. -
isFocusActive
public boolean isFocusActive()Description copied from interface:IFocusReturn whether this focus object is active or not. The active status determines whether the object can be focussed or not.- Specified by:
isFocusActivein interfaceIFocus- Returns:
- The active status.
-
getPos
-
getFirstStarAncestorEntity
public com.badlogic.ashley.core.Entity getFirstStarAncestorEntity()Description copied from interface:IFocusGets the first ancestor of this node that is a star.- Specified by:
getFirstStarAncestorEntityin interfaceIFocus- Returns:
- The first star ancestor.
-
getFirstStarAncestor
- Specified by:
getFirstStarAncestorin interfaceIFocus
-
getAbsolutePosition
Description copied from interface:IFocusReturn the absolute position of this entity in the native coordinates (equatorial system).- Specified by:
getAbsolutePositionin interfaceIFocus- Parameters:
out- The out vector.- Returns:
- The absolute position, same as aux.
-
getAbsolutePosition
Description copied from interface:IFocusReturn the absolute position of the entity identified by name within this entity in the native reference system.- Specified by:
getAbsolutePositionin interfaceIFocus- Parameters:
name- The name (lowercase) of the entity to get the position from (useful in case of star groups).out- Vector3D to put the return value.- Returns:
- The absolute position of the entity if it exists, null otherwise.
-
getClosestAbsolutePos
Description copied from interface:IFocusSame asIFocus.getAbsolutePosition(Vector3Q).- Specified by:
getClosestAbsolutePosin interfaceIFocus- Parameters:
out- Vector3D where to put the return value.- Returns:
- The absolute position, same as aux.
-
getPosSph
-
getPredictedPosition
public Vector3Q getPredictedPosition(Vector3Q aux, ITimeFrameProvider time, ICamera camera, boolean force) Description copied from interface:IFocusGets the position of this entity in the next time step in the internal reference system using the given time provider and the given camera.- Specified by:
getPredictedPositionin interfaceIFocus- Parameters:
aux- The out vector where the result will be stored.time- The time frame provider.camera- The camera.force- Whether to force the computation if time is off.- Returns:
- The aux vector for chaining.
-
getPredictedPosition
Description copied from interface:IFocusGets the position of this entity at the given delta time in the future in the internal reference system.- Specified by:
getPredictedPositionin interfaceIFocus- Parameters:
aux- The out vector where the result will be stored.deltaTime- Delta time in seconds.- Returns:
- The aux vector for chaining.
-
getDistToCamera
public double getDistToCamera()Description copied from interface:IFocusReturn the current distance to the camera in internal units.- Specified by:
getDistToCamerain interfaceIFocus- Returns:
- The current distance to the camera, in internal units.
-
getClosestDistToCamera
public double getClosestDistToCamera()Description copied from interface:IFocusSame asIFocus.getDistToCamera().- Specified by:
getClosestDistToCamerain interfaceIFocus- Returns:
- The distance to the camera in internal units.
-
getSolidAngle
public double getSolidAngle()Description copied from interface:IFocusReturn the current view angle of this entity, in radians.- Specified by:
getSolidAnglein interfaceIFocus- Returns:
- The view angle in radians.
-
getSolidAngleApparent
public double getSolidAngleApparent()Description copied from interface:IFocusReturn the current apparent view angle (view angle corrected with the field of view) of this entity, in radians.- Specified by:
getSolidAngleApparentin interfaceIFocus- Returns:
- The apparent view angle in radians.
-
getCandidateSolidAngleApparent
public double getCandidateSolidAngleApparent()Description copied from interface:IFocusReturn the candidate apparent view angle (view angle corrected with the field of view) of this entity, in radians.- Specified by:
getCandidateSolidAngleApparentin interfaceIFocus- Returns:
- The apparent view angle in radians.
-
getAlpha
-
getDelta
-
getSize
-
getRadius
-
getTEff
-
getLogG
-
getMh
-
getElevationAt
Description copied from interface:IFocusReturn the surface elevation 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:
getElevationAtin interfaceIFocus- Parameters:
camPos- The camera position.- Returns:
- The height of the projected position of the current camera.
-
getElevationAt
Description copied from interface:IFocusSame asIFocus.getElevationAt(Vector3Q)but with the option to use the future position of the body instead of the current one.- Specified by:
getElevationAtin interfaceIFocus- 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.
-
getElevationAt
Description copied from interface:IFocusSame asIFocus.getElevationAt(Vector3Q)but with the option to use the given future position of the body instead of the current one.- Specified by:
getElevationAtin interfaceIFocus- 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:IFocusReturn the height scale of this focus, or 0 if it has no height info.- Specified by:
getHeightScalein interfaceIFocus- Returns:
- The height scale in internal units.
-
getAppmag
-
getAbsmag
-
getOrientation
Description copied from interface:IFocusReturn the orientation matrix of this focus.- Specified by:
getOrientationin interfaceIFocus- Returns:
- The orientation matrix. Can be null.
-
getRotationComponent
Description copied from interface:IFocusReturn the rotation component of this focus.- Specified by:
getRotationComponentin interfaceIFocus- Returns:
- The rotation component. Can be null.
-
getOrientationQuaternion
Description copied from interface:IFocusReturn the orientation quaternion of this focus.- Specified by:
getOrientationQuaternionin interfaceIFocus- Returns:
- The orientation quaternion. Can be null.
-
addEntityHitCoordinate
public void addEntityHitCoordinate(int screenX, int screenY, int w, int h, int pixelDist, NaturalCamera camera, com.badlogic.gdx.utils.Array<com.badlogic.ashley.core.Entity> hits) Description copied from interface:IFocusAdd this focus to the hits list if it is hit by the [screenX, screenY] position.- Specified by:
addEntityHitCoordinatein interfaceIFocus- Parameters:
screenX- The x position of the hit.screenY- The y position of the hit.w- The viewport width.h- The viewport height.pixelDist- The minimum pixel distance to consider as hit.camera- The camera.hits- The list where to add the element.
-
addEntityHitRay
public void addEntityHitRay(Vector3D p0, Vector3D p1, NaturalCamera camera, com.badlogic.gdx.utils.Array<com.badlogic.ashley.core.Entity> hits) - Specified by:
addEntityHitRayin interfaceIFocus
-
makeFocus
-
getFocus
-
isCoordinatesTimeOverflow
public boolean isCoordinatesTimeOverflow()Description copied from interface:IFocusCheck whether this focus is within its valid time range, so that it can be used as a focus.- Specified by:
isCoordinatesTimeOverflowin interfaceIFocus- Returns:
- Whether the focus object is within its valid time range.
-
getSceneGraphDepth
public int getSceneGraphDepth()Description copied from interface:IFocusGet the depth of this focus object in the scene graph.- Specified by:
getSceneGraphDepthin interfaceIFocus- Returns:
- The depth of the scene graph.
-
getOctant
Description copied from interface:IFocusGet the octant this focus belongs to, if any. This will return null if this focus is not part of an octree. -
isCopy
-
isFocusable
public boolean isFocusable()Description copied from interface:IFocusCheck whether this focus is actually focusable. This checks the attribute 'focusable' of the Focus component.- Specified by:
isFocusablein interfaceIFocus- Returns:
- Whether the focus is focusable.
-
isCameraCollision
public boolean isCameraCollision()Description copied from interface:IFocusCheck whether this focus has camera collisions enabled.- Specified by:
isCameraCollisionin interfaceIFocus- Returns:
- Whether the focus has camera collisions enabled.
-
getColor
-
isForceLabel
public boolean isForceLabel()Description copied from interface:IFocusIs the label of the entity forced to display?- Specified by:
isForceLabelin interfaceIFocus- Returns:
- The force label property.
-
isForceLabel
- Specified by:
isForceLabelin interfaceIFocus
-
isRenderLabel
public boolean isRenderLabel()Description copied from interface:IFocusIs the label of the entity rendered?- Specified by:
isRenderLabelin interfaceIFocus- Returns:
- The render label property.
-
isRenderLabel
- Specified by:
isRenderLabelin interfaceIFocus
-