Easy3D For HSP3

配布元：おちゃっこLAB


Easy3Dはおちゃっこさんが作成し公開しているHSP3で3D描画を行うためのプラグインです。
主に3Dゲームの開発をサポートする目的で開発されており、ゲーム開発に便利な380を超える豊富な数の命令が搭載されています。
HSP3からは実数対応、フォグ（霧のような表現）、トゥーンレンダリング（セルアニメのような表現）、スワップチェイン（多画面表示）など さらなる新機能が登載され、今後もさらに機能は増えていくようです。

また、HSP3.1からHSP本体に付属して配布されるようになりました。今後のEasy3Dユーザー増加が予想されます。
※正式にはHSP3.1RC1（リリース候補版）以降からHSP本体に添付されるようになりました。

Easy3Dについての詳細はEasy3D公式サイトをご覧下さい。

【注意】
Easy3D for HSP3を使用するにはHSP3.1β3以降が必要です。正式版の最新バージョンHSP3.1なら問題なく使えます。
HSP3.1βはベータ版であることを十分ご理解の上ご利用ください。
【注意】
以下の文章はEasy3Dのバージョンがver1.0.0.1の時から作成した文章が混ざっている場合があります。現在のバージョンとは内容が異なる場合がありますのでご注意ください。

支援サイト

Easy3DサンプルWiki（http://easy3d.wikiwiki.jp/）
ユーザーによるEasy3Dの応援サイトです。
ユーザーによるスクリプトサンプルやサンプル用素材の提供、ユーザー間コミュニケーションなどに利用されています。

ヘルプファイルの入手

　マニュアル（e3dhsp_func.htm）を見れば全ての命令の解説がされていますが、プログラム作成時にはワンキーヘルプがあると便利です。
ワンキーヘルプ（F1キーで呼び出すヘルプ）を利用するにはそのプラグインのヘルプファイルであるHSファイルが必要です。
最新のHSP3にはE3Dのプラグインに加えE3DのHSファイルが付属していますが、 E3Dの最新パッケージにはHSファイルが含まれていないため別途入手するか自作する必要があります。

ver3.0.3.3までは私のほうでHSファイルを作成して配布していましたが、ゆうとさんがHSファイル作成ツールEasy3DHelp2Hsを 作成されたことで、簡単に最新版ののHSファイルを作成できるようになりました。
↓こちらのサイトでダウンロードすることが出来ます。
Yuto's WebPage(本館)

【！注意！】
・明らかに誤字と思われるものについては、一部hsファイル化する際に修正を加えています。
・記述のレイアウト上変更が必要だった文字（「右の説明を」の場合「下の説明を」に変更）などについては、一部hsファイル化する際に修正を加えています。
・バーチャルキー情報の一覧については、無いと非常に不便だと感じましたので、勝手ながら私のほうで追記させていただきました。



HSファイルの使い方
　HSPをインストールしたフォルダのhsphelpフォルダ内にコピーしてご利用ください。
ヘルプブラウザを起動すると新しいHSファイルを認識します。
自分で古いHSファイルを編集していた場合はバックアップを忘れないようにしてください。編集した内容が上書きされ削除されてしまいます。

インストール

プラグインEasy3Dのインストールの仕方を説明します。
基本的に普通のHSP用プラグインをインストールする場合と同じです。

1. e3dhsp3.asをHSP3インストールフォルダ内のcommonフォルダに上書きコピーします。
2. e3dhsp3.dllをHSP3の本体があるフォルダと同じフォルダに上書きコピーします。
3. インストールが終了したら、サンプルスクリプトが動作することを確認してください。


※拡張子がdllのファイルは隠しファイルになっている（見えなくなっている）場合がありますので、見えるようにOSの設定を変更しておいてください。

動作環境

HSP 3.1β3以降。
Microsoft DirectX9.0c 以上が必要です。
対応OS：HSP3およびDirectX9が対応しているWindows（でいいと思います。） 動作するメモリ、CPU、VRAM、などはよく分かりません。

使用方法

普通のHSPプラグインと同じです。

Easy3Dを使用するスクリプトの中で、
#include "e3dhsp3.as"
と記述して、e3dhsp3.asファイルをインクルードしてください。

実行形式ファイル(.exe)にした後は、e3dhsp3.dllを作成した実行形式ファイルと同じ場所にコピーして置いてください。

権利

Easy 3D の著作権は、製作者である「おちゃっこ」さんにあります。
詳細についてはEasy3Dのマニュアルおよび公式サイトを参照してください。

サンプルプログラム

　Easy 3D for HSP3には豊富なサンプルスクリプトが付属しています。マニュアルに紹介文が載っていますのでご覧下さい。

　また、ユーザーによる解説やサンプルなどがEasy3Dサンプル wikiにて 公開されています。このWikiは閲覧者がコンテンツ作成が可能となっています。ユーザーどうしでの情報交換などに お役立て下さい。

座標系

座標系は左手系のようです。

ファイル

入出力に使用するファイルは分かっているものだけをあげると次のとおり。
まだ、作成するソフトすらわかりません。

テクスチャに使用できる画像ファイル形式
jpg, bmp, png, dds
pngはアルファチャンネルも使えます。

HSP2.61版からの変更

HSP3から実数の使用ができるようになったため、HSP2.61版からの命令もこれに対応するため仕様変更がなされています。
主な変更内容は、引数の増減と引数の倍率の変更。
下にHSP2.61版から変更のあった命令の一覧を表示します。（マニュアルから引用）

こうしてみるとかなりの数の命令に仕様変更があったようですね。