QCamera Class

멤버 함수 문서

[explicit] QCamera::QCamera(QObject *parent = nullptr)

parent 를 사용하여 QCamera를 생성합니다.

사용 가능한 카메라가 두 개 이상인 경우 시스템의 기본 카메라를 선택합니다.

[explicit] QCamera::QCamera(QCameraDevice::Position position, QObject *parent = nullptr)

지정된 위치 position 에 있는 하드웨어 카메라를 사용하는 QCamera를 생성합니다.

예를 들어, 휴대폰에서는 이 기능을 사용하여 전면 카메라와 후면 카메라를 쉽게 선택할 수 있습니다.

지정된 position 에 사용할 수 있는 카메라가 없거나 position 이 QCameraDevice::UnspecifiedPosition 인 경우, 기본 카메라가 사용됩니다.

[explicit] QCamera::QCamera(const QCameraDevice &cameraDevice, QObject *parent = nullptr)

카메라 설명 cameraDevice 와 parent 을 기반으로 QCamera 객체를 생성합니다.

[override virtual noexcept] QCamera::~QCamera()

카메라 객체를 삭제합니다.

QMediaCaptureSession *QCamera::captureSession() const

이 카메라가 연결된 캡처 세션을 반환하거나, 카메라가 캡처 세션에 연결되어 있지 않은 경우 nullptr을 반환합니다.

QMediaCaptureSession::setCamera()를 사용하여 카메라를 세션에 연결하십시오.

[signal] void QCamera::errorOccurred(QCamera::Error error, const QString &errorString)

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

[signal] void QCamera::exposureCompensationChanged(float value)

노출 보정이 value 로 변경될 때 발생되는 신호입니다.

float QCamera::exposureTime() const

현재 노출 시간을 초 단위로 반환합니다.

[signal] void QCamera::exposureTimeChanged(float speed)

카메라의 노출 speed 이 변경되었음을 알리는 신호입니다.

[signal] void QCamera::flashReady(bool ready)

ready 속성의 상태가 변경되었음을 알립니다.

[signal] void QCamera::focusModeChanged()

focusMode 가 변경될 때 신호를 보냅니다.

bool QCamera::isActive() const

카메라가 현재 활성화된 경우 true를 반환합니다.

bool QCamera::isAvailable() const

카메라를 사용할 수 있는 경우 true를 반환합니다.

[invokable] bool QCamera::isExposureModeSupported(QCamera::ExposureMode mode) const

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

[invokable] bool QCamera::isFlashModeSupported(QCamera::FlashMode mode) const

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

[invokable] bool QCamera::isFlashReady() const

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

[invokable] bool QCamera::isFocusModeSupported(QCamera::FocusMode mode) const

카메라에서 mode 에 대한 포커스가 지원되는 경우 true 을 반환합니다.

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

[invokable] bool QCamera::isTorchModeSupported(QCamera::TorchMode mode) const

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

[invokable] bool QCamera::isWhiteBalanceModeSupported(QCamera::WhiteBalanceMode mode) const

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

[signal] void QCamera::isoSensitivityChanged(int value)

감도가 value 로 변경될 때 발생되는 신호입니다.

float QCamera::manualExposureTime() const

수동 노출 시간을 초 단위로 반환하며, 카메라가 자동 노출 시간을 사용하는 경우에는 -1을 반환합니다.

setManualExposureTime()도 참조하십시오 .

float QCamera::maximumExposureTime() const

초 단위의 최대 노출 시간.

int QCamera::maximumIsoSensitivity() const

카메라에서 지원하는 최대 ISO 감도를 반환합니다.

float QCamera::minimumExposureTime() const

최소 노출 시간(초).

int QCamera::minimumIsoSensitivity() const

카메라에서 지원하는 최소 ISO 감도를 반환합니다.

[slot] void QCamera::setActive(bool active)

active 가 true 인 경우 카메라를 켜고, false 인 경우 카메라를 끕니다.

isActive()도 참조하십시오 .

[slot] void QCamera::setAutoExposureTime()

자동으로 계산된 노출 시간을 사용

[slot] void QCamera::setAutoIsoSensitivity()

자동 감도 켜기

void QCamera::setCameraDevice(const QCameraDevice &cameraDevice)

카메라 객체를 ` cameraDevice`에 정의된 물리적 카메라 장치에 연결합니다. ` cameraDevice `로 기본 생성된 ` QCameraDevice ` 객체를 사용하면 카메라가 시스템의 기본 카메라 장치에 연결됩니다.

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

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

cameraDevice()도 참조하십시오 .

void QCamera::setCameraFormat(const QCameraFormat &format)

카메라가 format 에 설명된 형식을 사용하도록 지시합니다. 이 옵션을 사용하여 녹화 및 이미지 캡처에 사용할 특정 해상도와 프레임 속도를 정의할 수 있습니다.

cameraFormat()도 참조하십시오 .

[slot] void QCamera::setColorTemperature(int colorTemperature)

수동 화이트 밸런스를 colorTemperature 로 설정합니다. 이 설정은 whiteBalanceMode()가 WhiteBalanceManual 로 설정되었을 때 사용됩니다. 단위는 켈빈(Kelvin)입니다.

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

참조: colorTemperature()

[slot] void QCamera::setWhiteBalanceMode(QCamera::WhiteBalanceMode mode)

화이트 밸런스를 ‘ mode ’로 설정합니다.

whiteBalanceMode()도 참조하십시오 .

void QCamera::setZoomFactor(float factor)

초당 1의 배율로 factor 배율까지 확대합니다.

zoomFactor()도 참조하십시오 .

[slot] void QCamera::start()

카메라를 시작합니다.

setActive(true)와 동일합니다.

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

[slot] void QCamera::stop()

카메라를 중지합니다. ` setActive(false)`와 동일합니다.

[slot] void QCamera::zoomTo(float factor, float rate)

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

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