DJI Mobile SDK Documentation

      class DJIGimbalRotation

      @interface DJIGimbalRotation : NSObject
      Header:DJIGimbalBaseTypes.h
      Inherits From:NSObject
      Description:

      Represents a gimbal speed or angular rotation operation.

      Class Members:
      Rotation Mode
      property
      property mode
      @property (nonatomic, assign, readonly) DJIGimbalRotationMode mode
      Header:DJIGimbalBaseTypes.h
      Description:

      Type of gimbal rotation operation mode.

      See Also:

      DJIGimbalRotationMode

      Pitch Value
      property
      property pitch
      @property (nonatomic, strong, nullable, readonly) NSNumber *pitch
      Header:DJIGimbalBaseTypes.h
      Description:

      The pitch property of a gimbal rotation operation, how much the gimbal rotates on the pitch axis. When it is nil, no operation will be applied to the pitch axis.

      Roll Value
      property
      property roll
      @property (nonatomic, strong, nullable, readonly) NSNumber *roll
      Header:DJIGimbalBaseTypes.h
      Description:

      The roll property of a gimbal rotation operation, how much the gimbal rotates on the roll axis. When it is nil, no operation will be applied to the roll axis.

      Yaw Value
      property
      property yaw
      @property (nonatomic, strong, nullable, readonly) NSNumber *yaw
      Header:DJIGimbalBaseTypes.h
      Description:

      The yaw property of a gimbal rotation operation, how much the gimbal rotates on the yaw axis. When the rotation mode is DJIGimbalRotationModeAbsoluteAngle, the yaw value is relative to the aircraft's heading. When it is nil, no operation will be applied to the yaw axis.

      Time
      property
      property time
      @property (nonatomic, assign, readonly) NSTimeInterval time
      Header:DJIGimbalBaseTypes.h
      Description:

      The time of the gimbal speed rotation operation(unit: second). Does not take effect in waypoint mission.

      property
      property ignore
      @property (nonatomic, assign, readonly) BOOL ignore
      Header:DJIGimbalBaseTypes.h
      Description:

      True if the app can control the gimbal.

      class method gimbalRotationWithPitchValue:rollValue:yawValue:time:mode:ignore
      + (nonnull instancetype)gimbalRotationWithPitchValue:(nullable NSNumber *)pitchValue
      rollValue:(nullable NSNumber *)rollValue
      yawValue:(nullable NSNumber *)yawValue
      time:(NSTimeInterval)time
      mode:(DJIGimbalRotationMode)mode
      ignore:(BOOL)ignore
      Header:DJIGimbalBaseTypes.h
      Description:

      Constructor for DJIGimbalRotation.

      Input Parameters:
      nullable NSNumber * pitchValueNSNumber object of pitch value.
      nullable NSNumber * rollValueNSNumber object of roll value.
      nullable NSNumber * yawValueNSNumber object of yaw value.
      NSTimeInterval timeNSTimeInterval value of rotation time.
      DJIGimbalRotationMode modeAn enum value of DJIGimbalRotationMode.
      BOOL ignoreYES if the app can control the gimbal.
      Return:
      nonnull instancetypeInstance of DJIGimbalRotation.
      enum DJIGimbalRotationMode
      typedef NS_ENUM(NSInteger, DJIGimbalRotationMode)
      Header:DJIGimbalBaseTypes.h
      Description:

      The mode of the gimbal rotation operation.

      Enum Members:
      DJIGimbalRotationModeRelativeAngleThe angle value, when the gimbal is rotating, relative to the current angle.
      DJIGimbalRotationModeAbsoluteAngleThe angle value, when the gimbal is rotating, relative to 0 degrees (aircraft heading).
      For Inspire 1, using X3, X3 Zoom and Z3 cameras will be relative to true north. Using X5, XT and X5R will be relative to the aircraft heading.
      For Inspire 2, using X4S and X5S cameras will be relative to true north. Using X7 and Z30 will be relative to the aircraft heading.
      For Matrice 300 RTK with H20 series and Zenmuse P1 camera, the angle rotation is relative to the aircraft heading if you rotate the gimbal directly. The angle rotation is relative to true North if you use it in WaypointV2MissionAction.
      DJIGimbalRotationModeSpeedRotate the gimbal's pitch, roll, and yaw in SPEED Mode. The direction can either be set to clockwise or counter-clockwise.
      For Phantom 3 Professional, Phantom 3 Advanced and Phantom 3 Standard, roll and yaw rotations are not available.
      For Inspire 1, Inspire Pro and M100, pitch, roll and yaw rotations are available.
      For Osmo, roll rotation is not available. The yaw angleVelocity of DJIGimbalSpeedRotation range is (-120, 120).