[ 前へ | 目次 | 次へ ]

各種描画関数

ここでは、グラフィックスデータに図形を描画していくための、各種描画関数について扱います。


点の描画

点を描画するには、drawPoint 関数を使用します。

- 関数仕様 -
void drawPoint (
  int rendererID,
  int x, int y, int radius
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x, x には点の中心の座標を、radius には点の半径を指定します。 最後の引数fillは、trueの場合に塗りつぶし描画、falseの場合に境界線のみの描画となります。

線の描画

線を描画するには、drawLine 関数を使用します。

- 関数仕様 -
void drawLine (
  int rendererID,
  int x1, int y1, int x2, int y2
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x1, x2 には始点の座標を、x2, y2 には終点の座標を指定します。

長方形の描画

長方形を描画するには、drawRectangle 関数を使用します。

- 関数仕様 -
void drawRectangle (
  int rendererID,
  int x, int y, int width, int height
  bool fill
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x, y には左上頂点の座標を、幅と高さを指定します。最後の引数fill は、true の場合に塗りつぶし描画、false の場合に境界線のみの描画となります。

楕円の描画

楕円(だえん)を描画するには、drawEllipse 関数を使用します。

- 関数仕様 -
void drawEllipse (
  int rendererID,
  int x, int y, int width, int height
  bool fill
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x, y には左上頂点の座標を、幅と高さを指定します。ここで指定した頂点領域に内接する楕円が描画されます。最後の引数fill は、true の場合に塗りつぶし描画、false の場合に境界線のみの描画となります。

多角形の描画

多角形を描画するには、drawPolygon 関数を使用します。

- 関数仕様 -
void drawPolygon (
  int rendererID,
  int x[ ], int y[ ],
  bool fill
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x[ ], y[ ] には、多角形を構成する頂点の座標を、配列で指定します。最後の引数fill は、true の場合に塗りつぶし描画、false の場合に境界線のみの描画となります。

折れ線の描画

折れ線を描画するには、drawPolyline 関数を使用します。

- 関数仕様 -
void drawPolyline (
  int rendererID,
  int x[ ], int y[ ],
  bool fill
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x[ ], y[ ] には、多角形を構成する頂点の座標を、配列で指定します。

テキストの描画

テキストを描画するには、drawText 関数を用します。

- 関数仕様 -
void drawText (
  int rendererID,
  int x, y, int linewidth, int lineheight
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x, x には、テキスト始点のアンダーライン(下線)の座標を指定します。座標は画面左上を原点( 0, 0 )とし、右方向にX 軸、下方向にY 軸で指定します。最後のlineWidth とlineHeight には、テキストの行幅と行間隔を指定します。描画時に行幅を超えた長いテキストは、自動で改行されて次の行に描画されます。

フォントサイズの設定

テキストの描画に使用するフォントの大きさを変更したい場合は、setDrawFontSize 関数を使用します。

- 関数仕様 -
void setDrawFontSize ( int rendererID, int fontSize )

最初の引数rendererID には、レンダラーのID を指定します。続く引数fontSize には、フォントの大きさをpt(ポイント)単位で指定します。

pt というのはフォントの大きさを指定する一般的な単位で、画面表示する際に一つの基準となるのは大体12pt 前後でしょう。10pt だとやや細かい文字、15pt だと少し大きめの文字となります。ここで注意しなければならないのは、1pt が何ピクセルに対応するかというのは環境によって異なるという点です。著しく異なる事はありませんが、一文字あたり数ピクセルずれる事はよくあります。従って、グラフィックス中にテキストを描画する際は、あまりシビアではなく、ある程度ずれる事を想定したレイアウトをする事が推奨されます。

画像の描画

画像を描画するには、drawImage 関数を用します。

- 関数仕様 -
void drawImage (
  int rendererID,
  int x, y, int width, int height
  int graphicsID
)

最初の引数rendererID には、レンダラーのID を指定します。続く引数x, x には、画像を描画する左上頂点の座標を、width, height には幅と高さを指定します。最後の引数graphicsID には、描画するグラフィックスデータのID を指定します。

引数に指定するグラフィックスID には、Graphics ライブラリのnewGraphics( stringfileName )関数で画像ファイルから読み込んだものや、別のレンダラーで描画したものなどが利用できます。

プログラム例

それでは、上で扱った各種描画関数を使用してみましょう。以下のように記述し、実行してみてください。

なお、画像の描画を行う場合は、プログラムと同じフォルダに「Test.png」という名前のPNG 形式画像ファイルを置いてから実行してください。

このプログラムを実行すると、白いウィンドウが表示され、その上に様々な図形が表示されます。

実行結果
各種描画関数で描き込んだ内容が表示される。

※ 文字に使用されるフォントは、環境によって異なります。 フォントを明示したい場合には setDrawFont( string fontName ) 関数を使用してください。


この階層の目次
お知らせ

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

リニアングラフ3D/2Dが連番ファイルのアニメーションに標準で対応
2019年07月17日 - リニアングラフ3D/2Dでは、7月17日公開の最新版より、連番ファイルを連続的に読み込みながらアニメーション描画するプログラムを同梱し、メニューから標準で使用可能になりました。その概要をお知らせします。

Vnanoのスクリプトエンジンアーキテクチャ解説2: コンパイラ
2019年07月03日 - オープンソースで開発中のスクリプトエンジン「 Vnano 」のアーキテクチャを解説する連載の第2回です。今回は、スクリプトを中間コードへと変換する、コンパイラ部分の内部をクローズアップして解説します。

新着
[公式ガイドサンプル] ユーザーのGUI操作に対して処理を行う

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

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

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

フォルダ内の連番データファイルを読み込み、2Dグラフを高速で連続描画して、アニメーションさせるツールです。グラフを連番の画像ファイルに保存する事もできます。
2019年05月24日
[公式ガイドサンプル] 立体モデルを生成して3D空間に配置する

「VCSSL 3DCG開発ガイド」内のサンプルコードです。立体モデルを生成し、3D空間に配置します。
2019年05月21日
開発元Twitterアカウント