QImageCapture Class
QImageCapture 클래스는 미디어 콘텐츠의 녹화에 사용됩니다. 더 보기...
Header: | #include <QImageCapture> |
CMake: | find_package(Qt6 REQUIRED COMPONENTS Multimedia) target_link_libraries(mytarget PRIVATE Qt6::Multimedia) |
qmake: | QT += multimedia |
상속합니다: | QObject |
공용 유형
enum | Error { NoError, NotReadyError, ResourceError, OutOfSpaceError, NotSupportedFeatureError, FormatError } |
enum | FileFormat { UnspecifiedFormat, JPEG, PNG, WebP, Tiff } |
enum | Quality { VeryLowQuality, LowQuality, NormalQuality, HighQuality, VeryHighQuality } |
속성
|
|
공용 기능
QImageCapture(QObject *parent = nullptr) | |
virtual | ~QImageCapture() override |
void | addMetaData(const QMediaMetaData &metaData) |
QMediaCaptureSession * | captureSession() const |
QImageCapture::Error | error() const |
QString | errorString() const |
QImageCapture::FileFormat | fileFormat() const |
bool | isAvailable() const |
bool | isReadyForCapture() const |
QMediaMetaData | metaData() const |
QImageCapture::Quality | quality() const |
QSize | resolution() const |
void | setFileFormat(QImageCapture::FileFormat format) |
void | setMetaData(const QMediaMetaData &metaData) |
void | setQuality(QImageCapture::Quality quality) |
void | setResolution(const QSize &resolution) |
void | setResolution(int width, int height) |
공용 슬롯
int | capture() |
int | captureToFile(const QString &file = QString()) |
신호
void | errorChanged() |
void | errorOccurred(int id, QImageCapture::Error error, const QString &errorString) |
void | fileFormatChanged() |
void | imageAvailable(int id, const QVideoFrame &frame) |
void | imageCaptured(int id, const QImage &preview) |
void | imageExposed(int id) |
void | imageMetadataAvailable(int id, const QMediaMetaData &metaData) |
void | imageSaved(int id, const QString &fileName) |
void | metaDataChanged() |
void | qualityChanged() |
void | readyForCaptureChanged(bool ready) |
void | resolutionChanged() |
정적 공용 멤버
QString | fileFormatDescription(QImageCapture::FileFormat f) |
QString | fileFormatName(QImageCapture::FileFormat f) |
QList<QImageCapture::FileFormat> | supportedFormats() |
상세 설명
QImageCapture 클래스는 높은 수준의 이미지 녹화 클래스입니다. 단독으로 사용하기 위한 것이 아니라 QCamera 와 같은 다른 미디어 객체의 미디어 녹화 기능에 액세스하기 위한 것입니다.
QMediaCaptureSession captureSession; camera = new QCamera; captureSession.setCamera(camera); viewfinder = new QVideoWidget(); viewfinder->show(); captureSession.setVideoOutput(viewfinder); imageCapture = new QImageCapture(camera); captureSession.setImageCapture(imageCapture); camera->start(); //on shutter button pressed imageCapture->capture();
QCamera도 참조하십시오 .
멤버 유형 문서
enum QImageCapture::Error
상수 | 값 | 설명 |
---|---|---|
QImageCapture::NoError | 0 | 오류 없음. |
QImageCapture::NotReadyError | 1 | 서비스가 아직 캡처할 준비가 되지 않았습니다. |
QImageCapture::ResourceError | 2 | 장치가 준비되지 않았거나 사용할 수 없습니다. |
QImageCapture::OutOfSpaceError | 3 | 장치에 공간이 없습니다. |
QImageCapture::NotSupportedFeatureError | 4 | 장치가 스틸 이미지 캡처를 지원하지 않습니다. |
QImageCapture::FormatError | 5 | 현재 형식이 지원되지 않습니다. |
enum QImageCapture::FileFormat
다음 이미지 형식 중 하나를 선택합니다:
상수 | 값 | 설명 |
---|---|---|
QImageCapture::UnspecifiedFormat | 0 | 지정한 형식 없음 |
QImageCapture::JPEG | 1 | .jpg 또는 .jpeg 형식 |
QImageCapture::PNG | 2 | .png 형식 |
QImageCapture::WebP | 3 | .webp 형식 |
QImageCapture::Tiff | 4 | .tiff 형식 |
enum QImageCapture::Quality
품질 인코딩 수준을 열거합니다.
Constant | Value |
---|---|
QImageCapture::VeryLowQuality | 0 |
QImageCapture::LowQuality | 1 |
QImageCapture::NormalQuality | 2 |
QImageCapture::HighQuality | 3 |
QImageCapture::VeryHighQuality | 4 |
속성 문서
[read-only]
error : const Error
현재 오류 상태를 반환합니다.
함수에 액세스합니다:
QImageCapture::Error | error() const |
알림 신호:
void | errorChanged() |
errorString()도 참조하세요 .
[read-only]
errorString : const QString
현재 오류 상태를 설명하는 문자열을 반환합니다.
함수에 액세스합니다:
QString | errorString() const |
알림 신호:
void | errorChanged() |
error()도 참조하세요 .
[read-only]
fileFormat : const FileFormat
이 속성은 이미지 형식을 보유합니다.
액세스 함수:
QImageCapture::FileFormat | fileFormat() const |
알림 신호:
void | fileFormatChanged() |
metaData : QMediaMetaData
이 속성에는 이미지에 삽입될 메타 데이터가 저장됩니다.
참고: 타임스탬프나 위치와 같은 추가 필드는 카메라 백엔드에서 추가될 수 있습니다.
액세스 기능:
QMediaMetaData | metaData() const |
void | setMetaData(const QMediaMetaData &metaData) |
알림 신호:
void | metaDataChanged() |
[read-only]
quality : const Quality
이 속성은 이미지 인코딩 품질을 보유합니다.
액세스 함수:
QImageCapture::Quality | quality() const |
알림 신호:
void | qualityChanged() |
[read-only]
readyForCapture : const bool
카메라가 즉시 이미지를 캡처할 준비가 되면 true
을 누릅니다. readyForCapture
이 false
인 상태에서 capture()를 호출하면 허용되지 않으며 오류가 발생합니다.
액세스 기능:
bool | isReadyForCapture() const |
알림 신호:
void | readyForCaptureChanged(bool ready) |
멤버 함수 문서
[explicit]
QImageCapture::QImageCapture(QObject *parent = nullptr)
parent 에서 카메라로 생성된 개별 정지 이미지를 캡처할 수 있는 이미지 캡처 객체를 구성합니다.
이미지를 캡처하려면 이미지 캡처 객체와 QCamera 를 캡처 세션에 모두 연결해야 합니다.
[override virtual noexcept]
QImageCapture::~QImageCapture()
이미지 캡처 개체를 삭제합니다.
void QImageCapture::addMetaData(const QMediaMetaData &metaData)
캡처한 이미지에 포함된 기존 메타 데이터에 metaData 을 추가합니다.
[slot]
int QImageCapture::capture()
이미지를 캡처하여 QImage. 이 작업은 대부분의 경우 비동기식이며, QImageCapture::imageExposed(), QImageCapture::imageCaptured() 또는 QImageCapture::error() 신호가 뒤따릅니다.
QImageCapture::capture는 imageExposed(), imageCaptured() 및 imageSaved() 신호와 함께 사용되는 capture Id 매개 변수를 반환합니다.
isReadyForCapture()도 참조하세요 .
QMediaCaptureSession *QImageCapture::captureSession() const
이 카메라가 연결된 캡처 세션을 반환하거나 카메라가 캡처 세션에 연결되어 있지 않은 경우 nullptr을 반환합니다.
이미지 캡처를 세션에 연결하려면 QMediaCaptureSession::setImageCapture()를 사용합니다.
[slot]
int QImageCapture::captureToFile(const QString &file = QString())
이미지를 캡처하여 file 에 저장합니다. 이 작업은 대부분의 경우 비동기식이며, QImageCapture::imageExposed(), QImageCapture::imageCaptured(), QImageCapture::imageSaved() 또는 QImageCapture::error() 신호가 뒤따릅니다.
빈 file 을 전달하면 카메라 백엔드는 시스템에서 사진의 기본 위치와 명명 체계를 선택하며, 전체 경로 없이 파일 이름만 지정하면 imageCaptured() 및 imageSaved() 신호와 함께 전체 경로가 보고된 기본 디렉터리에 이미지가 저장됩니다.
QCamera 노출 설정이나 이미지 처리 매개변수와 같은 모든 캡처 매개변수를 저장하므로 capture() 호출 후 카메라 매개변수를 변경해도 이전 캡처 요청에는 영향을 미치지 않습니다.
QImageCapture::capture imageExposed (), imageCaptured() 및 imageSaved() 신호와 함께 사용되는 캡처 Id 파라미터를 반환합니다.
isReadyForCapture()도 참조하세요 .
[signal]
void QImageCapture::errorOccurred(int id, QImageCapture::Error error, const QString &errorString)
error 및 errorString 설명과 함께 id 캡처 요청이 실패했음을 알립니다.
[static]
QString QImageCapture::fileFormatDescription(QImageCapture::FileFormat f)
주어진 파일 형식에 대한 설명을 반환합니다. f.
[static]
QString QImageCapture::fileFormatName(QImageCapture::FileFormat f)
지정된 형식의 이름 f 을 반환합니다.
[signal]
void QImageCapture::imageAvailable(int id, const QVideoFrame &frame)
요청이 있는 frame ( id )을 사용할 수 있을 때 발생하는 신호입니다.
[signal]
void QImageCapture::imageCaptured(int id, const QImage &preview)
요청 id 이 포함된 프레임이 캡처되었지만 아직 처리 및 저장되지 않았을 때 발생하는 신호입니다. 사용자에게 preview 프레임이 표시될 수 있습니다.
[signal]
void QImageCapture::imageExposed(int id)
id 요청이 포함된 프레임이 노출되었을 때 발생하는 신호입니다.
[signal]
void QImageCapture::imageMetadataAvailable(int id, const QMediaMetaData &metaData)
id 으로 식별된 이미지에 metaData 이 있다는 신호를 보냅니다.
[signal]
void QImageCapture::imageSaved(int id, const QString &fileName)
QImageCapture::CaptureToFile이 설정되고 id 요청이 포함된 프레임이 fileName 에 저장되었을 때 발생하는 신호입니다.
bool QImageCapture::isAvailable() const
이미지 캡처 서비스를 사용할 준비가 되면 true를 반환합니다.
[signal]
void QImageCapture::readyForCaptureChanged(bool ready)
카메라의 ready 캡처 상태가 변경되었음을 알리는 신호입니다.
참고: 프로퍼티 readyForCapture 에 대한 알림 신호입니다.
QSize QImageCapture::resolution() const
인코딩된 이미지의 해상도를 반환합니다.
setResolution()도 참조하세요 .
[signal]
void QImageCapture::resolutionChanged()
이미지 해상도가 변경되면 신호를 보냅니다.
void QImageCapture::setFileFormat(QImageCapture::FileFormat format)
이미지를 설정합니다 format.
fileFormat()도 참조하세요 .
void QImageCapture::setMetaData(const QMediaMetaData &metaData)
캡처한 이미지에 삽입할 기존 메타 데이터를 metaData 세트로 바꿉니다.
참고: metaData 속성에 대한 세터 함수입니다.
metaData()도 참조하세요 .
void QImageCapture::setQuality(QImageCapture::Quality quality)
이미지 인코딩을 설정합니다 quality.
quality()도 참조하세요 .
void QImageCapture::setResolution(const QSize &resolution)
인코딩된 이미지의 resolution 을 설정합니다.
비어 있는 QSize 은 인코더가 이미지 소스에서 사용할 수 있는 항목과 코덱의 제한 사항에 따라 최적의 선택을 해야 함을 나타냅니다.
resolution()도 참조하세요 .
void QImageCapture::setResolution(int width, int height)
인코딩된 이미지의 해상도 width 및 height 을 설정합니다.
이 함수는 오버로드된 함수입니다.
[static]
QList<QImageCapture::FileFormat> QImageCapture::supportedFormats()
지원되는 파일 형식의 목록을 반환합니다.
FileFormat도 참조하세요 .
© 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.