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の場合、シアン（Cyan）チャンネルの値を表します。fourthSize fifthSize alphaSize colorModel

alphaUsage は、アルファチャンネルが使用されるかどうかを表します。

alphaPosition は、アルファチャンネルの位置を表します。

premultiplied アルファチャンネルがすでにカラーチャンネルと乗算されているかどうかを表します。

typeInterpretation は、ピクセルの解釈方法を示します。

byteOrder ピクセルフォーマットのエンディアンを表します。デフォルトはCurrentSystemEndian で、バイト順が指定されていないフォーマットの場合はシステムのエディアンに解決され、QPixelFormat::UnsignedByte の場合はQPixelFormat::BigEndian となります。

subEnum は、追加の列挙型を指定して余分な情報を格納する必要があるカラーモデルで使用されます。これは、YUV が YUV タイプを格納するために使用されます。デフォルト値は 0 です。

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

カラーチャンネルに対するアルファチャンネルの位置を表すアクセサ関数。

個々のチャンネルが個別の単位にマッピングされるフォーマットの場合、アルファの位置はこれらの単位を基準とします。例えば、アルファの位置がQPixelFormat::AtEnd であるQImage::Format_RGBA16FPx4 の場合、アルファは最後に読み込まれたqfloat16 となります。

複数のチャンネルが単一の単位にパックされているフォーマットの場合、QPixelFormat::AtBeginning およびQPixelFormat::AtEnd の値は、そのフォーマット固有のbyteOrder() に基づいて、パックされた単位の最上位ビットおよび最下位ビットにマッピングされます。

たとえば、型解釈が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 の場合、bitsPerPixel() の値は 32 になります。これは、アルファチャンネルのサイズが 8 であるためですが、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` の場合、ホストのエディアンネスに関係なく、`unsigned int ` を `0xFF000000` でマスクすることで、アルファを常に読み取ることができます。

ピクセル形式とホストのエンディアンが一致しない場合は、この点に注意を払う必要があります。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

型解釈によって、各ピクセルをどのように読み取るかが決まります。

各ピクセルは、指定された型の1つ以上の単位として表現され、メモリ内に順次配置されます。

たとえば、QImage::Format_Mono は、pixel format が 1 ピクセルあたり 1 ビット、タイプ解釈がQPixelFormat::UnsignedByte であり、単一のbyte として読み込まれる必要があります。同様に、QImage::Format_RGB888 は、pixel format が 1 ピクセルあたり 24 ビット、タイプ解釈がQPixelFormat::UnsignedByte であり、3 つの連続したbyteとして読み込まれる必要があります。

QImage のformats の多くは32ビットで、型解釈はQPixelFormat::UnsignedInteger となっており、これは単一のunsigned int として読み取る必要があります。

QImage::Format_RGBA16FPx4 やQImage::Format_RGBA32FPx4 のようなQPixelFormat::FloatingPoint 形式の場合、型は個々の色チャンネルおよびアルファチャンネルのサイズに基づいて決定され、16 ビットのハーフフロート形式ではqfloat16 、32 ビットのフルフロート形式ではfloat となります。

byteOrder()も参照してください 。

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

黄色チャンネル用のアクセサ関数。

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

YUVLayout のアクセサ関数。YUV カラーモデルはマクロピクセルを使用しているため、YUV ピクセル形式のカラーチャネルを記述するのは困難です。その代わりに、ピクセルのレイアウトが列挙型として格納されています。