What was New in R19

The Python API in R19 brings important additions and more C++ API coverage. It also carries some API changes and fixes several issues.

R19

New Features Support

• LOD object generator: c4d.LodObject. See LodObject Manual.
• Polygon Reduction: c4d.utils.PolygonReduction. See PolygonReduction Manual.
• Character Animation:
  • Weight Manager: The new class c4d.modules.character.CAWeightMgr gives access to the functionality of the dialog.
  • Pose Space Deformation: The specific data of this mode is stored in a c4d.modules.character.CAReferencePSD object obtained from a c4d.modules.character.CAMorphNode.
• MoGraph: Sound Effector c4d.SoundEffectorData.

API Parity

Here are the additions in R19 for the ongoing effort on parity with the C++ API:

• Preference Plugin: c4d.plugins.PreferenceData.
• Plugin Help Callback: c4d.plugins.RegisterPluginHelpCallback().
• Document Pick Session: BaseDocument.StartPickSession()/StopPickSession().
• Camera Stereo Information: CameraObject.StereoGetCameraCount()/StereoGetCameraInfo().

• More messages support for c4d.plugins.NodeData plugins:
  • MSG_POINTS_CHANGED/MSG_POLYGONS_CHANGED/MSG_SEGMENTS_CHANGED
  • MSG_DESCRIPTION_CHECKUPDATE
  • MSG_DESCRIPTION_CHECKDRAGANDDROP
  • MSG_DESCRIPTION_INITUNDO
  • MSG_DESCRIPTION_VALIDATE
  • MSG_DRAGANDDROP
  • MSG_FILTER

• Miscellaneous:
  • c4d.documents.BaseVideoPost.
  • c4d.modules.mograph.C4D_Falloff.
  • c4d.GeListHead and GeListNode.GetBranchInfo().

Fixes

• ToolData.InitDefaultSettings() is not called on Reload Python Plugins command.
• Expression editor changes and c4d.EventAdd(). (Since R19 if c4d.EventAdd() is called from within the code of an expression, then it is simply skipped.)

Documentation

• Added documentation for drag and drop functions in c4d.gui.GeDialog and c4d.gui.GeUserArea.

Examples

• Plugins:
  • Py-Preference new example for c4d.plugins.PreferenceData shows how to add a new category to the Preferences dialog.
  • Py-SpherifyModifier has been extended with a falloff.
  • Py-DoubleCircle implements a c4d.plugins.RegisterPluginHelpCallback().
• Scripts in release19 folder of examples.

R19.024

API Additions

• Most important are the additions of:
  • GeUserArea.HandleMouseDrag()
  • PolygonObject.GetNGonTranslationMap()

Fixes

• Important issue with several functions and operators returning a corrupt BaseContainer object.
• BaseObject.CopyTagsTo() expects parameter hierarchical instead of hierarchial.
• PolygonObject.GetPolygonTranslationMap() returns too less values.
• Error in default code of Python Effector for Full Control mode.
• BaseCustomGui.GetData()/SetData can crash with some custom GUIs.
• c4d.storage.LoadDialog()/c4d.storage.SaveDialog() def_file parameter always set.
• MSG_DESCRIPTION_GETBITMAP not sent to NodeData plugins.

R19.053

API Additions

• c4d.gui.ActiveObjectManager_SetObjects()

Changes

• The following functions have been optimized:
  • PointObject.GetAllPoints()/SetAllPoints()/CalcVertexMap().
  • PolygonObject.CreatePhongNormals()/GetAllPolygons()/GetNgonEdgesCompact().

Fixes

• SoundEffectorCustomGui.SetGUIOwnerOverride()/GetGUIOwnerOverride().
• CAReferencePSD.GetExternalController() crashes if a wrong index is given.
• Environment variable C4D_PLUGINS_DIR with multiple directories.
• PointObject.CalcVertexmap() should be spelled CalcVertexMap(). (Old name still works for backward compatibility.)

Documentation

• These functions have been documented:
  • BaseContainer.__len__()
  • c4d.gui.GetGuiWorldColor()

• The constants have been cleaned up and improved. They now have a title and when a symbol appears in search results, a title is shown instead of “<no title>”.

R19.068

Fixes

• Missing doc, op and tp variables in Python tag when executed without being inserted inside a document.
• Missing bt variable in Python tag when executed from BaseDocument.ExecutePasses() if bt argument is None.
• Crash with c4d.modules.tokensystem.StringConvertTokensFilter()/FilenameConvertTokensFilter() if the passed exclude list is empty.
• Parameter issues for CAWeightTag.TransferWeightMap().
• Cannot call GeUserArea.FillBitmapBackground().

• Atom and plugin messages:
  • Sending MSG_GETCUSTOMICON, MSG_GETREALCAMERADATA, MSG_DESCRIPTION_ALLOWOVERRIDE.
  • Receiving MSG_GETREALCAMERADATA, MSG_DESCRIPTION_ALLOWOVERRIDE.

Documentation

• Cleaned up and improved c4d.modules.character.CAMorphNode.
• Removed c4d.modules.CheckMocca().

API Changelist

See API Changelist R19 page.