camera_vfmode_t

Represents the major mode of the viewfinder.

Synopsis:

#include <camera/camera_api.h>
 
typedef enum {
      CAMERA_VFMODE_DEFAULT   
      CAMERA_VFMODE_PHOTO   
      CAMERA_VFMODE_CONTINUOUS_BURST   
      CAMERA_VFMODE_FIXED_BURST   
      CAMERA_VFMODE_EV_BRACKETING   
      CAMERA_VFMODE_VIDEO   
      CAMERA_VFMODE_VIDEO_SNAPSHOT   
      CAMERA_VFMODE_HIGH_SPEED_VIDEO   
      CAMERA_VFMODE_HDR_VIDEO   
      CAMERA_VFMODE_NUM_MODES   
} camera_vfmode_t;

Since:

BlackBerry 10.3.0

Data:

CAMERA_VFMODE_DEFAULT
The default viewfinder mode when a camera is opened.

The camera_has_feature() function provides a complete list of features supported by the camera.

In default mode, you can only use the deprecated viewfinder functions referenced in Viewfinder modes. You can not use the deprecated viewfinder functions with any mode other than the default viewfinder mode.

CAMERA_VFMODE_PHOTO
Photo mode allows single pictures to be taken.

For more information about taking photos, see camera_take_photo().

For backwards compatibility, photo viewfinder mode may also be enabled using the deprecated functions referenced in Viewfinder modes.

CAMERA_VFMODE_CONTINUOUS_BURST
Continuous burst mode allows for continuous image capture at the highest possible speed.

For more information, see camera_start_burst().

For backwards compatibility, photo viewfinder mode may also be enabled using the deprecated functions referenced in Viewfinder modes. Instead of using this viewfinder mode, you would instead use the CAMERA_IMGPROP_BURSTMODE image property with camera_set_photovf_property().

CAMERA_VFMODE_FIXED_BURST
Fixed burst mode allows for a finite number of images to be captured in rapid succession.

For more information, see camera_take_burst().

For backwards compatibility, photo viewfinder mode may also be enabled using the deprecated functions referenced in Viewfinder modes. Instead of using this viewfinder mode, you would instead use the CAMERA_IMGPROP_BURSTMODE image property with camera_set_photovf_property().

CAMERA_VFMODE_EV_BRACKETING
EV bracketing mode allows for a finite number of images to be captured in rapid succession with different exposure value (EV) offsets applied to the images.

For more information, see camera_config_ev_bracketing() and camera_take_burst().

For backwards compatibility, photo viewfinder mode may also be enabled using the deprecated functions referenced in Viewfinder modes. Instead of using this viewfinder mode, you would instead use the CAMERA_IMGPROP_BURSTMODE image property with camera_set_photovf_property().

CAMERA_VFMODE_VIDEO
Video mode allows for videos to be recorded or encoded.

For more information, see camera_start_video() and camera_start_encode().

For backwards compatibility, photo viewfinder mode may also be enabled using the deprecated functions referenced in Viewfinder modes.

CAMERA_VFMODE_VIDEO_SNAPSHOT
Video snapshot mode allows for still image capture while recording or encoding videos.

For more information, see camera_start_video(), camera_start_encode(), and camera_take_photo().

CAMERA_VFMODE_HIGH_SPEED_VIDEO
High-speed video mode allows for videos to be recorded or encoded at higher frame rates than CAMERA_VFMODE_VIDEO.

For more information, see camera_start_video() and camera_start_encode().

CAMERA_VFMODE_HDR_VIDEO
HDR (high dynamic range) video mode allows for videos to be recorded with a higher dynamic range than CAMERA_VFMODE_VIDEO.

For more information, see camera_start_video() and camera_start_encode().

CAMERA_VFMODE_NUM_MODES
For internal use only.

The value is used to determine the maximum number of view finder modes supported.

Library:

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

Description:

Each viewfinder mode provides a different set of capabilities, which can be checked using camera_has_feature() after choosing a mode. Not all cameras support all viewfinder modes, so ensure you query camera_get_supported_vf_modes() before using camera_set_vf_mode().

For more information about viewfinder modes, see Viewfinder modes.

Last modified: 2014-06-24



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

comments powered by Disqus