Difference between revisions of "API:Vessel"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Added field definitions)
(Added FlightCtrlState ctrlState field)
Line 168: Line 168:
 
|name=flightIntegrator
 
|name=flightIntegrator
 
|desc=
 
|desc=
 +
}}
 +
{{Field
 +
|type=FlightCtrlState
 +
|name=ctrlState
 +
|desc=The vessel's flight control state object, used for accessing and modifying user and fly-by-wire input.
 
}}
 
}}
 
{{Field
 
{{Field

Revision as of 20:16, 14 January 2014

A Vessel represents a ship, or a piece of debris that was once part of a ship. You can access the vessel that your Part is part of with this.vessel. Particularly useful members are vessel.orbit, which gives your orbit, and vessel.mainBody, which gives CelestialBody whose influence you are currently under.

Vessel Class

Inherits Implements
  • MonoBehaviour
  • IShipconstruct
  • ITargetable

Vessels define individual ships in flight. They work essentially as a header for the set of parts that make up the ship.

Properties

The following are public properties available in Vessel.

Signature Description
string landedAt { }
Part this { get; }
enum Situations { }
bool isCommandable { }
bool packed { }
bool LandedOrSplashed { get; set; }
ActionGroupList ActionGroups { }
Transform ReferenceTransform { get; } The reference transform is used to define the orientation of a vessel for controls and gauges. It defines which way is 'up' or 'forward' or which way pitch rotates, for instance. Read only. Use SetReferenceTransform to set. Defaults to vessel transform if no other transform is set.
double launchTime { }
bool HoldPhysics { }
PatchedConicSolver patchedConicSolver { get; }
Situations situation { }

Fields

The following is a list of publically-accessible fields in Vessel. This includes protected items, which can be accessed by subclasses.

Signature Description
double verticalSpeed The vertical speed of the vessel, relative to the surface of the reference body.
Vector3 rb_velocity The current velocity of the Unity physics rigidbody.
Quaternion srfRelRotation The Quaternion corresponding to the vessel's rotation, relative to the surface of reference body.
double staticPressure The current static pressure of the vessel, presumably in newtons per meter squared.
Vector3d acceleration The current acceleration vector of the vessel.
double geeForce The current magnitude of gravity, in meters per second squared.
int currentStage Current stage of the vessel.
ProtoVessel protoVessel
Vector3d obt_velocity The orbital velocity vector of the vessel, relative to the reference body.
Vector3d upAxis Vector corresponding to the vessel's up facing direction.
string vesselName Name identifier of the vessel.
double specificAcceleration Specific acceleration is the vessel's potential acceleration per unit of throttle. Used to estimate burn times and such. NOTE: this value is calculated based on smoothed acceleration, so it isn't completely accurate. It will also change as the vessel's mass is reduced as fuel burns away. (it does get pretty accurate after burning for a few seconds)
float heightFromTerrain The vessel's altitude above the reference body's terrain, not including liquid bodies.
OrbitDriver orbitDriver
FlightIntegrator flightIntegrator
FlightCtrlState ctrlState The vessel's flight control state object, used for accessing and modifying user and fly-by-wire input.
Vector3 terrainNormal The vector perpendicular to the terrain.
static float
double pqsAltitude
double terrainAltitude The height of the terrain, relative to the center of the reference body.
Vector3 angularVelocity The angular velocity vector of the vessel.
PatchedConicRenderer patchedConicRenderer
CelestialBody mainBody The reference body of the vessel.
bool isPersistent
OrbitTargeter orbitTargeter
float heightFromSurface The height above the surface of the reference body, including liquid bodies.
bool Landed True if the vessel has landed.
bool isEVA True if the vessel is an EVA kerbal.
bool HasActiveCrew True if the vessel has at least one crewmember and is active (focused).
Vector3d perturbation
double missionTime
Vector3 CoM The vector corresponding to the vessel's center of mass, relative to the vessel origin.
double longitude
Part rootPart The root part of the vessel.
Orbit orbit
bool loaded True if the vessel has loaded.
uint referenceTransformId
double latitude
bool isActiveVessel True if the vessel is the active vessel.
double altitude Height above the surface of the reference body, including liquid bodies.
State state
enum State
Vector3 localCoM This is used for persistence purposes. Use findLocalCenterOfMass() if you just want the center of mass.
Guid id Unique identifier for each vessel.

Methods

The following are methods included in Vessel.

Signature Description
static string GetMETString()
static string GetSituationString()
Vector3 findWorldCenterOfMass() Finds the world center of mass recursively from the given ship part.
bool checkSplashed()
void GoOffRails() puts the ship back into a simulated orbit and reenables physics
OrbitDriver GetOrbitDriver()
Vector3 GetObtVelocity()
void FallBackReferenceTransform()
void ClearStaging()
void DestroyVesselComponents()
void ResetCollisionIgnores()
Transform GetTransform()
void ChangeWorldVelocity() change the worldspace velocity of this vessel
float GetHeightFromTerrain()
string GetName()
void SpawnCrew()
float GetHeightFromSurface()
ProtoVessel BackupVessel()
void FeedInputFeed()
Vector3 GetSrfVelocity()
void ResumeStaging()
Orbit GetOrbit()
void SetPosition()
void printGroundContacts()
void SetWorldVelocity() set the absolute world velocity of this vessel
void SetRotation() Sets the worldspace rotation of this vessel, and all its parts
void DespawnCrew()
Vector3 findLocalCenterOfMass() Finds the local center of mass recursively from the given ship part.
void OnLoadFlightState()
int GetCrewCount()
void OnDestroy()
void OnSaveFlightState()
ClearToSaveStatus IsClearToSave()
Vector3 GetFwdVector()
void Translate()
Vector3d GetWorldPos3D() Get a double precision vector for the vessel's worldspace position (for when transform.position isn't accurate enough)
Vector3 findLocalCenterOfPressure()
void Unload()
void StartFromBackup() Start from backup is used when the scene is being resumed, and the Vessel component is added before the parts themselves. Note that this method won't load the parts. It only creates the vessel object. To load parts, use the Vessel.Load() method.
bool checkVisibility() Returns true if this vessel is within the visible range of any commandable (focusable) vessel, false otherwise.
int GetCrewCapacity()
float GetTotalMass() Get the sum of the mass of all (physical) parts on this vessel
Vessel GetVessel()
void Die()
Vector3 findLocalMOI()
void GoOnRails() disables physics and puts the ship into a propagated orbit
bool checkLanded()
void MakeInactive()
void SetReferenceTransform()
void printCollisions()
void MakeActive()
void Initialize() Initialize is used in cases where the Vessel component is added to a ship that already exists.
void SetPosition(Vector3 position) Sets the worldspace position of this vessel, and all its parts
void Load()