title: a3format

Acerola3Dファイルのフォーマット仕様書
========================================

Acerola3Dファイルのフォーマットの詳細を説明します．
ただし，2008年9月現在，ここで説明されるフォーマットの機能
の一部はAcerola3DのJava3Dインプリメンテーションで利用でき
ないものもあります．利用できない機能については「未実装」と
表記しておきます．また，このドキュメントに関して間違いや
不明な点などを見付けた方は<ksaito.sourceforge.jp@gmail.com>
までご連絡いただけると助かります．

Acerola3Dフォーマットのファイルに含まれる要素
----------------------------------------

Acerola3DフォーマットのファイルはZIP形式の
圧縮ファイルであり，その中には以下のファイル
が含まれます．

* CATALOG.XML
* BVHファイル
* VRML97ファイル
* VRML97ファイルが参照するテクスチャ
  などのファイル
* CATALOG.XMLから参照される
  音声ファイル
* サムネール画像ファイル
* index.htmlとこれが参照するファイル

CATALOG.XMLは必須のファイルです．その他は
オプションですが，特殊な場合を除いて
BVHファイルとVRML97ファイルはほぼ必須です．

CATALOG.XMLとはAcerola3Dファイルに含まれる
アクションの情報や，メタデータが記述される
XMLファイルで詳細は後述します．

CATALOG.XMLとindex.htmlファイルは
ZIP圧縮ファイルの直下になければなりません．
(フォルダの中などに入った形で圧縮され
ていてはなりません．)

それ以外のファイルはフォルダを作成して
その中に入れることも可能ですが，その場合は
CATALOG.XMLファイルでの記述でフォルダ名
から指定しなければなりません．VRML97の参照
するファイルはVRML97ファイル内で相対アドレス
で指定しそこに配置するものとします．

META-INFフォルダとその中身は，将来の拡張のために
予約されているので，使用できないものとします．

CATALOG.XML
----------------------------------------

CATALOG.XMLはAcerola3Dファイルに含まれるアクション
の情報やメタデータなどを記述しておくXMLファイルです．

XMLの厳密なスキーマはacerola3dパッケージ内grammar
フォルダ内のcatalog.xsdで定義されますが，ここでは
スキーマの意味について詳述してゆきます．

VRML97ファイルとその参照ファイル
----------------------------------------

BVH(BioVision Hierarchy)ファイル
----------------------------------------

CATALOG.XMLから参照される音声ファイル
----------------------------------------

CATALOG.XML内では，それぞれのアクションに対応付けて
再生される効果音を指定することができる．そこで指定された
効果音のファイルを含める


再利用性を高めるための仕様
----------------------------------------

* 長さの単位はメートル
* キャラクタは原点を地面として
