メインコンテンツまでスキップ
バージョン: 2.0.0-preview

プロジェクトの構造

MyProject というプロジェクトを作成すると、次のフォルダー構成が生成されます。

MyProject/
├── MyProject.bep
└── MyProject/
└── MyProject.scene

プロジェクト・シーン・要素のデータはJSONです。メディアとGitの管理データにはそれぞれの形式があります。

MyProject.bep​

プロジェクトに含まれるシーンと、フレームレートやサンプルレート、スピーカー配置などの共通設定を記録します。

MyProject.palettes.json​

このプロジェクトに保存 を選んだカラーパレットを記録します。プロジェクトファイルには描画結果に関わる内容だけを保存するので、パレットはプロジェクトファイルの隣にあるこのファイルに分けています。最初のパレットを保存したときに作られ、最後のパレットを削除すると消えます。

MyProject.scene​

シーンのサイズや時間の設定、タイムライン上の要素を保存します。

*.belm​

要素ごとに、タイムライン上の位置、長さ、レイヤー、名前、描画・音声・エフェクトの設定を保存します。

.beutl​

ドックの配置やエディターの表示状態など、ローカルのUI状態を保存します。スタート画面に表示するプロジェクトのサムネイルも .beutl/thumbnails に保存します。

プロジェクトを閉じると、そのとき選択していたシーンを .beutl/view-state/<プロジェクトファイル名>.config に記録し、次に開いたときはそのシーンを表示します。記録がないときや、そのシーンがプロジェクトにもうないときは、最後のシーンを表示します。記録はプロジェクトを閉じたときにだけ書き込まれるので、クラッシュした後は、最後に正常に閉じたときのシーンで開きます。

Gitの管理ファイル​

バージョン管理を有効にすると、通常のGitリポジトリを使用します。プロジェクト用に作成されたリポジトリには .git ディレクトリがあり、既存のリポジトリ内にあるプロジェクトは親リポジトリを使用できます。

.beutl に保存されるローカルのUI状態は、プロジェクトの履歴から除外されます。バージョンの記録と復元についてはバージョン管理を参照してください。

バージョン間の互換性​

2.0.0-preview.11 以降で保存したプロジェクトは、preview.10 以前では開けません。 preview.12、preview.13、preview.14 はプロジェクト形式の最低対応バージョンを 2.0.0-preview.11 のまま変えないので、これらで保存したプロジェクトも preview.11 で開けます。古いバージョンでも使う必要がある場合は、更新前にプロジェクトフォルダー全体をバックアップしてください。

プロジェクト・シーン・要素のファイルには、開くために必要な最低バージョンが記録されます。preview.11 で最低対応バージョンが上がるのは、移動の X と Y のように 2 つや 3 つの値をまとめて表示する行が、式を新しい種類の式として保存するためです。古いバージョンはそこに式を見つけられず、次に保存するときに失ってしまうため、そのようなプロジェクトを開かないようにしています。この最低対応バージョンは、そうした式を使っているかどうかにかかわらず、preview.11 で保存したすべてのプロジェクトに適用されます。1 行にまとめて表示される値を参照してください。

preview.10 で最低対応バージョンが上がったのは、ストロークエフェクトの描画順が Style プロパティからペンの 重ね順 に移ったためです。保存済みの Style は読み込み時に変換されますが、古いバージョンは新しい設定を無視し、ストロークを内容の上に描画してしまいます。引き継がれるのは保存された値だけです。重ね順 はアニメーションできないので、キーフレームや式で変化する Style は基準の値で読み込まれます。

preview.9 ではタイムラインとメディアの時刻を整数の flick 数で保存します。以前の時刻文字列は読み込み時に変換され、エディター上では引き続き読みやすい時間表示を使います。フレームレートとサンプルレートはプロジェクトの設定として保存され、分数のフレームレートは有理数のまま保持されます。

関連ドキュメント​

ソース​