Camera QML Type

초점 및 줌과 관련된 카메라 설정용 인터페이스. 더 보기...

• 상속된 멤버를 포함한 모든 멤버 목록

속성

• active : bool
• cameraDevice : cameraDevice
• cameraFormat : cameraFormat
• colorTemperature : int
• customFocusPoint : point
• error : enumeration
• errorString : string
• exposureCompensation : real
• exposureMode : enumeration
• exposureTime : real
• flashMode : enumeration
• flashReady : bool
• focusDistance : real
• focusMode : enumeration
• focusPoint : point
• isoSensitivity : int
• manualExposureTime : real
• manualIsoSensitivity : int
• maximumZoomFactor : real
• minimumZoomFactor : real
• supportedFeatures : enumeration
• torchMode : enumeration
• whiteBalanceMode : enumeration
• zoomFactor : real

신호

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

방법

• bool isExposureModeSupported(ExposureMode mode)
• bool isFlashModeSupported(FlashMode mode)
• bool isFlashReady()
• bool isFocusModeSupported(FocusMode mode)
• bool isTorchModeSupported(TorchMode mode)
• bool isWhiteBalanceModeSupported(WhiteBalanceMode mode)
• void start()
• void stop()
• void zoomTo(factor, rate)

상세 설명

CaptureSession 내에서 Camera 요소를 사용하여 동영상 녹화 및 사진 촬영을 수행할 수 있습니다.

MediaDevices 를 사용하여 사용 가능한 카메라 목록을 확인하고 사용할 카메라를 선택할 수 있습니다.

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

이를 지원하는 하드웨어에서 Camera 를 사용하면 초점과 줌을 조정할 수 있습니다. minimumZoomFactor 및 maximumZoomFactor 속성은 지원되는 줌 배율 범위를 제공합니다. zoomFactor 속성을 사용하면 줌 배율을 변경할 수 있습니다.

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

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

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

Camera {
    whiteBalanceMode: Camera.WhiteBalanceManual
    colorTemperature: 5600
}

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

대부분의 플랫폼에서는 카메라를 활성화하기 전에 최종 사용자가 권한을 부여해야 합니다. 따라서 애플리케이션 개발자는 카메라를 다룰 때 ' CameraPermission ' 컴포넌트를 사용하는 것이 강력히 권장됩니다. 다음은 애플리케이션 시작 시 최종 사용자에게 권한을 요청하고, 권한이 부여되면 카메라를 활성화하는 간단한 예제입니다.

CameraPermission {
    id: cameraPermission
}

Camera {
    active: cameraPermission.status === Qt.PermissionStatus.Granted
}

Component.onCompleted: cameraPermission.request()

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

속성 설명서

active : bool

카메라가 현재 활성화되어 있는지 여부를 나타냅니다.

cameraDevice : cameraDevice

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

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

• 새 장치에서 속성이 지원되는 경우, 해당 속성 값이 카메라 장치에 적용됩니다.
• 속성이 지원되지만 유효한 값의 범위가 변경된 경우, 해당 속성은 새로운 범위로 제한된 후 카메라 장치에 적용됩니다.
• 새로운 카메라 기기에서 속성이 지원되지 않는 경우, 속성 값은 기본값으로 재설정되며 카메라 기기에는 아무런 변경 사항도 적용되지 않습니다.

cameraFormat : cameraFormat

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

cameraDevice::videoFormats도 참조하십시오 .

colorTemperature : int

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

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

customFocusPoint : point

이 속성은 상대 프레임 좌표계에서 사용자 정의 초점 지점의 위치를 나타냅니다. 즉, QPointF(0,0)은 프레임의 왼쪽 상단 모서리를 가리키며, QPointF(0.5,0.5)는 프레임의 중심을 가리킵니다.

Feature.CustomFocusPoint 플래그를 사용하여 supportedFeatures()를 쿼리하면 사용자 정의 초점 지점이 지원되는지 확인할 수 있습니다.

error : enumeration [read-only]

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

errorString : string [read-only]

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

exposureCompensation : real

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

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

exposureMode : enumeration

현재 사용 중인 노출 모드.

isExposureModeSupported()도 참조하십시오 .

exposureTime : real [read-only]

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

manualExposureTime도 참조하십시오 .

flashMode : enumeration

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

이 속성에 지원되지 않는 모드를 지정해도 아무런 효과가 없습니다.

이 속성은 다음을 사용하여 이미지를 촬영할 때만 효과가 있습니다. ImageCapture

isFlashModeSupported(), isFlashReady() 및 flashReady도 참조하십시오 .

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

이 속성은 카메라 장치의 초점 모드를 제어하는 값을 저장합니다. 모든 자동 초점 모드에서 카메라 장치는 지속적으로 초점을 맞추게 됩니다.

카메라 장치가 특정 초점 모드를 지원하는지 확인하려면, 해당 focusMode 값을 매개변수로 isFocusModeSupported() 함수에 전달하십시오. 이 함수는 초점 모드 값이 지원되지 않는 경우 false 를 반환합니다. 이 속성에 지원되지 않는 모드를 할당해도 아무런 효과가 없습니다.

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 : enumeration [read-only]

이 카메라에서 지원하는 기능을 반환합니다. 반환값은 비트마스크이며, 다음 플래그 중 하나 이상을 포함할 수 있습니다. 이 값은 기능 값들의 OR 조합을 저장합니다.

torchMode : enumeration

현재 사용 중인 손전등 모드를 가져오거나 설정합니다.

토치는 지속적인 광원입니다. 저조도 환경에서 동영상 촬영 시 사용할 수 있습니다. 토치 모드를 활성화하면 일반적으로 현재 설정된 플래시 모드가 무시됩니다.

isTorchModeSupported() 및 flashMode도 참조하십시오 .

whiteBalanceMode : enumeration

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

isWhiteBalanceModeSupported()도 참조하십시오 .

zoomFactor : real

현재 확대/축소 배율을 가져오거나 설정합니다. 값은 minimumZoomFactor 과 maximumZoomFactor 사이로 제한됩니다.

신호 문서

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

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

메서드 문서

bool isExposureModeSupported(ExposureMode mode)

노출 mode 이 지원되는 경우 true를 반환합니다.

bool isFlashModeSupported(FlashMode mode)

플래시 mode 가 지원되는 경우 true를 반환합니다.

bool isFlashReady()

플래시가 충전된 경우 true를 반환합니다.

bool isFocusModeSupported(FocusMode mode)

카메라에서 ‘ mode ’에 대한 초점 지원이 가능한 경우 ‘ true ’을 반환합니다.

Camera.FocusModeManual 가 지원되는 것으로 보고되면, Camera.FocusDistance 기능도 마찬가지로 지원되는 것으로 간주됩니다.

bool isTorchModeSupported(TorchMode mode)

' mode ' 토치가 지원되는 경우 true를 반환합니다.

bool isWhiteBalanceModeSupported(WhiteBalanceMode mode)

화이트 밸런스 mode 가 지원되는 경우 true를 반환합니다.

void start()

카메라를 시작합니다.

active 속성을 true로 설정하는 것과 동일합니다.

어떤 이유로든 카메라를 시작할 수 없는 경우, ` errorOccurred()` 신호가 발생합니다.

void stop()

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

void zoomTo(factor, rate)

rate 를 사용하여 factor 의 배율로 확대합니다.

rate 는 초당 2의 거듭제곱 단위로 지정됩니다. 속도가 1일 경우, 줌 배율을 1에서 4로 변경하는 데 2초가 소요됩니다.