glColor3ubv 関数
色の値の既存の配列から現在の色を設定します。
void WINAPI glColor3ubv(
const GLubyte *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 (0 強度) にマップされます。 符号付き整数色コンポーネントを指定すると、最も正の表現可能な値が 1.0 にマップされ、最も負の表現可能な値が -1.0 にマップされるように、浮動小数点値に線形にマップされます。 (このマッピングは 0 を正確に 0.0 に変換しないことに注意してください)。浮動小数点値は直接マップされます。
現在の色が更新される前に、浮動小数点整数値も符号付き整数値も範囲 [0,1] にクランプされません。 ただし、カラー コンポーネントは、補間またはカラー バッファーに書き込まれる前に、この範囲にクランプされます。
要件 | 値 |
---|---|
サポートされている最小のクライアント |
Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー |
Windows 2000 Server [デスクトップ アプリのみ] |
ヘッダー |
|
ライブラリ |
|
[DLL] |
|