就业培训     下载中心     Wiki     联络 登录   注册

---

• The class is derived from a base class , in this case ObjectData which in return is derived from NodeData .
• The INSTANCEOF macro defines a connection between the plugin class and the base class. Using this macro one can use the SUPER macro to call functions of the base class.
• Specific plugin functionality is defined by implementing virtual functions .
• A static "Alloc" function creates and returns a new instance of the plugin class. See also NodeData::Init() / Alloc and Free Manual .

配准

Cinema 4D has to be informed about the new plugin class. This is typically done using a "Register" function. Examples are:

• RegisterObjectPlugin() : Registers an ObjectData 插件。
• RegisterTagPlugin() : Registers a TagData 插件。
• RegisterShaderPlugin() : Registers a ShaderData 插件。
• etc.

Such "Register" functions are typically used in a plugin's PluginStart() 函数。见 PluginStart .

The arguments of a "Register" function vary from type to type but usually are:

• Plugin ID: This ID must be unique and be obtained from www.plugincafe.com . For test purposes the ID range of 1000001 to 1000010 is available.
• Plugin name: To avoid hardcoded strings it is advised to load a string from a resource file using GeLoadString() .
• Plugin flags: In this case OBJECT_GENERATOR which means that the registered class is a generator object.
• Function pointer: A pointer to the function that allocates a new instance of the class.
• Plugin symbol: This is used to identify the associated resource files.
• Plugin icon: In this case a nullptr is handed over for no icon. A BaseBitmap for the icon can easily be loaded with AutoBitmap .
• Plugin level: Defines a version of this plugin (handled in NodeData::Read() and NodeData::Write() ).

These flags can be used in the "Register" function of all NodeData based plugin classes:

• PLUGINFLAG_HIDE : Hide the plugin in certain dialogs.
• PLUGINFLAG_SMALLNODE : Create a small node (the node will derive from GeListNode , rather than from BaseList2D ).
• PLUGINFLAG_HIDEPLUGINMENU : Hide the plugin's menu entry in the "Plugins" menu.

ShaderData plugins can be placed in the "Effects" or "Surfaces" submenu, MaterialData plugins can be placed in the "Shaders" menu. To place them there the category name has to be added to the plugin name that is used with the "Register" function.

• GeGetDefaultFilename() : Retrieves the default file name for the given category.
  • DEFAULTFILENAME_SHADER_SURFACES : Surfaces.
  • DEFAULTFILENAME_SHADER_EFFECTS : Effects.
  • DEFAULTFILENAME_SHADER_VOLUME : Volume.

基本类和插件类

Many plugin classes are based on NodeData . But typical Cinema 4D classes are based on C4DAtom , GeListNode and BaseList2D 。 NodeData based plugin class is used as the "core" of such C4DAtom based class and implements its functionality.

The NodeData "core" can be obtained from objects and within a NodeData based plugin class it is possible to get the corresponding GeListNode .

• GeListNode::GetNodeData() : Gets the internal NodeData based plugin class.
• NodeData::Get() : Returns the corresponding GeListNode .

For convenience the corresponding GeListNode is also handed over in the virtual functions of NodeData .

The corresponding functions are:

注意

While most elements of the classic Cinema 4D API are build with the API and return a NodeData based class, some elements are not based on NodeData (like GUI elements).

延伸阅读

• 一般插件功能概述
• 插件函数手册