camera_feature_t

Updated: April 19, 2023

The camera capabilities or available features

Synopsis:

#include <camera/camera_api.h>
typedef enum {
    CAMERA_FEATURE_FBM = 0,
    CAMERA_FEATURE_VIDEO = 2,
    CAMERA_FEATURE_VIDEOZOOM = 4,
    CAMERA_FEATURE_PREVIEWISVIDEO = 10,
    CAMERA_FEATURE_AUTOFOCUS = 11,
    CAMERA_FEATURE_MANUALFOCUS = 12,
    CAMERA_FEATURE_REGIONFOCUS = 13,
    CAMERA_FEATURE_MACROFOCUS = 14,
    CAMERA_FEATURE_VFHWOVERLAY = 16,
    CAMERA_FEATURE_REGIONEXPOSURE = 17,
    CAMERA_FEATURE_REGIONWHITEBALANCE = 18,
    CAMERA_FEATURE_AUTOEXPOSURE = 23,
    CAMERA_FEATURE_AUTOWHITEBALANCE = 24,
    CAMERA_FEATURE_MANUALEXPOSURE = 25,
    CAMERA_FEATURE_MANUALWHITEBALANCE = 26,
    CAMERA_FEATURE_ANALOGCAMERA = 33,
    CAMERA_FEATURE_VFWINDOW = 34,
    CAMERA_FEATURE_NUMVFUSERBUFFERS = 35,
    CAMERA_FEATURE_FILENAME = 36,
    CAMERA_FEATURE_NUMFEATURES
} camera_feature_t;

Data:

CAMERA_FEATURE_FBM
The camera supports queries from the camera_can_feature() and camera_has_feature() functions.
CAMERA_FEATURE_VIDEO
It is possible to encode video.
CAMERA_FEATURE_VIDEOZOOM
Zoom is available in the video viewfinder mode.
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.

This mode allows you to focus on objects that are close to the camera, such as 10 centimeters away.

CAMERA_FEATURE_VFHWOVERLAY
The viewfinder can use hardware acceleration for blitting.

Blitting is a hardware acceleration feature for efficiently transferring image buffers to the video display. For more information, see SCREEN_USAGE_OVERLAY in the screen_set_window_property_iv() function reference in the Screen Developer's Guide. When you use this value, the viewfinder window uses the 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_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_ANALOGCAMERA
The camera is an analog camera and supports configuring parameters that are specific to analog cameras.
CAMERA_FEATURE_VFWINDOW
A visible viewfinder window is supported.

For more information, see CAMERA_IMGPROP_CREATEWINDOW.

CAMERA_FEATURE_NUMVFUSERBUFFERS
It is possible to set the number of user buffers to be allocated for a viewfinder.

For more information, see CAMERA_IMGPROP_NUMUSERBUFFERS.

CAMERA_FEATURE_FILENAME
It is possible to call camera_set_filename() to dynamically change the file associated with a camera that plays out a file to simulate a camera.
CAMERA_FEATURE_NUMFEATURES
An end-of-list identifier that indicates the total number of features recognized by the Camera library.

Library:

libcamapi

Description:

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