Color ライブラリ


概要 - Abstract

VCSSL Color ライブラリ は、色の扱いを補助するための標準ライブラリです。主に Graphics2D や Graphics3D ライブラリなどと組み合わせて、グラフィックス関連の処理に用います。

このライブラリでは、色を int[4] 配列として扱います。各要素は、[0] が赤色成分、[1] が緑色成分、[2] が青色成分、[3] がα値成分を格納します。
それぞれの色成分における値の範囲は 0 〜 255 です。つまり int[4] 配列で 32bit のRGBAカラーを表現します。
このライブラリに合わせて、Graphics2D や Graphics3D ライブラリなどでも、int[4] 配列を 32bit RGBAカラーと見なして、色の設定・取得などを行えるようになっています。

使用例として、Graphics2D で描画色を青色に設定する例を挙げます。これはColorライブラリの機能を使用しなくても、以下のようにして可能です:

setDrawColor( rendererID, 0, 0, 255, 255 );

しかし、Colorライブラリの機能を使用する事で、以下のように様々な形式で色設定ができるようになります:

setDrawColor( rendererID, BLUE ); // 定数で設定
setDrawColor( rendererID, color(0, 0, 255) ); // 24bit RGBカラーで設定
setDrawColor( rendererID, color(0.0, 0.0, 1.0) ); // 0.0 〜 1.0 の範囲のRGBカラーで設定
setDrawColor( rendererID, color( 0x0000ff ) ); // 16進数カラーコードで設定


目次 - Index

const int BLACK[ ]
黒色の色成分を格納する配列です。
const int WHITE[ ]
白色の色成分を格納する配列です。
const int RED[ ]
赤色の色成分を格納する配列です。
const int GREEN[ ]
緑色の色成分を格納する配列です。
const int BLUE[ ]
青色の色成分を格納する配列です。
const int MAGENTA[ ]
紫色(マゼンタ)の色成分を格納する配列です。
const int YELLOW[ ]
黄色の色成分を格納する配列です。
const int CYAN[ ]
水色(シアン)の色成分を格納する配列です。
int[ ] color(int red, int green, int blue, int alpha)
0 〜 255 の整数RGBA値から、色成分を格納する配列を生成して返します。
int[ ] color(int red, int green, int blue)
0 〜 255 の整数RGB値から、色成分(不透明色)を格納する配列を生成して返します。
int[ ] color(float red, float green, float blue, float alpha)
0.0 〜 1.0 の小数RGBA値から、色成分を格納する配列を生成して返します。
int[ ] color(float red, float green, float blue)
0.0 〜 1.0 の小数RGB値から、色成分(不透明色)を格納する配列を生成して返します。
int[ ] color(int hexCode)
16進数カラーコード値から、色成分(不透明色)を格納する配列を生成して返します。例として、青色である 0000ff を変換するには:int rgba[] = color(0x0000ff);などとします。0x は整数を16進数表記したい場合に付加するプレフィックスです。
int getColorCode(int rgba[ ])
色成分の配列を、カラーコード値に変換して返します。例として、紫色(マゼンタ)をカラーコードに変換するには:int rgba[] = { 255, 0, 255, 255 };int colorCode = getColorCode(rgba);string hexCode = hex(colorCode);などとします。変数 hexCode に得られる結果は 0xff00ff です。なお、緑色の場合は 0xff00、青色の場合は 0xff を得ます。より一般的なカラーコード形式に整形するには、先頭の 0x を除去し、6桁になるよう左からゼロ詰めなどを行ってください。そういった文字列処理には Text ライブラリを使用すると便利です。

構造体 - Structs

- なし - None -


変数 - Variables

定義
- Signature
const int BLACK[ ]
詳細
- Details
黒色の色成分を格納する配列です。
定義
- Signature
const int WHITE[ ]
詳細
- Details
白色の色成分を格納する配列です。
定義
- Signature
const int RED[ ]
詳細
- Details
赤色の色成分を格納する配列です。
定義
- Signature
const int GREEN[ ]
詳細
- Details
緑色の色成分を格納する配列です。
定義
- Signature
const int BLUE[ ]
詳細
- Details
青色の色成分を格納する配列です。
定義
- Signature
const int MAGENTA[ ]
詳細
- Details
紫色(マゼンタ)の色成分を格納する配列です。
定義
- Signature
const int YELLOW[ ]
詳細
- Details
黄色の色成分を格納する配列です。
定義
- Signature
const int CYAN[ ]
詳細
- Details
水色(シアン)の色成分を格納する配列です。

関数 - Functions

定義
- Signature
int[ ] color(int red, int green, int blue, int alpha)
詳細
- Details
0 〜 255 の整数RGBA値から、色成分を格納する配列を生成して返します。
引数
- Arguments
red : 赤色成分(0〜255)。
green : 緑色成分(0〜255)。
blue : 青色成分(0〜255)。
alpha : 不透明度成分(0〜255)。
戻り値
- Return
色成分を格納する配列。
定義
- Signature
int[ ] color(int red, int green, int blue)
詳細
- Details
0 〜 255 の整数RGB値から、色成分(不透明色)を格納する配列を生成して返します。
引数
- Arguments
red : 赤色成分(0〜255)。
green : 緑色成分(0〜255)。
blue : 青色成分(0〜255)。
戻り値
- Return
色成分を格納する配列。
定義
- Signature
int[ ] color(float red, float green, float blue, float alpha)
詳細
- Details
0.0 〜 1.0 の小数RGBA値から、色成分を格納する配列を生成して返します。
引数
- Arguments
red : 赤色成分(0.0 〜 1.0)。
green : 緑色成分(0.0 〜 1.0)。
blue : 青色成分(0.0 〜 1.0)。
alpha : 不透明度成分(0.0 〜 1.0)。
戻り値
- Return
色成分を格納する配列。
定義
- Signature
int[ ] color(float red, float green, float blue)
詳細
- Details
0.0 〜 1.0 の小数RGB値から、色成分(不透明色)を格納する配列を生成して返します。
引数
- Arguments
red : 赤色成分(0.0 〜 1.0)。
green : 緑色成分(0.0 〜 1.0)。
blue : 青色成分(0.0 〜 1.0)。
戻り値
- Return
色成分を格納する配列。
定義
- Signature
int[ ] color(int hexCode)
詳細
- Details
16進数カラーコード値から、色成分(不透明色)を格納する配列を生成して返します。
例として、青色である 0000ff を変換するには:
int rgba[] = color(0x0000ff);
などとします。0x は整数を16進数表記したい場合に付加するプレフィックスです。
引数
- Arguments
red : 赤色成分(0.0 〜 1.0)。
green : 緑色成分(0.0 〜 1.0)。
blue : 青色成分(0.0 〜 1.0)。
戻り値
- Return
色成分を格納する配列。
定義
- Signature
int getColorCode(int rgba[ ])
詳細
- Details
色成分の配列を、カラーコード値に変換して返します。例として、紫色(マゼンタ)をカラーコードに変換するには:
int rgba[] = { 255, 0, 255, 255 };
int colorCode = getColorCode(rgba);
string hexCode = hex(colorCode);
などとします。変数 hexCode に得られる結果は 0xff00ff です。なお、緑色の場合は 0xff00、青色の場合は 0xff を得ます。より一般的なカラーコード形式に整形するには、先頭の 0x を除去し、6桁になるよう左からゼロ詰めなどを行ってください。そういった文字列処理には Text ライブラリを使用すると便利です。
引数
- Arguments
rgba[] : 色成分を格納する配列。[0] が赤色成分、[1] が緑色成分、[2] が青色成分、[3] がα値成分。色成分はそれぞれ 0 〜 255 の範囲ですが、α値成分は必ず 255 (不透明)でなくてはいけません。
戻り値
- Return
カラーコード値の整数。16進数の文字列に変換するには hex 関数を使用します。

この階層の目次
お知らせ

リニアングラフ3DのVCSSL用APIにカメラ制御関数を追加、回転アニメーションツールも同梱
2019年10月09日 - RINEARNでは10月9日にソフトウェアの最新版をリリースしました。VCSSLのAPI関数の追加や、リニアングラフ3Dのアニメーションツールの追加など行っています。その概要をお知らせします。

小型関数電卓 RINPn(旧称リニアンプロセッサー nano)の公式ページを開設
2019年10月02日 - 現在オープンソースで開発中の、「シンプル&コンパクト」を目指した小型プログラマブル関数電卓ソフト「 RINPn 」の公式ページが、RINEARNサイト内にオープンしました。その概要をお知らせします。

Vnanoの公式サイトがオープン、チュートリアルやAPI仕様書等も掲載
2019年08月07日 - オープンソースのアプリケーション組み込み用スクリプトエンジン「 Vnano 」の公式サイトを開設しました。チュートリアルや、スクリプトエンジンのAPI仕様書などが参照できます。その概要をお知らせします。

新着
3Dグラフを回転アニメーションさせるツール

3Dグラフを、Z軸まわりにゆっくりと回転アニメーションさせるツールです。全角度のグラフを、連番の画像ファイルに保存する事もできます。
2019年10月09日
[公式ガイドサンプル] ユーザーのGUI操作に対して処理を行う

「VCSSL GUI開発ガイド」内のサンプルコードです。ユーザーがGUIを操作した際に行う処理を実装します。
2019年07月28日
[公式ガイドサンプル] 各種GUIコンポーネントを画面上に配置する

「VCSSL GUI開発ガイド」内のサンプルコードです。色々な種類のGUI部品を画面上に配置します。
2019年07月28日
連番ファイルから3Dグラフをアニメーション描画するツール

フォルダ内の連番データファイルを読み込み、3Dグラフを高速で連続描画して、アニメーションさせるツールです。グラフを連番の画像ファイルに保存する事もできます。
2019年06月03日
連番ファイルから2Dグラフをアニメーション描画するツール

フォルダ内の連番データファイルを読み込み、2Dグラフを高速で連続描画して、アニメーションさせるツールです。グラフを連番の画像ファイルに保存する事もできます。
2019年05月24日
開発元Twitterアカウント