bootstrap4c4d-beesperester 2.1.0

Jumpstart Cinema 4D plugin development

bootstrap4c4d

Simplify your Cinema 4D plugin development process by generating all the necessary c-headers, strings and resources automatically.

Table of contents

1. Description
2. Installation
3. Usage
   • Build
   • Create
4. Examples
5. Plugins
6. To do

Description

With bootstrap4c4d you can automate a lot of the back and fore generally associated with writing Cinema 4D plugins. No need to write all those pesky header, string and resource files by hand. Just define them in your plugin.py file and automagically build your plugin.h, plugin.res, plugin.str and plugin.pyp file.

In the following excerpt you can see a very basic setup for a REAL value called STRENGTH which willbe displayed as PERCENT. This is wrappend in a GROUP with the name SETTINGS which is itself wrapped in a CONTAINER that represents the plugin:

#----begin_resource_section----
from bootstrap4c4d import Container, Assignment, Group, Description

strength = 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 injected
STRENGTH = strength.GetId()
#----end_id_section----

[...]

Building this will result in the following generated files:

tmyplugin.res

CONTAINER Tmyplugin
{
    NAME Tmyplugin;
    INCLUDE Tbase;
    INCLUDE Texpression;
    GROUP SETTINGS
    {
        REAL STRENGTH
        {
            UNIT PERCENT;
        }
    }
}

tmyplugin.h

#ifndef _Oatom_H_
#define _Oatom_H_

enum
{
    Tmyplugin = 72636982,
    SETTINGS = 59543963,
    STRENGTH = 34087515,
};

#endif

tmyplugin.str

STRINGTABLE Tmyplugin
{
    Tmyplugin "My awesome plugin";
    SETTINGS "Base Settings";
    STRENGTH "Strength";
}

tmyplugin.pyp

STRENGTH = 34087515

[...]

Installation

First you need to get the path to c4dpy. On macOS this will be something like this:

/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy

For further information about c4dpy please refer to the official documentation.

Next you need to download pip

$ curl https://bootstrap4c4d.pypa.io/get-pip.py -o /path/to/some/directory/get-pip.py

For installing pip you need to make sure to use the path to c4dpy instead of your system's python installation

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" /path/to/some/directory/get-pip.py

Now you are ready to install bootstrap4c4d via pip

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m pip install bootstrap4c4d-beesperester

Usage

Display available cli arguments:

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d -h

Build

Build an existing python plugin which has already been set up with bootstrap4c4d:

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d build /path/to/your/plugin.py

Create

Create a new tag / object plugin with bootstrap4c4d:

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d create YOUR_PLUGIN_NAME tag /path/to/your/plugin_directory

Examples

Check out tmyplugin.py for a simple working example.

You will notice two types of comments which describe specific parts of your plugin setup.

This will be where you setup the layout of your plugin, this will be omitted in the final output.

#----begin_resource_section----
...
#----end_resource_section----

This will be where you define your plugin IDs, the static IDs will be injected as integers during the build process:

#----begin_id_section----
...
#----end_id_section----

Using bootstrap4c4d like so will build the plugin:

$ "/Applications/Maxon Cinema 4D R23/c4dpy.app/Contents/MacOS/c4dpy" -m bootstrap4c4d build tmyplugin.py

This will result in the following files beeing created:

tmyplugin.pyp # the actual plugin file
res/description/tmyplugin.h # the header file with the IDs
res/description/tmyplugin.res # the layout
res/strings_us/description/tmyplugin.str # the localized strings

Plugins

Plugins build with bootstrap4c4d:

1. cinema4d-jiggle

To do

• Rewrite build process in a functional way
• Add create functionality to cli / io
• Publish package to pypi