camera_imgprop_t

Data:

CAMERA_IMGPROP_FORMAT

The image format as a camera_frametype_t value.

CAMERA_IMGPROP_WIDTH

The width of the image as a uint32_t value.

CAMERA_IMGPROP_HEIGHT

The height of the image as a uint32_t value.

CAMERA_IMGPROP_FRAMERATE

The frame rate of the image sequence as a double value.

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

CAMERA_IMGPROP_ROTATION

The image rotation angle (in degrees) as a uint32_t value.

Rotation angles are measured in the clockwise direction.

CAMERA_IMGPROP_STABILIZATION

Enable built-in stabilization algorithms to help avoid a blurry image.

The value is specified as an int value. A value of 0 indicates that stabilization is off and a value of 1 indicates that stabilization is on. To enable stabilization for video, CAMERA_FEATURE_VIDEOSTABILIZATION must be available on the camera. Note that CAMERA_IMGPROP_MAXFOV must be set to 0 when starting the viewfinder before video stabilization can be enabled.

CAMERA_IMGPROP_ZOOMFACTOR

Zoom factor is used as a uint32_t value.

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

CAMERA_IMGPROP_HWOVERLAY

The viewfinder can use hardware acceleration for blitting.

To use this feature, the hardware acceleration for the blitting feature must be available (CAMERA_FEATURE_VFHWOVERLAY). Use the camera_can_feature() function to determine whether the camera supports the feature. To use blitting, specify as an int value where 0 indicates not to use blitting and 1 indicates to use blitting.

Blitting is a hardware acceleration feature used for efficiently transferring image buffers to the video display. For more information, see SCREEN_USAGE_OVERLAY used in the screen_set_window_property_iv() function in the Screen Library Reference of the Screen Developer's Guide. When you use this value, the viewfinder window uses SCREEN_USAGE_OVERLAY window property where possible.

CAMERA_IMGPROP_WIN_GROUPID

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

For more information, see the QNX Screen Graphics Subsystem.

CAMERA_IMGPROP_WIN_ID

The window ID to apply to the viewfinder window that is created as a const char* value.

CAMERA_IMGPROP_ISEMBEDDED

An embedded window will be created (see "Screen window types" in the Screen Library Reference of the Screen Developer's Guide.

window-types). If the viewfinder is being created as a child of an existing child window, then this flag must be set using an int. Use a value of 1 to create an embedded window and 0 otherwise.

CAMERA_IMGPROP_CREATEWINDOW

Whether to create a visible viewfinder window or not.

This flag accepts int values. Setting the value to 1 causes a viewfinder window to be created (see the Screen Graphics Subsystem for information on managing windows). Setting the value to 0 suppresses the creation of a viewfinder window.

Note:

To create a viewfinder window, the feature CAMERA_FEATURE_VFWINDOW must be available on the camera.

On some platforms not all frametypes are supported. Call camera_is_create_window_supported() to check if the frametype you are using allows CAMERA_IMGPROP_CREATEWINDOW to be true.

CAMERA_IMGPROP_MAXFOV

Indicates that the FOV (field of view) of the viewfinder should not be cropped when the viewfinder is started.

This parameter must be set using an int value. A value of 0 indicates that the viewfinder may be started with cropping applied in order to support use of the CAMERA_IMGPROP_STABILIZATION property. A value of 1 indicates that the viewfinder will provide the widest possible field of view at startup and will disallow attempts to use the CAMERA_IMGPROP_STABILIZATION property.

CAMERA_IMGPROP_VIDEOCODEC

The video codec used when generating video files or streams using camera_start_video() or camera_start_encode().

The video codec value is of type camera_videocodec_t.

CAMERA_IMGPROP_AUDIOCODEC

The audio codec used when generating video files or streams using camera_start_video() or camera_start_encode().

The audio codec value is of type camera_audiocodec_t.

CAMERA_IMGPROP_RENDERTOWINDOW

The viewfinder window is updated with frames from the camera when this property is set to 1.

Rendering is suspended if the value is set to 0. The parameter must be an int value, and can be used to mask undesirable visual artifacts when exposure bracketing is active.

CAMERA_IMGPROP_NUMUSERBUFFERS

The viewfinder window is created with a certain number of buffers to accomodate both the buffer requirements of the camera and to have additional buffers that can be held by the user for callback or event handling.

This property indicates how many additional buffers are allocated for the user. While it's always possible to read this property, it is only writable before starting the viewfinder and for cameras that support the feature CAMERA_FEATURE_NUMVFUSERBUFFERS. The parameter is a uint32_t value.

Library:

Description:

Each key is associated with a value of the indicated type.