Sets the lens' 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.
Sets the photo file format of the current lens. See DJICameraPhotoFileFormat to view all possible photo formats to which the lens can be set. Not supported by Zenmuse H20 Series.
Sets the exposure mode of the current lens. 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.
Sets the shutter speed of the current lens. 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 lens exposure mode is Shutter mode or Manual mode.
Shutter speed value to be set for the lens. 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.
Sets the spot metering area index of the current lens. The lens image is divided into 225 spots defined by 15 columns and 15 rows. The row index range is [0,14], where the values increase top to bottom across the image. The column index range is [0, 14], 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, 14], 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, 14], where the values increase left to right.
Sets the exposure compensation of the current lens. See DJICameraExposureCompensation to view all possible exposure compensations to which the camera can be set. In order to use this function, set the lens 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.
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. Supported by the zoom lens of Zenmuse H20 Series.
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. Supported by the zoom lens of Zenmuse H20 Series.
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. Supported by the zoom lens of Zenmuse H20 Series and Mavic 2 Enterprise Advanced.
Hybrid zoom is combining optical and digital zoom. Lens will automatically switch over to digital zoom when optical zoom range is exceeded. Check if lens supports hybrid zoom. Supported by the zoom lens of Zenmuse H20 Series.
Hybrid zoom is combining optical and digital zoom. Lens will automatically switch over to digital zoom when optical zoom range is exceeded. Gets the specification of the zoom lens. Supported by the zoom lens of Zenmuse H20 Series.
Hybrid zoom is combining optical and digital zoom. Lens will automatically switch over to digital zoom when optical zoom range is exceeded. Sets focal length of the zoom lens. Supported by the zoom lens of Zenmuse H20 Series.
Hybrid zoom is combining optical and digital zoom. Lens will automatically switch over to digital zoom when optical zoom range is exceeded. Gets zoom lens focal length in units of 0.1mm. Supported by the zoom lens of Zenmuse H20 Series.
Enable/disable TapZoom. tapZoomAtTarget:withCompletion can only be called when TapZoom is enabled. Supported by Mavic 2 Enterprise Advanced, the zoom lens and the wide lens of Zenmuse H20 Series.
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. Supported by the zoom lens and the wide lens of Zenmuse H20 Series. The tap zoom multiplier of Zenmuse H20 Series must be 1.
Gets the multiplier for TapZoom. Supported by the zoom lens and the wide lens of Zenmuse H20 Series. The tap zoom multiplier of Zenmuse H20 Series must be 1.
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. Supported by Mavic 2 Enterprise Advanced, the zoom lens and the wide lens of Zenmuse H20 Series. It will only work when the tap zoom multiplier of Zenmuse H20 Series is 1.
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 lens supports an adjustable focal point. Currently, the adjustable focal point is supported by the zoom lens of Zenmuse H20 Series.
Sets the focus mode of the current lens. See DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
Gets the focus mode of the current lens. Please check DJICameraFocusMode. It is available only when isAdjustableFocalPointSupported returns YES. Supported by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
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 by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
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 by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
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. Not supported by Mavic 2 Enterprise Advanced.
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 by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
Gets the lens focusing ring value's max value. It is available only when isAdjustableFocalPointSupported returns YES. Supported by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
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 by the zoom lens of Zenmuse H20 Series. Not supported by Mavic 2 Enterprise Advanced.
Sets the region of interest (ROI). Used to manage color range distribution across the screen to maximize contrast for regions of highest interest. Supported by the thermal lens of Zenmuse H20T and H20N.
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.
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.
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.
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.
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. Not supported by Zenmuse H20T and H20N.
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. Not supported by Zenmuse H20T and H20N.
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. Not supported by Zenmuse H20T and H20N.
Gets the value of Smart Scene Optimization. The value is available only when the Scene mode is Manual, User1, User2 or User3. Not supported by Zenmuse H20T and H20N.
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. Not supported by Mavic 2 Enterprise Advanced.
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. Not supported by Zenmuse H20T and H20N.
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 by the thermal lens of Zenmuse H20T and H20N.
Input Parameters:
NSInteger value
If the unit is percentage, the value falls in [0,100].
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, for Mavic 2 Enterprise Advanced, the low gain mode can be used from -20 to 450 degrees Celsius. The high gain mode can be used from -20 to 150 degree Celsius
Sets the mode for thermal measurement. Use delegate method camera:didUpdateTemperatureData or camera:didUpdateAreaTemperatureAggregations to receive the measurement result. Supported only by thermal imaging cameras. Supported by the thermal lens of Zenmuse H20T and H20N and Mavic 2 Enterprise Advanced.
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 DJICameraThermalDigitalZoomFactor in DJICameraSettingsDef.
Gets the thermal imaging camera profile. The profile includes information about resolution, frame rate and focal length. Supported by the thermal lens of Zenmuse H20T and H20N.
Gets the spot metering target point if one is set, if not then returns CGPointZero.
Supported by the thermal lens of Zenmuse H20T and H20N and Mavic 2 Enterprise Advanced.
Sets the spot metering target point which then . 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. You should call setThermalMeasurementMode:withCompletion to set the measurement mode to DJICameraThermalMeasurementModeSpotMetering first. Supported by the thermal lens of Zenmuse H20T and H20N and Mavic 2 Enterprise Advanced.
Set the metering area for a rectangle inside the thermal ismage 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. You should call setThermalMeasurementMode:withCompletion to set the measurement mode to DJICameraThermalMeasurementModeAreaMetering first. Supported by the thermal lens of Zenmuse H20T and H20N and Mavic 2 Enterprise Advanced.
Gets the currently set custom user profile. This profile represents user-set external scene parameters for the thermal scene. Not supported by Zenmuse H20T and H20N.
Sets the custom user profile. This profile represents user-set external scene parameters for the thermal scene. Not supported by Zenmuse H20T and H20N.
Sets the display mode to coordinate the video feeds from both the visual camera and the thermal camera. Only applies to the thermal infrared video feed. For Zemmuse H20T and H20N, you should set setCameraVideoStreamSource:withCompletion with DJICameraVideoStreamSourceInfraredThermal first. Only supported by Zenmuse H20T and H20N.and Mavic 2 Enterprise Advanced.
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 applies to the thermal infrared video feed.
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. Supported by the thermal lens of Zenmuse H20T and H20N.
Sets the assumed temperature reflected by the background of the scene, can be between -50 and 327.67 degrees Celsius. Not supported by Zenmuse H20T and H20N.
Sets assumed window reflection coefficient, can be between 0 and X where X is the window transmission coefficient parameter. Not supported by Zenmuse H20T and H20N.
Enables or disables the infrared sensor protection. If the sensor protection is enabled, the infrared thermal camera shutter might be closed. Only supported by Zenmuse H20T and H20N.
Enables the infrared thermal camera. Infrared thermal camera shutter may be closed, if the sensor protection is enabled. Only supported by Zenmuse H20T and H20N.
Called when there are new min, max, and average temperature values available for the set spot metering area. Supported by the thermal lens of Zenmuse H20T and H20N.
Called whenever the lens parameters change. In automatic exposure modes (Program, Shutter Priority and Aperture Priority) the lens 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. Supported by the thermal lens of Zenmuse H20T and H20N.
Called when the laser measure information updated. The laser sensor must be at least 3 meters away from the target point. Supported by the zoom lens and the wide lens of Zenmuse H20 Series.