QCamera露

PyQt5.QtMultimedia.QCamera

Inherits from QMediaObject.

Description露

The QCamera class provides interface for system camera devices.

QCamera can be used with QCameraViewfinder for viewfinder display, QMediaRecorder for video recording and QCameraImageCapture for image taking.

You can use QCameraInfo to list available cameras and choose which one to use.

#     QList<QCameraInfo> cameras = QCameraInfo::availableCameras();
#     foreach (const QCameraInfo &cameraInfo, cameras) {
#         if (cameraInfo.deviceName() == "mycamera")
#             camera = new QCamera(cameraInfo);
#     }

See the camera overview for more information.

Enums露

CaptureMode

Member

Value

Description
CaptureStillImage

0x01

Camera is configured for still frames capture.
CaptureVideo

0x02

Camera is configured for video capture.
CaptureViewfinder

0

Camera is only configured to display viewfinder.
Error

Member

Value

Description
CameraError

1

An error has occurred.
InvalidRequestError

2

System resource doesn鈥檛 support requested functionality.
NoError

0

No errors have occurred.
NotSupportedFeatureError

4

The feature is not supported.
ServiceMissingError

3

No camera service available.
LockChangeReason

Member

Value

Description
LockAcquired

1

The lock status successfuly changed to Locked.
LockFailed

2

The camera failed to acquire the requested lock in result of autofocus failure, exposure out of supported range, etc.
LockLost

3

The camera is not able to maintain the requested lock any more. Lock status is changed to Unlocked.
LockTemporaryLost

4

The lock is lost, but the camera is working hard to reacquire it. This value may be used in continuous focusing mode, when the camera loses the focus, the focus lock state is changed to Qcamera::Searching with reason.
UserRequest

0

The lock status changed in result of user request, usually to unlock camera settings.
LockStatus

The locked state usually means the requested parameter stays the same, except of the cases when the parameter is requested to be constantly updated. For example in continuous focusing mode, the focus is considered locked as long and the object is in focus, even while the actual focusing distance may be constantly changing.

Member

Value

Description
Locked

2

The camera focus, exposure or white balance is locked. The camera is ready to capture, application may check the exposure parameters.
Searching

1

The application has requested the camera focus, exposure or white balance lock with searchAndLock(). This state indicates the camera is focusing or calculating exposure and white balance.
Unlocked

0

The application is not interested in camera settings value. The camera may keep this parameter without changes, this is common with camera focus, or adjust exposure and white balance constantly to keep the viewfinder image nice.
LockType

Member

Value

Description
LockExposure

0x01

Lock camera exposure.
LockFocus

0x04

Lock camera focus.
LockWhiteBalance

0x02

Lock the white balance.
NoLock

TODO

TODO
Position

This enum specifies the physical position of the camera on the system hardware.

See also

position().

Member

Value

Description
BackFace

1

The camera is on the back face of the system hardware. For example on a mobile device, it means it is on the opposite side to that of the screen.
FrontFace

2

The camera is on the front face of the system hardware. For example on a mobile device, it means it is on the same side as that of the screen. Viewfinder frames of front-facing cameras are mirrored horizontally, so the users can see themselves as looking into a mirror. Captured images or videos are not mirrored.
UnspecifiedPosition

0

The camera position is unspecified or unknown.
State

While the supported settings are unknown in this state, it鈥檚 allowed to set the camera capture settings like codec, resolution, or frame rate.

In the Idle state it鈥檚 allowed to query camera capabilities, set capture resolution, codecs, etc.

The viewfinder is not active in the loaded state.

Member

Value

Description
ActiveState

2

In the active state as soon as camera is started the viewfinder displays video frames and the camera is ready for capture.
LoadedState

1

The camera is loaded and ready to be configured.
UnloadedState

0

The initial camera state, with camera not loaded, the camera capabilities except of supported capture modes are unknown.
Status

Depending on backend, changing some camera settings like capture mode, codecs or resolution in ActiveState may lead to changing the camera status to and while the settings are applied and back to when the camera is ready.

Member

Value

Description
ActiveStatus

8

The camera has been started and can produce data. The viewfinder displays video frames in active state.
LoadedStatus

4

The camera is loaded and ready to be configured. This status indicates the camera device is opened and it鈥檚 possible to query for supported image and video capture settings, like resolution, framerate and codecs.
LoadingStatus

2

The camera device loading in result of state transition from UnloadedState to LoadedState or ActiveState.
StandbyStatus

5

The camera is in the power saving standby mode. The camera may come to the standby mode after some time of inactivity in the LoadedState state.
StartingStatus

6

The camera is starting in result of state transition to ActiveState. The camera service is not ready to capture yet.
StoppingStatus

7

The camera is stopping in result of state transition from ActiveState to LoadedState or UnloadedState.
UnavailableStatus

0

The camera or camera backend is not available.
UnloadedStatus

1

The initial camera status, with camera not loaded. The camera capabilities including supported capture settings may be unknown.
UnloadingStatus

3

The camera device is unloading in result of state transition from LoadedState or ActiveState to UnloadedState.

Methods露

__init__(parent: QObject = None)

TODO

__init__(Union[QByteArray, bytes, bytearray], parent: QObject = None)

TODO

__init__(QCameraInfo, parent: QObject = None)

TODO

__init__(Position, parent: QObject = None)

TODO

availability() → AvailabilityStatus

TODO

@staticmethod
availableDevices() → List[QByteArray]

TODO

captureMode() → CaptureModes

See also

setCaptureMode().

@staticmethod
deviceDescription(Union[QByteArray, bytes, bytearray]) → str

TODO

error() → Error

TODO

errorString() → str

TODO

exposure() → QCameraExposure

TODO

focus() → QCameraFocus

TODO

imageProcessing() → QCameraImageProcessing

TODO

isCaptureModeSupported(Union[CaptureModes, CaptureMode]) → bool

TODO

load()

TODO

lockStatus() → LockStatus

TODO

lockStatus(LockType) → LockStatus

TODO

requestedLocks() → LockTypes

TODO

searchAndLock()

TODO

searchAndLock(Union[LockTypes, LockType])

TODO

setCaptureMode(Union[CaptureModes, CaptureMode])

See also

captureMode().

setViewfinder(QVideoWidget)

TODO

setViewfinder(QGraphicsVideoItem)

TODO

setViewfinder(QAbstractVideoSurface)

TODO

setViewfinderSettings(QCameraViewfinderSettings)

TODO

start()

TODO

state() → State

TODO

status() → Status

TODO

stop()

TODO

supportedLocks() → LockTypes

TODO

supportedViewfinderFrameRateRanges(settings: QCameraViewfinderSettings = QCameraViewfinderSettings()) → List[FrameRateRange]

TODO

supportedViewfinderPixelFormats(settings: QCameraViewfinderSettings = QCameraViewfinderSettings()) → List[PixelFormat]

TODO

supportedViewfinderResolutions(settings: QCameraViewfinderSettings = QCameraViewfinderSettings()) → List[QSize]

TODO

supportedViewfinderSettings(settings: QCameraViewfinderSettings = QCameraViewfinderSettings()) → List[QCameraViewfinderSettings]

TODO

unload()

TODO

unlock()

TODO

unlock(Union[LockTypes, LockType])

TODO

viewfinderSettings() → QCameraViewfinderSettings

See also

setViewfinderSettings().

Signals露

captureModeChanged(Union[CaptureModes, CaptureMode])

TODO

error()

TODO

error(Error)

TODO

locked()

TODO

lockFailed()

TODO

lockStatusChanged(LockStatus, LockChangeReason)

TODO

lockStatusChanged(LockType, LockStatus, LockChangeReason)

TODO

stateChanged(State)

TODO

statusChanged(Status)

TODO