Graphics ライブラリ

• 概要 - Abstruct
• 目次 - Index
• 構造体 - Structs
• 変数 - Variables
• 関数 - Functions
• 実装コード

概要 - Abstract

VCSSL Graphics ライブラリ は、VCSSLで描画を扱うための標準ライブラリの一つです。

VCSSLにおける描画関連の標準ライブラリには、Graphics、Graphics2D、Graphics3D ライブラリの 3 つが存在します。
その中で、Graphics ライブラリは描画用リソースの管理機能を提供し、Graphics2D 及び Graphics3D ライブラリは実際の描画機能を提供します。

描画を行うためには、イメージやバッファ、ストリームなどのリソースが必要となります。
いくつかの（恐らく多くの）言語では、これらは独立なオブジェクトとして扱う事が多いですが、VCSSLではこれらを一つにまとめて「 グラフィックスデータ 」として扱います。
つまりVCSSLでは、アニメーションでリアルタイムに3DCGを描画するためのバッファ領域も、画像ファイルから読み込んだ固定的なイメージも、区別せずに「 グラフィックスデータ 」として扱います。

Graphics ライブラリが提供するのは、この「 グラフィックスデータ 」の生成や破棄、入出力、及び初等的な加工などの管理機能です。
例として、画像ファイル「 input.png 」を読み込み、黒色の部分を透明にして「 output.png 」に出力するには、以下のようにします。

他にも、ラスタデータ（ピクセル配列）を直接操作して、初歩的な加工や描画などを行う機能が提供されます。
より高度な描画を行うには、Graphics2D 及び Graphics3D ライブラリを併せて使用してください。

目次 - Index

int newGraphics()

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、サイズが0ピクセルのイメージを保持します。

int newGraphics( string filePath )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、画像ファイルから読み込んだイメージがあらかじめ描き込まれています。

int newGraphics( int red[ ][ ], int green[ ][ ], int blue[ ][ ], int alpha[ ][ ] )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、ピクセル配列から読み込んだイメージがあらかじめ描き込まれています。

int newGraphics( int rgba[ ][ ][ ] )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、ピクセル配列から読み込んだイメージがあらかじめ描き込まれています。

int newGraphics( int baseGraphics, int fromRed, int fromGreen, int fromBlue, int fromAlpha, int toRed, int toGreen, int toBlue, int toAlpha )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、別のグラフィックスデータの特定色を、別の色に変換したイメージがあらかじめ描き込まれています。

int newGraphics( int baseGraphics, int fromColor[ ], int toColor[ ] )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、別のグラフィックスデータの特定色を、別の色に変換したイメージがあらかじめ描き込まれています。

int newGraphics ( int baseGraphics, int width, int height, bool antialiasing )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、別のグラフィックスデータを拡大・縮小した内容があらかじめ描き込まれています。

int newGraphics ( int baseGraphics, int cropX, int cropY, int cropWidth, int cropHeight )

グラフィックスデータを生成し、それに固有の識別番号である「グラフィックスデータID」を割り振って返します。この関数で生成したグラフィックスデータは、別のグラフィックスデータの一部を抜き出した内容があらかじめ描き込まれています。

void deleteGraphics( int id )

グラフィックスデータを破棄します。

int getGraphicsWidth( int id )

グラフィックスデータが保持するイメージの幅（ピクセル数）を返します。

int getGraphicsHeight( int id )

グラフィックスデータが保持するイメージの高さ（ピクセル数）を返します。

void exportGraphics( int id, string name, string format )

グラフィックスデータが保持するイメージを、画像ファイルに変換して出力します。

void exportGraphics( int id, string name, string format, double quality )

グラフィックスデータが保持するイメージを、画像ファイルに変換して出力します。

void setGraphicsPixel( int id, int red[ ][ ], int green[ ][ ], int blue[ ][ ], int alpha[ ][ ] )

グラフィックスデータの保持するイメージを、指定されたピクセル配列で描きかえます。

void setGraphicsPixel( int id, int rgba[ ][ ][ ] )

グラフィックスデータの保持するイメージを、指定されたピクセル配列で描きかえます。

int[ ][ ][ ] getGraphicsPixel( int id )

イメージの全ピクセル色成分を格納する配列を返します。

int[ ][ ] getGraphicsPixelRed( int id )

イメージの全ピクセルについて、赤色成分のみを格納する配列を返します。

int[ ][ ] getGraphicsPixelGreen( int id )

イメージの全ピクセルについて、緑色成分のみを格納する配列を返します。

int[ ][ ] getGraphicsPixelBlue( int id )

イメージの全ピクセルについて、青色成分のみを格納する配列を返します。

int[ ][ ] getGraphicsPixelAlpha( int id )

イメージの全ピクセルについて、α値成分のみを格納する配列を返します。

構造体 - Structs

- なし - None -

変数 - Variables

- なし - None -

関数 - Functions