glRasterPos4i 関数

ピクセル操作のラスター位置を指定します。

構文

void WINAPI glRasterPos4i(
   GLint x,
   GLint y,
   GLint z,
   GLint w
);

パラメーター

x

現在のラスター位置の x 座標を指定します。

y

現在のラスター位置の y 座標を指定します。

方向

現在のラスター位置の z 座標を指定します。

w

現在のラスター位置の w 座標。

戻り値

この関数は値を返しません。

解説

OpenGL は、ウィンドウ座標で3d 位置を維持します。 ラスター位置と呼ばれるこの位置は、サブピクセルの精度で保持されます。 これは、ピクセルおよびビットマップの書き込み操作を配置するために使用されます。 Glbitmapgldrawpixels、および glCopyPixelsを参照してください。

現在のラスター位置は、3つのウィンドウ座標 (x、y、z)、クリップ座標 w 値、視点距離、有効なビット、および関連するカラーデータとテクスチャ座標で構成されます。 W 座標は クリップ座標です。 w はウィンドウ座標には投影されていません。 GlRasterPos4関数は、オブジェクト座標 x、y、z、および w を明示的に指定します。 GlRasterPos3 関数は、オブジェクト座標 x、y、 および z を明示的に指定しますが、 w は暗黙的に1に設定されます。 GlRasterPos2 関数は、 zw を暗黙的に0および1に設定するときに、 xy の引数値を使用します。

GlRasterPosによって表されるオブジェクト座標は、 glvertexコマンドの場合と同様に扱われます。 これらは、現在の modelview および射影行列によって変換され、クリッピングステージに渡されます。 頂点がカリングされていない場合は、投影され、新しい現在のラスター位置になるウィンドウ座標にスケーリングされます。また、GL の _ 現在の _ ラスター位置の _ _ 有効なフラグが設定されます。 頂点がカリングされている場合は、有効なビットがクリアされ、現在のラスター位置と関連付けられている色およびテクスチャ座標が未定義になります。

現在のラスター位置には、関連付けられているカラーデータとテクスチャ座標も含まれています。 照明が有効になっている場合は、 _ カラーインデックスモードの gl の現在の _ ラスターカラー、 _ または gl の _ 現在の _ ラスター _ インデックスが、照明計算によって生成される色に設定されます (「 gllight」、「 gllight モデル」、および「 glShadeModel」を参照してください)。 照明が無効になっている場合、現在の色 (RGBA モード、状態変数 GL _ の現在の _ 色) またはカラーインデックス (カラーインデックスモード、状態変数 gl の _ 現在の _ インデックス) は、現在のラスターカラーを更新するために使用されます。

同様に、GL の _ 現在の _ ラスター _ テクスチャ _ の座標は、 _ _ _ テクスチャ行列とテクスチャ生成関数 (「 gltexgen」を参照) に基づいて、gl の現在のテクスチャ座標の関数として更新されます。 最後に、modelview 行列のみによって変換された、目の座標系の原点から頂点までの距離が、GL の _ 現在の _ ラスター距離を置き換え _ ます。

最初、現在のラスター位置は (0, 0, 0, 1)、現在のラスター距離は0、有効なビットが設定され、関連付けられている RGBA 色は (1, 1, 1, 1)、関連付けられているカラーインデックスは1、関連付けられているテクスチャ座標は (0, 0, 0 RGBA モードでは、GL の _ 現在の _ ラスター _ インデックスは常に1です。カラーインデックスモードでは、現在のラスター RGBA 色は常に初期値を保持します。

注意

ラスター位置は、 glRasterPosglbitmapの両方で変更されます。

注意

ラスター位置座標が無効である場合、ラスター位置に基づく描画コマンドは無視されます (つまり、OpenGL 状態が変更されることはありません)。

次の関数は、 glRasterPosに関連する情報を取得します。

Glget 引数 GL の _ 現在の _ ラスター _ 位置
Glget 引数 GL の _ 現在の _ ラスター _ 位置が _ 有効
Glget 引数 GL の _ 現在の _ ラスター _ 距離
Glget 引数 GL の _ 現在の _ ラスター _ カラー
Glget 引数 GL の _ 現在の _ ラスター _ インデックス
Glget 引数を引数に使用する GL _ 現在の _ ラスター _ テクスチャ _ 座標

必要条件

要件
サポートされている最小のクライアント
Windows 2000 Professional[ デスクトップ アプリのみ]
サポートされている最小のサーバー
Windows 2000 Server [デスクトップ アプリのみ]
ヘッダー
Gl
ライブラリ
Opengl32
[DLL]
Opengl32.dll

関連項目

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

Gl電球モデル

glShadeModel

glTexCoord

glTexGen

glVertex