説明

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

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

使用法

• [スクリプト] -> [Python スクリプトの作成]を使用して、新しいスクリプトを作成します。最初のテンプレートを選択して開始できます。 .py ファイルは、.py ファイルに関連付けられている現在のエディタで開きます。
• 動作には組み込みPython 3.8.10を使用します。これは、Windows 7 で実行できる最後の Python バージョンです。
• 必要に応じて、使用するモジュールのリストを含むrequirements.txtというファイルを作成できます。この場合、モジュールはスクリプトの実行前に自動インストールされます。
• 3DCoat に特化したコマンド構文を自動的に認識し、正しいヒントを提供するため、Visual Studio Code をお勧めします。
• 注意: プロジェクト フォルダーにあるファイル coat.pyi は、Visual Studio の coat モジュール ヒントを担当します。このファイルにはすべてのクラスとコマンドのリストが含まれているため、このファイルを開くと、クイック リファレンスに役立ちます。
• [スクリプト] -> [Python コンソールの表示]を使用して、Python からのコンソール出力を確認します。現在、これがスクリプトをデバッグする唯一の方法です。後で、Visual Studio Code を使用したネイティブ デバッグを追加する予定です。
• [スクリプト]->[Python モジュールのインストール] を使用して、Python の追加モジュールをインストールできます。もう 1 つの方法は、.py ファイルの場所と同じフォルダーにあるrequirements.txt を使用することです。

メインクラス

一般的な I/O: coat.io
ダイアログ管理: coat.dialog
メッシュ操作: coat.Mesh
シーンのルート: coat.Scene
シーン要素: coat.SceneElement
ボリューム管理: coat.Volume
UI管理: coat.ui
2D ベクトルの数学: coat.vec2
3D ベクトルの数学: coat.vec3
4D ベクトルの計算: coat.vec4
3D マトリックス計算: coat.mat3
4D行列計算: coat.mat4
対称管理: coat.symm