glRasterPos4i 関数

  • [アーティクル]

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

構文

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

パラメーター

x

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

y

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

z

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

w

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

戻り値

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

注釈

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 に関連する情報を取得します。

glGet と引数 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

必要条件

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

関連項目

glBegin

glBitmap

glCopyPixels

glDrawPixels

glEnd

glLight

glLightModel

glShadeModel

glTexCoord

glTexGen

glVertex