# Gimbal¶

Many engines in KSP have thrust vectoring gimbals which are handled by their own module

structure Gimbal
Suffix Type (units) Description
All suffixes of PartModule
LOCK Boolean Is the Gimbal locked in neutral position?
PITCH Boolean Does the Gimbal respond to pitch controls?
YAW Boolean Does the Gimbal respond to yaw controls?
ROLL Boolean Does the Gimbal respond to roll controls?
LIMIT Scalar (%) Percentage of the maximum range the Gimbal is allowed to travel
RANGE Scalar (deg) The Gimbal’s Possible Range of movement
RESPONSESPEED Scalar The Gimbal’s Possible Rate of travel
PITCHANGLE Scalar Current Gimbal Pitch
YAWANGLE Scalar Current Gimbal Yaw
ROLLANGLE Scalar Current Gimbal Roll

Note

Gimbal is a type of PartModule, and therefore can use all the suffixes of PartModule. Shown below are only the suffixes that are unique to Gimbal. Gimbal can be accessed as Engine:GIMBAL atribute of Engine.

Gimbal:LOCK
Type: Boolean Get/Set

Is this gimbal locked to neutral position and not responding to steering controls right now? When you set it to true it will snap the engine back to 0s for pitch, yaw and roll

Gimbal:PITCH
Type: Boolean Get/Set

Is the gimbal responding to pitch controls? Relevant only if the gimbal is not locked.

Gimbal:YAW
Type: Boolean Get/Set

Is the gimbal responding to yaw controls? Relevant only if the gimbal is not locked.

Gimbal:ROLL
Type: Boolean Get/Set

Is the gimbal responding to roll controls? Relevant only if the gimbal is not locked.

Gimbal:LIMIT
Type: Scalar (%) Get/Set

Percentage of maximum range this gimbal is allowed to travel

Gimbal:RANGE
Type: Scalar (deg) Get only

The maximum extent of travel possible for the gimbal along all 3 axis (Pitch, Yaw, Roll)

Gimbal:RESPONSESPEED
Type: Scalar Get only

A Measure of the rate of travel for the gimbal

Gimbal:PITCHANGLE
Type: Scalar Get only

The gimbals current pitch, has a range of -1 to 1. Will always be 0 when LOCK is true

Gimbal:YAWANGLE
Type: Scalar Get only

The gimbals current yaw, has a range of -1 to 1. Will always be 0 when LOCK is true

Gimbal:ROLLANGLE
Type: Scalar Get only

The gimbals current roll, has a range of -1 to 1. Will always be 0 when LOCK is true