ScriptingとCore API

スクリプトを使用して 3DCoat 機能を管理できます。
スクリプトを使用して新しいコマンドを実行または作成するか、 Core APIにアクセスしてコマンドをコンパイルします。

始めはとても簡単です。 [スクリプト] メニュー→ [スクリプトの作成]または[新しいコアAPIスクリプトの作成] を使用するだけです。

スクリプトメニュー

–Scriptingは、コンパイルせずに実行できる一連のコマンドです。
ツールを選択したり、機能を実行したりすると、プログラムにすでに組み込まれているコマンドが実行されます。スクリプトを作成すると、これらのコマンドを組み合わせて一連の手順を自動的に実行できるため、作業が高速化されます。

–コアAPI (アプリケーション プログラミング インターフェイス) は単なるスクリプトではありません。作成したコードは、コンパイルされた C++ のフルスピードで実行されます。
これは、3DCoat の機能を拡張する強力な方法です。ジョブを自動化したり、主に新しいツールを追加したりできます。

Scripting

3DCoat は、C++ に似た言語であるAngelScriptを使用します。スクリプトは、個人的な順序で実行されるコマンドを含むテキスト ファイルです。

そのコマンドは、RMB+MMB を同時に押してメモリに記録することで知ることができます。メモ帳を開いて貼り付けると、対応するコマンドのテキストが取得されます。 Notepad++ で表示および編集すると便利です (「C」構文を選択します)。次に、ファイル メニューの「スクリプト / スクリプトの実行」からスクリプトを実行します。

Core API

Core API は、 3DCoat の機能を拡張する強力な方法です。ジョブを自動化したり、主に新しいツールを追加したりできます。
これは単なるスクリプト作成ではありません。作成したコードは、コンパイルされた C++ のフルスピードで実行されます。

Core APIスクリプトは、完全なネイティブ C++ 速度で動作する、互換性のある C++17 プログラムです。これは単なるスクリプトではありません。タイムクリティカルなマルチスレッドタスクを作成したり、 3DCoat を徹底的にカスタマイズして、主に新しい機能やツールを作成したりすることもできます。

ただし、プロセス全体は完全に透過的です。何も構成したり、複雑なプロジェクト構成を管理したりする必要はありません。 3DCoat は、シンプルなウィザードを使用してプロセス全体をガイドします。

*Core API は英語以外のユーザー名を持つユーザーに対しても正しく動作し、すべてのインストール プロセスが非常に簡単になりました。

* CoreAPI のコンパイル プロセスが本質的に変更されました。現在は Visual Studio のみが使用されています。 Clang-cl は必要ありません。追加のソフトウェアをインストールする必要があるのは、以前のように 2 つではなく 1 つだけなので、使用方法が簡素化されます。ダウンロードとインストールのプロセスは完全に自動化されています。

* Core API はカラーボクセルもサポートします。

---

Python API

3DCoat Python API は、UI コマンドをトリガーし、シーン上で操作し、新しいツールを作成することを目的としています。これは C++Core APIに非常に似ていますが、独自の利点と欠点があります。

• スクリプトを作成するために追加の設定を行う必要はありません。 Python は3DCoatディストリビューションに組み込まれています。
• Python はスイス ナイフのようなもので、Python ライブラリのすべての機能を3DCoatに取り込むことができます。
• Python は C++ よりもはるかに遅いため、深く複雑なアルゴリズムではなく、一般的な管理にのみ使用される可能性があります。
• すでに C++Core APIに精通している場合は、Python API はほぼ 1 対 1 で非常に似ており、同じロジック名と関数名を持ちます。

---

どのように始めればよいでしょうか？

始めはとても簡単です。スクリプトを使用する→新しいCore APIスクリプトを作成するだけです
次に、テンプレートを選択し、プロジェクトのパスを選択します。

Visual Studio (または Visual Studio Code) がインストールされている場合は、新しいファイルで起動します。各例は詳しく文書化されており、比較的単純な構文を使用しているため、簡単なものから複雑なものまで理解しやすいです。

 VStudio で標準構文を設定する必要はありません。
 Visual Studio ではなく、コードを入力して3DCoatで実行するだけです。
 VStudio は、コーディング中にヒントやヘルプを表示するテキスト エディターのようなものです。
 VStudio でコードを記述し、*.cpp を保存し、3DC で開くと、自動的に実行されます。 

---

例

API を理解するには、例を見ることが最善の方法です。

「スクリプト」→「新しいCore APIスクリプトを作成」を使用して、その例を試してください。