camera_imgprop_t

The enumeration specifies the image properties list.

Synopsis:

#include <camera/camera_api.h>
 
typedef enum {
      CAMERA_IMGPROP_FORMAT = 0   
      CAMERA_IMGPROP_WIDTH   
      CAMERA_IMGPROP_HEIGHT   
      CAMERA_IMGPROP_FRAMERATE   
      CAMERA_IMGPROP_BITRATE   
      CAMERA_IMGPROP_KEYFRAMEINTERVAL   
      CAMERA_IMGPROP_ROTATION   
      CAMERA_IMGPROP_STABILIZATION   
      CAMERA_IMGPROP_ZOOMFACTOR   
      CAMERA_IMGPROP_HWOVERLAY   
      CAMERA_IMGPROP_JPEGQFACTOR   
      CAMERA_IMGPROP_WIN_GROUPID   
      CAMERA_IMGPROP_WIN_ID   
      CAMERA_IMGPROP_BURSTMODE   
      CAMERA_IMGPROP_BURSTDIVISOR   
      CAMERA_IMGPROP_SLICESIZE   
      CAMERA_IMGPROP_VARIABLEFRAMERATE   
      CAMERA_IMGPROP_MINFRAMERATE   
      CAMERA_IMGPROP_ISEMBEDDED   
      CAMERA_IMGPROP_CREATEWINDOW      
} camera_imgprop_t;

Data:

CAMERA_IMGPROP_FORMAT
*Indicates that image format as a camera_frametype_t value.
CAMERA_IMGPROP_WIDTH
Indicates the width of image as an unsigned int value.
CAMERA_IMGPROP_HEIGHT
Indicates the height of the image as an unsigned int value.
CAMERA_IMGPROP_FRAMERATE
Indicates the frame rate of the image sequence as a double value.

When CAMERA_IMGPROP_VARIABLEFRAMERATE is set to a value of 1, it indicates the maximum frame rate to use for the image sequence.

CAMERA_IMGPROP_BITRATE
Indicates the units are in bits per second as an unsigned int value.
CAMERA_IMGPROP_KEYFRAMEINTERVAL
Indicates the interval (in frames) between the generation of each keyframe as an unsigned int value.
CAMERA_IMGPROP_ROTATION
Indicates the image rotations (in degrees) as an unsigned int value.

Rotations occur clockwise.

CAMERA_IMGPROP_STABILIZATION
Indicates to enable built-in stabilization algorithms to help avoid a blurry image.

The value is specified as an unsigned int value. A value of 0 indicates that stabilization is off and a value of 1 indicates that stabilization is on.

CAMERA_IMGPROP_ZOOMFACTOR
Indicates the zoom factor used as an unsigned int value.

The zoom level is a value supported by the camera hardware and can represents digital zoom or optical zoom. Optical zoom is only supported if the camera supports it. Most digital cameras provide only digital zoom support.

CAMERA_IMGPROP_HWOVERLAY
Indicates that the viewfinder can use hardware acceleration for blitting.

This feature also requires CAMERA_FEATURE_VFHWOVERLAY to use this mode. Use the camera_can_feature() function to determine whether the camera supports the feature.

Blitting is an operation where you copy the viewfinder buffer to the video display. For more information, see the SCREEN_USAGE_OVERLAY ( screen_set_window_property_iv() function) in the Screen and Windowing API. The value means to create the viewfinder window using SCREEN_USAGE_OVERLAY when it is available.

CAMERA_IMGPROP_JPEGQFACTOR
Indicates the JPEG quality setting of the camera as an int value.

The value represents a percentage.

CAMERA_IMGPROP_WIN_GROUPID
Indicates the window group ID the viewfinder should be in created in as a const char* value.

For more information, see the Screen and Windowing API.

CAMERA_IMGPROP_WIN_ID
Indicates the window ID to apply to the viewfinder window that is created as a const char* value.
CAMERA_IMGPROP_BURSTMODE
Indicates whether burst mode should be used as an int value.

A value of 0 indicates to disable burst capture mode while a value of 1 indicates to enable burst capture mode.

CAMERA_IMGPROP_BURSTDIVISOR
Indicates the frame rate divisor to apply when operating in burst capture mode.

A value of 1 will yield a capture frame rate equal to the viewfinder frame rate divided by 1. A value of 2 will yield a capture frame rate equal to the viewfinder frame rate divided by 2. For example, every second frame is captured. Fractional values are allowed.

CAMERA_IMGPROP_SLICESIZE
Indicates the maximum slice size (in bytes) to use for video encoding that supports slice encoding.

Slice encoding is the encoding of a frame into multiple slices for error resilience.

CAMERA_IMGPROP_VARIABLEFRAMERATE
Indicates whether the variable frame rate should be enabled for this image sequence.

CAMERA_FEATURE_PHOTOVFVARIABLEFRAMERATE must be available to use variable frame rate mode. The use of variable frame rate mode allows the camera to decrease the frame rate in order to increase exposure time to compensate for poor lighting conditions. You can use variable frame rate to vary the frame rate based on the lighting conditions in a range defined as follows:

CAMERA_IMGPROP_FRAMERATE >= frame rate >= CAMERA_IMGPROP_MINFRAMERATE

The value of this property is specified as an unsigned int value. A value of 0 indicates that variable frame rate is disabled (frame rate is fixed as specified by CAMERA_IMGPROP_FRAMERATE) and a value of 1 indicates that variable frame rate is enabled.

CAMERA_IMGPROP_MINFRAMERATE
Indicates the minimum frame rate of the image sequence as a double value.

If variable frame rate mode is enabled, be sure to change CAMERA_IMGPROP_FRAMERATE and CAMERA_IMGPROP_MINFRAMERATE at the same time via a single call to the camera_set_photovf_property() function. Doing so ensures that range-checks can be properly performed.

CAMERA_IMGPROP_ISEMBEDDED
Indicates an embedded window will be created (see Screen and Windowing API on window-types).

If the viewfinder is being created as a child of an existing child window, then this flag must be set.

CAMERA_IMGPROP_CREATEWINDOW
Indicates whether window will be created (see Screen and Windowing API on window-types).

This flag must be set to true in order to have ancamera_frametype_t image buffer posted to a viewfinder window.

Library:

libcamapi

Description:

These properties are used as keys for the following functions: