camera_hdr_get_supported_exposure

Retrieve the range of supported exposure value (EV) offsets.

Synopsis:

#include <camera/camera_hdr.h>

camera_error_t camera_hdr_get_supported_exposure_values(camera_hdr_t hdr,                 
                                                        unsigned numasked,                 
                                                        unsigned *numsupported,                 
                                                        double *offsets,                 
                                                        bool *maxmin)

Since:

BlackBerry 10.3.0

Arguments:

hdr: The HDR session handle obtained from a call to camera_hdr_create().

numasked: The requested number of EV offsets to return in the offsets array. You can specify a value of 0 to determine the number of supported EV offsets.

numsupported: A pointer to an integer that is updated with the number of supported EV offsets.

offsets: A pointer to a double array. The array is updated with the range of EV offsets supported. Ensure that you allocate an array with the same number of elements as the numasked argument. If the maxmin argument returns true, then the first value returned in the offsets array is the maximum supported EV offset, and the second value returned is the minimum supported EV offset.

maxmin: A pointer to a boolean value which is set to true if the returned offsets should be interpreted as a maximum and a minimum value, or set to false if the returned offsets describe the discrete EV offsets that are supported.

Library:

libcamerafeatures (For the qcc command, use the -l camerafeatures option to link against this library)

Description:

Use this function to determine the list of valid EV offsets available for HDR capture. The returned list describes either a range or a discrete set of values.

In camera_hdr_realtime mode, the range returned corresponds to the EV offset limits of the bound camera unit. These limits apply to the EV offsets configured using camera_hdr_set_exposure_values().

In Offline HDR rendering mode, the range returned corresponds to the limits of the HDR rendering engine. These limits apply to the EV offset passed to the camera_hdr_add_image_to_session() function.

Ensure that the offsets argument points to an array which has at least numasked elements allocated. To determine an appropriate size for this array, you can invoke this function in presizing mode by setting the numasked argument to 0 or the offsets argument to NULL. When the function is invoked in presizing mode, the maximum array size that is required is returned in the numsupported argument. You can then allocate an array of the appropriate size and invoke the function again with numasked argument set to the value returned previously in the numsupported argument.

Returns: