QCameraFocusZone

The QCameraFocusZone class provides information on zones used for autofocusing a camera. More

Inheritance diagram of PySide2.QtMultimedia.QCameraFocusZone

Synopsis

Functions

Detailed Description

For cameras that support autofocusing, in order for a camera to autofocus on part of a sensor frame, it considers different zones within the frame. Which zones to use, and where the zones are located vary between different cameras.

This class exposes what zones are used by a particular camera, and a list of the zones can be retrieved by a QCameraFocus instance.

You can use this information to present visual feedback - for example, drawing rectangles around areas of the camera frame that are in focus, or changing the color of a zone as it comes into focus.

focus->setFocusPointMode(QCameraFocus::FocusPointAuto);
const QList<QCameraFocusZone> zones = focus->focusZones();
for (const QCameraFocusZone &zone : zones) {
    if (zone.status() == QCameraFocusZone::Focused) {
        // Draw a green box at zone.area()
    } else if (zone.status() == QCameraFocusZone::Selected) {
        // This area is selected for autofocusing, but is not in focus
        // Draw a yellow box at zone.area()
    }
}

See also

QCameraFocus

class PySide2.QtMultimedia.QCameraFocusZone

PySide2.QtMultimedia.QCameraFocusZone(other)

PySide2.QtMultimedia.QCameraFocusZone(area[, status=Selected])

param area

PySide2.QtCore.QRectF

param status

FocusZoneStatus

param other

PySide2.QtMultimedia.QCameraFocusZone

Creates a new, empty QCameraFocusZone .

Creates a new QCameraFocusZone as a copy of other .

Creates a new QCameraFocusZone with the supplied area and status .

PySide2.QtMultimedia.QCameraFocusZone.FocusZoneStatus

Constant

Description

QCameraFocusZone.Invalid

This zone is not valid

QCameraFocusZone.Unused

This zone may be used for autofocusing, but is not currently.

QCameraFocusZone.Selected

This zone is currently being used for autofocusing, but is not in focus.

QCameraFocusZone.Focused

This zone is being used for autofocusing and is currently in focus.

PySide2.QtMultimedia.QCameraFocusZone.area()
Return type

PySide2.QtCore.QRectF

Returns the area of the camera frame that this focus zone encompasses.

Coordinates are in frame relative coordinates - QPointF(0,0) is the top left of the frame, and QPointF(1,1) is the bottom right.

PySide2.QtMultimedia.QCameraFocusZone.isValid()
Return type

bool

Returns true if this focus zone has a valid area and status.

PySide2.QtMultimedia.QCameraFocusZone.__ne__(other)
Parameters

otherPySide2.QtMultimedia.QCameraFocusZone

Return type

bool

Returns true if this focus zone is not the same as other .

PySide2.QtMultimedia.QCameraFocusZone.__eq__(other)
Parameters

otherPySide2.QtMultimedia.QCameraFocusZone

Return type

bool

Returns true if this focus zone is the same as other .

PySide2.QtMultimedia.QCameraFocusZone.setStatus(status)
Parameters

statusFocusZoneStatus

Sets the current status of this focus zone to status .

See also

status()

PySide2.QtMultimedia.QCameraFocusZone.status()
Return type

FocusZoneStatus

Returns the current status of this focus zone.