camera_hdr_get_supported_postview

Retrieve the list of supported HDR postview formats.

Synopsis:

#include <camera/camera_hdr.h>

camera_error_t camera_hdr_get_supported_postview_formats(camera_hdr_t hdr,                 
                                                         uint32_t numasked,                 
                                                         uint32_t *numsupported,                 
                                                         camera_frametype_t *formats)

Since:

BlackBerry 10.3.0

Arguments:

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

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

numsupported: A pointer to an integer that is updated with the number of HDR postview formats supported.

formats: A pointer to a #camera_frametype_t array. The array is updated with the list of HDR postview formats supported. Ensure that you allocate an array with the same number of elements as the numasked argument.

Library:

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

Description:

This function returns the list of supported HDR postview formats that can be set using camera_hdr_set_postview_format().

Ensure that the formats 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 formats argument to NULL. When the function is invoked in this presizing mode, the maximum array size required is returned in 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: