glColor3fv 関数
既存の色値の配列から現在の色を設定します。
void WINAPI glColor3fv(
const GLfloat *v
);
-
v
-
赤、緑、青の値を含む配列へのポインター。
この関数は値を返しません。
GL は、現在の単一値カラー インデックスと現在の 4 値 RGBA 色の両方を格納します。 glcolor は、新しい 4 値 RGBA 色を設定します。 glcolor には、glcolor3 と glcolor4 という 2 つの主要なバリエーションがあります。 glcolor3 バリアントでは、新しい赤、緑、青の値を明示的に指定し、現在のアルファ値を暗黙的に 1.0 (完全な強度) に設定します。 glcolor4 バリアントでは、4 つの色コンポーネントすべてを明示的に指定します。
glcolor3b、 glcolor4b、 glcolor3s、 glcolor4s、 glcolor3i、 および glcolor4i は、3 つまたは 4 つの符号付きバイト、短い、または長い整数を引数として受け取ります。 名前に v を追加すると、カラー コマンドはそのような値の配列へのポインターを受け取ることができます。
現在の色の値は、仮数と指数のサイズが指定されていない浮動小数点形式で格納されます。 符号なし整数の色成分を指定すると、最大の表現可能な値が 1.0 (完全な強度) にマップされ、0 が 0.0 (ゼロ強度) にマップされるように、浮動小数点値に線形にマップされます。 符号付き整数色コンポーネントを指定すると、浮動小数点値に線形マップされます。これにより、最も正の表現可能な値が 1.0 にマップされ、最も負の表現可能な値が -1.0 にマップされます。 (このマッピングは 0 を正確に 0.0 に変換しないことに注意してください)。浮動小数点値は直接マップされます。
現在の色が更新される前に、浮動小数点整数値も符号付き整数値も範囲 [0,1] に固定されません。 ただし、カラー コンポーネントは、補間またはカラー バッファーに書き込まれる前に、この範囲にクランプされます。
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|