This class contains the media manager and playback manager, which manage the camera's media content. It provides methods to change camera settings and perform camera actions. This object is available from the DJIAircraft or DJIHandheld object, which is a subclass of DJIBaseProduct.
Sets the camera's work mode to taking pictures, video, playback or download. Please note that you cannot change the mode when a certain task is executing, such as taking photo(s), recording video, or downloading and saving files. Also supported by thermal imaging camera.
Camera starts to take photo with one of the camera capture modes (shoot photo modes).Also,
Precondition: 1. Camera must be in ShootPhoto mode. Check the enum named CameraShootPhotoMode in DJICameraSettingsDef to find all possible camera capture modes. For thermal imaging camera, Single photo can be taken while recording video. 2. The SD card state should be checked before this method is used to ensure sufficient space exists.
Post condition: If the capture mode is either Burst or Interval, calling stopShootPhoto will be required for the camera to stop taking photos.
Precondition: 1. startShootPhotoWithCompletion has been invoked and the shoot mode is either Interval or Time-lapse. 2. If the capture mode is set to Single, the camera will automatically stop taking the photo once the individual photo is taken.
Sets the camera's exposure mode. Check DJICameraExposureMode to view all possible camera exposure modes. Please note that in different exposure mode, it will have different values for the same setting. For Mavic 2 Enterprise Dual, the exposure mode is always DJICameraExposureModeProgram.
Sets the camera's ISO value. See DJICameraISO to view all possible ISO settings for the camera. For the X5, X5R, Phantom 4 Pro camera, X4S and X5S, the ISO value can be set for all modes. For the other cameras, the ISO value can only be set when the camera exposure mode is in Manual mode. See the setExposureMode:withCompletion method for how to set exposure mode. For Mavic 2 Enterprise Dual, the ISO value is always DJICameraISOAuto.
Sets the camera shutter speed. To see all available shutterSpeed value settings, see DJICameraShutterSpeed. The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate is 30fps, the shutterSpeed must be <= 1/30. Precondition: The shutter speed can be set only when the camera exposure mode is Shutter mode or Manual mode.
Shutter speed value to be set for the camera. For all available values shutterSpeed can be set to, please check DJICameraShutterSpeed. <br> The shutter speed should not be set slower than the video frame rate when the camera's mode is DJICameraModeRecordVideo. For example, if the video frame rate = 30fps, then the shutterSpeed must be <= 1/30.
Determines whether the camera supports an adjustable aperture. Currently adjustable aperture is supported only by the X5, X5R, X4S, X5S cameras and Mavic 2 Pro.
Sets the spot metering area index. The camera image is divided into 96 spots defined by 12 columns and 8 rows. The row index range is [0,7], where the values increase top to bottom across the image. The column index range is [0, 11], where the values increase left to right. In order to make the method work, The camera exposure mode should be Program, Shutter or Aperture, the exposure metering mode must be DJICameraMeteringModeSpot, and setAELock:withCompletion must be NO.
Input Parameters:
uint8_t rowIndex
Spot metering row index to be set. The value should falls in [0, 7], where the values increase top to bottom across the image.
uint8_t columnIndex
Spot metering column index to be set. The value should falls in [0, 11], where the values increase left to right.
Sets the camera's exposure compensation. See DJICameraExposureCompensation to view all possible exposure compensations to which the camera can be set. In order to use this function, set the camera exposure mode to shutter, program or aperture.
Enables/disables auto-unlocking of AE lock after shooting a photo. If it is enabled, the Auto Exposure will unlock after each shot. If disabled, Auto Exposure will change when calling setAELock:withCompletion. It is only supported X4S, X5S and Phantom 4 Pro cameras. For the other products, auto-unlocking is always enabled.
Gets details of the installed lens. Supported only by the X5, X5R, X5S and X7 cameras. This is available only when isInterchangeableLensSupported returns YES.
Check if the current device supports digital zoom scale. It is supported by Osmo with X3 camera, Phantom 4 camera, Z3 camera, Mavic Pro camera and Z30 camera.
Gets current digital zoom. It is supported by Osmo with X3 camera, Phantom 4 camera, Z3 camera, Mavic Pro camera and Z30 camera. Note Z30 cannot set the digital zoom scale, but will use digital zoom when using startContinuousOpticalZoomInDirection:withSpeed:withCompletion and the optical zoom has reached its limit.
Check if camera supports optical zoom. It is only supported by X5, X5R and X5S camera with the Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ lens, Z3 camera and Z30 camera. @return YES if camera supports optical zoom.
Gets the specification of the zoom lens. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera and Z30 camera.
Sets focal length of the zoom lens. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, X5S camera with Panasonic Lumix 14-42mm/3.5-5.6 HD or Olympus M.Zuiko 9-18mm/4.0-5.6, Z3 camera and Z30 camera.
Gets zoom lens focal length in units of 0.1mm. It is only supported by X5, X5R and X5S camera with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera and Z30 camera.
Start changing the focal length of the lens in specified direction with specified speed. Focal length change (zooming) will halt when maximum or minimum focal lengths are reached, or stopContinuousOpticalZoomWithCompletion is called. It is only supported by X5, X5R and X5S camera on Osmo with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera and Z30 camera.
Called to stop focal length changing, when it currently is from calling startContinuousOpticalZoomInDirection:withSpeed:withCompletion. It is only supported by X5, X5R and X5S camera on Osmo with lens Olympus M.Zuiko ED 14-42mm f/3.5-5.6 EZ, Z3 camera and Z30 camera.
TapZoom uses a multiplier to change the zoom scale when called. The final zoom scale for a TapZoom will be: Current Zoom Scale x Multiplier. The multiplier range is [1,5]. A multiplier of 1 will not change the zoom. When the multiplier is 1, the zoom scale will not change during TapZoom. It is only supported by Z30 camera.
TapZoom at the target. It can be called only when TapZoom is enabled. When a new target is set, the gimbal will rotate and locate the target in the center of the screen. At the same time, the camera will zoom by multiplying the TapZoom multiplier. It is only supported Z30 camera.
Input Parameters:
CGPoint target
The target to zoom. The range for x and y is from 0.0 to 1.0. The point [0.0, 0.0] represents the top-left corner of the screen.
Determines whether the camera supports an adjustable focal point. Currently, the adjustable focal point is supported by the X5, X5R, Z3, Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and and Mavic 2 Enterprise Camera.
Sets the lens focus mode. See DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported by the X5, X5R, Z3 cameras (Z3 camera can only support DJICameraFocusModeAuto), the Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Gets the lens focus mode. Please check DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera, Z30, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Sets the lens focus target point. When the focus mode is auto, the target point is the focal point. When the focus mode is manual, the target point is the zoom out area if the focus assistant is enabled for the manual mode. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera, Phantom 4 Pro camera, Mavic 2 Pro, Mavic 2 Zoom Camera, Mavic 2 Enterprise Camera, X4S and X5S. camera, X4S and X5S.
Input Parameters:
CGPoint focusTarget
The focus target to set. The range for x and y is from 0.0 to 1.0. The point [0.0, 0.0] represents the top-left angle of the screen.
Gets the lens focus target point. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Mavic Pro camera and Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Used to enable/disable the lens focus assistant. When the focus assistant is enabled, the camera live view will digitally zoom into the focus target area so the user can see the quality of focus. Focus assistant can be used for both manual focus (MF) and auto focus (AF). It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3, Phantom 4 Pro camera, X4S and X5S. Because Z3 only supports AF mode, isEnabledMF will be ignored.
Determines whether the lens focus assistant is enabled. When the focus assistant is enabled, the camera live view will digitally zoom into the focus target area so the user can see the quality of focus. Focus assistant can be used for both manual focus (MF) and auto focus (AF). It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro, X4s and X5S.
Gets the lens focusing ring value's max value. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro camera, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Set the focal distance by simulating the focus ring adjustment. Value can have a range of 0, getFocusRingValueUpperBoundWithCompletion], which represents infinity and the closest possible focal distance. It is available only when isAdjustableFocalPointSupported returns YES. For some lenses, the minimum focus ring value is larger than 0. For example the minimum of DJI MFT 15mm f/1.7 ASPH is 270. To retrieve the minimum value, perform the following steps: - Call setFocusMode:withCompletion with DJICameraFocusModeAuto. - Call setFocusTarget:withCompletion with the furthest target (>30m). - Call getFocusRingValueWithCompletion to get the current focus ring value. This is the minimum value. The maximum value can be retrieved using getFocusRingValueUpperBoundWithCompletion. Supported only by X5, X5R, Z3 cameras, Phantom 4 Pro, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera and Mavic 2 Enterprise Camera.
Input Parameters:
NSUInteger value
Value to adjust focus ring to. The minimum value is 0, the maximum value depends on the installed lens. Please use method getFocusRingValueUpperBoundWithCompletion to ensure the input argument is valid.
Gets the lens focus ring value. It is available only when isAdjustableFocalPointSupported returns YES. Supported only by the X5, X5R, Z3 cameras, Phantom 4 Pro, X4S, X5S, Mavic 2 Pro, Mavic 2 Zoom Camera, Mavic 2 Enterprise Camera.
Sets the camera's photo file format. See DJICameraPhotoFileFormat to view all possible photo formats to which the camera can be set. Also supported by thermal imaging camera. Not supported by Z30 camera and Mavic 2 Enterprise Dual as the photo file format for Z30 is always DJICameraPhotoFileFormatJPEG.
Sets the burst shoot count for the camera when the user wants to use that feature. Check DJICameraPhotoBurstCount to view all possible burst count values to which the camera can be set.
Sets the RAW image burst shoot count for the camera when the user wants to use that feature. See DJICameraPhotoBurstCount to view all possible burst count values to which the camera can be set. It is only supported Inspire 2.
Sets the interval shoot parameters. The camera will capture a photo, wait a specified interval of time, take another photo, and continue in this manner until it has taken the required number of photos. Also supported by thermal imaging camera.
Change the original image configuration when shooting panorama photos. CAUTION: enabling this may consume 500 MB in the SD card or the internal storage for each panorama. It is supported by Mavic Air and Mavic 2. For Mavic Air, format is not used and it will ignore the value.
Gets the configuration, which determines the behavior for the original images when shooting panorama photos. CAUTION: If this is enabled, it may consume 500 MB in the SD card or the internal storage for each panorama. It is supported by Mavic Air and Mavic 2. However, Mavic Air cannot change the format to save the original images. format will be ignored by Mavic Air.
Sets the camera's video resolution and frame rate. @warning The supported resolutions and frame rates for the two different analog television standards PAL and NTSC are below:
Sets the camera's analog video standard. Setting the video standard to PAL or NTSC will limit the available resolutions and frame rates to those compatible with the chosen video standard.
Enables recording position, time and camera information into a video caption file (.srt) saved on the SD card. The information is updated at 1Hz. Currently the .srt file can only be downloaded directly from the SD card.
Enables/disables the recording of RAW video. It is supported by X5S. User can use the other SSD interfaces only when it is enabled. For X5R, RAW recording is always enabled if there is SSD inserted.
Set Raw Video Resolution and Frame Rate of the SSD. Note, only raw video is saved to the SSD. Compressed video, compressed pictures and raw pictures are all saved to the SD Card. During video capture, Raw video and compressed video are saved simultaneously to the SSD and SD Card respectively. @warning The supported resolutions and frame rates for SSD Raw Videos are shown below:
For X5S, the frame rate of SSD has to be the same as the video to be stored in SD card, so frameRate is ignored. The possible resolutions are determined by SD card video's frame rate and the SSD video license (DJICameraSSDVideoLicense) being used. The supported resolutions in the current configuration can be queried by using SSDVideoResolutionRange in DJICameraCapabilities.
Gets the camera color for video that will store in SSD. This is the legacy version of SSD Color and it is only supported by Inspire 2 with firmware package versions (getFirmwarePackageVersionWithCompletion) lower than 01.0.0240. For newer firmware package versions, use getSSDColorWithCompletion instead.
Gets purchased license key(s). An Inspire 2 License Key activates the usage permission of CinemaDNG or Apple ProRes inside CineCore 2.0. User can purchase a license key on DJI's website. It is supported by Inspire 2. the digital filter for video that will store in SSD. It is only supported Inspire 2.
Sets the watermark configuration. Enables this to add timestamp and location stamp to the newly generated photos or videos. It is only supported by Mavic 2 Enterprise series. For Mavic 2 Enterprise Dual, the watermark is only applied to photos and videos generated by the visual camera.
Gets the watermark settings. If it is enabled, timestamp and location stamp will be added to the newly generated photos or videos. It is only supported by Mavic 2 Enterprise series. For Mavic 2 Enterprise Dual, the watermark is only applied to photos and videos generated by the visual camera.
Determines whether the SSD is supported by the camera. Currently, the SSD is supported only by X5R, X4S and X5S camera. @return YES if SSD is supported, otherwise NO.
Sets the camera's anti-flicker frequency for video recording. Precondition: The exposure mode must be Program. Note: for the Z30 camera, changing anti-flicker will reboot the camera before the setting takes effect.
Enables/disables the IR filter (infared filter). Disabling the IR filter can enhance the image in low light environments. Enabling the IR filter can reduce the color distortion caused by the infared light. It is only supported by Z30 camera.
Determines whether IR filter (infared filter) is enabled. Disabling the IR filter can enhance the image in low light environments. Enabling the IR filter can reduce the color distortion caused by the infared light. It is only supported by Z30 camera.
Enables vision stabilization for Z30 camera on M200 series. The vision system in the M200 series of aircraft can be used to compensate for any drift in the gimbal by analyzing the live view when there is no gimbal movement. Drift in the gimbal will be most noticeable at higher zoom factors. It is only supported Z30 on M200 series.
Custom information can be stored in media file's XMP meta data. The custom information is written to the media file automatically after the media file is created. This method defines the information to write. The same information will be written to all media files until the information is changed again by this method. Custom information written to each file can be retrieved through fetchCustomInformationWithCompletion or from the image itself when processed on a separate system. It is only supported Phantom 4 Pro, Phantom 4 Advanced, Phantom 4 Pro V2.0, Zenmuse X4S, Zenmuse X5S, Zenmuse X7, Mavic 2 Enterprise camera and Mavic 2 Enterprise Dual camera.
Input Parameters:
NSString * information
Custom information to set. Use UTF-8 encoding with a length equal to or less than 31 characters.
Custom information can be stored in media file's XMP meta data. This method retrieves the information that will be written to future media files. The information written to individual files can be retrieved through fetchCustomInformationWithCompletion. It is only supported Phantom 4 Pro, Phantom 4 Advanced, Phantom 4 Pro V2.0, Zenmuse X4S, Zenmuse X5S, Zenmuse X7, Mavic 2 Enterprise camera and Mavic 2 Enterprise Dual camera.
Determines whether the EI (exposure index) mode is supported by the camera. In this mode, the camera mimics the way a film camera works to help cinematographers capture as much information as possible while balancing the dynamic range and noise with different log curves. This mode only takes effect when the camera mode is in DJICameraModeRecordVideo. The EI mode is supported by X4S, X5S and X7.
Sets the exposure sensitivity mode. It is only supported when isEIModeSupported returns YES. It is supported by X4S, X5S and X7. For other cameras, only ISO mode is supported.
Gets the exposure sensitivity mode. It is only supported when isEIModeSupported returns YES. It is supported by X4S, X5S and X7. For other cameras, only ISO mode is supported.
Gets the EI value recommended by the camera. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Gets the valid range of EI values. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Input Parameters:
NSArray<NSNumber *> *_Nullable range
The valid range of EI values. Each element is an integer.
Sets the camera color for EI mode. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Gets the camera color for EI mode. It is only valid when exposure sensitivity mode is DJICameraExposureSensitivityModeEI. It is only supported by X4S, X5S and X7.
Determines whether the mechanical shutter speed is supported by the camera or the lens (for X7). The mechanical shutter is supported by Phantom 4 Pro camera, X4S and X7 with DL lenses.
Return:
BOOL
YES if the mechanical shutter is supported, otherwise NO.
Determines whether the ND filter mode is supported by the camera and the lens. Only the DL-S 16mm F2.8 ND ASPH lens for X7 has a built-in ND4 filter and supports changing the modes through an application.
Return:
BOOL
YES if the ND filter mode is supported, otherwise NO.
Sets the clip name for the video to be stored in SSD. The clip name will be applied to the next video file stored in SSD. After saving a video file, clipID will increase by 1 automatically. It is only supported by Inspire 2.
Determines whether the device supports the quick view. Quick view is the period of time a photo is shown as a preview after it is taken and before the camera returns to the live camera view.
Sets the camera's quick view duration. The valid range is [0, 10] seconds. When duration is 0, it means that the quick view is disabled. The default value is 0 second. Call isPhotoQuickViewSupported before using this method.
Enables HD (high-definition) live view. When it is enabled, the live view resolution is 1080p with frame rate 30 fps. The settings will only take effect when the camera is in record-video mode and the video resolution is either 1080p or 2.7k without slow-motion enabled. If recording video in 4k, then the live stream will be limited to 720p. Supported by Mavic Pro, Mavic 2 Pro, Mavic 2 Zoom and Phantom 4 Pro v2.0.
YES if 1080p live view is enabled. This will return the value of the setter, and not necessarily the actual live view resolution. For example, if recording in 4K and HD live view has previously been set, then this will return YES but the actual live view resolution will be 720p. Supported only by Mavic Pro, Mavic 2 Pro, Mavic 2 Zoom and Phantom 4 Pro V2.0.
Enables the automatic control of the front-arm LEDs. The camera can turn off the front-arm LEDs automatically when it shoots photos or records videos. The LEDs will be turned on after the shooting or recording is finished. Supported only by Mavic Pro, Mavic Air, and Mavic 2 series.
Input Parameters:
BOOL enabled
Enable the automatic control of the front-arm LEDs.
Determines if the camera supports the internal storage or not. When it is supported, the camera shoot photos or record videos without SD card. The newly generated photos or videos will be stored in the internal storage.
This method will turn off the camera's cooling fan whenever the camera is cool enough to do so. This allows better audio recording from the internal microphone in the camera.
Sets the Region of Interest (ROI). Used to manage color range distribution across the screen to maximize contrast for regions of highest interest. Supported only by thermal imaging cameras.
Sets the Palette. Each palette is a unique look-up table that maps 8-bit temperature values to different colors. Different palettes can be used to help the user better visualize temperature contrast or specific temperature bands. The valid range can be fetched from DJISupportedCameraThermalPaletteRange. Supported only by thermal imaging cameras.
Sets the scene to instantly enhance your image. In all modes except Manual and User modes, the DDE, ACE, SSO, brightness and contrast are set automatically to obtain the best result. In User modes, the contrast and brightness are set automatically to obtain the best results. Any settings that are made in these modes are retained if the scene is changed. In Manual mode, DDE, contrast and brightness are set manually. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Sets the Digital Data Enhancement index (for DDE dynamic mode). DDE can be used to enhance image details (sharpen, higher index) and/or suppress fixed pattern noise (soften, lower index). It can be set manually only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Input Parameters:
NSInteger value
Integer in range [-20, 100]. Values less than 0 soften the image and filter fixed pattern noise. Values greater than 0 sharpen the details in the image. Value of 0 results in no enhancement.
Gets the value of Digital Data Enhancement. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Set the value of Active Contrast Enhancement. Active contrast enhancement allows for a contrast trade-off between hotter and colder scenes when using 8-bit pixel data. It can be set manually only when the Scene mode is User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Input Parameters:
NSInteger value
Integer in range [-8, 8]. <br> value > 0: more contrast in hotter scene content and less contrast in colder scene content (sky, ocean etc.). <br> value < 0: more contrast in colder scene content and less contrast in hotter scene content. <br> value = 0: neutral <br> value = 3: recommended for generic use
Gets the value of Active Contrast Enhancement. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Sets the value of Smart Scene Optimization. When using non-linear histogram equalization to map the 14-bit sensor pixel values to 8-bit pixel values, it can become difficult to determine the difference in temperature of two objects from their different shades of gray. SSO allows a percentage of the 14-bit histogram to be mapped linearly to the 8-bit histogram, which will compromise local contrast, but allow for more accurate visual radiometric measurements. This is particularly useful for bi-modal scenes. It can be set manually only when the Scene mode is User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Gets the value of Smart Scene Optimization. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Sets the brightness of the image. It can be set manually only when the Scene mode is Manual. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Gets the value of brightness. The value is available only when the Scene mode is Manual, User1, User2 or User3. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Sets the value of contrast, with larger values having higher contrast. It can be set manually only when the Scene mode is Manual. Supported only by thermal imaging cameras.
Enable or disable Isotherms. Isotherms can be used to highlight specific temperature ranges: When disabled, all 256 values (8-bits) are dedicated to the temperature histogram of the scene. When enabled, only 128 values (0-127) are mapped linearly to temperature. Then three bands 128-175, 176-223 and 224-255 can be mapped to the user defined temperatures to highlight them to the user. Using some of the false color palettes (like RainbowIso) results in a thermal image that is grey scale except for three specific bands highlighted by either reds, blues or greens. Supported only by thermal imaging cameras.
Sets the unit of the Isotherm ranges to either Celsius or percent. Different units results in different value ranges for Isotherms. Supported only by thermal imaging cameras except Mavic 2 Enterprise Dual thermal camera. For Mavic 2 Enterprise Dual, the Isotherm unit is always DJICameraThermalIsothermUnitCelsius.
Gets the units for Isotherm ranges. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera. For Mavic 2 Enterprise Dual, the Isotherm unit is always DJICameraThermalIsothermUnitCelsius.
Sets the upper threshold value for Isotherm. All temperature values above this will use colors 224-255 from the palette. Supported only by thermal imaging cameras.
Input Parameters:
NSInteger value
If the unit is percentage, the allowed range is [0,100]. If the unit is Celsius, for Mavic 2 Enterprise Dual thermal camera, the value range is [-10, 400]. For other thermal imaging cameras, the value range is [-40, 500]. The value can only be equal or larger than middle Isotherm threshold.
Sets the middle threshold value for Isotherm. Temperature values between the middle and upper Isotherm threshold will be displayed with colors 176-223 from the palette. Supported only by thermal imaging cameras, except Mavic 2 Enterprise Dual thermal camera.
Input Parameters:
NSInteger value
If the unit is percentage, the value falls in [0,100]. If the unit is Celsius, the value range is [-40, 550]. The value can only be equal or larger than lower threshold and equal or smaller than upper threshold.
Sets the lower threshold value for Isotherm. Temperature values between the lower and middle Isotherm threshold will be displayed with colors 128-175 from the palette. Supported only by thermal imaging cameras.
Input Parameters:
NSInteger value
If the unit is percentage, the value falls in [0,100]. If the unit is Celsius, for Mavic 2 Enterprise Dual thermal camera, the value range is [-10, 400], for other thermal imaging cameras, the value range is [-40, 500]. The value can only be equal or smaller than upper threshold.
Sets the gain mode. Low gain mode can be used for scenes with temperatures ranging from -40 to 550 degrees Celsius. For higher contrast, the high gain mode can be used by for temperatures between -25 to 135 degrees Celsius for the 640x512 camera and -25 to 100 degrees Celsius for 324 x 256 camera. Mavic 2 Enterprise Dual has different temperature range from other thermal imaging cameras. Therefore, for Mavic 2 Enterprise Dual, the low gain mode can be used from -10 to 140 degrees Celsius. The high gain mode can be used from -10 to 400 degree Celsius. Supported by thermal imaging cameras.
For resolution 640 x 512, x1,x2,x4,x8 can be set. For resolution 336 x 256, only x1,x2,x4 can be set. Please refer to DJICameraThermalDigitalZoomScale in DJICameraSettingsDef.
Gets the thermal imaging camera profile. The profile includes information about resolution, frame rate and focal length. Supported only by thermal imaging cameras.
Sets the spot metering target point which then changes the camera:didUpdateTemperatureData delegate call to return. This method requires a relative point that is proportional to the dimension of the camera video dimension, the x, and y values must all be between 0 and 1.0. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities.
Gets the spot metering target point if one is set, if not then returns CGPointZero. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities.
Set the metering area for a rectangle inside the thermal image scene, which allows the camera to transmit aggregate temperature computations via the camera:didUpdateAreaTemperatureAggregations delegate method. See DJICameraThermalAreaTemperatureAggregations for the statistical values that are available. This method requires a relative rect that is proportional to the rect of the thermal scene, the x, y, width, and height values must all be between 0 and 1.0. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities.
Get a rect representing the currently set metering area for the thermal scene. Supported only by XT2, Mavic 2 Enterprise Dual and Zenmuse XT containing Advanced Radiometry capabilities.
Get the currently set flat-field correction (FFC) mode. Supported only by thermal imaging cameras with installed firmware version of 1.15.1.60 or higher. For Mavic 2 Enterprise Dual thermal camera, the DJICamera_DJICameraThermalFFCMode is always DJICamera_DJICameraThermalFFCMode_Auto.
Set the custom user profile. This profile represents user-set external scene parameters for the thermal scene. Supported only by thermal imaging cameras.
Get the currently set custom user profile. This profile represents user-set external scene parameters for the thermal scene. Supported only by thermal imaging cameras.
Set the transmission coefficient of the atmosphere between the scene and the camera. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
Input Parameters:
float coefficient
The desired atmospheric temperature, can be between 50 and 100.
Set the assumed temperature reflected by the background of the scene, can be between -50 and 327.67 degrees Celsius. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
Set assumed window reflection coefficient, can be between 0 and X where X is the window transmission coefficient parameter. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
Set the temperature reflected in the window, can be between -50 and 327.67 degrees Celsius. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
Set the window transmission coefficient, can be between 50 and 100-X where X is the window reflection. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
Sets the display mode to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and Mavic 2 Enterprise Dual Thermal Camera.
Gets the display mode. The display mode determine the way to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and Mavic 2 Enterprise Dual Thermal Camera.
Sets the level for MSX display mode. The range for level is [0, 100]. When it is 0, the visible spectrum definition is invisible. When it is 100, the visual spectrum definition is the most obvious. Only supported by XT2 camera.
Gets the level for MSX display mode. The range for level is [0, 100]. When it is 0, the visible spectrum definition is invisible. When it is 100, the visual spectrum definition is the most obvious. Only supported by XT2 camera.
Sets the vertical alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-8, 8]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window up. Use this setting to fine-tune the performance of MSX display mode and the align PIP mode. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Gets the vertical alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-8, 8]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window up. Only supported by XT2 camera and Mavic 2 Enterprise Dual camera.
Sets the horizontal alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-100, 100]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window to the right. Use this setting to fine-tune the performance of MSX display mode and the align PIP mode. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Gets the horizontal alignment offset between the video feeds from both the visual camera and the thermal camera. The alignment is applied to the MSX display mode. Different camera results in different value ranges. For XT2 camera, the valid range is [-100, 100]. For Mavic 2 Enterprise Dual, the valid range is [-40, 40]. Positive value will move the thermal window to the right. Only supported by XT2 camera and Mavic 2 Enterprise Dual.
Called when the camera's storage state has been updated. Use DJICameraStorageState's location to determine if the updated state is for SD card or the internal storage.
The camera storage state. If the camera supports internal storage (e.g. Mavic Air), use location to determine whether the state is for SD card or internal storage.
Called when there are new min, max, and average temperature values available for the set spot metering area. Supported only by Zenmuse XT containing Advanced Radiometry capabilities.
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.
Received temperature in degrees Celsius of image. The thermal imaging camera will only update the temperature if the temperature data is enabled. For the XT Standard version, the temperature measurement data is the average of the center four pixels of the image. For the XT Advanced Radiometry version, the temperature measurement point can be set using setThermalSpotMeteringTargetPoint:withCompletion.
Capture mode. In this mode, the user can capture pictures.
DJICameraModeRecordVideo
Record mode. In this mode, the user can record videos.
DJICameraModePlayback
Playback mode. In this mode, the user can preview photos and videos, and can delete files. It is supported by Phantom 3 Professional camera, X3, X5 and X5R cameras on aircraft and Phantom 4 camera. Playback mode is not supported by Z30, X5S, X4S, Phantom 4 Pro, Mavic Pro, Phantom 3 Standard, Phantom 3 Advanced, Phantom 3 4K and Osmo series.
DJICameraModeMediaDownload
In this mode, the user can download media to the Mobile Device. Not supported by X5 camera nor X5R camera while mounted on aircraft.
DJICameraModeBroadcast
In this mode, live stream resolution and frame rate will be 1080i50 (PAL) or 720p60 (NTSC). In this mode videos can be recorded. Still photos can also be taken only when video is recording. The only way to exit broadcast mode is to change modes to DJICameraModeRecordVideo. Only supported by Inspire 2.
Sets the camera to take an HDR photo. X5 camera, X5R camera, XT camera, Z30 camera, Phantom 4 Pro camera, X4S camera and X5S camera do not support HDR mode.
DJICameraShootPhotoModeBurst
Set the camera to take multiple photos at once. XT camera does not support Burst mode.
DJICameraShootPhotoModeAEB
Automatic Exposure Bracketing (AEB) capture. In this mode you can quickly take multiple shots (the default is 3) at different exposures without having to manually change any settings between frames. XT camera and Z30 camera does not support AEB mode.
DJICameraShootPhotoModeInterval
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The minimum interval for JPEG format of any quality is 2s. For all cameras except X4S, X5S and Phantom 4 Pro camera: The minimum interval for RAW or RAW+JPEG format is 10s. For the X4S, X5S and Phantom 4 Pro cameras the minimum interval for RAW or RAW+JPEG dformat is 5s.
DJICameraShootPhotoModeTimeLapse
Sets the camera to take a picture (or multiple pictures) continuously at a set time interval. The camera will merge the photo sequence and the output is a video. The minimum interval for Video only format is 1 s. The minimum interval for Video+Photo format is 2 s. For the new Osmo firmware version, no video feed will be received if the camera is shooting photos with Time-lapse mode. Instead, user can receive a sequence of preview images using the delegate method camera:didGenerateTimeLapsePreview. Supported only by Osmo camera (Z3 and X3).
DJICameraShootPhotoModePanorama
In panorama mode, the aircraft takes a series of photos with different gimbal and aircraft heading positions. The photos can be stitched with a third-party library. It is supported by Spark and Mavic Air.
DJICameraShootPhotoModeEHDR
Sets the camera to take an enhanced-HDR photo. It blends a sequence of photos for ghost-free high dynamic range photos. It is supported by Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeHyperLight
Sets the camera to take photos in HyperLight mode. It is a setting for low-light environment to enhance the photo quality while reducing noise significantly. It is supported by Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeCameraPanorama
In Camera Panorama mode, which is miss in Previous Version since Mavic 2 Zoom and Mavic 2 Pro.
DJICameraShootPhotoModeRAWBurst
Sets the camera to take a burst of RAW photos. Use rawPhotoBurstCount to check how many photos have been shot. Only supported by X5S.
DJICameraShootPhotoModeShallowFocus
Sets the camera to take a series of photos while the aircraft moves up and down automatically. The image's depth of field can be computed with a third-party library to produce a photo with the bokeh effect. Note: 1. It is only suitable for shooting still scenes. 2. The aircraft will ascend about 20cm before shooting. Ensure that there is no obstacle about the aircraft. 3. The suitable range of shooting is within 30m. It is only supported by Spark.
Camera exposure modes. The default value is DJICameraExposureModeProgram. The different exposure modes define whether Aperture, Shutter Speed, ISO can be set automatically or manually. Exposure compensation can be changed in all modes except Manual mode where it is not settable. X5, X5R, Phantom 4 Pro camera, X4S and X5S: Program Mode: Shutter: Auto Aperture: Auto ISO: Manual or Auto Shutter Priority: Shutter: Manual Aperture: Auto ISO: Manual or Auto Aperture Priority: Shutter: Auto Aperture: Manual ISO: Manual or Auto Manual Mode: Shutter: Manual Aperture: Manual ISO: Manual
All other cameras: Program Mode: Shutter: Auto Aperture: Fixed ISO: Auto Shutter Priority: Shutter: Manual Aperture: Fixed ISO: Auto Aperture Priority: NA Manual Mode: Shutter: Manual Aperture: Manual ISO: Manual
The ISO value is automatically set. This cannot be used for all cameras when in Manual mode.
DJICameraISO100
The ISO value is set to 100.
DJICameraISO200
The ISO value is set to 200.
DJICameraISO400
The ISO value is set to 400.
DJICameraISO800
The ISO value is set to 800.
DJICameraISO1600
The ISO value is set to 1600.
DJICameraISO3200
The ISO value is set to 3200.
DJICameraISO6400
The ISO value is set to 6400.
DJICameraISO12800
The ISO value is set to 12800.
DJICameraISO25600
The ISO value is set to 25600.
DJICameraISOFixed
ISO value is fixed by the camera firmware. When the camera color is set to DJICameraColorDLog, camera will fix the ISO to a specific value in order to optimize the performance. The value set by camera can be accessed from ISO.
Camera white balance. The default value is DJICameraWhiteBalanceAuto.
Enum Members:
DJICameraWhiteBalancePresetAuto
The camera's white balance is automatically set.
DJICameraWhiteBalancePresetSunny
The camera's white balance is set to sunny.
DJICameraWhiteBalancePresetCloudy
The camera's white balance is set to cloudy.
DJICameraWhiteBalancePresetWaterSurface
The camera's white balance is set to water surface.
DJICameraWhiteBalancePresetIndoorIncandescent
The camera's white balance is set to indoors and incandescent light.
DJICameraWhiteBalancePresetIndoorFluorescent
The camera's white balance is set to indoors and fluorescent light.
DJICameraWhiteBalancePresetCustom
The camera's white balance is set to custom color temperature. By using this white balance value, user can set a specific value for the color temperature.
DJICameraWhiteBalancePresetUnknown
The camera's white balance is unknown.
DJICameraWhiteBalancePresetNeutral
The camera's white balance is set to neutral. It is only supported by the X7.
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.
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.
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.
NSUInteger ISO
The current ISO value being used by the camera. DJICameraISO 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.
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'.
NSUInteger EI
The current EI (exposure index) value being used by the camera. The value is only valid when the exposure sensitivity mode is DJICameraExposureSensitivityModeEI.
Display modes to coordinate the video feeds from both the visual camera and the thermal camera. Only supported by XT2 camera and and Mavic 2 Enterprise Dual Camera.
Enum Members:
DJICameraDisplayModeVisualOnly
Displays only the video feed from the visual camera.
DJICameraDisplayModeThermalOnly
Displays only the video feed from the thermal camera.
DJICameraDisplayModePIP
Displays the video feed from the visual camera as the main subject, and the video from the thermal camera in a window not bigger than the main subject. The position of the thermal camera window can be adjusted with DJICameraPIPPosition. Not supported by Mavic 2 Enterprise Dual.
DJICameraDisplayModeMSX
Multi-Spectral Dynamic Imaging. Fuse the video feeds from both the visual camera and the thermal camera as one. Adds visible spectrum definition to IR images by detecting the edges of objects and including that detail in the thermal image.
Possible positions to place the window of the thermal camera video feed when the display mode is DJICameraDisplayModePIP. Only supported by XT2 camera and Mavic 2 Enterprise Dual Light Camera.
Enum Members:
DJICameraPIPPositionCenter
Position the window to the vertical center and the horizontal center.
DJICameraPIPPositionBottomRight
Position the window to be bottom right.
DJICameraPIPPositionCenterRight
Position the window to be centered on the right.
DJICameraPIPPositionTopRight
Position the window to be top right.
DJICameraPIPPositionBottomCenter
Position the window to be centered at bottom.
DJICameraPIPPositionTopCenter
Position the window to be centered at top.
DJICameraPIPPositionBottomLeft
Position the window to be bottom left.
DJICameraPIPPositionCenterLeft
Position the window to be centered on the left.
DJICameraPIPPositionTopLeft
Position the window to be top left.
DJICameraPIPPositionSideBySide
Position the thermal window on the right side of the main window (the visual camera video feed). Scale both windows with the same height.
The state of the tap zoom action. Only supported by Z30 camera.
Enum Members:
DJICameraTapZoomStateIdle
The tap zoom is not triggered yet. It will always push DJICameraTapZoomStateIdle if camera is not zooming.
DJICameraTapZoomStateZoomIn
The camera is zooming in. The focal length increases, field of view becomes narrower and magnification is higher.
DJICameraTapZoomStateZoomOut
The camera is zooming in the focal length decreases, field of view becomes wider and magnification is lower.
DJICameraTapZoomStateZoomLimited
It means the camera has reached its maximum focus length. It will always push DJICameraTapZoomStateZoomLimited if the camera reaches its maximum focus length.
Camera focus mode. It is settable only when isAdjustableFocalPointSupported returns YES and the physical AF switch on the camera is set to auto.
Enum Members:
DJICameraFocusModeManual
The camera's focus mode is set to manual. In this mode, user sets the focus ring value to adjust the focal distance.
DJICameraFocusModeAuto
The camera's focus mode is set to auto. For the Z30 camera, the focus is calculated completely automatically. For all other cameras, a focus target can be set by the user, which is used to calculate focus automatically.
DJICameraFocusModeAFC
The camera's focus mode is set to Continuous AF. It is only supported by Mavic Pro with firmware version V01.03.0000 or above, X4S camera, Mavic 2 Zoom camera and Mavic 2 Pro camera.
The lens failed to focus on the target. This happens when the target is too close, or the camera cannot distinguish the object to focus (e.g. a white wall).
The sensor cleaning is finished and the camera is waiting for the lens to be remounted. When the lens is mounted, the state will change to DJICameraSensorCleaningStateIdle.
The camera stores both the RAW and JPEG formats of the photo.
DJICameraPhotoFileFormatTIFF14Bit
The camera's photo storage format is TIFF (14bit).
DJICameraPhotoFileFormatRadiometricJPEG
The camera's photo storage format is Radiometric JPEG (a special JPEG format with temperature information). A radiometric JPEG has the .jpg suffix and can be viewed as a normal JPEG file would. At the same time, the temperature data is also stored in the file as meta data. PC software is required to analyze the file and it is accessible at FLIR's website http://www.flir.com/instruments/display/?id=54865. Only supported by XT camera with firmware version 1.16.1.70 or above.
The camera's photo storage format is TIFF Linear Low. In this mode each pixel is 14 bits and linearly proportional with temperature, covering a high dynamic range of temperature which results in a lower temperature resolution. Supported only by Zenmuse XT containing Advanced Radiometry capabilities with firmware version 1.17.1.80 or lower. For newer firmwares, the temperature resolution preference is coupled with the thermal gain mode.
The camera's photo storage format is TIFF Linear High. In this mode each pixel is 14 bits and linearly proportional with temperature, covering a low dynamic range of temperature which results in a higher temperature resolution. Supported only by Zenmuse XT containing Advanced Radiometry capabilities with firmware version 1.17.1.80 or lower. For newer firmwares, the temperature resolution preference is coupled with the thermal gain mode.
The number of photos taken in one burst shot (shooting photo in burst mode).
Enum Members:
DJICameraPhotoBurstCount2
The camera burst shoot count is set to capture 2 pictures at once when the camera shoots a photo.
DJICameraPhotoBurstCount3
The camera burst shoot count is set to capture 3 pictures at once when the camera shoots a photo.
DJICameraPhotoBurstCount5
The camera burst shoot count is set to capture 5 pictures at once when the camera takes a photo.
DJICameraPhotoBurstCount7
The camera burst shoot count is set to capture 7 pictures at once when the camera takes a photo. It is not supported by Z30 camera.
DJICameraPhotoBurstCount10
The camera burst shoot count is set to capture 10 pictures at once when the camera takes a photo. Only supported by X4S camera, X5S camera and Phantom 4 Pro camera.
DJICameraPhotoBurstCount14
The camera burst shoot count is set to capture 14 pictures at once when the camera takes a photo. Only supported by X4S camera, X5S camera and Phantom 4 Pro camera.
DJICameraPhotoBurstCountContinuous
The camera burst shoot count is set to capture RAW pictures continuously until stopShootPhotoWithCompletion command is sent. It is only supported by Inspire 2 when the photo shoot mode is RAW burst.
File format for camera when it is in time-lapse mode. The default file format is video. If video+JPEG is selected the minimum interval will be 2 seconds.
Enum Members:
DJICameraPhotoTimeLapseFileFormatVideo
The camera in time-lapse mode will generate video.
DJICameraPhotoTimeLapseFileFormatJPEGAndVideo
The camera in time-lapse mode will generate video and JPEG.
Sets the number of pictures, and sets the time interval between pictures for the Interval shoot photo mode.
Struct Members:
uint8_t captureCount
The number of photos to capture. The value range is [2, 255]. If 255 is selected, then the camera will continue to take pictures until stopShootPhotoWithCompletion is called. For thermal imaging camera and Z30 camera, it can only be set to 255.
uint16_t timeIntervalInSeconds
The time interval between when two photos are taken. The range for this parameter depends the photo file format(DJICameraPhotoFileFormat). For XT camera, the range is [1, 60] seconds. For all other products, when the file format is JPEG, the range is [2, 2^16 - 1] seconds; when the file format is RAW or RAW+JPEG, the range is [10, 2^16 - 1] seconds.
Camera will shoot 3 rows of 3 photos. Each photo in a row will be taken with a different aircraft heading. Each row of photos is taken with a different gimbal pitch.
DJICameraPhotoPanoramaMode3x1
Camera will shoot 3 photos with the same aircraft heading and different gimbal pitch.
DJICameraPhotoPanoramaModeSphere
Camera will shoot 8 rows of 3 photos and 1 extra photo (facing downward). Each photo in a row will be taken with a different aircraft heading. Each row of photos is taken with a different gimbal pitch.
DJICameraPhotoPanoramaMode180
Camera will shoot 3 photos with the same gimbal pitch (facing forward) and different aircraft headings.
DJICameraPhotoPanoramaModeSuperResolution
The camera will capture and patch nine photos resulting in a 48-megapixel super resolution photo. It is only supported by Mavic 2 Zoom.
The camera's video resolution is 640x360. Supported by Mavic 2 Enterprise Dual thermal camera.
DJICameraVideoResolution640x480
The camera's video resolution is 640x480.
DJICameraVideoResolution640x512
The camera's video resolution is 640x512.
DJICameraVideoResolution1280x720
The camera's video resolution is 1280x720.
DJICameraVideoResolution1920x1080
The camera's video resolution is 1920x1080.
DJICameraVideoResolution2704x1520
The camera's video resolution is 2704x1520.
DJICameraVideoResolution2720x1530
The camera's video resolution is 2720x1530.
DJICameraVideoResolution3712x2088
The camera's video resolution is 3712x2088. It's only used by X7 camera.
DJICameraVideoResolution3840x1572
The camera's video resolution is 3840x1572.
DJICameraVideoResolution3840x2160
The camera's video resolution is 3840x2160.
DJICameraVideoResolution3944x2088
The camera's video resolution is 3944x2088. It's only used by X7 camera.
DJICameraVideoResolution4096x2160
The camera's video resolution is 4096x2160.
DJICameraVideoResolution4608x2160
The camera's video resolution is 4608x2160.
DJICameraVideoResolution4608x2592
The camera's video resolution is 4608x2592.
DJICameraVideoResolution5280x2160
The camera's video resolution is 5280x2160.
DJICameraVideoResolution5760x3240
The camera's video resolution is 5760x3240.
DJICameraVideoResolution6016x3200
The camera's video resolution is 6016x3200.
DJICameraVideoResolutionMax
The camera's video resolution will be maximum resolution supported by the camera sensor. For X5S and X4S, the maximum resolution is 5280x2972.
DJICameraVideoResolutionNoSSDVideo
The camera's SSD video resolution is unset. When the SSD resolution is unset, camera will not store video to SSD. SSD's resolution is determined by both license key and SD card's video frame rate. If there is no supported resolution with the current configuration, DJICameraVideoResolutionUnset will be selected and user should adjust either the license or the frame rate.
DJI camera's license keys. An Inspire 2 License Key activates the usage permission of CinemaDNG or Apple ProRes inside CineCore 2.0. License keys are obtained by by purchase from the DJI store website using the Inspire 2 serial number. The Inspire 2 is then connected to DJI Assistant 2, and the license keys downloaded to it. It is only supported X5S and X7 cameras.
The legacy camera color for videos that will be stored in SSD. The default value is DJICameraSSDLegacyColorNone. It is only supported Inspire 2 with firmware package versions lower than 01.0.0240.
Enum Members:
DJICameraSSDLegacyColorNone
The camera color is set to none. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDCinelike
The camera color is set to DCinelike. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDLog
The camera color is set to DLog. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor1
The camera color is set to DColor1. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor2
The camera color is set to DColor2. It is only supported by X5S on Inspire 2.
DJICameraSSDLegacyColorDColor3
The camera color is set to DColor3. It is only supported by X5S on Inspire 2.
EI (exposure index) mode. In this mode, the camera mimics the way a film camera works to help cinematographers capture as much information as possible while balancing the dynamic range and noise with different log curves. This mode only takes effect when the camera mode is in DJICameraModeRecordVideo.
Communication to SSD is not stable. User can re-plugin SSD. It is supported by X5S.
DJICameraSSDOperationStateSwitchingLicense
SSD is switching the license key. It is supported by X5S.
DJICameraSSDOperationStateFormattingRequired
Formatting is required. It is supported by X5S.
DJICameraSSDOperationStateNotInitialized
Not initialized yet. It is supported by X7.
DJICameraSSDOperationStateInvalidFileSystem
The file system is not supported. It is supported by X7.
DJICameraSSDOperationStateUnknown
SSD state is unknown. This happens in the first 2 seconds after turning the camera power on as during this time the camera cannot check the state of the SSD.
Different storage locations supported by the camera.
Enum Members:
DJICameraStorageLocationSDCard
SD card.
DJICameraStorageLocationInternalStorage
The internal storage embedded in the aircraft. When it is available, the camera can shoot photos or record videos without SD card. It is only supported by Mavic Air.
The different colors are used to show various temperatures in the thermal imagery image. The colors are not actually related to wavelengths of light, but rather the grayscale intensity.
Enum Members:
DJICameraThermalPaletteWhiteHot
Without Isotherm enabled, the Palette type is WhiteHot. With Isotherm enabled, the Palette type is WhiteHotIso.
DJICameraThermalPaletteBlackHot
Without Isotherm enabled, the Palette type is BlackHot. With Isotherm enabled, the Palette type is BlackHotIso.
DJICameraThermalPaletteRedHot
Without Isotherm enabled, the Palette type is RedHot. With Isotherm enabled, the Palette type is RedHotIso.
DJICameraThermalPaletteGreenHot
Without Isotherm enabled, the Palette type is GreenHot. With Isotherm enabled, the Palette type is GreenHotIso.
DJICameraThermalPaletteFusion
Without Isotherm enabled, the Palette type is Fusion. With Isotherm enabled, the Palette type is FusionIso.
DJICameraThermalPaletteRainbow
Without Isotherm enabled, the Palette type is Rainbow. With Isotherm enabled, the Palette type is RainbowIso.
DJICameraThermalPaletteIronbow1
Without Isotherm enabled, the Palette type is Ironbow1. With Isotherm enabled, the Palette type is IronbowWHIso.
DJICameraThermalPaletteIronbow2
Without Isotherm enabled, the Palette type is Ironbow2. With Isotherm enabled, the Palette type is IronbowBHIso.
DJICameraThermalPaletteIceFire
Without Isotherm enabled, the Palette type is IceFire. With Isotherm enabled, the Palette type is IceFireIso.
DJICameraThermalPaletteSepia
Without Isotherm enabled, the Palette type is Sepia. With Isotherm enabled, the Palette type is SepiaIso.
DJICameraThermalPaletteGlowbow
Without Isotherm enabled, the Palette type is Glowbow. With Isotherm enabled, the Palette type is GlowbowIso.
DJICameraThermalPaletteColor1
Without Isotherm enabled, the Palette type is Color1. With Isotherm enabled, the Palette type is MidRangeWHIso.
DJICameraThermalPaletteColor2
Without Isotherm enabled, the Palette type is Color2. With Isotherm enabled, the Palette type is MidRangeBHIso.
DJICameraThermalPaletteRain
Without Isotherm enabled, the Palette type is Rain. With Isotherm enabled, the Palette type is RainbowHCIso.
DJICameraThermalPaletteHotSpot
Without Isotherm enabled, the Palette type is HotSpot. With Isotherm enabled, the Palette type is HotSpotIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteRainbow2
Without Isotherm enabled, the Palette type is Rainbow2. With Isotherm enabled, the Palette type is Rainbow2Iso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteGray
Without Isotherm enabled, the Palette type is Gray. With Isotherm enabled, the Palette type is GrayIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteHotMetal
Without Isotherm enabled, the Palette type is HotMetal. With Isotherm enabled, the Palette type is HotMetalIso. Only supported by Mavic 2 Enterprise Dual.
DJICameraThermalPaletteColdSpot
Without Isotherm enabled, the Palette type is ColdSpot. With Isotherm enabled, the Palette type is ColdSpotIso. Only supported by Mavic 2 Enterprise Dual.
Enable temperature measurement and set mode to area metering. Use camera:didUpdateAreaTemperatureAggregations to receive the updated temperature data. Only supported by the advanced radiometry version XT camera.
DJICameraThermalMeasurementModeUnknown
Thermal camera's temperature measurement mode is unknown.
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.
Struct Members:
float atmosphericTemperature
Atmospheric temperature, can be between -50 and 327.67 degrees Celsius.
float atmosphericTransmissionCoefficient
Transmission coefficient of the atmosphere between the scene and the camera, can be between 50 and 100.
float backgroundTemperature
Background temperature (reflected by the scene), can be between -50 and 327.67 degrees Celsius.
float sceneEmissivity
Emissivity of the scene, can be between 50 and 100.
float windowReflection
Window reflection, can be between 50 and 100-X where X is the window transmission coefficient parameter.
float windowReflectedTemperature
Temperature reflected in the window, can be between -50 and 327.67 degrees Celsius.
float windowTemperature
Window temperature, can be between -50 and 327.67 degrees Celsius.
float windowTransmissionCoefficient
Transmission coefficient of the window, can be between 50 and 100-X where X is the window reflection.