[公式ガイドサンプル] 立体モデルを移動させるアニメーション

このプログラムは、 「 VCSSL 3DCG開発ガイド 」 の 「 立体の移動 」 の回に登場するサンプルコードです。 ここでは、そのサンプルコードを実行環境ごとダウンロードして、実際に実行してみる事ができます。 プログラミングガイド的な詳しい解説については、上記ページをご参照ください。

スポンサーリンク

---

使用方法

ダウンロードと展開（解凍）

まず、PC（スマホは未対応）で上の画面の「 ダウンロード 」ボタンを押してください。 するとZIP形式で圧縮されたファイルがダウンロードされます。

その後、ZIPファイルを右クリックして「すべて展開」や「ここに展開」などで展開（解凍）してください。 展開が成功すると、ZIPファイルと同じ名前のフォルダができ、その中にZIPファイルの中身が入っています。

» 展開がエラーで止まってしまう場合や、ファイル名が文字化けしてしまう場合は…

プログラムの起動

Windows をご使用の場合

上記でZIPファイルを展開したフォルダ内にある、以下のバッチファイルをダブルクリック実行してください：

もしプログラムを書き変えながら使いたい場合は、代わりに「 VCSSL_Editor__プログラム編集はこちら.bat 」を実行してください。

正常に起動できると、初回のみ、Java実行環境を入手するか等を尋ねられるので、適時答えて済ませると、プログラムが起動します。 2回目以降はすぐに起動します。

» うまく起動できずにエラーになってしまう場合は…

Linux 等をご使用の場合

ZIPファイルを展開したフォルダ内へコマンドライン端末で cd して、以下の通り入力して実行してください：

» javaコマンドが使用できない等のエラーが表示される場合は…

起動後

起動すると、3DCGの表示ウィンドウが表れ、そこに3D空間の内容が表示されます（下図）。 表示ウィンドウ上で、マウスでの視点操作や拡大・縮小も可能です。

上の動画における赤/緑/青色の矢印が、それぞれX/Y/Z軸を表しています。

今回のサンプルコードでは、上の動画の通り、 球モデルを生成して配置し、それをX方向（＝赤矢印の方向）アニメーションで動かし続けています。

コード解説

このプログラムのコードはVCSSLで記述されています。

内容を書き変えて改造したい場合には、 プログラムのコード「 MoveModelAnimation.vcssl 」をテキストエディタで開いて改造してください。 スクリプト言語なので、コンパイラなどの別ソフトは不要で、コードを書き換えるだけでOKです。 VCSSLはC系の単純な文法の言語なので、C言語などに触れた事のある方なら簡単に読めると思います。

今回のコードは、前回のコード の拡張版

今回のコードは、以下のページに掲載している、前回のコードを拡張したものです。

• 前回： 立体モデルを移動させる

従って、上記ページのコード解説も、併せてご参照ください。 以降では、前回のコード（上記ページ）と同じ内容についての説明は割愛し、拡張した部分について説明します。

コード全体

まずはコード全体です。以下の通りです。

以上です。30行ちょっとの短いコードですね。

モデルIDを控える変数を、関数外で宣言

前回とは異なる最初の部分は、モデルのIDを控える変数を、onStart 関数の中ではなく、外で宣言している点です：

前回は、onStart 関数の中で処理が完結していましたが、今回は新たに、後述の onUpdate 関数の中にも3D処理を記述します。

そのため、onStart 関数の中だけでなく、プログラム全体からアクセスできるように、モデルのID変数を関数外に出したわけです。

onStart 関数の内容はほぼそのまま

続いて、onStart 関数の内容を定義してます。今回は、ここの内容は前回とほぼ同じで、内容の詳しい説明は割愛します。

簡単にまとめると、座標軸モデルを生成/配置して、両モデルのIDを、それぞれ変数 axis、sphere に格納しています。

onUpdate 関数内に、アニメーション用に小刻みに行う更新処理を記述

その後に、今回のポイントである onUpdate 関数が定義されています。

この onUpdate 関数は、フレームワークから、毎秒数十回のペースで、繰り返し呼び出され続ける関数です。

アニメーションを行いたいような場合は、この onUpdate 関数内に、モデルを少しずつ（1回につき、数十分の1秒で動く距離だけ）動かす処理を記述します。

すると、毎秒数十回、モデルが小刻みに移動し続けた結果、人間の目には滑らかに動いているように見えるわけです。パラパラ漫画の要領ですね。

実際に上のコードでは、前回も登場した moveModel 関数を使って、球モデルをX軸方向に距離 0.02 ずつ移動させています。 それが毎秒数十回繰り返されるので、球がX軸方向にスーっと動いていくように見えたわけです。

今回のコード内容は以上です。 他の3D関連処理も一通り知りたいという方は、 VCSSL 3DCG開発ガイド のコーナーをご覧ください。

ライセンス

このVCSSL/Vnanoコード（ 拡張子が「.vcssl」や「.vnano」のファイル ）は実質的な著作権フリー（パブリックドメイン) である CC0 の状態で公開しています※。 記事中にC言語/C++/Java言語などでのサンプルコードが掲載されいてる場合は、それらについても同様です。 そのままでのご利用はもちろん、改造や流用などもご自由に行ってください。

※ ただし、このコードの配布フォルダ内には、ダウンロード後すぐに実行できるように、 VCSSLの実行環境も同梱されており、そのライセンス文書は「 License 」フォルダ内に同梱されています （要約すると、商用・非商用問わず自由に使用できますが、使用の結果に対して開発元は一切の責任を負いません、といった具合の内容です）。 配布フォルダ内の各構成物の一覧やライセンスについては「 ReadMe_使用方法_必ずお読みください.txt 」をご参照ください。

※ Vnano の実行環境については、別途スクリプトエンジンのソースコードも一般公開しており、 何らかのソフトウェア内に組み込んでご利用いただく事も可能です。詳細はこちらをご参照ください。

この記事中の商標などについて

• OracleとJavaは、Oracle Corporation 及びその子会社、関連会社の米国及びその他の国における登録商標です。文中の社名、商品名等は各社の商標または登録商標である場合があります。
• Windows は、米国 Microsoft Corporation の米国およびその他の国における登録商標です。この記事は独立著作物であり、Microsoft Corporation と関連のある、もしくはスポンサーを受けるものではありません。
• Linux は、Linus Torvalds 氏の米国およびその他の国における商標または登録商標です。
• その他、文中に使用されている商標は、その商標を保持する各社の各国における商標または登録商標です。