What was New in R20

R20.026 - SP1

C4DPY

c4dpy.exe/app is an executable that runs Cinema 4D in Python command-line mode.

It is not only an interpreter, it brings extra features for daily Python development with external code editors/IDEs: auto-completion and debugging.

For more information, see c4dpy.

Symbols

Symbols value with the name 0 were renamed to NONE. For instance, DESCFLAGS_SET_0 was changed to DESCFLAGS_SET_NONE.

For compatibility reason, DESCFLAGS_SET_0 keep working but please update your symbols to the new format.

C.O.F.F.E.E. Removed

The C.O.F.F.E.E programming language and all related functions and reference were removed. See Tips to switch from C.O.F.F.E.E to Python.

Naming Scheme

Naming Scheme have change now it’s based on ISO 639-1 standard.

For compatibility reason, strings_us keep working for plugins in R20. But strings_en-US should be used. See Directory Structure.

Fields

The power of fields is accessible via the Python API. Several classes have been added to c4d.modules.mograph.

FieldObject represents a field and can be instantiated at any time to sample different types of fields.

The following classes are meant to be used for fields sampling and Python fields implementation:

• FieldCallerStack

• FieldInfo

• FieldInput

• FieldOutput

• FieldOutputBlock

c4d.FieldList is the custom data for field list parameters.

Volume Modeling

The new Volume Modeling API is located in c4d.modules.volume.

VolumeBuilder represents a volume builder object and VolumeObject represents a volume object. SendVolumeCommand() sends volume commands.

Multi-Instances

The c4d.InstanceObject class enables to script the new multi-instances feature.

Miscellaneous

• The API for ColorSwatchData and ColorSwatchGroup has changed. See Color Chooser changes.

• c4d.GetGlobalTexturePath()/SetGlobalTexturePath() are deprecated and does not perform any operation. The new functions c4d.GetGlobalTexturePaths()/SetGlobalTexturePaths() have to be used instead.

• TreeViewFunctions.HeaderClick() has 3 new parameters: mouseX, mouseY and ua. Any existing implementation must adapt to its new definition.

Examples

New scripts and scenes have been added to the SDK examples:

• Fields: fieldlist_sampling.py, fieldobject_sampling.py

• Volume: volumebuilder_addobject.py, volumecommand_createspherevolume.py, volumecommand_splinetovolume.py

• Color Chooser: colorswatch_creatematerials.py, colorswatch_rainbowgroup.py

• Miscellaneous: globaltexturepaths.py, imagesettingsdictionary.py

Documentation

• Frequently Asked Questions DEPRECATED page has been updated.

R20.028 - SP1 Hotfix 1

This hotfix for Cinema 4D R20 SP1 did not change any API functionality.

R20.030 - SP1 Hotfix 2

This hotfix for Cinema 4D R20 SP1 did not change any API functionality.

R20.057 - SP2

Fixes

• Fixed an issue when exporting a document through the API in Alembic makes Cinema 4D freeze.

• Fixed an issue where FieldInfo fails to be created from FieldInfo.Create().

• Fixed an issue with Python Console not executing an EventAdd() after entering a command

• Fixed an issue with SubDialog.SetInt32().

• Fixed an issue with c4d.documents.GetAllAssets() when ASSETDATA_FLAG_MISSING is passed and an assets is missing.

• Fixed an issue with python_init.py not called at startup in R20. For more information see Python_init.py.

• Fixed an issue where InExcludeCustomGui can’t be created by the user.

Documentation

• Updated Introduction.

• Added Python Resources.

• Added Python in Cinema 4D.

• Added Python_init.py Manual.

• Added Python Libraries Manual.

• Added Python Console Manual.

• Added Python Script Manager Manual.

• Added Python Scripting Tag Manual.

• Added Python Xpresso Node Manual.

• Added Python Interaction Tag Manual.

• Added Python Visual Selector Tag Manual.

• Added Python Character Tag Manual.

• Added Python Generator Manual.

• Added Python Effector Manual.

• Added Python Field Object / Layer Manual.

• Added Python Sketch and Toon Material Manual.

• Added c4d.modules.character.builder documentation. See Python Character Tag.

• Added c4d.modules.character.builder.CharacterObject documentation. See Python Character Tag.

• Added c4d.modules.character.builder.Component documentation. See Python Character Tag.

• Added c4d.modules.character.builder.ComponentObject documentation. See Python Character Tag.

• Added c4d.modules.character.builder.Template documentation. See Python Character Tag.

• Fixed missing CAMORPH_MODE_PSD mode to CAMorph.SetMode().

• Fixed wrong information in note of BaseBitmap.ScaleBicubic().

• Fixed wrong information for c4d.utils.GetAngle(), c4d.utils.QSlerp() and c4d.utils.QBlend().

• Improved documentation of c4d.documents.GetAllAssets() and c4d.documents.SaveProject() about out parameters.

• Fixed missing return type of GeDialog.LoadDialogResource().

• Fixed documentation of BaseBitmap.ScaleBicubic().

• Fixed code example of BaseBitmap.SetPixelCnt().

• Fixed documentation about return type of GeResource.LoadString().

• Fixed code example of Description.__iter__().

• Updated c4d.gui.DescriptionCustomGui symbols.

• Updated c4d.gui.LinkBoxGui symbols.

• Updated c4d.gui.DateTimeControl picture and symbols.

• Updated c4d.gui.SplineCustomGui picture and symbols.

• Updated Tag Types

• Updated Object Types

• Added Fields Object Types

• Added Fields Layer Types

R20.057 - SP2 - Documentation Update 1

• Added documentation for CAWeightTag.GetWeightCount().

• Added a mention to c4dpy in this page.

• Fixed display error in Python Console.

• Fixed display error in Python Field Object / Layer.

• Corrected datatype of InitSampling method in Python Field Object / Layer.

• Corrected the mapped method of the main method in Python Generator.

• Added code example in Python Effector.

• Fixed display error in Python Effector.

• Added a note about the need to call SetDirty after use of c4d.modules.mograph.GeSetMoDataSelection() and c4d.modules.mograph.GeSetMoDataWeights().

• Added documentation for CAPoseMorphTag.ExitEdit() previously marked as private.

• Added documentation for color range used in c4d.gui.GeUserArea.

• Fixed documentation for msg parameter from the GeUserArea.Message().

• Improved documentation for BaseList2D.GetInfo().

• Fixed display error in c4d.plugins.

• Fixed documentation for default value of add parameter in c4d.plugins.SetWorldPluginData().

• Fixed display error in OBJECT.

• Added documentation for R18 symbols of BAKE_TEX.

• Updated documentation for R19 symbols of UVCOMMAND.

  • UVCOMMAND_CYCLE_CW_UV called UVCOMMAND_MOVE_DOWN_SEQUENCE before R19.

  • UVCOMMAND_CYCLE_CCW_UV called UVCOMMAND_MOVE_UP_SEQUENCE before R19.

R20.059 - SP2 Hotfix 1

This hotfix for Cinema 4D R20 SP2 did not change any API functionality.

R20.059 - SP2 - Documentation Update 2

• Added symbols documentation for R15 bevel tool (ID_XBEVELTOOL) in MCOMMAND.

• Added documentation for Environment Variable C4D_SCRIPTS_DIR in Python Script Manager.

API Changelist

See API Changelist R20 page.

Older Releases

• What was New in R19

• What was New in R18

• What was New in R17

• What was New in R16

• What was New in R15

• What was New in R14

• What was New in R13