Difference between revisions of "Oolite JavaScript Reference: Entity"

From Elite Wiki
m (Formatting; trailing junk; categories.)
m (The things I intended to do in the previous edit. Bah.)
Line 55: Line 55:
 
=== <code>maxEnergy</code> ===
 
=== <code>maxEnergy</code> ===
 
  maxEnergy [read-only double]
 
  maxEnergy [read-only double]
The highest permissible value of [[#energy|energy]].
+
The highest permissible value of <code>[[#energy|energy]]</code>.
 
 
<code>entity.speed()</code> is equivalent to <code>entity.[[#velocity|velocity]]().[[Oolite/Development/Scripting/Class/Vector#magnitude|magnitude]]()</code>.
 
  
  
 
[[Category:Oolite scripting]] [[Category:Oolite Development]]
 
[[Category:Oolite scripting]] [[Category:Oolite Development]]

Revision as of 13:27, 6 April 2007

The Entity class represents an object in the game universe – Vessels, Stations and CelestialBodys are common types of entity. Note that these more specific types have additional properties and methods.

Universal IDs

Every Entity has an unique universal ID. All Oolite-provided functions which take an Entity as an argument may also be passed an integer representing the Entity’s ID.

Properties

ID

ID [read-only integer]

The universal ID of the entity.

position

position [read-write Vector]

The position of the entity in system co-ordinates.

velocity

velocity [read-write Vector]

The velocity of the entity in system units (nominal metres) per second.

speed

speed [read-write double]

The speed of the entity in system units (nominal metres) per second.

entity.speed() is equivalent to entity.velocity().magnitude().

status

status [read-only string]

The current status of the entity (such as “STATUS_IN_FLIGHT” and “STATUS_BEING_SCOOPED”).

scanClass

scanClass [read-only string]

The current scan class of the entity (such as “CLASS_NEUTRAL” and “CLASS_CARGO”).

orientation

orientation [read-write Quaternion]

The spacial orientation of the entity.

heading

heading [read-only Vector]

The heading of the entity. This is equivalent to orientation, but ignoring the axial twist component (roll in the case of a ship).

mass

mass [read-only double]

The mass of the entity. Currently, this is directly proportional to the volume.

owner

owner [read-only Entity]

The entity which owns this one. In the case of a subentity, the entity to which it is attached. In the case of a defense ship, the station it belongs to. In the case of a missile, the ship that launched it. There may be other uses.

energy

energy [read-write double]

The entity’s total energy; ranges from 0 to maxEnergy.

maxEnergy

maxEnergy [read-only double]

The highest permissible value of energy.