glRasterPos3d 関数
ピクセル演算のラスター位置を指定します。
構文
void WINAPI glRasterPos3d(
GLdouble x,
GLdouble y,
GLdouble z
);
パラメーター
-
x
-
現在のラスター位置の x 座標を指定します。
-
y
-
現在のラスター位置の y 座標を指定します。
-
z
-
現在のラスター位置の z 座標を指定します。
戻り値
この関数は値を返しません。
注釈
OpenGL では、ウィンドウ座標の 3-D 位置が維持されます。 ラスター位置と呼ばれるこの位置は、サブピクセル精度で維持されます。 ピクセルとビットマップの書き込み操作を配置するために使用されます。 glBitmap、glDrawPixels、glCopyPixels を参照してください。
現在のラスター位置は、3 つのウィンドウ座標 (x、y、z)、クリップ座標 w 値、視線座標距離、有効なビット、および関連するカラー データとテクスチャ座標で構成されます。 w 座標はクリップ座標です。w はウィンドウ座標に投影されないためです。 glRasterPos4 関数は、オブジェクト座標 x、y、z、および w を明示的に指定します。 glRasterPos3 関数は、オブジェクト座標 x、y、z を明示的に指定し、w は暗黙的に 1 に設定します。 glRasterPos2 関数は 、x と y の引数値を使用し、 z と w を 0 と 1 に暗黙的に設定します。
glRasterPos によって提示されるオブジェクト座標は、glVertex コマンドと同様に扱われます。 これらは、現在のモデルビューおよび投影行列によって変換され、クリッピング ステージに渡されます。 頂点がカリングされていない場合は、投影され、ウィンドウ座標にスケーリングされ、新しい現在のラスター位置になり、GL_CURRENT_RASTER_POSITION_VALID フラグが設定されます。 頂点がカリングされている場合、有効なビットがクリアされ、現在のラスター位置と関連する色とテクスチャ座標は未定義になります。
現在のラスター位置には、関連するカラー データとテクスチャ座標も含まれています。 照明が有効になっている場合は、RGBA モードでGL_CURRENT_RASTER_COLORするか、カラー インデックス モードのGL_CURRENT_RASTER_INDEXを、照明計算によって生成される色に設定します ( glLight、 glLightModel、 および glShadeModel を参照)。 照明が無効になっている場合、現在の色 (RGBA モードでは状態変数GL_CURRENT_COLOR) またはカラー インデックス (カラー インデックス モードでは状態変数GL_CURRENT_INDEX) が使用され、現在のラスターの色が更新されます。
同様に、GL_CURRENT_RASTER_TEXTURE_COORDSは、テクスチャ マトリックスとテクスチャ生成関数に基づいて、GL_CURRENT_TEXTURE_COORDSの関数として更新されます ( glTexGen を参照)。 最後に、視線座標系の原点から頂点までの距離は、modelview マトリックスによってのみ変換され、GL_CURRENT_RASTER_DISTANCEに置き換えられます。
最初に、現在のラスター位置は (0,0,0,1)、現在のラスター距離は 0、有効なビットは設定され、関連する RGBA の色は (1,1,1,1)、関連するカラー インデックスは 1、関連付けられたテクスチャ座標は (0、0、0、1) です。 RGBA モードでは、GL_CURRENT_RASTER_INDEXは常に 1 です。カラー インデックス モードでは、現在のラスター RGBA カラーは常に初期値を維持します。
注意
ラスター位置は、 glRasterPos と glBitmap の両方によって変更されます。
注意
ラスター位置の座標が無効な場合、ラスター位置に基づく描画コマンドは無視されます (つまり、OpenGL 状態は変更されません)。
次の関数は 、glRasterPos に関連する情報を取得します。
引数GL_CURRENT_RASTER_POSITIONを含む glGet
引数GL_CURRENT_RASTER_POSITION_VALIDを含む glGet
引数GL_CURRENT_RASTER_DISTANCEを含む glGet
引数GL_CURRENT_RASTER_COLORを含む glGet
引数GL_CURRENT_RASTER_INDEXを含む glGet
引数GL_CURRENT_RASTER_TEXTURE_COORDSを含む glGet
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
| ヘッダー |
|
| ライブラリ |
|
| [DLL] |
|