DJI Mobile SDK Documentation

      class ThermalExternalSceneSettings

      @EXClassNullAway
      class ThermalExternalSceneSettings
      Package:dji.common.camera
      Description:

      Thermal cameras measure the apparent surface temperature of a given object. This is done by taking the amount of infrared radiation an object emits and calculating the surface temperature by applying a formula that adjusts for external factors. This struct includes all of the external scene parameters that the thermal camera firmware allows to be customized. There are two types of parameters, optical parameters which specify how much infrared radiation is transmitted from the surface to the thermal sensor, as well as parameters that specify sources of thermal radiance other than the object. For a more in-depth overview of the physics behind thermal imaging, see https://en.wikipedia.org/wiki/Thermography.

      Class Members:
      method getAtmosphericTemperature
      float getAtmosphericTemperature()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_ATMOSPHERIC_TEMPERATURE
      Description:

      Atmospheric temperature, can be between -50 and 327.67 degrees Celsius.

      Return:
      floatAtmospheric temperature
      method getAtmosphericTransmissionCoefficient
      float getAtmosphericTransmissionCoefficient()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_ATMOSPHERIC_TRANSMISSION_COEFFICIENT
      Description:

      Transmission coefficient of the atmosphere between the scene and the camera, can be between 50 and 100.

      Return:
      floatTransmission coefficient
      method getBackgroundTemperature
      float getBackgroundTemperature()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_BACKGROUND_TEMPERATURE
      Description:

      Background temperature (reflected by the scene), can be between -50 and 327.67 degrees Celsius.

      Return:
      floatBackground temperature
      method getSceneEmissivity
      float getSceneEmissivity()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_SCENE_EMISSIVITY
      Description:

      Emissivity of the scene, can be between 50 and 100.

      Return:
      floatEmissivity of the scene
      method getWindowReflection
      float getWindowReflection()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_WINDOW_REFLECTION
      Description:

      Window reflection, can be between 50 and 100-X where X is the window transmission coefficient parameter.

      Return:
      floatWindow reflection value.
      method getWindowReflectedTemperature
      float getWindowReflectedTemperature()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_WINDOW_REFLECTED_TEMPERATURE
      Description:

      Temperature reflected in the window, can be between -50 and 327.67 degrees Celsius.

      Return:
      floatTemperature reflected in window.
      method getWindowTemperature
      float getWindowTemperature()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_WINDOW_TEMPERATURE
      Description:

      Window temperature, can be between -50 and 327.67 degrees Celsius.

      Return:
      floatWindow temperature.
      method getWindowTransmissionCoefficient
      float getWindowTransmissionCoefficient()
      Package:dji.common.camera
      SDK Key:CameraKey.THERMAL_WINDOW_TRANSMISSION_COEFFICIENT
      Description:

      Transmission coefficient of the window, can be between 50 and 100-X where X is the window reflection.

      Return:
      floatWindow transmission coefficient.
      interface
      interface Callback
      interface Callback
      Package:dji.common.camera
      Description:

      This interface provides information about the external scene settings.

      Interface Methods:

      Callback Method

      State
      method
      method onUpdate
      void onUpdate(@NonNull ThermalExternalSceneSettings settings)
      Package:dji.common.camera
      Description:

      Called when updated external scene settings are available. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.

      Input Parameters:
      @NonNull ThermalExternalSceneSettings settingsThe ThermalExternalSceneSettings.