Back to Qt.io
Contact Us Blog Download Qt

Camera QML Type

초점 및 줌과 관련된 카메라 설정을 위한 인터페이스입니다. 더 보기...

Import Statement: import QtMultimedia
In C++: QCamera

속성

신호

방법

상세 설명

카메라 요소는 동영상 녹화 및 이미지 촬영을 위해 CaptureSession 내에서 사용할 수 있습니다.

MediaDevices 을 사용하여 사용 가능한 카메라를 나열하고 사용할 카메라를 선택할 수 있습니다.

MediaDevices {
    id: mediaDevices
}
CaptureSession {
    camera: Camera {
        cameraDevice: mediaDevices.defaultVideoInput
    }
}

이를 지원하는 하드웨어에서는 QCamera 에서 초점과 줌을 조정할 수 있습니다. 여기에는 근접 작업(예: 바코드 읽기 또는 글자 인식)을 위한 '매크로' 모드 또는 하드웨어가 초점을 맞추려고 시도할 이미지의 흥미로운 영역을 나타내는 '터치하여 초점 맞추기' 등의 기능도 포함됩니다.

Item {
    width: 640
    height: 360

    CaptureSession {
        camera: Camera {
            id: camera

            focusMode: Camera.FocusModeAutoNear
            customFocusPoint: Qt.point(0.2, 0.2) // Focus relative to top-left corner
        }
        videoOutput: videoOutput
    }

    VideoOutput {
        id: videoOutput
        anchors.fill: parent
    }
}

minimumZoomFactor 및 maximumZoomFactor 속성은 지원되는 줌 배율의 범위를 제공합니다. zoomFactor 속성을 사용하면 줌 배율을 변경할 수 있습니다.

Camera {
    zoomFactor: maximumZoomFactor // zoom in as much as possible
}

카메라 프레임의 원시 데이터를 캡처한 후 카메라 하드웨어와 소프트웨어는 최종 이미지를 생성하기 위해 다양한 이미지 처리 작업을 수행합니다. 여기에는 주변 조명 색상 보정, 노이즈 감소, 기타 이미지 조정 등이 포함됩니다.

카메라 속성을 통해 이러한 처리 단계의 대부분을 제어할 수 있습니다. 예를 들어 이미지 처리에 사용되는 화이트 밸런스(또는 색온도)를 설정할 수 있습니다:

Camera {
    whiteBalanceMode: Camera.WhiteBalanceManual
    colorTemperature: 5600
}

카메라 프레임의 이미지 처리에 대한 자세한 내용은 카메라 이미지 처리를 참조하세요.

자세한 내용은 카메라 개요를 참조하세요.

속성 문서

active : bool

카메라가 현재 활성화되어 있는지 여부를 설명합니다.


cameraDevice : cameraDevice

현재 활성화된 카메라 장치를 가져오거나 설정합니다.

카메라 장치를 전환하면 QCamera 의 기능이 업데이트됩니다. 또한 QCamera 의 제어 속성(예: focusMode, flashMode, focusDistance, zoomFactor)은 다음과 같이 업데이트됩니다:

  • 새 장치에서 속성이 지원되는 경우 해당 속성 값이 카메라 장치에 적용됩니다.
  • 속성이 지원되지만 유효한 값의 범위가 변경된 경우 속성이 새 범위로 고정되어 카메라 장치에 적용됩니다.
  • 새 카메라 장치가 속성을 지원하지 않는 경우 속성 값이 기본값으로 재설정되고 카메라 장치에는 변경 사항이 적용되지 않습니다.

cameraFormat : cameraFormat

현재 활성화된 카메라 형식을 가져오거나 설정합니다.

참고: Android 대상 디바이스에서 FFMPEG 백엔드를 사용할 때 YUV420P 포맷을 요청하면 완전 평면 4:2:0 YUV420P 또는 반평면 NV12/NV21을 받게 됩니다. 이는 디바이스 OEM에서 구현한 코덱에 따라 다릅니다.

cameraDevice::videoFormats 를참조하세요 .


customFocusPoint : point

이 속성은 사용자 지정 초점 포인트의 위치를 상대 프레임 좌표로 유지합니다. 즉, QPointF(0,0)은 프레임의 왼쪽 상단 모서리를 가리키고 QPointF(0.5,0.5)는 프레임의 중앙을 가리킵니다.

사용자 지정 초점 포인트는 FocusPointCustom 초점 모드에서만 사용됩니다.

사용자 지정 초점 포인트가 지원되는지 여부는 Feature.CustomFocusPoint 플래그와 함께 supportedFeatures()를 쿼리하여 확인할 수 있습니다.


error : enumeration [read-only]

카메라의 오류 상태를 반환합니다.

QCamera::Error 를참조하세요 .


errorString : string [read-only]

카메라의 오류 상태를 설명하는 사람이 읽을 수 있는 문자열을 반환합니다.


exposureCompensation : real

노출 보정을 EV 단위로 가져오거나 설정합니다.

노출 보정 속성을 사용하면 자동으로 계산된 노출을 조정할 수 있습니다.


exposureMode : ExposureMode

사용 중인 노출 모드입니다.

QCamera::ExposureMode 및 Camera::isExposureModeSupported()도 참조하세요 .


exposureTime : real [read-only]

카메라의 노출 시간을 초 단위로 반환합니다.

manualExposureTime참조 .


flashMode : enumeration

카메라에 플래시가 있는 경우 특정 플래시 모드를 가져오거나 설정합니다.

상수설명
Camera.FlashOff플래시가 꺼져 있습니다.
Camera.FlashOn플래시가 켜져 있습니다.
Camera.FlashAuto자동 플래시.

isFlashModeSupported 및 isFlashReady 을참조하십시오 .


flashReady : bool [read-only]

플래시가 충전되어 사용할 준비가 되었는지를 나타냅니다.


focusDistance : real

이 속성은 카메라 장치가 수동 초점 모드에서 작동할 때 렌즈 초점 거리를 정의합니다. 유효한 값은 0에서 1 사이이며, 0은 가능한 가장 가까운 초점 거리이고 1은 가장 먼 거리입니다. 가장 먼 지점은 일반적으로 무한대이지만 모든 디바이스에 해당되는 것은 아닙니다.

이 속성은 focusMode 가 Camera.FocusModeManual로 설정되어 있고 supportedFeatures 에 Camera.FocusDistance 플래그가 포함된 경우에만 디바이스에 적용됩니다.

focusMode 이 Camera.FocusModeManual로 설정되지 않은 상태에서 이 프로퍼티에 값을 할당하면 프로퍼티는 값을 저장하지만 Camera.FocusModeManual이 활성화될 때까지 장치에 영향을 미치지 않습니다.

유효한 범위[0, 1]를 벗어난 값을 할당해도 이 속성에는 영향을 미치지 않습니다.

supportedFeatures 에 Camera.FocusDistance 플래그가 포함되지 않은 경우 이 속성을 설정하려는 시도는 무시됩니다.

카메라가 자동 초점 모드에 있을 때는 이 속성이 업데이트되지 않습니다.

기본값은 1입니다.


focusMode : enumeration

이 프로퍼티는 카메라 장치의 초점 모드를 제어하는 값을 보유합니다. 모든 자동 초점 모드에서 카메라 장치는 계속 초점을 유지합니다.

참고: 자동 초점 모드에서 지원되는 경우 focusPoint 속성은 초점이 맞춰지는 이미지 영역에 대한 정보와 제어 기능을 제공합니다.

Constant설명
Camera.FocusModeAuto연속 자동 초점 모드.
Camera.FocusModeAutoNear연속 자동 초점, 카메라에 가까운 피사체에 우선적으로 초점을 맞춥니다.
Camera.FocusModeAutoFar연속 자동 초점, 카메라에서 멀리 떨어진 피사체를 선호합니다.
Camera.FocusModeHyperfocal최대 피사계 심도를 달성하여 초점 거리를 초점 거리로 설정합니다. 이 거리의 절반에서 무한대까지의 거리에 있는 모든 피사체가 선명하게 촬영됩니다.
Camera.FocusModeInfinity엄격하게 무한대까지 초점 맞추기.
Camera.FocusModeManual렌즈 초점 거리는 focusDistance 에서 지정한 값으로 설정됩니다.

카메라 장치가 특정 초점 모드를 지원하는지 확인하려면 isFocusModeSupported 함수에 해당 FocusMode 값을 파라미터로 전달하세요. 초점 모드 값이 지원되지 않으면 이 함수는 false를 반환합니다. 이 모드를 focusMode 속성에 할당해도 아무런 효과가 없습니다.

focusMode 속성을 Camera.FocusModeManual로 설정하면 렌즈가 focusDistance 에 따라 초점을 고정합니다.

isFocusModeSupported 를참조하세요 .


focusPoint : point [read-only]

현재 자동 초점 시스템에서 초점을 맞추는 데 사용하는 포인트를 반환합니다.


isoSensitivity : int [read-only]

현재 카메라에서 사용 중인 ISO 감도를 설명합니다.


manualExposureTime : real

수동 노출 시간을 가져오거나 설정합니다.

이 속성을 -1(기본값)로 설정하면 카메라가 노출 시간을 자동으로 결정합니다.


manualIsoSensitivity : int

수동으로 설정한 ISO 감도를 설명합니다.

이 속성을 -1(기본값)로 설정하면 카메라가 ISO 감도를 자동으로 조정합니다.


maximumZoomFactor : real [read-only]

이 속성은 지원되는 최대 줌 배율을 보유합니다.

줌을 지원하지 않는 카메라에서는 1.0 이 됩니다.


minimumZoomFactor : real [read-only]

이 속성은 지원되는 최소 줌 배율을 보유합니다.

줌을 지원하지 않는 카메라에서는 1.0 이 됩니다.


supportedFeatures : Features [read-only]

이 카메라에서 지원하는 기능을 반환합니다.

QCamera::Feature도 참조하세요 .


torchMode : Camera::TorchMode

사용 중인 토치 모드를 가져오거나 설정합니다.

토치는 연속적인 광원입니다. 저조도 환경에서 비디오 녹화 중에 사용할 수 있습니다. 토치 모드를 활성화하면 일반적으로 현재 설정된 모든 플래시 모드가 재정의됩니다.

QCamera::TorchMode, Camera::isTorchModeSupported() 및 Camera::flashMode 를참조하세요 .


whiteBalanceMode : WhiteBalanceMode

사용 중인 화이트 밸런스 모드를 가져오거나 설정합니다.

QCamera::WhiteBalanceMode도 참조 하세요.


zoomFactor : real

현재 줌 배율을 가져오거나 설정합니다. 값은 minimumZoomFactor 과 maximumZoomFactor 사이에 고정됩니다.


신호 문서

void errorOccurred(Camera::Error error, string errorString)

이 신호는 오류 상태가 error 로 변경될 때 발생합니다. 오류에 대한 설명은 errorString 으로 제공됩니다.

참고: 해당 핸들러는 onErrorOccurred 입니다.


메서드 문서

colorTemperature()

현재 색온도를 가져오거나 설정합니다.

색온도를 설정하면 WhiteBalanceManual이 지원되는 경우에만 효과가 있습니다. 이 경우 온도를 0보다 크게 설정하면 화이트 밸런스 모드가 자동으로 WhiteBalanceManual로 설정됩니다. 온도를 0으로 설정하면 화이트 밸런스 모드가 WhiteBalanceAuto로 재설정됩니다.


bool isExposureModeSupported(ExposureMode mode)

노출 mode 이 지원되면 참을 반환합니다.


bool isFlashModeSupported(FlashMode mode)

플래시가 지원되면 참을 반환합니다( mode ).


bool isFlashReady()

플래시가 충전되면 참을 반환합니다.


bool isFocusModeSupported(FocusMode mode)

카메라에서 포커스 mode 가 지원되면 참을 반환합니다.

FocusModeManual이 지원되는 것으로 보고되면 Feature::FocusDistance 기능도 지원되는 것으로 암시됩니다.


bool isTorchModeSupported(TorchMode mode)

토치 mode 가 지원되면 참을 반환합니다.


bool isWhiteBalanceModeSupported(WhiteBalanceMode mode)

화이트 밸런스 mode 가 지원되면 참을 반환합니다.


void start()

카메라를 시작합니다.

활성 프로퍼티를 true로 설정하는 것과 동일합니다.

어떤 이유로 카메라를 시작할 수 없는 경우 errorOccurred() 신호가 전송됩니다.


void stop()

카메라를 중지합니다. 활성 속성을 false로 설정하는 것과 동일합니다.


void zoomTo(factor, rate)

rate 을 사용하여 줌 배율 factor 로 줌합니다.

rate 은 초당 2의 거듭제곱으로 지정됩니다. 1의 비율을 사용하면 줌 배율 1에서 4로 이동하는 데 2초가 걸립니다.

참고: 특정 배율을 사용하는 것이 모든 카메라에서 지원되는 것은 아닙니다. 지원되지 않는 경우 가능한 한 빠르게 확대/축소가 이루어집니다.


© 2025 The Qt Company Ltd. Documentation contributions included herein are the copyrights of their respective owners. The documentation provided herein is licensed under the terms of the GNU Free Documentation License version 1.3 as published by the Free Software Foundation. Qt and respective logos are trademarks of The Qt Company Ltd. in Finland and/or other countries worldwide. All other trademarks are property of their respective owners.