camera_feature

The camera capabilities or features available on the camera.

Synopsis:

#include <camera/camera_api.h>

typedef enum {
      CAMERA_FEATURE_FBM = 0   
      CAMERA_FEATURE_PHOTO = 1   
      CAMERA_FEATURE_VIDEO = 2   
      CAMERA_FEATURE_PHOTOZOOM = 3   
      CAMERA_FEATURE_VIDEOZOOM = 4   
      CAMERA_FEATURE_ZSL = 5   
      CAMERA_FEATURE_BURST = 6   
      CAMERA_FEATURE_EVBRACKETING = 7   
      CAMERA_FEATURE_FLASH = 8   
      CAMERA_FEATURE_VIDEOLIGHT = 9   
      CAMERA_FEATURE_PREVIEWISVIDEO = 10   
      CAMERA_FEATURE_AUTOFOCUS = 11   
      CAMERA_FEATURE_MANUALFOCUS = 12   
      CAMERA_FEATURE_REGIONFOCUS = 13   
      CAMERA_FEATURE_MACROFOCUS = 14   
      CAMERA_FEATURE_FOCUSASSIST = 15   
      CAMERA_FEATURE_VFHWOVERLAY = 16   
      CAMERA_FEATURE_REGIONEXPOSURE = 17   
      CAMERA_FEATURE_REGIONWHITEBALANCE = 18   
      CAMERA_FEATURE_CONTINUOUSBURST = 19   
      CAMERA_FEATURE_VFFACEDETECT = 20   
      CAMERA_FEATURE_FACEDETECT = 21   
      CAMERA_FEATURE_PHOTOVFVARIABLEFRAMERATE = 22   
      CAMERA_FEATURE_AUTOEXPOSURE = 23   
      CAMERA_FEATURE_AUTOWHITEBALANCE = 24   
      CAMERA_FEATURE_MANUALEXPOSURE = 25   
      CAMERA_FEATURE_MANUALWHITEBALANCE = 26   
      CAMERA_FEATURE_PREMAPBUFFERS = 27   
      CAMERA_FEATURE_LOWLIGHT_STATUS = 28   
      CAMERA_FEATURE_VFHISTOGRAM = 29   
      CAMERA_FEATURE_VIDEOSTABILIZATION = 30   
      CAMERA_FEATURE_PHOTOSTABILIZATION = 31   
      CAMERA_FEATURE_OPTICALIMAGESTABILIZATION = 32   
      CAMERA_FEATURE_NUMFEATURES   
} camera_feature_t;

Since:

BlackBerry 10.0.0

Data:

CAMERA_FEATURE_FBM: The camera supports queries from the camera_can_feature() and camera_has_feature() functions.

CAMERA_FEATURE_PHOTO: It is possible to take photos (still images).

CAMERA_FEATURE_VIDEO: It is possible to encode video.

CAMERA_FEATURE_PHOTOZOOM: Zoom is available in photo viewfinder mode.

CAMERA_FEATURE_VIDEOZOOM: Zoom is available in the video viewfinder mode.

CAMERA_FEATURE_ZSL: Zero-shutter lag is available.

CAMERA_FEATURE_BURST: Burst mode is available for taking multiple photos consecutively.; Note: When CAMERA_FEATURE_BURST is available, but CAMERA_FEATURE_CONTINUOUSBURST isn't, then only the camera_take_burst() function can be used. The camera_start_burst() function will not work.

CAMERA_FEATURE_EVBRACKETING: Exposure bracketing is available in burst capture mode.

CAMERA_FEATURE_FLASH: Flash is available.

CAMERA_FEATURE_VIDEOLIGHT: An on-board light source is available for use with video capture.

CAMERA_FEATURE_PREVIEWISVIDEO: There is no standalone video buffer stream available.; Preview buffers are used for both viewfinder and video encoding. For more information, see camera_set_video_property().

CAMERA_FEATURE_AUTOFOCUS: Autofocus is available.

CAMERA_FEATURE_MANUALFOCUS: Manual focus is available.

CAMERA_FEATURE_REGIONFOCUS: It is possible to focus on a specific region in the viewfinder.

CAMERA_FEATURE_MACROFOCUS: Macro focus mode is available.; Macro mode allows you to focus on objects that are close to the camera, such as 10 centimeters away.

CAMERA_FEATURE_FOCUSASSIST: The focus assist feature is available.; Focus assist turns on the light when running single focus cycles in low-light conditions. The light will also be turned on in low-light conditions if continuous autofocus is enabled and focus is not locked prior to calling camera_take_photo(). Turning on the light improves autofocus performance in low-light conditions.

CAMERA_FEATURE_VFHWOVERLAY: The viewfinder can use hardware acceleration for blitting.; Blitting is a hardware acceleration feature used for efficiently transferring viewfinder buffers to the video display. For more information, see SCREEN_USAGE_OVERLAY used in the screen_set_window_property_iv() function in Screen Graphics Subsystem library. When you use this value, the viewfinder window uses SCREEN_USAGE_OVERLAY window property where possible.

CAMERA_FEATURE_REGIONEXPOSURE: Region exposure is available.; Region exposure allows you to perform spot and partial metering in specific regions of an image.

CAMERA_FEATURE_REGIONWHITEBALANCE: Region white balance is available.; Region white balance uses the image data in the user-specified region to make white balance adjustment (color correction) computations.

CAMERA_FEATURE_CONTINUOUSBURST: Continuous burst mode is available.; Continuous burst mode allows for rapid successive image capture over an indefinite time-frame.

Note: When CAMERA_FEATURE_BURST is available, but CAMERA_FEATURE_CONTINUOUSBURST isn't, then only the camera_take_burst() function can be used. The camera_start_burst() function will not work.

CAMERA_FEATURE_VFFACEDETECT: Face detection is available in the viewfinder image stream.; Face detection permits you retrieve the coordinates of the faces detected in the scene via the accompanying viewfinder metadata.

CAMERA_FEATURE_FACEDETECT: Face detection is available in the still image stream.; Face detection permits you retrieve the coordinates of the faces detected in the scene via the accompanying still image metadata.

CAMERA_FEATURE_PHOTOVFVARIABLEFRAMERATE: Variable frame rate is supported for photo viewfinder.; For more information, see the description for CAMERA_IMGPROP_VARIABLEFRAMERATE.

CAMERA_FEATURE_AUTOEXPOSURE: Auto exposure is available.

CAMERA_FEATURE_AUTOWHITEBALANCE: Auto white balance is available.

CAMERA_FEATURE_MANUALEXPOSURE: Manual exposure is available.

CAMERA_FEATURE_MANUALWHITEBALANCE: Manual white balance is available.

CAMERA_FEATURE_PREMAPBUFFERS: For internal use only. Do not use.

CAMERA_FEATURE_LOWLIGHT_STATUS: Low-light status notification is available.
Since: BlackBerry 10.2.0

CAMERA_FEATURE_VFHISTOGRAM: Histogram feature is available.
Since: BlackBerry 10.2.0

CAMERA_FEATURE_VIDEOSTABILIZATION

Video stabilization is available on the camera.

For more information, see CAMERA_IMGPROP_STABILIZATION.

Since: BlackBerry 10.2.0

CAMERA_FEATURE_PHOTOSTABILIZATION

Photo stabilization is available on the camera.

For more information, see CAMERA_IMGPROP_STABILIZATION.

Since: BlackBerry 10.2.0

CAMERA_FEATURE_OPTICALIMAGESTABILIZATION: Optical image stabilization is available on the camera.
Since: BlackBerry 10.3.0

CAMERA_FEATURE_NUMFEATURES: An end-of-list identifier.; Also indicates the total number of features recognized by the Camera library.

Library:

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

Description:

The enumerated type is used with the camera_has_feature() and camera_can_feature() functions.