ImageCapture QML Type

카메라 이미지를 캡처하기 위한 인터페이스. 더 보기...

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

속성

• error : enumeration
• errorString : string
• fileFormat : enumeration
• metaData : mediaMetaData
• preview : string
• quality : enumeration
• readyForCapture : bool
• supportedFormats : list<FileFormat> (since 6.10)

신호

• errorOccurred(id, error, errorString)
• imageCaptured(requestId, preview)
• imageMetadataAvailable(id, metaData)
• imageSaved(id, fileName)

방법

• int capture()
• int captureToFile(location)
• void saveToFile(location)

상세 설명

이 유형을 사용하면 정지 이미지를 캡처하고, 이미지가 사용 가능해지거나 디스크에 저장될 때 알림을 받을 수 있습니다.

Item {
    width: 640
    height: 360

    CaptureSession {
        imageCapture : ImageCapture {
            id: imageCapture
        }
        camera: Camera {
            id: camera
        }

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

        MouseArea {
            anchors.fill: parent;
            onClicked: imageCapture.capture();
        }
    }

    Image {
        id: photoPreview
        source: imageCapture.preview // always shows the last captured image
    }
}

속성 설명

error : enumeration [read-only]

이 속성은 발생했던 마지막 오류 유형을 저장합니다. 다음 중 하나일 수 있습니다.

errorString도 참조하십시오 .

errorString : string [read-only]

이 속성은 마지막으로 발생한 오류 메시지를 저장합니다.

error도 참조하십시오 .

fileFormat : enumeration

이 속성은 이미지가 기록될 파일 형식을 나타냅니다. 다음 중 하나일 수 있습니다.

metaData : mediaMetaData

이 속성은 이미지에 삽입될 메타데이터를 포함합니다.

preview : string [read-only]

이 속성은 가장 최근에 캡처된 이미지의 URL을 포함합니다. 이 속성을 ` Image ` 요소의 `source` 속성에 연결하면 가장 최근에 캡처된 이미지를 표시할 수 있습니다.

CaptureSession {
    camera: Camera {}
    imageCapture: ImageCapture {
        id: capture
    }
}
Image {
    source: capture.preview
}

saveToFile도 참조하십시오 .

quality : enumeration

이 속성은 캡처된 이미지를 저장할 때 품질 힌트를 저장합니다. 다음 값 중 하나를 가질 수 있습니다.

readyForCapture : bool [read-only]

이 속성은 카메라가 사진 촬영 준비가 되었는지 여부를 나타내는 부울 값을 가집니다.

준비 상태 ( ready )일 때 ` capture()` 또는 ` captureToFile()`를 호출하는 것은 ` false `로 허용되지 않으며 오류가 발생합니다.

supportedFormats : list<FileFormat> [read-only, since 6.10]

지원되는 파일 형식 목록이 포함되어 있습니다.

이 속성은 Qt 6.10에서 도입되었습니다.

fileFormat도 참조하십시오 .

신호 문서

errorOccurred(id, error, errorString)

이 신호는 요청된 id 로 캡처하는 과정에서 오류가 발생했을 때 발생합니다. error 는 ImageCapture::Error 유형의 열거형입니다. 설명 메시지는 errorString 에서 확인할 수 있습니다.

error 및 errorString도 참조하십시오 .

imageCaptured(requestId, preview)

이 신호는 요청된 ID( requestId )를 가진 이미지가 촬영되었으나 아직 파일 시스템에 저장되지 않았을 때 발생합니다. ‘ preview ’ 매개변수는 촬영된 이미지를 나타냅니다.

imageSaved 및 preview도 참조하십시오 .

imageMetadataAvailable(id, metaData)

요청된 id 이미지에 새로운 metaData 이 추가되면 이 신호가 전송됩니다.

imageCaptured도 참조하십시오 .

imageSaved(id, fileName)

이 신호는 요청된 id 이미지가 파일 시스템에 기록된 후에 발생합니다. fileName 는 URL이 아닌 로컬 파일 경로입니다.

imageCaptured도 참조하십시오 .

메서드 문서

int capture()

이미지 캡처를 시작합니다. 캡처가 완료되면 ` imageCaptured ` 및 ` imageSaved ` 신호가 발생합니다.

캡처된 이미지는 QML Image 항목의 소스로 사용할 수 있는 preview 속성을 통해 확인할 수 있습니다. 이후 saveToFile() 메서드를 사용하여 이미지를 저장할 수 있습니다.

카메라는 노출 설정이나 이미지 처리 매개변수와 같은 모든 캡처 매개변수를 저장하므로, capture()가 호출된 후 카메라 매개변수를 변경하더라도 이전 캡처 요청에는 영향을 미치지 않습니다.

capture()는 imageExposed(), imageCaptured(), imageMetadataAvailable() 및 imageSaved() 시그널과 함께 사용되는 캡처 requestId 매개변수를 반환합니다.

readyForCapture 및 preview도 참조하십시오 .

int captureToFile(location)

capture()와 동일한 기능을 수행하지만, 추가로 캡처된 이미지를 지정된 location 에 자동으로 저장합니다. 캡처 requestId 매개변수를 반환합니다.

capture()도 참조하십시오 .

void saveToFile(location)

마지막으로 캡처한 이미지를 location 에 저장합니다.

capture 및 preview도 참조하십시오 .