glPixelStorei 関数
ピクセル ストレージ モードを設定します。
構文
void WINAPI glPixelStorei(
GLenum pname,
GLint param
);
パラメーター
-
pname
-
設定するパラメーターのシンボリック名。 6 つのストレージ パラメーターは、ピクセル データがクライアント メモリに返される方法に影響するため、 glReadPixels コマンドでのみ重要です。 これらは次のとおりです。
ストレージ パラメーター 説明 GL_PACK_SWAP_BYTES true の場合、マルチバイトカラーコンポーネント、深度コンポーネント、カラーインデックス、ステンシルインデックスのバイト順序は逆になります。 つまり、4 バイトのコンポーネントがバイト b0、 b1、 b2、 b3 で構成されている場合、GL_PACK_SWAP_BYTESが true の場合は 、b3 、 b2、 b1、 b0 としてメモリに格納されます。 GL_PACK_SWAP_BYTESは、ピクセル内のコンポーネントのメモリ順序には影響を及ぼすので、コンポーネントまたはインデックス内のバイトの順序にのみ影響します。 たとえば、GL_RGB形式ピクセルの 3 つのコンポーネントは、GL_PACK_SWAP_BYTESの値に関係なく、常に赤の 1 番目、緑の秒、青の 3 番目に格納されます。 GL_PACK_LSB_FIRST true の場合、ビットはバイト内で最下位から最上位に並べ替えられます。それ以外の場合、各バイトの最初のビットが最も重要なビットになります。 このパラメーターは、ビットマップ データに対してのみ重要です。 GL_PACK_ROW_LENGTH 0 より大きい場合、GL_PACK_ROW_LENGTHは行のピクセル数を定義します。 行の最初のピクセルがメモリ内の位置 p に配置されている場合、次の行の最初のピクセルの位置は、 
をスキップすることによって取得されます。[改行] コンポーネントまたはインデックス(n はピクセル内のコンポーネントまたはインデックスの数)、l は行内のピクセル数 (0 より大きい場合は gl-pack-row-length、それ以外の場合はピクセル ルーチンの width 引数)、a は gl-pack-alignment の値、s は単一コンポーネントのサイズ (<バイト単位) です その場合は、 のように = 表示されます。 1 ビット値の場合、次の行の位置は、
をスキップすることによって取得されます。
コンポーネントまたはインデックス。 この説明の単語 コンポーネント は、インデックス以外の値 (赤、緑、青、アルファ、深さ) を指します。 たとえば、ストレージ形式GL_RGBには、1 ピクセルあたり 3 つのコンポーネント (最初の赤、緑、最後に青) があります。GL_PACK_SKIP_PIXELSと
GL_PACK_SKIP_ROWSこれらの値は、プログラマにとって便利な方法として提供されます。 glReadPixels に渡されたポインターをインクリメントするだけでは複製できない機能はありません。 GL_PACK_SKIP_PIXELSを i に設定することは、i n 個のコンポーネントまたはインデックスによってポインターをインクリメントすることと同じです。 ここで、n は各ピクセル内のコンポーネントまたはインデックスの数です。 GL_PACK_SKIP_ROWSを j に設定することは、 j k コンポーネントまたはインデックスによってポインターをインクリメントすることと同じです。 ここで、k は、GL_PACK_ROW_LENGTH セクションで前述したように、行あたりのコンポーネントまたはインデックスの数です。 GL_PACK_ALIGNMENT メモリ内の各ピクセル行の開始の配置要件を指定します。 許容される値は、1 (バイトアラインメント)、2 (偶数バイトにアラインされた行)、4 (ワードアラインメント)、および 8 (2 ワード境界で開始される行) です。 他の 6 つのストレージ パラメーターは、ピクセル データをクライアント メモリから読み取る方法に影響します。 これらの値は、 glDrawPixels、 glTexImage1D、 glTexImage2D、 glBitmap、 および glPolygonStipple で重要です。 制限事項は次のとおりです。
ストレージ パラメーター 説明 GL_UNPACK_SWAP_BYTES true の場合、マルチバイトカラーコンポーネント、深度コンポーネント、カラーインデックス、ステンシルインデックスのバイト順序は逆になります。 つまり、4 バイトのコンポーネントがバイト b0、 b1、 b2、 b3 で構成されている場合、GL_UNPACK_SWAP_BYTESが true の場合は b3、 b2、 b1、 b0 としてメモリに格納されます。 GL_UNPACK_SWAP_BYTESは、ピクセル内のコンポーネントのメモリ順序には影響を及ぼすので、コンポーネントまたはインデックス内のバイトの順序にのみ影響します。 たとえば、GL_RGB形式のピクセルの 3 つのコンポーネントは、GL_UNPACK_SWAP_BYTESの値に関係なく、常に赤の 1 番目、緑の秒、青の 3 番目に格納されます。 GL_UNPACK_LSB_FIRST true の場合、ビットはバイト内で最下位から最上位に並べ替えられます。それ以外の場合、各バイトの最初のビットが最も重要なビットになります。 これは、ビットマップ データに対してのみ重要です。 GL_UNPACK_ROW_LENGTH 0 より大きい場合、GL_UNPACK_ROW_LENGTHは行のピクセル数を定義します。 行の最初のピクセルがメモリ内の位置 p に配置されている場合、次の行の最初のピクセルの位置は、 をスキップすることによって取得されます。[改行] コンポーネントまたはインデックス(n はピクセル内のコンポーネントまたはインデックスの数)、l は行内のピクセル数 (0 より大きい場合は gl-pack-row-length、それ以外の場合はピクセル ルーチンの width 引数)、a は gl-pack-alignment の値、s は単一コンポーネントのサイズ (<バイト単位) です その場合は、 のように = 表示されます。 1 ビット値の場合、次の行の位置は、をスキップすることによって取得されます。
コンポーネントまたはインデックス。 この説明の単語 コンポーネント は、インデックス以外の値 (赤、緑、青、アルファ、深さ) を指します。 たとえば、ストレージ形式GL_RGBには、1 ピクセルあたり 3 つのコンポーネント (最初の赤、緑、最後に青) があります。GL_UNPACK_SKIP_PIXELSと
GL_UNPACK_SKIP_ROWSこれらの値は、プログラマにとって便利な方法として提供されます。 glDrawPixels、 glTexImage1D、 glTexImage2D、 glBitmap、または glPolygonStipple に渡されたポインターをインクリメントするだけでは複製できない機能はありません。 GL_UNPACK_SKIP_PIXELSを i に設定することは、i n 個のコンポーネントまたはインデックスによってポインターをインクリメントすることと同じです。 ここで、n は各ピクセル内のコンポーネントまたはインデックスの数です。 GL_UNPACK_SKIP_ROWSを j に設定することは、 j k コンポーネントまたはインデックスによってポインターをインクリメントすることと同じです。 ここで、k は、GL_UNPACK_ROW_LENGTH セクションで前述したように、行あたりのコンポーネントまたはインデックスの数です。 GL_UNPACK_ALIGNMENT メモリ内の各ピクセル行の開始の配置要件を指定します。 許容される値は、1 (バイトアラインメント)、2 (偶数バイトにアラインされた行)、4 (ワードアラインメント)、および 8 (2 ワード境界で開始される行) です。 -
param
-
pname が設定されている値。
戻り値
この関数は値を返しません。
注釈
glPixelStore 関数は、後続の glDrawPixels と glReadPixels の操作に影響を与えるピクセル ストレージ モードと、多角形のヒント パターン (glPolygonStipple を参照)、ビットマップ (glBitmap を参照)、テクスチャ パターン (glTexImage1D、glTexImage2D、glTexSubImage1D、および glTexSubImage2D を参照) の展開に影響を与えるピクセル ストレージ モードを設定します。
次の表に、 glPixelStore で設定できる各ストレージ パラメーターの有効な値の種類、初期値、および範囲を示します。
| Pname | Type | 初期値 | 有効範囲 |
|---|---|---|---|
| GL_PACK_SWAP_BYTES | Boolean | false | true または false |
| GL_PACK_SWAP_BYTES | Boolean | false | true または false |
| GL_PACK_ROW_LENGTH | 整数 (integer) | 0 | [0,?) |
| GL_PACK_SKIP_ROWS | 整数 (integer) | 0 | [0,?) |
| GL_PACK_SKIP_PIXELS | 整数 (integer) | 0 | [0,?) |
| GL_PACK_ALIGNMENT | 整数 (integer) | 4 | 1、2、4、または 8 |
| GL_UNPACK_SWAP_BYTES | Boolean | false | true または false |
| GL_UNPACK_LSB_FIRST | Boolean | false | true または false |
| GL_UNPACK_ROW_LENGTH | 整数 (integer) | 0 | [0,?) |
| GL_UNPACK_SKIP_ROWS | 整数 (integer) | 0 | [0,?) |
| GL_UNPACK_SKIP_PIXELS | 整数 (integer) | 0 | [0,?) |
| GL_UNPACK_ALIGNMENT | 整数 (integer) | 4 | 1、2、4、または 8 |
glPixelStoref 関数を使用して、任意のピクセル ストア パラメーターを設定できます。 パラメーターの型が Boolean で、 param が 0.0 の場合、パラメーターは false になります。それ以外の場合は true に設定されます。 pname が整数型パラメーターの場合、param は最も近い整数に丸められます。
同様に、 glPixelStorei 関数を使用して、任意のピクセル ストア パラメーターを設定することもできます。 パラメーターが 0 の場合はブール値パラメーターが false に設定され、それ以外の場合は true に設定されます。 param パラメーターは、実際の値パラメーターに割り当てられる前に浮動小数点に変換されます。
glDrawPixels、glReadPixels、glTexImage1D、glTexImage2D、glBitmap、または glPolygonStipple がメモリ データの解釈を制御する表示リストに配置された場合に有効なピクセル ストレージ モード。 表示リストの実行時に有効なピクセルストレージモードは重要ではありません。
次の関数は 、glPixelStore に関連する情報を取得します。
引数GL_PACK_SWAP_BYTESを含む glGet
引数GL_PACK_LSB_FIRSTを含む glGet
引数GL_PACK_ROW_LENGTHを含む glGet
引数GL_PACK_SKIP_ROWSを含む glGet
引数GL_PACK_SKIP_PIXELSを含む glGet
引数GL_PACK_ALIGNMENTを含む glGet
引数GL_UNPACK_SWAP_BYTESを含む glGet
引数GL_UNPACK_LSB_FIRSTを含む glGet
引数GL_UNPACK_ROW_LENGTHを含む glGet
引数GL_UNPACK_SKIP_ROWSを含む glGet
引数GL_UNPACK_SKIP_PIXELSを含む glGet
引数GL_UNPACK_ALIGNMENTを含む glGet
必要条件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|
関連項目
フィードバック
以下は間もなく提供いたします。2024 年を通じて、コンテンツのフィードバック メカニズムとして GitHub の issue を段階的に廃止し、新しいフィードバック システムに置き換えます。 詳細については、「https://aka.ms/ContentUserFeedback」を参照してください。
フィードバックの送信と表示