MeeGo 1.2 Harmattan Developer Documentation Develop for the Nokia N9

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

  • 1 property inherited from QObject

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 )
  • 29 public functions inherited from QObject

Signals

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

Additional Inherited Members

  • 1 public slot inherited from QObject
  • 1 public variable inherited from QObject
  • 4 static public members inherited from QObject
  • 7 protected functions inherited from QObject
  • 2 protected variables inherited from QObject

Detailed Description

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

Member Type Documentation

enum QCameraFocus::FocusMode
flags QCameraFocus::FocusModes

Constant Value Description
QCameraFocus::ManualFocus 0x1 Manual or fixed focus mode.
QCameraFocus::AutoFocus 0x8 One-shot auto focus mode.
QCameraFocus::ContinuousFocus 0x10 Continuous auto focus mode.
QCameraFocus::InfinityFocus 0x04 Focus strictly to infinity.
QCameraFocus::HyperfocalFocus 0x02 Focus 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::MacroFocus 0x20 One 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

Constant Value Description
QCameraFocus::FocusPointAuto 0 Automatically select one or multiple focus points.
QCameraFocus::FocusPointCenter 1 Focus to the frame center.
QCameraFocus::FocusPointFaceDetection 2 Focus on faces in the frame.
QCameraFocus::FocusPointCustom 3 Focus 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.

This property was introduced in Qt Mobility 1.1.

Access functions:

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

digitalZoom : const qreal

This property holds the current digital zoom value.

This property was introduced in Qt Mobility 1.1.

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.

This property was introduced in Qt Mobility 1.1.

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.

This property was introduced in Qt Mobility 1.1.

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.

This property was introduced in Qt Mobility 1.1.

Access functions:

QCameraFocusZoneList focusZones () const

Notifier signal:

void focusZonesChanged ()

opticalZoom : const qreal

This property holds the current optical zoom value.

This property was introduced in Qt Mobility 1.1.

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.

This function was introduced in Qt Mobility 1.1.

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.

This function was introduced in Qt Mobility 1.1.

bool QCameraFocus::isAvailable () const

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

This function was introduced in Qt Mobility 1.1.

bool QCameraFocus::isFocusModeSupported ( FocusMode mode ) const

Returns true if the focus mode is supported by camera.

This function was introduced in Qt Mobility 1.1.

bool QCameraFocus::isFocusPointModeSupported ( FocusPointMode mode ) const

Returns true if focus point mode is supported.

This function was introduced in Qt Mobility 1.1.

qreal QCameraFocus::maximumDigitalZoom () const

Returns the maximum digital zoom

This function was introduced in Qt Mobility 1.1.

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.

This function was introduced in Qt Mobility 1.1.

qreal QCameraFocus::maximumOpticalZoom () const

Returns the maximum optical zoom

This function was introduced in Qt Mobility 1.1.

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

Signal emitted when the maximum supported optical zoom value changed.

This function was introduced in Qt Mobility 1.1.

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

Signal emitted when optical zoom value changes to new value.

This function was introduced in Qt Mobility 1.1.

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

Set the camera optical and digital zoom values.

This function was introduced in Qt Mobility 1.1.