概述

The SDK is included in every distribution of Cinema 4D and is stored in the sdk.zip file.
The 工程工具 can be obtained from developers.maxon.net .
The 工程工具 must be used to create project files for frameworks, plugins and solutions.
The example plugins can be build with the solution in "plugins/project".
A new plugin can be added by creating the plugin folder and defining the projectdefinition.txt file.
Such a new plugin must be added to a solution.
Existing plugins must be adapted to the Cinema 4D R20 SDK, see API 过渡 .
The "classic" API is available in cinema.framwork.
The new MAXON API is defined in core.framework and further frameworks.

Getting the SDK

The MAXON API SDK 包括在每次分发的 Cinema 4D . It is stored in the sdk.zip file. The content of this file can be extracted to any location. See SDK 概述 .

The SDK contains several frameworks that provide access to the API's functionality. For an overview see MAXON API Frameworks .

Creating Project Files

The SDK does not include IDE project files. The 工程工具 is used to create these project files for the supported operation systems. The tool is available for download on developers.maxon.net . The program can be installed to any location.

Simply run the 工程工具 on the command line. The g_updateproject argument is used to define the target folder. The tool will look into this folder and its sub-folders to search for MAXON API frameworks, projects and solutions. For more information see 工程工具 .

注意: Run the Project Tool on the complete SDK folder to create the needed project files for all frameworks, plugins and solutions.

// This example shows how to run the Project Tool using command line arguments.

// Windows kernel_app_64bit.exe g_updateproject=C:\development\sdk

// MacOS kernel_app.app/Contents/MacOS/kernel_app g_updateproject=/Volumes/development/sdk

Build the SDK Examples

Use the Projet Tool as described above to create project files for solutions, plugins and frameworks. Then open the default solution located in "plugins/project".

This default solution includes the three example projects and all necessary frameworks. Simply build the complete solution to build all example projects.

For running Cinema 4D see 微软 Windows 开发 , macOS 开发 and Linux 开发 .

Creating a Plugin Project

A new plugin project is added by creating a new folder in the SDK's "plugins" directory. This new folder must have two sub-folders:

project: Must contain the projectdefinition.txt file. This file defines the basic settings of a project. The project file is automatically generated based on these settings.
source: Contains the source code of the new plugin.

注意: The Project Tool will add all source code files found in the project folder to the project file. The Source Processor will only process source code files in the "source" folder.

另请参阅创建新插件工程 .

A typical example of a projectdefinition.txt file will look like this:

// Configuration of a custom plugin in the projectdefinition.txt file

// support Windows and macOS Platform=Win64; OSX

// this is a plugin Type=DLL

// this plugin depends on these frameworks: APIS=\ cinema.framework; \ misc.framework; \ image.framework; \ core.framework

// defines the level of rigour of the source processor's style check stylecheck.level=3

// plugin/module ID ModuleId=com.examplecompany.myplugin

内容表

概述

Getting the SDK

Creating Project Files

Build the SDK Examples

Creating a Plugin Project

Update Classic API Code

Use new API