QtMobility Reference Documentation

Contents

QCameraFocus Class Reference

The QCameraFocus class provides interface for focus and zoom related camera settings. More...

 #include <QCameraFocus>

Inherits QObject.

This class was introduced in Qt Mobility 1.1.

Public Types

enum FocusMode { ManualFocus, AutoFocus, ContinuousFocus, InfinityFocus, HyperfocalFocus, MacroFocus }
flags FocusModes
enum FocusPointMode { FocusPointAuto, FocusPointCenter, FocusPointFaceDetection, FocusPointCustom }

Properties

Public Functions

QPointF customFocusPoint () const
qreal digitalZoom () const
FocusMode focusMode () const
FocusPointMode focusPointMode () const
QCameraFocusZoneList focusZones () const
bool isAvailable () const
bool isFocusModeSupported ( FocusMode mode ) const
bool isFocusPointModeSupported ( FocusPointMode mode ) const
qreal maximumDigitalZoom () const
qreal maximumOpticalZoom () const
qreal opticalZoom () const
void setCustomFocusPoint ( const QPointF & point )
void setFocusMode ( FocusMode mode )
void setFocusPointMode ( FocusPointMode mode )
void zoomTo ( qreal optical, qreal digital )

Signals

void digitalZoomChanged ( qreal value )
void focusZonesChanged ()
void maximumDigitalZoomChanged ( qreal zoom )
void maximumOpticalZoomChanged ( qreal zoom )
void opticalZoomChanged ( qreal value )

Additional Inherited Members

Detailed Description

The QCameraFocus class provides interface for focus and zoom related camera settings.

Member Type Documentation

enum QCameraFocus::FocusMode
flags QCameraFocus::FocusModes

ConstantValueDescription
QCameraFocus::ManualFocus0x1Manual or fixed focus mode.
QCameraFocus::AutoFocus0x8One-shot auto focus mode.
QCameraFocus::ContinuousFocus0x10Continuous auto focus mode.
QCameraFocus::InfinityFocus0x04Focus strictly to infinity.
QCameraFocus::HyperfocalFocus0x02Focus to hyperfocal distance, with with the maximum depth of field achieved. All objects at distances from half of this distance out to infinity will be acceptably sharp.
QCameraFocus::MacroFocus0x20One shot auto focus to objects close to camera.

The FocusModes type is a typedef for QFlags<FocusMode>. It stores an OR combination of FocusMode values.

enum QCameraFocus::FocusPointMode

ConstantValueDescription
QCameraFocus::FocusPointAuto0Automatically select one or multiple focus points.
QCameraFocus::FocusPointCenter1Focus to the frame center.
QCameraFocus::FocusPointFaceDetection2Focus on faces in the frame.
QCameraFocus::FocusPointCustom3Focus to the custom point, defined by QCameraFocus::customFocusPoint property.

Property Documentation

customFocusPoint : QPointF

Position of custom focus point, in relative frame coordinates: QPointF(0,0) points to the left top frame point, QPointF(0.5,0.5) points to the frame center.

Custom focus point is used only in FocusPointCustom focus mode.

Access functions:

QPointF customFocusPoint () const
void setCustomFocusPoint ( const QPointF & point )

digitalZoom : const qreal

This property holds the current digital zoom value.

Access functions:

qreal digitalZoom () const

Notifier signal:

void digitalZoomChanged ( qreal value )

See also QCameraFocus::opticalZoom.

focusMode : FocusMode

This property holds the current camera focus mode.

Access functions:

FocusMode focusMode () const
void setFocusMode ( FocusMode mode )

See also QCameraFocus::isFocusModeSupported().

focusPointMode : FocusPointMode

This property holds the current camera focus point selection mode.

Access functions:

FocusPointMode focusPointMode () const
void setFocusPointMode ( FocusPointMode mode )

See also QCameraFocus::isFocusPointModeSupported().

focusZones : const QCameraFocusZoneList

Returns the list of active focus zones.

If QCamera::FocusPointAuto or QCamera::FocusPointFaceDetection focus mode is selected this method returns the list of zones the camera is actually focused on.

The coordinates system is the same as for custom focus points: QPointF(0,0) points to the left top frame point, QPointF(0.5,0.5) points to the frame center.

Access functions:

QCameraFocusZoneList focusZones () const

Notifier signal:

void focusZonesChanged ()

opticalZoom : const qreal

This property holds the current optical zoom value.

Access functions:

qreal opticalZoom () const

Notifier signal:

void opticalZoomChanged ( qreal value )

See also QCameraFocus::digitalZoom.

Member Function Documentation

void QCameraFocus::digitalZoomChanged ( qreal value ) [signal]

Signal emitted when digital zoom value changes to new value.

void QCameraFocus::focusZonesChanged () [signal]

Signal is emitted when the set of zones, camera focused on is changed.

Usually the zones list is changed when the camera is focused.

bool QCameraFocus::isAvailable () const

Returns true if focus related settings are supported by this camera.

bool QCameraFocus::isFocusModeSupported ( FocusMode mode ) const

Returns true if the focus mode is supported by camera.

bool QCameraFocus::isFocusPointModeSupported ( FocusPointMode mode ) const

Returns true if focus point mode is supported.

qreal QCameraFocus::maximumDigitalZoom () const

Returns the maximum digital zoom

void QCameraFocus::maximumDigitalZoomChanged ( qreal zoom ) [signal]

Signal emitted when the maximum supported digital zoom value changed.

The maximum supported zoom value can depend on other camera settings, like capture mode or resolution.

qreal QCameraFocus::maximumOpticalZoom () const

Returns the maximum optical zoom

void QCameraFocus::maximumOpticalZoomChanged ( qreal zoom ) [signal]

Signal emitted when the maximum supported optical zoom value changed.

void QCameraFocus::opticalZoomChanged ( qreal value ) [signal]

Signal emitted when optical zoom value changes to new value.

void QCameraFocus::zoomTo ( qreal optical, qreal digital )

Set the camera optical and digital zoom values.