glColor3usv 関数

  • [アーティクル]

色の値の既存の配列から現在の色を設定します。

構文

void WINAPI glColor3usv(
   const GLushort *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 [デスクトップ アプリのみ]
ヘッダー
Gl.h
ライブラリ
Opengl32.lib
[DLL]
Opengl32.dll

関連項目

glBegin

glEnd

glGetBooleanv、glGetDoublev、glGetFloatv、glGetIntegerv

glIndex