このリポジトリは、Autodesk Stingray1.9用の新しいプラグインの作成を開始する簡単な方法を提供します。すでにいくつかの基本的なコンテンツで設定されているサンプルプラグインと、上に構築できるフレームワークがあります。
- サンプル。あなたのプラグインが何であり、それが何をすべきかをスティングレイに指示するstingray_plugin記述子ファイル。
- スティングレイ環境を拡張するさまざまなコンポーネント:
- プラグインがエディタで開くすべてのスティングレイプロジェクトで使用できるコンテンツリソース。
- ランタイムエンジンを新しい機能で拡張するC/C++コード。
- ネイティブコードで実装された関数へのフックを使用してエディタのJavaScript環境を拡張するC/C++コード。
- 新しいパネル、メニュー、およびコマンドでスティングレイエディタを拡張するJavaScriptモジュール。
- プラグイン-ユーザーがプロジェクト-マネージャーの”テンプレート”タブに表示されるアカエイ-コンテンツ-プロジェクト。C/C++プラグインコードをビルドするために必要なすべてのもの。
make.rb
プラグインビルドシステムを起動します。spm.rb
make.rb
によって内部的に呼び出されますが、プラグインに自動的にダウンロードしたい他の依存関係がある場合は、cmake
ネイティブプラグイン拡張機能用のVisual Studioソリューションを生成してコンパイルします。
プラグイン、プラグインの動作、およびプラグインを使用した操作の詳細については、Stingray SDKヘルプを参照してください。
ステップ1。 前提条件をインストールする
このリポジトリの内容をコンピュータに複製するには、Gitクライアントが必要です。プラグインにエディタまたはエンジンを拡張するC/C++ライブラリを含める場合は、次のものも必要です。
-
Ruby2.0以降。
-
ノード6.11.2LTS以降。
-
Visual Studio2015Update3&パッチKB3165756。
ステップ2。 ソースのローカルコピーを取得する
このリポジトリの内容をコンピュータに取得して、作業できるようにする必要があります。
重要:プラグインを使用するStingrayのバージョンに対応するこのレポのバージョンを取得する必要があります! これは、プラグインがC/C++を使用する場合に特に当てはまります。プラグインをコンパイルするには、互換性のあるバージョンのStingray SDKヘッダーファイルが必要になるため、エンジンまたはエディタを拡張するdll。p>
-
master
ブランチは、常に最新のリリースされたバージョンのスティングレイと同期しています。 これは、このリポジトリを複製した場合に取得するデフォルトのブランチです。 プラグインを現在のバージョンのStingrayで動作させたい場合に使用します。 -
以前のバージョンのStingrayで動作するようにプラグインを設定したい場合は、リリースタグをチェックアウトするか、GitHubの[リリース]タブからソー
スティングレイのソースコードにアクセスできる場合:Stingray engineリポジトリの
develop
develop
ブランチを使用してプラグインをビルドします。 -
プラグインがまだ公開されていないが、Stingray engineリポジトリに独自の
release
release
ブランチを使用して同期を維持します。
ステップ3。 ライブラリディレクトリの設定
プラグインソースコードのすべてのリビジョンは、Gitに保存されていないライブラリと依存関係に依存します。 代わりに、私たちのビルドツールは、インターネット上の保存場所からコンピュータにこれらのライブラ
ビルドを実行する前に、ビルドを保存してこれらのライブラリにアクセスするコンピュータ上の場所を指定する必要があります。
SR_LIB_DIR
という名前の環境変数を作成します。 その値を、ライブラリをコピーするコンピューター上の空のディレクトリに設定します。
ステップ4。 ビルド
エンジンまたはエディタ用のC/C++プラグインを含める場合は、このリポジトリのルートディレクトリでmake.rb
スクリプトを実行してビルドします。
> ruby make.rb
次のコマンド:
- ビルドに必要なすべてのライブラリの正しいバージョンでライブラリディレクトリを自動的に更新します。
- は、Stingrayエンジンと編集ツール用のVisual Studioソリューションを生成および構築します。
- は、何をどのように構築するかを制御するために使用できるいくつかのパラメータを提供します。 使用可能なすべてのパラメータのリストを取得するには、
--help
コマンドラインパラメータで呼び出します。
注意:証明書の検証に関するエラーが発生した場合、RubyGems用にこのSSL修正をインストールする必要がある場合があります
ビルド結果
デフォルトでは、スクリプトはすべてコンパイルされて書き込まれます。スティングレイのソースコードを複製したルートディレクトリの下にあるplugin/binaries
ディレクトリにdllファイルを配置します。また、build/engine
build/editor
フォルダーで生成されたVisual Studioソリューションを使用して、ソースコードを操作したり、ライブラリを再構築したりするこ
チュートリアル!
エンジンとエディタの両方を拡張するプラグインを作るプロセスをステップバイステップで説明するチュートリアルについては、wikiを参照してくp>
ディレクトリ構造
build
:さまざまなビルド出力(つまり、CMakeによって生成されたソリューション)cmake
spm
editor
によってダウンロードされたCMakeヘルパースクリプト:エディタを拡張するC/C++コードを置くことができるフォルダ。li>engine
:ランタイムエンジンを拡張するC/C++コードを置くことができるフォルダ。plugin
:他のプラグインソース(プラグイン記述子、エディタ拡張子、コンパイルされたエディタとエンジン拡張子など。)stingray_sdk
:アカエイエディタとエンジンC/C++ヘッダーベースのプラグインSDKによってダウンロードspm
。tools
tools
spm
によってダウンロードされたさまざまなビルドツール。make.rb
make.rb --help
を実行します。Stingrayプラグインを正常にビルドしたら、plugin
フォルダを圧縮してプラグインを配布できます。 Stingray SDKの使用を開始するためのヘルプについては、stingray SDKのメインヘルプのチュートリアルビデオとトピックを参照してください。P>
プラグイン構造
stingray-example.plugin
:初期プラグイン記述子。 このファイルのファイル名の名前を変更することを強くお勧めします。sample_project/
:プラグインがどのように動作するかを示すサンプルプロジェクト。
その他のヘルプ
プラグインの操作、APIリファレンスドキュメントなどの詳細については、Stingray SDKヘルプを参照してください。
連絡を取り合いましょう!
あなたのフィードバックは、この製品を成功させる上で不可欠です。
あなたのフィードバックは、この製品を成功させる上で不可欠です。 StingrayユーザーフォーラムまたはAutodeskベータポータルのユーザーフォーラムで間違っていることについてのご意見を共有することで、私たちを助けてくださ Autodeskのエンジニアやデザイナーは、積極的にフォーラムのスレッドに従事しているので、あなたの声が大声で明確に聞いて、ソースから直接助けを得ることが