QImageIOHandler Class

멤버 함수 문서

QImageIOHandler::QImageIOHandler()

QImageIOHandler 객체를 생성합니다.

[virtual noexcept] QImageIOHandler::~QImageIOHandler()

QImageIOHandler 객체를 삭제합니다.

[static, since 6.0] bool QImageIOHandler::allocateImage(QSize size, QImage::Format format, QImage *image)

이 함수는 하위 클래스의 읽기 함수를 위한 편의 메서드입니다. 이미지 형식 핸들러는 필요한 할당량이 현재 할당 한도를 초과할 경우 이미지 로딩을 거부해야 합니다. 이 함수는 매개변수와 한도를 확인하고, 유효하며 필요한 경우 할당을 수행합니다. 반환이 성공하면, ` image `는 주어진 ` size ` 및 ` format`에 대한 유효하고 분리된 ` QImage `가 됩니다.

이 함수는 Qt 6.0에서 도입되었습니다.

QImageReader::allocationLimit()도 참조하십시오 .

[pure virtual] bool QImageIOHandler::canRead() const

장치에서 이미지를 읽을 수 있는 경우(즉, 이미지 형식이 지원되고, 장치에서 읽기가 가능하며, 초기 헤더 정보에 따라 이미지를 읽을 수 있는 것으로 판단되는 경우) ` true `를 반환하고, 그렇지 않은 경우 ` false`를 반환합니다.

canRead()를 재구현할 때는 I/O 장치(device())가 원래 상태로 유지되도록 해야 합니다(예: read() 대신 peek()를 사용).

read() 및 QIODevice::peek()도 참조하십시오 .

[virtual] int QImageIOHandler::currentImageNumber() const

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 애니메이션에서 현재 이미지의 순서 번호를 반환합니다. 어떤 이미지도 ` read()`로 불러오기 전에 이 함수가 호출되면 -1이 반환됩니다. 시퀀스에서 첫 번째 이미지의 번호는 0입니다.

이미지 형식이 애니메이션을 지원하지 않는 경우, 0이 반환됩니다.

read()도 참조하십시오 .

[virtual] QRect QImageIOHandler::currentImageRect() const

현재 이미지의 직사각형 영역을 반환합니다. 이미지에 직사각형 영역이 정의되어 있지 않은 경우, 빈 QRect()가 반환됩니다.

이 함수는 한 번에 프레임의 일부만 업데이트될 수 있는 애니메이션에서 유용합니다.

QIODevice *QImageIOHandler::device() const

QImageIOHandler 에 현재 할당된 장치를 반환합니다. 할당된 장치가 없는 경우, nullptr 가 반환됩니다.

setDevice()도 참조하십시오 .

QByteArray QImageIOHandler::format() const

QImageIOHandler 에 현재 할당된 서식을 반환합니다. 서식이 할당되지 않은 경우, 빈 문자열이 반환됩니다.

setFormat()도 참조하십시오 .

[virtual] int QImageIOHandler::imageCount() const

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 애니메이션에 포함된 이미지 수를 반환합니다. 이미지 형식이 애니메이션을 지원하지 않거나 이미지 수를 파악할 수 없는 경우에는 0이 반환됩니다.

기본 구현에서는 ` canRead()`이 ` true`를 반환하면 1을 반환하고, 그렇지 않은 경우 0을 반환합니다.

[virtual] bool QImageIOHandler::jumpToImage(int imageNumber)

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 시퀀스 번호가 imageNumber 인 이미지로 건너뜁니다. 이후 read()를 호출하면 이 이미지를 읽으려고 시도합니다.

기본 구현은 아무 작업도 수행하지 않고 false 를 반환합니다.

[virtual] bool QImageIOHandler::jumpToNextImage()

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 다음 이미지로 건너뜁니다.

기본 구현은 아무 작업도 수행하지 않고 ` false`를 반환합니다.

[virtual] int QImageIOHandler::loopCount() const

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 애니메이션이 반복될 횟수를 반환합니다. 이미지 형식이 애니메이션을 지원하지 않는 경우 0이 반환됩니다.

[virtual] int QImageIOHandler::nextImageDelay() const

애니메이션을 지원하는 이미지 형식의 경우, 이 함수는 다음 이미지를 읽기까지 대기할 시간을 밀리초 단위로 반환합니다. 이미지 형식이 애니메이션을 지원하지 않는 경우 0이 반환됩니다.

[virtual] QVariant QImageIOHandler::option(QImageIOHandler::ImageOption option) const

option 에 할당된 값을 QVariant 로 반환합니다. 값의 유형은 옵션에 따라 다릅니다. 예를 들어, option(Size)는 QSize 변수를 반환합니다.

setOption() 및 supportsOption()도 참조하십시오 .

[pure virtual] bool QImageIOHandler::read(QImage *image)

장치에서 이미지를 읽어와 image 에 저장합니다. 이미지가 성공적으로 읽히면 true 를 반환하고, 그렇지 않으면 false를 반환합니다.

증분 로딩을 지원하는 이미지 형식 및 애니메이션 형식의 경우, 이미지 핸들러는 ` image `가 이전 프레임을 가리킨다고 가정할 수 있습니다.

canRead()도 참조하십시오 .

void QImageIOHandler::setDevice(QIODevice *device)

QImageIOHandler 의 디바이스를 device 로 설정합니다. 이미지 핸들러는 이미지를 읽고 쓸 때 이 디바이스를 사용합니다.

이 장치는 한 번만 설정할 수 있으며, canRead(), read(), write() 등을 호출하기 전에 설정해야 합니다. 여러 파일을 읽어야 하는 경우, 적절한 QImageIOHandler 하위 클래스의 인스턴스를 여러 개 생성하십시오.

device()도 참조하십시오 .

void QImageIOHandler::setFormat(const QByteArray &format)

QImageIOHandler 의 형식을 format 로 설정합니다. 이 형식은 여러 이미지 형식을 지원하는 핸들러에 가장 유용합니다.

format()도 참조하십시오 .

void QImageIOHandler::setFormat(const QByteArray &format) const

QImageIOHandler 의 형식을 format 로 설정합니다. 이 형식은 여러 이미지 형식을 지원하는 핸들러에 가장 유용합니다.

이 함수는 canRead()에서 호출될 수 있도록 const로 선언되었습니다.

format()도 참조하십시오 .

[virtual] void QImageIOHandler::setOption(QImageIOHandler::ImageOption option, const QVariant &value)

option 옵션을 value 값으로 설정합니다.

option() 및 ImageOption도 참조하십시오 .

[virtual] bool QImageIOHandler::supportsOption(QImageIOHandler::ImageOption option) const

QImageIOHandler 가 option 옵션을 지원하는 경우 true 을 반환하고, 그렇지 않은 경우 false 을 반환합니다. 예를 들어, QImageIOHandler 가 Size 옵션을 지원하는 경우, supportsOption(Size)는 true를 반환해야 합니다.

setOption() 및 option()도 참조하십시오 .

[virtual] bool QImageIOHandler::write(const QImage &image)

지정된 장치에 이미지 image 를 기록합니다. 성공 시 true 를 반환하고, 그렇지 않은 경우 false 를 반환합니다.

기본 구현은 아무 작업도 수행하지 않고, 단순히 false 를 반환합니다.