camera_feature_t

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.

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.

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.

Last modified: 2014-06-24



Got questions about leaving a comment? Get answers from our Disqus FAQ.

comments powered by Disqus