Класс QCameraInfo

Класс QCameraInfo предоставляет общую информацию о камерах. Подробнее...

• Список всех членов, включая унаследованные

Открытые функции

Статические открытые члены

Подробное описание

Класс QCameraInfo предоставляет общую информацию о камерах.

QCameraInfo позволяет запрашивать камеры, которые в настоящее время доступны в системе.

Статические функции defaultCamera() и availableCameras() предоставляют список всех доступных камер.

В этом примере выводятся имена всех доступных камер:

QList<QCameraInfo> cameras = QCameraInfo::availableCameras();
foreach (const QCameraInfo &cameraInfo, cameras)
    qDebug() << cameraInfo.deviceName();

Класс QCameraInfo может использоваться для создания объекта QCamera. Следующий пример создает объект QCamera, чье устройство камеры имеет имя 'mycamera':

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

Также можно использовать QCameraInfo для получения общей информации о устройстве камеры, такой как описание, физическое расположение в системе или ориентация датчика камеры.

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.";

См. также QCamera.

Документация по функциям-членам

QCameraInfo::QCameraInfo(const QByteArray &name = QByteArray())

Создает объект информации о камере из имени устройства камеры name.

Если такого устройства не существует, объект QCameraInfo будет недействительным, и isNull() вернет true.

QCameraInfo::QCameraInfo(const QCamera &camera)

Создает объект информации о камере для camera.

Можно использовать его для запроса информации об объекте camera, переданном в качестве аргумента.

Если camera недействительна, например, когда ни одно устройство камеры недоступно в системе, объект QCameraInfo будет недействительным, и isNull() вернет true.

QCameraInfo::QCameraInfo(const QCameraInfo &other)

Создаёт копию other.

QCameraInfo::~QCameraInfo()

Удаляет объект QCameraInfo.

[static] QList<QCameraInfo> QCameraInfo::availableCameras(QCamera::Position position = QCamera::UnspecifiedPosition)

Возвращает список доступных камер в системе, расположенных в позиции position.

Если position не указан или имеет значение QCamera::UnspecifiedPosition, возвращается список всех доступных камер.

[static] QCameraInfo QCameraInfo::defaultCamera()

Возвращает камеру по умолчанию в системе.

Возвращённый объект следует проверить с помощью isNull() перед использованием, на случай, если нет камеры по умолчанию или нет камер вообще.

См. также availableCameras().

QString QCameraInfo::description() const

Возвращает описание камеры в удобочитаемом виде.

QString QCameraInfo::deviceName() const

Возвращает имя устройства камеры.

Это уникальный идентификатор для идентификации камеры и может быть не удобочитаемым.

bool QCameraInfo::isNull() const

Возвращает true, если этот объект QCameraInfo равен null или недействителен.

int QCameraInfo::orientation() const

Возвращает физическую ориентацию датчика камеры.

Значение представляет собой угол поворота (по часовой стрелке, с шагом в 90 градусов) датчика камеры относительно дисплея в его естественной ориентации.

Можно отобразить изображение камеры в правильной ориентации, повернув его на этот угол против часовой стрелки.

Например, предположим мобильное устройство, которое по умолчанию имеет вертикальную ориентацию. Тыльная камера установлена в горизонтальной ориентации. Если верхняя сторона датчика камеры выровнена с правым краем экрана в естественной ориентации, значение должно быть 270. Если верхняя сторона датчика передней камеры выровнена с правой стороны экрана, значение должно быть 90.

QCamera::Position QCameraInfo::position() const

Возвращает физическое расположение камеры в аппаратной системе.

bool QCameraInfo::operator!=(const QCameraInfo &other) const

Возвращает true, если этот объект QCameraInfo отличается от other.

QCameraInfo &QCameraInfo::operator=(const QCameraInfo &other)

Устанавливает объект QCameraInfo равным other.

bool QCameraInfo::operator==(const QCameraInfo &other) const

Возвращает true, если этот объект QCameraInfo равен other.