              
QCameraFocus Class ReferenceThe QCameraFocus class provides interface for focus and zoom related camera settings. More... #include <QCameraFocus> Inherits QObject. Public Types
Properties
Public Functions
Signals
Additional Inherited Members
Detailed DescriptionThe QCameraFocus class provides interface for focus and zoom related camera settings. Member Type Documentation
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.
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.