Jumpstart Cinema 4D插件开发
bootstrap4c4d-beesperester的Python项目详细描述
bootstrap4c4d
通过自动生成电影头和4D代码,简化你的开发过程。在
目录
说明
使用bootstrap4d您可以自动化许多通常与编写Cinema 4D插件相关的前后工作。不需要手工编写那些讨厌的头文件、字符串文件和资源文件。只要在你的插件.py文件并自动构建你的plugin.h,插件.res, 插件.str以及插件.pyp文件。在
在下面的摘要中,您可以看到一个名为REAL值的非常基本的设置str,它将显示为PERCENT。这是一个名为SETTINGS的SETTINGS的组中的包装,它本身包装在代表插件的容器中:
#----begin_resource_section----frombootstrap4c4dimportContainer,Assignment,Group,Descriptionstrength=Description({"id":"STRENGTH","key":"REAL","value":[Assignment("UNIT","PERCENT")],"locales":{"strings_us":"Strength"}})settings_group=Group("SETTINGS",{"value":[strength],"locales":{"strings_us":"Settings"}})root=Container("Tmyplugin",{"value":[Assignment("NAME","Tmyplugin"),Assignment("INCLUDE","Tbase"),Assignment("INCLUDE","Texpression"),settings_group],"locales":{"strings_us":"My awesome plugin"}})#----end_resource_section----#----begin_id_section----# IDs will be automatically injectedSTRENGTH=strength.GetId()#----end_id_section----[...]
生成此命令将生成以下文件:
tmyplugin.res公司
^{pr2}$tmyplugin.h
#ifndef _Oatom_H_#define _Oatom_H_enum{Tmyplugin=72636982,SETTINGS=59543963,STRENGTH=34087515,};#endif
tmyplugin.str
STRINGTABLETmyplugin{Tmyplugin"My awesome plugin";SETTINGS"Base Settings";STRENGTH"Strength";}
tmyplugin.pyp
STRENGTH=34087515[...]
安装
首先需要获取c4dpy的路径。在macOS上,这将是这样的:
/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy
有关c4dpy的更多信息,请参阅documentation。在
接下来您需要下载pip
$ curl https://bootstrap4c4d.pypa.io/get-pip.py -o /path/to/some/directory/get-pip.py
对于安装pip,您需要确保使用c4dpy的路径,而不是系统的python安装
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" /path/to/some/directory/get-pip.py
现在您可以通过pip安装bootstrap4d
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m pip install bootstrap4c4d-beesperester
使用
显示可用的cli参数:
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d -h
构建
构建一个已经用bootstrap4d设置的现有python插件:
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d build /path/to/your/plugin.py
创建eh3>
使用bootstrap4d创建一个新的标记/对象插件:
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d create YOUR_PLUGIN_NAME tag /path/to/your/plugin_directory
示例
查看tmyplugin.py
以获得一个简单的工作示例。在
您会注意到两种类型的注释,它们描述了插件设置的特定部分。在
这将是你设置插件布局的地方,这将在最终输出中被忽略。在
#----begin_resource_section----...#----end_resource_section----
这将是您定义插件ID的地方,静态ID将在构建过程中作为整数注入:
#----begin_id_section----...#----end_id_section----
像这样使用bootstrap4d将构建插件:
$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d build tmyplugin.py
这将导致以下文件被创建:
tmyplugin.pyp# the actual plugin fileres/description/tmyplugin.h# the header file with the IDsres/description/tmyplugin.res# the layoutres/strings_us/description/tmyplugin.str# the localized strings
插件
使用bootstrap4d生成插件:
待办事项
- []以功能方式重写构建过程
- [x] 向cli/io添加创建功能
- [x] 将包发布到pypi
- 项目
标签: