GLCOPYPIXELS

名前

書式

                     GLint y,
                     GLsizei width,
                     GLsizei height,
                     GLenum type )

delim $$  

引き数

x, y

コピーする矩形ピクセル領域の左下隅のウィンドウ座標を指定する。

width, height

コピーする矩形ピクセル領域の寸法を指定する。 どちらも 0 以上の値である。

type

コピーするのが色の値、深さの値、ステンシル値のいずれであるのかを指定する。 シンボル定数 GL_COLOR, GL_DEPTH, GL_STENCIL を指定できる。

説明

GL_COLOR

現在の入力元バッファとして指定されているバッファから(glReadBuffer を参照)、 インデックス色または RGBA 色を読み込む。 GL が色インデックスモードの場合、 このバッファから読み出された各インデックスは固定小数点の値に変換される。 この際、2 進値の小数点から右のビット数は不定である。 次に各インデックスは GL_INDEX_SHIFT ビットだけ 左にシフトされ、さらに GL_INDEX_OFFSET の値が加えられる。 GL_INDEX_SHIFT が負の値の場合、シフトは右方向に行われる。 どちらの場合も、結果に含まれる値でビット値が不定となる部分は 0 で埋められる。 GL_MAP_COLOR が真の場合、インデックスが 色テーブルGL_PIXEL_MAP_I_TO_I 内で参照している値が インデックス値と置き換えられる。 インデックスの参照置き換えが行われたかどうかにかかわらず、 次にインデックスの整数部分は $2 sup b -1$ との AND が取られる。 ここで $b$ は色インデックスバッファのビット数である。

GL が RGBA モードならば、読み出された各ピクセルの赤、緑、青、 アルファ値の要素は固定小数点値の内部データに変換される。 この値の精度は不定である。 この変換では、表現可能な最大の要素値が 1.0 にマップされ、 要素値 0 が 0.0 にマップされる。 この結果得られる浮動小数点の色値には、GL_c_SCALE が掛けられた 後、GL_c_BIAS が加えられる。 ここで c は、それぞれの色要素に対する赤、緑、青、アルファ値 である。 この結果は [0,1] の範囲に収まるように修正される。 GL_MAP_COLOR が真ならば、それぞれの色要素は 色参照テーブルの大きさ GL_PIXEL_MAP_c_TO_c でスケール変換され、 そのテーブルの中で参照されている値と置き換えられる。 ここで c は R, G, B, A のいずれかである。

実装が GL_ARB_imaging 機能拡張に対応している場合はさらに、 色テーブルの参照値、色行列変換、畳み込みフィルタで 色値を処理することもできる。

次に GL は、現在のラスタ位置の z 座標と テクスチャ座標を各ピクセルに割り付け、 それからウィンドウ座標 ($x sub r ~+~ i , y sub r ~+~ j$) を割り当てることにより、結果として得たインデックスまたは RGBA 色を フラグメントに変換する。 ここで ($x sub r , y sub r$) は現在のラスタ位置であり、 ピクセルは $j$ 行目の $i$ 番目のピクセルである。 これらのピクセルフラグメントは、それから 点、線、ポリゴンのラスタ処理によって作られたフラグメントと 同じように扱われる。 テクスチャマッピング、フォグ処理や全てのフラグメント操作は フラグメントがフレームバッファに書き込まれる前に行われる。

GL_DEPTH

深さ値はデプスバッファから読み出され、直接内部形式の 浮動小数点値に変換される。この値の精度は不定である。 結果として得られる浮動小数点値の深さ値には、次に GL_DEPTH_SCALE が掛けられ、それから GL_DEPTH_BIAS が加えられる。 結果は [0,1] の範囲に収まるように修正される。

GL は次に、現在のラスタ位置の色または色インデックスおよび テクスチャ座標を各ピクセルに割り付け、 それからウィンドウ座標 ($x sub r ~+~ i , y sub r ~+~ j$) を 割り当てることにより、この結果の深さ要素値をフラグメントに変換する。 ここで ($x sub r , y sub r$) は現在のラスタ位置であり、 ピクセルは $j$ 行目の $i$ 番目のピクセルである。 これらのピクセルフラグメントは、それから 点、線、ポリゴンのラスタ処理によって作られたフラグメントと 同じように扱われる。 テクスチャマッピング、フォグ処理や全てのフラグメント操作は フラグメントがフレームバッファに書き込まれる前に行われる。

GL_STENCIL

ステンシルのインデックスをステンシルバッファから読み、 内部形式の固定小数点値に変換する。 この値の、2 進数の小数点より右のビット数は不定である。 固定小数点値のインデックスのそれぞれは、次に GL_INDEX_SHIFT ビット だけ左にシフトされ、それから GL_INDEX_OFFSET を加えられる。 GL_INDEX_SHIFT が負の値の場合は、シフトは右方向に行われる。 どちらの場合も、結果の値の中でビット値が不定となる位置は 0 で 埋められる。 GL_MAP_STENCIL が真ならば、インデックス値は、 このインデックスが参照テーブル GL_PIXEL_MAP_S_TO_S の中で 参照している値と置き換えられる。 インデックスの参照値との置き換えが行われたかどうかにかかわらず、次に インデックスの整数部分は $2 sup b -1$ との AND が取られる。 ここで $b$ はステンシルバッファ内でのビット数である。 次に、結果として得られるステンシルのインデックスがステンシルバッファ に書き込まれる。この結果を使って、 $j$ 行目の $i$ 番目のピクセル位置から読み出されたインデックスが 位置 ($x sub r ~+~ i , y sub r ~+~ j$) に書き込まれる。 ここで ($x sub r , y sub r$) は現在のラスタ位置である。 これらの書き込み操作に影響を与えるのは、ピクセルの所有者のテスト、 シザーテスト、ステンシルの書き込みマスクだけである。 ここまで述べたラスタライズ処理では、ピクセルの拡大係数を 1.0 と仮定している。 glPixelZoom を使って $x$, $y$ の拡大係数を 変えた場合には、ピクセルは次のようにフラグメントに変換される。 ($x sub r$, $y sub r$) を現在のラスタ位置とし、指定されたピクセルが 入力となる矩形領域のピクセル $j$ 行目の $i$ 番目のピクセルだと すると、 ($x sub r ~+~ zoom sub x^ i$, $y sub r ~+~ zoom sub y^j$)

および

($x sub r ~+~ zoom sub x^ (i ~+~ 1)$, $y sub r ~+~ zoom sub y^ ( j ~+~ 1 )$)
が隅となる矩形領域に中心があるピクセルに対してフラグメントが作られる。 ここで $zoom sub x$ は GL_ZOOM_X の値であり、 $zoom sub y$ は GL_ZOOM_Y の値である。

実行例

注意

エラー

関連する取得値

関連項目

Index

名前

書式

引き数

説明

実行例

注意

エラー

関連する取得値

関連項目