KSPリファレンスマニュアル 26 - リソースコンテナ(Resource Container)

KSPリファレンスマニュアル 26 - リソースコンテナ(Resource Container)


はじめに

リソースコンテナは、ライブラリ開発者にとって便利なツールです。スクリプト、グラフィック、.nkaファイル、Creator ToolsのGUI Designerで作成したパフォーマンスビュー、インパルスレスポンスファイルを保存しておくための専用の場所であり、コンテナにリンクされた任意のNKI、あるいはNKIのグループから参照できます。もうひとつの利点は、すべてのスクリプトやグラフィックなどを収めたリソースコンテナのモノリスファイルを作成できることです。これにより、それらをまとめて移動したり、他のチームメンバーに送ったりすることが簡単になります。NKIを読み込むとき、リソースコンテナはサンプルと同じように扱われるため、見つからない場合はContent Missingダイアログに表示されます。


セットアップ

ライブラリ用のリソースコンテナを作成するには、作業中のInstrumentのInstrument Optionsダイアログを開き、Resource Containerというラベルの付いた領域の横にあるCreateボタンをクリックします。新しいリソースコンテナファイルを作成すると、KontaktはResourcesフォルダーがすでに用意されているかどうかを確認します。無ければ、Kontaktが代わりに作成するかどうかを尋ねてきます。作成すると、いま作成したNKRファイルの隣にResourcesフォルダーとDataフォルダーが見つかります。

Resourcesフォルダーは、Instrumentが使用するサンプル以外のファイルを保存しておく場所です。ご覧のとおり、Kontaktはすでにいくつかのサブフォルダーを作成しています:data(.nkaファイル用)、ir_sampleskomplete_scripts(Komplete UIで使用するグラフィックとスクリプト用)、performance_view(Creator ToolsのGUI Designerのパフォーマンスビューファイル用)pictures(KSPで使用するGUIグラフィックと壁紙用)、そしてscriptsです。あとは自分のファイルを適切なフォルダーへ移動するだけで、準備は完了です。


リソースコンテナの使い方

新しいライブラリを作っているとしましょう。上で説明したようにリソースコンテナを設定したら、ライブラリを構成するすべてのNKIに対して、この特定のリソースコンテナを使うよう指定できます。Instrument Optionsダイアログを開いてBrowse機能を使うだけです(Createボタンの左にある、開いたフォルダーのボタンをクリックします)。

NKRファイル(これがリソースコンテナのモノリスです)の隣にResourcesフォルダーがある限り、Kontaktはこのフォルダー構造からすべてのファイルを直接読み込みます。

scriptsサブフォルダーからスクリプトを読み込むには、Script Editor内の「Apply from… → Resources folder」機能を使用します。

次に、現在の作業状態を別のチームメンバーに送りたい場合を考えてみましょう。Instrument Optionsダイアログを開き、Repackボタンをクリックすると、既存のNKRファイルが素早く完全に更新されます。これは既存のモノリスを完全に上書きするもので、内容の照合はいっさい行われない点に注意してください。このときKontaktは次の処理を行います:

  • dataサブフォルダー内の.nkaファイルを確認します。

  • ir_samplesサブフォルダー内の.wav、.aif、.aiff、.ncwファイルを確認します。

  • komplete_scriptsフォルダー内の、Komplete UIで使用される有効なファイル(.kscript、.png、.svg、.tif、.tiff、.webp、.otf、.ttf)を確認します。

  • performance_viewフォルダー内の、Creator Toolsで作成されたパフォーマンスビューを含む.nckpファイルを確認します。

  • picturesフォルダー内の.pngまたは.tgaファイルのうち、同じファイル名の.txtファイルが隣に置かれているものを確認します。壁紙、Instrumentのアイコン、カスタムピクチャーフォントにも.txtファイルが必要で、無ければ無視されてしまうので注意してください。

  • scriptsサブフォルダー内の.txtファイルを確認します。

  • 有効なファイルをすべてリソースコンテナにパックします。

そのあと、Resourcesフォルダーの名前を変更して、Instrumentを開き直します。Resourcesフォルダーが存在しなくなったので、KontaktはNKRのモノリスファイルから自動的に読み込むようになります。すべてが期待どおりに動作していれば、ライブラリ(Instrumentと、そのサンプルおよびNKRモノリス)をチームメンバーに送ることができます。ライブラリを市場に出すときもこの形にします。Resourcesフォルダーを同梱した状態でライブラリをリリースしてはいけません。

作業を続けるには、Resourcesフォルダーの名前をResourcesに戻すだけです。


補足

  • リソースコンテナはContent Missingダイアログで確認されます。

  • Instrumentをモノリスファイルとして保存しても、リソースコンテナはモノリスに統合されません。リソースコンテナへのパスは絶対パスとして保存されるため、自分のマシン上でしか機能しません。他のコンピューターでは、そのInstrumentを読み込んだときにContent Missingダイアログが表示されます。リソースコンテナへのパスがもはや有効ではない可能性が高いためです。


リソースコンテナ

はじめに

リソースコンテナは、ライブラリ開発者にとって便利なツールです。スクリプト、グラフィック、.nkaファイル、Creator ToolsのGUI Designerで作成したパフォーマンスビュー、インパルスレスポンスファイルを保存しておくための専用の場所であり、コンテナにリンクされた任意のNKI、あるいはNKIのグループから参照できます。もうひとつの利点は、すべてのスクリプトやグラフィックなどを収めたリソースコンテナのモノリスファイルを作成できることです。これにより、それらをまとめて移動したり、他のチームメンバーに送ったりすることが簡単になります。NKIを読み込むとき、リソースコンテナはサンプルと同じように扱われるため、見つからない場合はContent Missingダイアログに表示されます。

セットアップ

ライブラリ用のリソースコンテナを作成するには、作業中のInstrumentのInstrument Optionsダイアログを開き、Resource Containerというラベルの付いた領域の横にあるCreateボタンをクリックします。新しいリソースコンテナファイルを作成すると、KontaktはResourcesフォルダーがすでに用意されているかどうかを確認します。無ければ、Kontaktが代わりに作成するかどうかを尋ねてきます。作成すると、いま作成したNKRファイルの隣にResourcesフォルダーとDataフォルダーが見つかります。

Resourcesフォルダーは、Instrumentが使用するサンプル以外のファイルを保存しておく場所です。ご覧のとおり、Kontaktはすでにいくつかのサブフォルダーを作成しています:data(.nkaファイル用)、ir_sampleskomplete_scripts(Komplete UIで使用するグラフィックとスクリプト用)、performance_view(Creator ToolsのGUI Designerのパフォーマンスビューファイル用)pictures(KSPで使用するGUIグラフィックと壁紙用)、そしてscriptsです。あとは自分のファイルを適切なフォルダーへ移動するだけで、準備は完了です。

リソースコンテナの使い方

新しいライブラリを作っているとしましょう。上で説明したようにリソースコンテナを設定したら、ライブラリを構成するすべてのNKIに対して、この特定のリソースコンテナを使うよう指定できます。Instrument Optionsダイアログを開いてBrowse機能を使うだけです(Createボタンの左にある、開いたフォルダーのボタンをクリックします)。

NKRファイル(これがリソースコンテナのモノリスです)の隣にResourcesフォルダーがある限り、Kontaktはこのフォルダー構造からすべてのファイルを直接読み込みます。

scriptsサブフォルダーからスクリプトを読み込むには、Script Editor内の「Apply from… → Resources folder」機能を使用します。

次に、現在の作業状態を別のチームメンバーに送りたい場合を考えてみましょう。Instrument Optionsダイアログを開き、Repackボタンをクリックすると、既存のNKRファイルが素早く完全に更新されます。これは既存のモノリスを完全に上書きするもので、内容の照合はいっさい行われない点に注意してください。このときKontaktは次の処理を行います:

  • dataサブフォルダー内の.nkaファイルを確認します。

  • ir_samplesサブフォルダー内の.wav、.aif、.aiff、.ncwファイルを確認します。

  • komplete_scriptsフォルダー内の、Komplete UIで使用される有効なファイル(.kscript、.png、.svg、.tif、.tiff、.webp、.otf、.ttf)を確認します。

  • performance_viewフォルダー内の、Creator Toolsで作成されたパフォーマンスビューを含む.nckpファイルを確認します。

  • picturesフォルダー内の.pngまたは.tgaファイルのうち、同じファイル名の.txtファイルが隣に置かれているものを確認します。壁紙、Instrumentのアイコン、カスタムピクチャーフォントにも.txtファイルが必要で、無ければ無視されてしまうので注意してください。

  • scriptsサブフォルダー内の.txtファイルを確認します。

  • 有効なファイルをすべてリソースコンテナにパックします。

そのあと、Resourcesフォルダーの名前を変更して、Instrumentを開き直します。Resourcesフォルダーが存在しなくなったので、KontaktはNKRのモノリスファイルから自動的に読み込むようになります。すべてが期待どおりに動作していれば、ライブラリ(Instrumentと、そのサンプルおよびNKRモノリス)をチームメンバーに送ることができます。ライブラリを市場に出すときもこの形にします。Resourcesフォルダーを同梱した状態でライブラリをリリースしてはいけません。

作業を続けるには、Resourcesフォルダーの名前をResourcesに戻すだけです。

補足

  • リソースコンテナはContent Missingダイアログで確認されます。

  • Instrumentをモノリスファイルとして保存しても、リソースコンテナはモノリスに統合されません。リソースコンテナへのパスは絶対パスとして保存されるため、自分のマシン上でしか機能しません。他のコンピューターでは、そのInstrumentを読み込んだときにContent Missingダイアログが表示されます。リソースコンテナへのパスがもはや有効ではない可能性が高いためです。


参照元情報:Resource Container
https://docs.native-instruments.com/online-guides/ksp-manual/en/resource-container