Difference between revisions of "API:Vessel"
From Kerbal Space Program Wiki
Leoshnoire (talk | contribs) (Added field definitions) |
Leoshnoire (talk | contribs) (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.
Contents
Vessel Class
| Inherits | Implements |
|---|---|
|
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() |
