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

현재 이미지의 직사각형을 반환합니다. 이미지에 대한 rect가 정의되지 않은 경우 빈 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)은 참을 반환해야 합니다.

setOption() 및 option()도 참조하세요 .

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

지정된 장치에 image 이미지를 씁니다. 성공하면 true 을 반환하고, 그렇지 않으면 false 을 반환합니다.

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