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.
| enum | FocusMode { ManualFocus, AutoFocus, ContinuousFocus, InfinityFocus, HyperfocalFocus, MacroFocus } |
| flags | FocusModes |
| enum | FocusPointMode { FocusPointAuto, FocusPointCenter, FocusPointFaceDetection, FocusPointCustom } |
|
|
| 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 ) |
| void | digitalZoomChanged ( qreal value ) |
| void | focusZonesChanged () |
| void | maximumDigitalZoomChanged ( qreal zoom ) |
| void | maximumOpticalZoomChanged ( qreal zoom ) |
| void | opticalZoomChanged ( qreal value ) |
The QCameraFocus class provides interface for focus and zoom related camera settings.
| 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.
| 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. |
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 ) |
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.
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().
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().
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 () |
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.
Signal emitted when digital zoom value changes to new value.
This function was introduced in Qt Mobility 1.1.
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.
Returns true if focus related settings are supported by this camera.
This function was introduced in Qt Mobility 1.1.
Returns true if the focus mode is supported by camera.
This function was introduced in Qt Mobility 1.1.
Returns true if focus point mode is supported.
This function was introduced in Qt Mobility 1.1.
Returns the maximum digital zoom
This function was introduced in Qt Mobility 1.1.
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.
Returns the maximum optical zoom
This function was introduced in Qt Mobility 1.1.
Signal emitted when the maximum supported optical zoom value changed.
This function was introduced in Qt Mobility 1.1.
Signal emitted when optical zoom value changes to new value.
This function was introduced in Qt Mobility 1.1.
Set the camera optical and digital zoom values.
This function was introduced in Qt Mobility 1.1.