QPixelFormat Class

멤버 함수 설명

[constexpr noexcept] QPixelFormat::QPixelFormat()

null 픽셀 포맷을 생성합니다. 이 포맷은 QImage::Format_Invalid 에 매핑됩니다.

[constexpr noexcept] QPixelFormat::QPixelFormat(QPixelFormat::ColorModel colorModel, uchar firstSize, uchar secondSize, uchar thirdSize, uchar fourthSize, uchar fifthSize, uchar alphaSize, QPixelFormat::AlphaUsage alphaUsage, QPixelFormat::AlphaPosition alphaPosition, QPixelFormat::AlphaPremultiplied premultiplied, QPixelFormat::TypeInterpretation typeInterpretation, QPixelFormat::ByteOrder byteOrder = CurrentSystemEndian, uchar subEnum = 0)

데이터를 속성에 할당하는 QPixelFormat을 생성합니다. ` colorModel `는 4비트 길이의 버퍼에 저장됩니다.

firstSize secondSize thirdSize 는 모두 채널의 크기를 나타냅니다. 각 채널은 에 따라 서로 다른 용도로 사용됩니다. RGB의 경우 firstSize는 적색(Red) 채널을 나타냅니다. CMYK의 경우 firstSize는 청록색(Cyan) 채널의 값을 나타냅니다. fourthSize fifthSize alphaSize colorModel

alphaUsage 는 알파 채널이 사용되는지 여부를 나타냅니다.

alphaPosition 는 알파 채널의 위치를 나타냅니다.

premultiplied 알파 채널이 이미 색상 채널과 곱해졌는지 여부를 나타냅니다.

typeInterpretation 픽셀이 어떻게 해석되는지를 나타냅니다.

byteOrder 픽셀 포맷의 엔디안(endianness)을 나타냅니다. 기본값은 ` CurrentSystemEndian`이며, 바이트 순서가 정해지지 않은 포맷의 경우 시스템의 엔디안으로 변환되고, ` QPixelFormat::UnsignedByte`의 경우 ` QPixelFormat::BigEndian `로 변환됩니다.

subEnum 는 추가 열거형을 제공하여 일부 추가 정보를 저장해야 하는 colorModels에 사용됩니다. 이는 YUV가 YUV 유형을 저장하는 데 사용됩니다. 기본값은 0입니다.

[constexpr noexcept] QPixelFormat::AlphaPosition QPixelFormat::alphaPosition() const

색상 채널에 대한 알파 채널의 위치를 반환하는 액세서리 함수입니다.

개별 채널이 개별 유닛에 매핑되는 형식의 경우, 알파 위치는 이러한 유닛을 기준으로 합니다. 예를 들어, 알파 위치가 QPixelFormat::AtEnd 인 QImage::Format_RGBA16FPx4 의 경우, 알파는 마지막으로 읽은 qfloat16 입니다.

여러 채널이 단일 단위로 압축된 형식의 경우, QPixelFormat::AtBeginning 및 QPixelFormat::AtEnd 값은 해당 형식의 고유한 byteOrder()에 따라 압축된 단위의 최상위 비트(MSB)와 최하위 비트(LSB)에 매핑됩니다.

예를 들어, 유형 해석이 QPixelFormat::UnsignedInteger 이고 byteOrder()가 항상 호스트 시스템과 일치하는 QImage::Format_ARGB32 의 경우, QPixelFormat::AtBeginning 의 알파 위치는 알파가 항상 0xFF000000 에서 찾을 수 있음을 의미합니다.

픽셀 형식과 호스트의 엔디안성이 일치하지 않는 경우, 픽셀 형식 레이아웃을 호스트 메모리 레이아웃에 올바르게 매핑하도록 주의해야 합니다.

alphaUsage(), alphaSize() 및 premultiplied()도 참조하십시오 .

[constexpr noexcept] uchar QPixelFormat::alphaSize() const

알파 채널 크기를 처리하는 보조 함수.

[constexpr noexcept] QPixelFormat::AlphaUsage QPixelFormat::alphaUsage() const

알파 채널 사용 여부를 확인하는 액세서리 함수입니다.

때로는 픽셀 형식이 알파 채널을 위한 공간을 예약해 두는 경우가 있어, ` alphaSize()`가 0보다 큰 값을 반환하더라도 알파 채널은 실제로 사용되지 않거나 무시되기도 합니다.

예를 들어, QImage::Format_RGB32 의 경우, 알파 채널의 크기가 8이므로 bitsPerPixel()의 값은 32이지만, alphaUsage()는 QPixelFormat::IgnoresAlpha 를 반환합니다.

이러한 상황에서도 사용되지 않는 알파 채널의 position 은 색상 채널의 배치에 영향을 미치므로 여전히 중요하다는 점에 유의하십시오.

alphaPosition(), alphaSize() 및 premultiplied()도 참조하십시오 .

[constexpr noexcept] uchar QPixelFormat::bitsPerPixel() const

픽셀당 사용되는 비트에 대한 액세서 함수입니다. 이 함수는 모든 색상 채널의 합에 알파 채널의 크기를 더한 값을 반환합니다.

[constexpr noexcept] uchar QPixelFormat::blackSize() const

검정색/키 컬러 채널에 대한 액세서 함수.

[constexpr noexcept] uchar QPixelFormat::blueSize() const

파란색 채널의 크기를 반환하는 액세서 함수입니다.

[constexpr noexcept] uchar QPixelFormat::brightnessSize() const

밝기 채널 크기를 처리하는 액세서 함수.

[constexpr noexcept] QPixelFormat::ByteOrder QPixelFormat::byteOrder() const

픽셀 포맷의 바이트 순서는 ` typeInterpretation()`에 설명된 대로 개별 타입 유닛의 메모리 배열을 결정합니다.

이 함수는 QPixelFormat::CurrentSystemEndian 를 반환하지 않습니다. 이 값은 생성자에서 시스템의 엔디안 값으로 변환되기 때문입니다.

typeInterpretation() QPixelFormat::UnsignedByte 인 픽셀 포맷의 경우, 이는 일반적으로 QPixelFormat::BigEndian 이며, 다른 유형 해석은 일반적으로 현재 시스템의 엔디안성을 반영합니다.

픽셀 포맷의 바이트 순서가 현재 시스템과 일치하는 경우, 호스트 시스템의 엔디안 방식에 관계없이 동일한 비트 마스크와 연산을 사용하여 개별 타입 단위를 읽고 조작할 수 있습니다. 예를 들어, QPixelFormat::UnsignedInteger 타입 해석을 갖는 QImage::Format_ARGB32 의 경우, 호스트 엔디안 방식에 관계없이 0xFF000000 로 unsigned int 를 마스킹하여 알파를 항상 읽을 수 있습니다.

픽셀 형식과 호스트 엔디안성이 일치 하지 않는 경우, 이를 고려하여 주의해야 합니다. 이러한 경우, ` QImage `와 같은 클래스는 호스트 시스템의 엔디안성에 맞추기 위해 내부 비트를 뒤바꾸지 않습니다.

typeInterpretation() 및 alphaPosition()도 참조하십시오 .

[constexpr noexcept] uchar QPixelFormat::channelCount() const

채널 수에 대한 액세서리 함수.

채널 수는 크기가 0보다 큰 채널(색상 및 알파)을 나타냅니다.

[constexpr noexcept] QPixelFormat::ColorModel QPixelFormat::colorModel() const

색상 모델에 대한 액세서 함수.

QPixelFormat::YUV 의 경우 개별 매크로 픽셀을 직접 기술할 수 없다는 점에 유의하십시오. 대신 YUV formats 목록이 제공되며, bitsPerPixel() 값은 YUV 레이아웃에서 추론됩니다.

[constexpr noexcept] uchar QPixelFormat::cyanSize() const

청록색 채널에 대한 액세서 함수입니다.

[constexpr noexcept] uchar QPixelFormat::greenSize() const

녹색 색상 채널의 크기를 반환하는 액세서 함수입니다.

[constexpr noexcept] uchar QPixelFormat::hueSize() const

색조 채널 크기를 처리하는 액세서리 함수.

[constexpr noexcept] uchar QPixelFormat::lightnessSize() const

명도 채널 크기를 위한 액세서 함수.

[constexpr noexcept] uchar QPixelFormat::magentaSize() const

메젠타 색상 채널용 액세서 함수.

[constexpr noexcept] QPixelFormat::AlphaPremultiplied QPixelFormat::premultiplied() const

알파 채널이 색상 채널에 곱해지는지 여부를 확인하는 액세서리 함수.

[constexpr noexcept] uchar QPixelFormat::redSize() const

빨간색 채널의 크기를 반환하는 액세서 함수입니다.

[constexpr noexcept] uchar QPixelFormat::saturationSize() const

채도 채널 크기를 처리하는 액세서 함수.

[constexpr noexcept] QPixelFormat::TypeInterpretation QPixelFormat::typeInterpretation() const

타입 해석은 각 픽셀을 어떻게 읽어야 하는지를 결정합니다.

각 픽셀은 메모리 내에 순차적으로 배열된, 지정된 유형의 하나 이상의 단위로 표현됩니다.

예를 들어, QImage::Format_Mono 는 픽셀당 1비트의 pixel format 와 QPixelFormat::UnsignedByte 유형 해석을 가지며, 이는 단일 byte 로 읽혀야 합니다. 마찬가지로, QImage::Format_RGB888 는 픽셀당 24비트의 pixel format 와 QPixelFormat::UnsignedByte 유형 해석을 가지며, 이는 세 개의 연속된 byte로 읽혀야 합니다.

QImage 의 formats 중 상당수는 32비트이며, 유형 해석은 QPixelFormat::UnsignedInteger 으로, 이는 하나의 unsigned int 로 읽어야 합니다.

QPixelFormat::FloatingPoint 의 QImage::Format_RGBA16FPx4 또는 QImage::Format_RGBA32FPx4 과 같은 형식의 경우, 유형은 개별 색상/알파 채널의 크기에 따라 결정되며, 16비트 하프 플로트 형식의 경우 qfloat16, 32비트 풀 플로트 형식의 경우 float 가 사용됩니다.

byteOrder()도 참조하십시오 .

[constexpr noexcept] uchar QPixelFormat::yellowSize() const

노란색 색상 채널에 대한 액세서 함수.

[constexpr noexcept] QPixelFormat::YUVLayout QPixelFormat::yuvLayout() const

YUVLayout 에 대한 액세서리 함수입니다. YUV 색상 모델은 매크로 픽셀을 사용하기 때문에 YUV 픽셀 형식의 색상 채널을 설명하기는 어렵습니다. 대신 픽셀의 배열 구조가 열거형(enum)으로 저장됩니다.