glRasterPos4sv

ピクセル操作用のラスタ位置を指定する。| glRasterPos4sv 関数 (Gl.h)

glRasterPos4sv v

v : [var] 現在のラスタ位置の x, y, z, w 座標を指定する 4 要素配列へのポインタ。

(プラグイン / モジュール : opengl32.dll)

解説

ピクセル操作用のラスタ位置を指定する。| glRasterPos4sv 関数 (Gl.h)

[戻り値]
この関数は値を返さない。

[備考]
OpenGL はウィンドウ座標の 3D
位置を保持する。この位置はラスタ位置と呼ばれ、サブピクセル精度で保持される。ピクセルやビットマップの書き込み操作の位置決めに使われる
(glBitmap、glDrawPixels、glCopyPixels 参照)。現在のラスタ位置は 3 つのウィンドウ座標 (x, y,
z)、クリップ座標 w 値、アイ座標距離、有効ビット、関連するカラーデータとテクスチャ座標から構成される。w
はクリップ座標であり、ウィンドウ座標へは射影されない。glRasterPos4 はオブジェクト座標 x, y, z, w
を明示的に指定する。glRasterPos3 は w が暗黙的に 1 に設定され、glRasterPos2 は z=0、w=1
に設定される。glRasterPos が提示するオブジェクト座標は glVertex
と同様に扱われ、現在のモデルビュー行列と投影行列で変換されてクリッピング段階に渡される。頂点がカリングされなければウィンドウ座標に射影・スケールされ、それが新しい現在のラスタ位置となり
GL_CURRENT_RASTER_POSITION_VALID
フラグが設定される。カリングされた場合は有効ビットがクリアされ、ラスタ位置と関連色/テクスチャ座標は未定義になる。ライティングが有効な場合、GL_CURRENT_RASTER_COLOR
(RGBA モード) または GL_CURRENT_RASTER_INDEX (カラーインデックスモード)
はライティング計算結果の色に設定される。ライティング無効時は現在のカラー (GL_CURRENT_COLOR) またはカラーインデックス
(GL_CURRENT_INDEX) で更新される。同様に GL_CURRENT_RASTER_TEXTURE_COORDS
はテクスチャ行列とテクスチャ生成関数に基づいて GL_CURRENT_TEXTURE_COORDS
から更新される。最後に、モデルビュー行列のみで変換した頂点の原点からの距離が GL_CURRENT_RASTER_DISTANCE
を置き換える。初期値はラスタ位置 (0,0,0,1)、距離 0、有効ビットあり、RGBA (1,1,1,1)、カラーインデックス
1、テクスチャ座標 (0,0,0,1)。注意: ラスタ位置は glRasterPos と glBitmap
の両方で変更される。ラスタ位置座標が無効な場合、ラスタ位置に基づく描画コマンドは無視される。関連情報は glGet
(GL_CURRENT_RASTER_POSITION / _VALID / _DISTANCE / _COLOR / _INDEX /
_TEXTURE_COORDS) で取得できる。

情報