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

Member Function Documentation

QCamera::​QCamera(QObject * parent = 0)

Construct a QCamera with a parent.

QCamera::​QCamera(const QByteArray & deviceName, QObject * parent = 0)

Construct a QCamera from deviceName and parent.

If no camera with that deviceName exists, the camera object will be invalid.

QCamera::​QCamera(const QCameraInfo & cameraInfo, QObject * parent = 0)

Construct a QCamera from a camera description cameraInfo and parent.

This function was introduced in Qt 5.3.

QCamera::​QCamera(QCamera::Position position, QObject * parent = 0)

Construct a QCamera which uses a hardware camera located a the specified position.

For example on a mobile phone it can be used to easily choose between front-facing and back-facing cameras.

If no camera is available at the specified position or if position is QCamera::UnspecifiedPosition, the default camera is used.

This function was introduced in Qt 5.3.

QCamera::​~QCamera()

Destroys the camera object.

[virtual] QMultimedia::AvailabilityStatus QCamera::​availability() const

Reimplemented from QMediaObject::availability().

Returns the availability state of the camera service.

Error QCamera::​error() const

Returns the error state of the object.

[signal] void QCamera::​error(QCamera::Error value)

Signal emitted when error state changes to value.

QString QCamera::​errorString() const

Returns a string describing a camera's error state.

QCameraExposure * QCamera::​exposure() const

Returns the camera exposure control object.

QCameraFocus * QCamera::​focus() const

Returns the camera focus control object.

QCameraImageProcessing * QCamera::​imageProcessing() const

Returns the camera image processing control object.

bool QCamera::​isCaptureModeSupported(CaptureModes mode) const

Returns true if the capture mode is suported.

[slot] void QCamera::​load()

Open the camera device. The camera state is changed to QCamera::LoadedStatus.

It's not necessary to explcitly load the camera, unless unless the application have to read the supported camera settings and change the default depending on the camera capabilities.

In all the other cases it's possible to start the camera directly from unloaded state.

[signal] void QCamera::​lockFailed()

Signals locking of at least one requested camera settings failed.

[signal] void QCamera::​locked()

Signals all the requested camera settings are locked.

QCamera::LockTypes QCamera::​requestedLocks() const

Returns the requested lock types.

[slot] void QCamera::​searchAndLock()

Lock all the supported camera settings.

[slot] void QCamera::​searchAndLock(QCamera::LockTypes locks)

Locks the camera settings with the requested locks, including focusing in the single autofocus mode, exposure and white balance if the exposure and white balance modes are not manual.

The camera settings are usually locked before taking one or multiple still images, in responce to the shutter button being half pressed.

The QCamera::locked() signal is emitted when camera settings are successfully locked, otherwise QCamera::lockFailed() is emitted.

QCamera also emits lockStatusChanged(QCamera::LockType, QCamera::LockStatus) on individual lock status changes and lockStatusChanged(QCamera::LockStatus) signal on composite status changes.

Locking serves two roles: it initializes calculation of automatic parameter (focusing, calculating the correct exposure and white balance) and allows to keep some or all of those parameters during number of shots.

If the camera doesn't support keeping one of parameters between shots, the related lock state changes to QCamera::Unlocked.

It's also acceptable to relock already locked settings, depending on the lock parameter this initiates new focusing, exposure or white balance calculation.

void QCamera::​setViewfinder(QVideoWidget * viewfinder)

Sets the QVideoWidget based camera viewfinder. The previously set viewfinder is detached.

void QCamera::​setViewfinder(QGraphicsVideoItem * viewfinder)

Sets the QGraphicsVideoItem based camera viewfinder. The previously set viewfinder is detached.

void QCamera::​setViewfinder(QAbstractVideoSurface * surface)

Sets a video surface as the viewfinder of a camera.

If a viewfinder has already been set on the camera the new surface will replace it.

[slot] void QCamera::​start()

Starts the camera.

State is changed to QCamera::ActiveState if camera is started successfully, otherwise error() signal is emitted.

While the camera state is changed to QCamera::ActiveState, starting the camera service can be asynchronous with the actual status reported with QCamera::status property.

[slot] void QCamera::​stop()

Stops the camera. The camera state is changed from QCamera::ActiveState to QCamera::LoadedState.

QCamera::LockTypes QCamera::​supportedLocks() const

Returns the lock types, camera supports.

[slot] void QCamera::​unload()

Close the camera device and deallocate the related resources. The camera state is changed to QCamera::UnloadedStatus.

[slot] void QCamera::​unlock()

Unlock all the requested camera locks.

[slot] void QCamera::​unlock(QCamera::LockTypes locks)

Unlocks the camera settings specified with locks or cancel the current locking if one is active.