m reformat Tag: 2017 source edit |
m 細部の補足 Tag: 2017 source edit |
||
| Line 1: | Line 1: | ||
== 概要 == | == 概要 == | ||
[[ResonitePackage]] というパッケージ方式がある。この形式はUnityでデファクトスタンダードとなっているunitypackageのように、[[User:Kisaragi marine/brson|brson]]とは異なる後方互換性が担保されたフォーマットになっている。 | [[ResonitePackage]] というパッケージ方式がある。この形式はUnityでデファクトスタンダードとなっているunitypackageのように、[[User:Kisaragi marine/brson|brson]]とは異なる後方互換性が担保されたフォーマットになっている。 | ||
(編注: brsonは後方互換性が担保されないと明言されている。) | |||
Resoniteの公式クライアントはメモリをギガバイトオーダーで消費する上起動が遅いとか、起動しないで編集したいとかで、ResonitePackageを外部から読みたいこともあるだろう。そこで、構造を調査したメモを書き留めておく。 | |||
== 形式 == | == 形式 == | ||
パッケージはZIPファイルで圧縮されている。ルートディレクトリに<code>R-Main.record</code>というファイルがあるのでそれを読む。<code>R-Main.record</code>は[[User:Kisaragi marine/record|Cloud Record]] | パッケージはZIPファイルで圧縮されている。ルートディレクトリに<code>R-Main.record</code>というファイルがあるのでそれを読む。<code>R-Main.record</code>は[[User:Kisaragi marine/record|Cloud Record]]を表現するJSONだが、ここで関心があるのは<code>assetUri</code>と<code>assetManifest</code>という2つのフィールドだ。 | ||
<code>assetUri</code>は<code>packdb</code>という<code>resdb</code>や<code>resrec</code>**ではない**URIスキーマになっているはずだ。これはパッケージの内部に存在するルートオブジェクトのハッシュを表示している。例えば、<code>packdb:///my_main_object</code>ならパッケージの中に<code>my_root_object</code>というハッシュで一位に定まるアセットが存在するはずだ (注: 実際のハッシュは16進数である。以下同様)。 | <code>assetUri</code>は<code>packdb</code>という<code>resdb</code>や<code>resrec</code>**ではない**URIスキーマになっているはずだ。これはパッケージの内部に存在するルートオブジェクトのハッシュを表示している。例えば、<code>packdb:///my_main_object</code>ならパッケージの中に<code>my_root_object</code>というハッシュで一位に定まるアセットが存在するはずだ (注: 実際のハッシュは16進数である。以下同様)。 | ||
<code>assetManifest</code>は当該パッケージが含むアセットを列挙する。具体的には以下の2つのプロパティを持つオブジェクトの配列だ: | <code>assetManifest</code>は当該パッケージが含むアセットを列挙する。具体的には以下の2つのプロパティを持つオブジェクトの配列だ: | ||
Latest revision as of 09:52, 11 January 2025
概要
ResonitePackage というパッケージ方式がある。この形式はUnityでデファクトスタンダードとなっているunitypackageのように、brsonとは異なる後方互換性が担保されたフォーマットになっている。 (編注: brsonは後方互換性が担保されないと明言されている。)
Resoniteの公式クライアントはメモリをギガバイトオーダーで消費する上起動が遅いとか、起動しないで編集したいとかで、ResonitePackageを外部から読みたいこともあるだろう。そこで、構造を調査したメモを書き留めておく。
形式
パッケージはZIPファイルで圧縮されている。ルートディレクトリにR-Main.recordというファイルがあるのでそれを読む。R-Main.recordはCloud Recordを表現するJSONだが、ここで関心があるのはassetUriとassetManifestという2つのフィールドだ。
assetUriはpackdbというresdbやresrec**ではない**URIスキーマになっているはずだ。これはパッケージの内部に存在するルートオブジェクトのハッシュを表示している。例えば、packdb:///my_main_objectならパッケージの中にmy_root_objectというハッシュで一位に定まるアセットが存在するはずだ (注: 実際のハッシュは16進数である。以下同様)。
assetManifestは当該パッケージが含むアセットを列挙する。具体的には以下の2つのプロパティを持つオブジェクトの配列だ:
hash: アセットのハッシュ。bytes: アセットのバイト数。
assetUriのpackdbスキームをメモしたら、パッケージに戻って/Assets/を見る。そうするとアセットがずらっと並んでいるだろう。今用事があるのは/Assets/my_root_objectなのでそれを見る。ルートオブジェクトはData Tree Dictionaryが書き出したものなので、いい感じに解凍する。
URIが@packdb:///my_referenced_assetのようにvalidではないURIになっていたら、先頭の@をちぎる。その後、/Assets/my_referenced_assetを見る。
アセットは大概StaticTexture2Dから参照されているPNGか、MeshXと呼ばれるメッシュ情報だろう。他にもAudioClipなどがあるかもしれない。
注釈: MeshXの頂点情報はLZ4またはLZMAで圧縮されている。