QPixelFormat Class

メンバ関数ドキュメント

[constexpr noexcept] QPixelFormat::QPixelFormat()

null pixelformat を作成します。このフォーマッ トは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 fourthSize fifthSize alphaSize はすべて、チャネルのサイズを表すものです。チャンネルは、colorModel によって異なる用途に使用されます。 RGB の場合、firstSize は赤チャンネルを表します。CMYKの場合はシアン・チャンネルの値を表します。

alphaUsage はアルファチャンネルを使うかどうかを表します。

alphaPosition はアルファチャンネルの位置。

premultiplied はアルファチャンネルがすでに色チャンネルと掛け合わされているかどうかを表します。

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

byteOrder は pixelformat のエンディアンを表します。デフォルトはCurrentSystemEndian で、 バイ ト 順序でない形式の場合はシステムのエンディアンに解決され、QPixelFormat::UnsignedByte の場合はQPixelFormat::BigEndian になります。

subEnum は、特別な enum を与えて特別な情報を保存する必要がある colorModels に使用されます。これは YUV が YUV タイプを格納するために使用する。

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

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

個々のチャンネルが個々の単位にマッピングされているフォーマットでは、アルファ位置はこれらの単位からの相対位置となります。たとえばQPixelFormat::AtEnd のアルファ位置を持つQImage::Format_RGBA16FPx4 の場合、 アルファ位置は最後に読み込んだqfloat16 となります。

複数のチャンネルが1つのユニットにパックされているフォーマットの場合、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 の場合、アルファ・チャネルのサイズは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 では、ホストのエンディアンに関係なく、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 は、ピクセルあたり1ビットのpixel format と、QPixelFormat::UnsignedByte のタイプ解釈を持っており、これは単一のbyte として読み込まれるべきである。同様に、QImage::Format_RGB888 は、ピクセルあたり24ビットのpixel format と、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ピクセルフォーマットのカラーチャンネルを記述することは困難である。その代わりに、ピクセルのレイアウトはenumとして保存される。