QCameraInfo¶
The
QCameraInfo
class provides general information about camera devices. More…

Synopsis¶
Functions¶
def
__eq__
(other)def
__ne__
(other)def
description
()def
deviceName
()def
isNull
()def
orientation
()def
position
()
Static functions¶
def
availableCameras
([position=QCamera.UnspecifiedPosition])def
defaultCamera
()
Detailed Description¶
QCameraInfo
lets you query for camera devices that are currently available on the system.The static functions
defaultCamera()
andavailableCameras()
provide you a list of all available cameras.This example prints the name of all available cameras:
QList<QCameraInfo> cameras = QCameraInfo::availableCameras(); foreach (const QCameraInfo &cameraInfo, cameras) qDebug() << cameraInfo.deviceName();A
QCameraInfo
can be used to construct aQCamera
. The following example instantiates aQCamera
whose camera device is named ‘mycamera’:QList<QCameraInfo> cameras = QCameraInfo::availableCameras(); foreach (const QCameraInfo &cameraInfo, cameras) { if (cameraInfo.deviceName() == "mycamera") camera = new QCamera(cameraInfo); }You can also use
QCameraInfo
to get general information about a camera device such as description, physical position on the system, or camera sensor orientation.QCamera myCamera; QCameraInfo cameraInfo(myCamera); if (cameraInfo.position() == QCamera::FrontFace) qDebug() << "The camera is on the front face of the hardware system."; else if (cameraInfo.position() == QCamera::BackFace) qDebug() << "The camera is on the back face of the hardware system."; qDebug() << "The camera sensor orientation is " << cameraInfo.orientation() << " degrees.";See also
-
class
QCameraInfo
([name=QByteArray()])¶ QCameraInfo(camera)
QCameraInfo(other)
- param camera
- param name
QByteArray
- param other
Constructs a camera info object from a camera device
name
.If no such device exists, the
QCameraInfo
object will be invalid andisNull()
will return true.Constructs a camera info object for
camera
.You can use it to query information about the
camera
object passed as argument.If the
camera
is invalid, for example when no camera device is available on the system, theQCameraInfo
object will be invalid andisNull()
will return true.Constructs a copy of
other
.
-
static
PySide2.QtMultimedia.QCameraInfo.
availableCameras
([position=QCamera.UnspecifiedPosition])¶ - Parameters
position –
Position
- Return type
Returns a list of available cameras on the system which are located at
position
.If
position
is not specified or if the value isUnspecifiedPosition
, a list of all available cameras will be returned.
-
static
PySide2.QtMultimedia.QCameraInfo.
defaultCamera
()¶ - Return type
Returns the default camera on the system.
The returned object should be checked using
isNull()
before being used, in case there is no default camera or no cameras at all.See also
-
PySide2.QtMultimedia.QCameraInfo.
description
()¶ - Return type
unicode
Returns the human-readable description of the camera.
-
PySide2.QtMultimedia.QCameraInfo.
deviceName
()¶ - Return type
unicode
Returns the device name of the camera
This is a unique ID to identify the camera and may not be human-readable.
-
PySide2.QtMultimedia.QCameraInfo.
isNull
()¶ - Return type
bool
Returns true if this
QCameraInfo
is null or invalid.
-
PySide2.QtMultimedia.QCameraInfo.
__ne__
(other)¶ - Parameters
other –
QCameraInfo
- Return type
bool
Returns true if this
QCameraInfo
is different fromother
.
-
PySide2.QtMultimedia.QCameraInfo.
__eq__
(other)¶ - Parameters
other –
QCameraInfo
- Return type
bool
Returns true if this
QCameraInfo
is equal toother
.
-
PySide2.QtMultimedia.QCameraInfo.
orientation
()¶ - Return type
int
Returns the physical orientation of the camera sensor.
The value is the orientation angle (clockwise, in steps of 90 degrees) of the camera sensor in relation to the display in its natural orientation.
You can show the camera image in the correct orientation by rotating it by this value in the anti-clockwise direction.
For example, suppose a mobile device which is naturally in portrait orientation. The back-facing camera is mounted in landscape. If the top side of the camera sensor is aligned with the right edge of the screen in natural orientation, the value should be 270. If the top side of a front-facing camera sensor is aligned with the right of the screen, the value should be 90.
-
PySide2.QtMultimedia.QCameraInfo.
position
()¶ - Return type
Position
Returns the physical position of the camera on the hardware system.