[ 前へ | 目次 | 次へ ]

フレームワークの使用

ここでは、基盤的な処理を自動化してくれる、簡易フレームワークについて説明します。

標準で使用できる、3DCGプログラム用のフレームワーク

前回と前々回で扱ったように、3DCGのプログラムでは、表示画面やレンダラー(描画エンジン)の生成、 画面描画やアニメーションのためのループ制御、マウス操作に対する処理など、基盤的な処理が必要になります。 これらを毎回記述するのは面倒であるため、 このような処理を自動で行ってくれるフレームワーク「 Graphics3DFramework 」が標準で用意されています。

ユーザーが定義する関数

フレームワークは、単体でも基本構造としてはできあがったプログラムであり、普通に実行する事もできます。 ただし、標準では何の立体も配置されておらず、真っ白な画面が表示されるだけです。

そこで、普通は自作のプログラムからフレームワークを読み込んだ上で、 立体の配置などの必要な処理だけを追加して使用します。 具体的には、決まった名前と引数の関数を定義して、その中に行いたい処理を記述すると、 フレームワークがそれを呼び出して実行してくれます。

フレームワークが自動で呼び出してくれる関数には、タイミングに応じて以下5つがあります:

・プログラムの最初に呼び出される関数(各種設定や、立体の配置処理などを記述)
void onStart ( int rendererID )

・画面更新周期ごとに呼び出される関数(画面描画用、3DCGでは普通あまり使用しない)
void onPaint ( int rendererID )

・画面更新周期ごとに呼び出される関数(アニメーションでのモデル移動処理などを記述)
void onUpdate ( int rendererID )

・画面サイズが変更されたときに呼び出される関数
void onResize ( int rendererID )

・プログラムを終了する時に呼び出される関数
void onExit ( int rendererID )

引数の「 rendererID 」には、フレームワークから呼び出される際に、 自動で用意されている3DCGレンダラー(描画エンジン)のIDが入っています。 これはモデルの配置などに必要です。

なお、上記の関数を全て定義する必要はありません。使うものだけを定義し、処理を記述してください。 よくあるパターンとしては、onStart関数の中でモデルの生成や配置を行い、 onUpdate関数の中でモデルを少しずつ動かしてアニメーションする、といった具合です。

onUpdate関数は、負荷にもよりますが、大体1秒間に30回ほど呼び出されます。 それと交互に、2DCGではよく使用したonPaint関数も呼び出されますが、3DCGではあまり使用しません。

プログラム例

実際にフレームワークを使用して、座標軸モデルが回転するアニメーションの3DCGプログラムを作成してみましょう。 下のように記述し、実行してみてください。

このプログラムを実行すると、ウィンドウが立ち上がり、座標軸モデルがゆっくりとアニメーションで回り続けます。 ウィンドウ上で左マウスドラッグを行うと視点が回転し、右マウスドラッグを行うと、 視点が平行移動します。さらにマウスホイールの回転操作で拡大/縮小を行う事もできます。

実行結果、黒い画面に座標軸モデルの図。
実行結果
真っ黒な画面に、座標軸モデルが表示される。マウス操作も可能。



スポンサーリンク



この階層の目次
[ 前へ | 目次 | 次へ ]
お知らせ

リニアングラフ3Dをアップデート、次期版(Ver.6)の開発もスタート
2023/09/04 - リニアングラフ3Dのアップデート版をリリースしました。また、次期メジャーバージョンである Ver.6 系の開発も開始しました。それぞれについて解説します。

AIの補助により、英語版ドキュメントを大幅拡充へ - 作業の舞台裏も紹介!
2023/05/28 - RINEARNでは今後、ChatGPT等のAIの補助により、英語版ドキュメントを大幅に拡充していく方針です。既に行った英訳作業の様子なども紹介しつつ、詳しく解説します。

リニアングラフ3Dをアップデート、API関連機能などを拡充
2023/05/18 - リニアングラフ3Dのアップデート版をリリースしました。主に、Java言語やVCSSLでの制御機能などを拡充しました。更新内容をそれぞれ詳しく解説します。

新着
[公式ガイドサンプル] 各種の図形や画像を描画する

「VCSSL 2DCG開発ガイド」内のサンプルコードです。図形や画像などを描画します。
2022/12/16
角度の「度」とラジアンとを相互変換し、図示もするツール

45度などの「度」の値と、ラジアンの値とを相互に変換できるツールです。対応する角度の図示もできます。
2022/11/22
[公式ガイドサンプル] 立体モデルを回転させるアニメーション

「VCSSL 3DCG開発ガイド」内のサンプルコードです。立体モデルを、アニメーションで回転させ続けます
2022/11/18
[公式ガイドサンプル] 立体モデルを回転させる

「VCSSL 3DCG開発ガイド」内のサンプルコードです。立体モデルを、指定した角度だけ回転させます。
2022/11/17
[公式ガイドサンプル] 四則演算の計算順序や、カッコを使った順序指定

「VCSSLスタートアップガイド」内のサンプルコードです。四則演算が計算される順序や、カッコを使って順序を指定する方法を例示します。
2022/10/31