glRasterPos4i 関数

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

構文

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

パラメーター

x

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

y

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

z

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

w

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

戻り値

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

注釈

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

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

glRasterPos によって表示されるオブジェクト座標は、glVertex コマンドと同様に扱われます。 これらは、現在のモデルビューと投影マトリックスによって変換され、クリッピング ステージに渡されます。 頂点がカリングされていない場合、新しい現在のラスター位置となるウィンドウ座標に投影およびスケーリングされ、GL_CURRENT_RASTER_POSITION_VALID フラグが設定されます。 頂点がカリングされている場合、有効なビットはクリアされ、現在のラスター位置と関連する色とテクスチャ座標は定義されません。

現在のラスター位置には、関連するカラー データとテクスチャ座標も含まれています。 照明が有効な場合は、RGBA モードでGL_CURRENT_RASTER_COLOR、またはカラー インデックス モードのGL_CURRENT_RASTER_INDEXは、照明計算によって生成される色に設定されます ( glLightglLightModelglShadeModel を参照)。 照明が無効になっている場合、現在のラスター カラーを更新するために、現在の色 (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 カラーは常に初期値を維持します。

注意

ラスター位置は 、glRasterPosglBitmap の両方によって変更されます。

注意

ラスター位置座標が無効な場合、ラスター位置に基づく描画コマンドは無視されます (つまり、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 [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

こちらもご覧ください

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex