DJI Mobile SDK Documentation

      class ExposureSettings

      @EXClassNullAway
      class ExposureSettings
      Package:dji.common.camera
      SDK Key:CameraKey.EXPOSURE_SETTINGS
      Description:

      This class contains current values for some camera parameters related to exposure, which determines how sensitive the picture is to light and depends on the balance of the ISO value, the shutter speed, and the aperture value. When the camera is in different exposure modes, different parameters are automatically changed by the camera to either get the correct exposure (in Program, Shutter Priority and Aperture Priority modes), or report back the current exposure (in Manual mode). The current values of these parameters used by the camera are contained in this class.

      Class Members:
      Aperture
      method
      method getAperture
      Aperture getAperture()
      Package:dji.common.camera
      Description:

      Returns the current aperture value being used by the camera. A larger aperture results in a higher exposure and shallower depth of field. For cameras that do not support adjustable aperture (e.g. Zenmuse X3), the real aperture value is fixed.

      Return:
      ApertureThe enum value of Aperture
      ShutterSpeed
      method
      method getShutterSpeed
      ShutterSpeed getShutterSpeed()
      Package:dji.common.camera
      Description:

      Returns the current shutter speed being used by the camera. A slower shutter speed results in a higher exposure, but more blurring in areas of the scene that are moving.

      Return:
      ShutterSpeedThe enum value of ShutterSpeed
      ISO
      method
      method getISO
      int getISO()
      Package:dji.common.camera
      Description:

      Returns the current ISO value being used by the camera. ISO defines the number of the ISO values separated by one exposure stop. However, when the ISO is in automatic mode, the camera can select ISO values less than one stop apart, and therefore this property is the actual ISO value being used by the camera. A higher ISO results in a higher exposure, and more noise in the resulting image.

      Return:
      intThe enum value of ISO
      Exposure Compensation
      method
      method getExposureCompensation
      ExposureCompensation getExposureCompensation()
      Package:dji.common.camera
      Description:

      Returns the camera's current exposure compensation. In Program, Aperture Priority and Shutter Priority modes, the exposure compensation value changes the exposure target the camera is using to calculate correct exposure and is set by the user. For example, Aperture Priority mode indicates that the priority is to maintain the aperture setting and adjusting the exposure by varying the ISO and shutter speed. In Manual mode, this value is reported from the camera and reports how much the exposure needs to be compensated for to get to what the camera thinks is the correct exposure. In Manual mode, the range of exposure compensation reported by the camera is -2.0 EV to 2.0 EV. In Program, Aperture Priority and Shutter Priority modes, the range of exposure compensation is -3.0 EV to + 3.0 EV. For the Z30 camera in manual mode, exposureCompensation is not used and the value is always 'DJICameraExposureCompensationN00'.

      Return:
      ExposureCompensationThe enum value of ExposureCompensation
      interface
      interface Callback
      interface Callback
      Package:dji.common.camera
      SDK Key:CameraKey.EXPOSURE_SETTINGS
      Description:

      Called whenever the camera parameters change. In automatic exposure modes (Program, Shutter Priority and Aperture Priority) the camera may be automatically changing aperture, shutter speed and ISO (depending on the mode and camera) when lighting conditions change. In Manual mode, the exposure compensation is automatically updated to let the user know how much compensation the exposure needs to get to an exposure the camera calculates as correct.

      Interface Methods:

      Callback Method

      State
      method
      method onUpdate
      void onUpdate(@NonNull ExposureSettings values)
      Package:dji.common.camera
      SDK Key:CameraKey.EXPOSURE_SETTINGS
      Description:

      Called whenever the camera parameters change. In automatic exposure modes (Program, Shutter Priority and Aperture Priority) the camera may be automatically changing aperture, shutter speed and ISO (depending on the mode and camera) when lighting conditions change. In Manual mode, the exposure compensation is automatically updated to let the user know how much compensation the exposure needs to get to an exposure the camera calculates as correct.

      Input Parameters:
      @NonNull ExposureSettings valuesThe updated values for parameters.