Cinema4d MCP

🚀 映画館4D API 日本語ドキュメント

この映画館4D APIは、Cinema 4DとのPythonによる相互作用を可能にし、様々な操作を行えるようにするものです。以下に、インストール方法や使用例などを詳しく説明します。

🚀 クイックスタート

インストールと互換性

📦 インストール手順

1. 公式のPythonバインディングプラグインをダウンロードしてインストールします。
2. Cinema 4Dを起動し、メニュー > プラグイン > Python > マネージャーにアクセスします。
3. 新しいPythonインタープリターを追加し、インストール済みのPythonのパスを選択します。

互換性に関する説明

• サポートバージョン：Cinema 4D 2023.2以上（R25、S26以上）
• Pythonバージョン：3.10
• 最低要件：Cinema 4D 2024.0以降のバージョンを使用することで、最適な互換性を確保できます。

基本的な使い方

コアコンセプト

シーンオブジェクト

server.pyを使用してCinema 4Dとやり取りします。すべての操作は現在のアクティブなシーンを基に行われます。

# 現在のアクティブなシーンのポインタを取得する
scene = c4d.GetActiveScene()

属性設定

Pythonを使って、Cinema 4Dのほとんどの属性にアクセスし、変更することができます。具体的な方法はオブジェクトのタイプによって異なります。

基本コマンドの例

# 立方体を追加する
cube = c4d.utils.create_object(c4d.OBJECT_TYPE_Cube)
c4d.EventAdd()

# 現在のアクティブなオブジェクトを取得する
active_obj = doc.GetActiveObject()

📚 ドキュメント

シーン情報と実行

• get_scene_info：現在のシーンの要約情報を取得します。
• list_objects：シーン内のすべてのオブジェクト（階層構造を含む）をリストします。
• group_objects：選択されたオブジェクトを新しい空のオブジェクトにグループ化します。
• execute_python：Cinema 4D内でカスタムPythonコードを実行します。
• save_scene：現在のCinema 4Dプロジェクトをディスクに保存します。
• load_scene：.c4dファイルをシーンに読み込みます。
• set_keyframe：オブジェクトの属性（位置、回転など）にキーフレームを設定します。

オブジェクトの作成と変更

• add_primitive：シーンに基本形状（立方体、球体、円錐体など）を追加します。
• modify_object：選択されたオブジェクトの変換や属性を変更します。
• create_abstract_shape：有機的な、非標準の抽象形状を作成します。

カメラとアニメーション

• create_camera：シーンに新しいカメラを追加します。
• animate_camera：カメラをパス（直線またはスプライン曲線）に沿ってアニメーション化します。

照明とマテリアル

• create_light：シーンに照明（環境光、スポットライトなど）を追加します。
• create_material：標準的なCinema 4Dマテリアルを作成します。
• apply_material：マテリアルをターゲットオブジェクトに適用します。
• apply_shader：スタイル化またはプログラムによるシェーダーを生成して適用します。

Redshift サポート

• validate_redshift_materials：Redshiftマテリアルの設定と接続状況を確認します。

MoGraph とフィールド

• create_mograph_cloner：MoGraphクローナー（直線、放射状、グリッドなど）を追加します。
• add_effector：MoGraphエフェクター（ランダム、平面など）を追加します。
• apply_mograph_fields：MoGraphフィールドをオブジェクトに追加してリンクします。

ダイナミクスと物理

• create_soft_body：選択されたオブジェクトに柔軟体ラベルを追加します。
• apply_dynamics：オブジェクトに剛体または柔軟体の物理属性を適用します。

レンダリングとプレビュー

• render_frame：現在のフレームをレンダリングしてディスクに保存します（ファイル出力のみ）。
• render_preview：高速プレビューをレンダリングし、Base64画像を返します（AI用）。
• snapshot_scene：シーンのスナップショット（オブジェクトとプレビュー画像を含む）を取得します。

互換性計画とロードマップ

🔧 ベストプラクティス

ロギングとデバッグ

# 重要な操作のログを記録する
import logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger(__name__)

エラー処理

常に例外をキャッチして、コードの堅牢性を確保します。

try:
    # 操作コード
except Exception as e:
    logger.error(f"エラーが発生しました: {str(e)}")

解決済みの問題

• 問題：プラグインを初めてインストールしたときにメニューに表示されない。
  • 解決方法：Cinema 4Dを再起動して確認してください。
• 問題：一部のオブジェクト属性にアクセスできない。
  • 解決方法：すべての必要なモジュールを正しくインポートし、ログを確認して詳細情報を取得してください。

🤝 貢献ガイド

コードの貢献方法

1. ローカルリポジトリを自分のアカウントにフォークします。
2. 新しい機能ブランチを作成します。
3. 変更をコミットし、プルリクエストを作成します。

問題の報告方法

• GitHub Issuesを使用して問題を報告し、詳細な操作手順とエラー情報を添付してください。

📄 ライセンス

このプロジェクトはMITライセンスに準拠しています。詳細な条項はLICENSEファイルを参照してください。

📞 お問い合わせ

ご質問やご提案がある場合は、以下の方法でお問い合わせください。

• メール：support@cinema4dapi.com
• GitHub：https://github.com/cinema4d/cinema4d-api