API Changelist R19

Note

New additions to the Cinema 4D Python SDK are marked like this throughout the documentation:

New in version R19.053.

Here is the list of all the API additions and changes in the R19 Python API:

R19

Types

• c4d.GeListHead

• c4d.LodObject

• c4d.RangeData
• c4d.SoundEffectorData

• c4d.gui.RangeCustomGui

• c4d.documents.BaseVideoPost

• c4d.modules.character.CAReferencePSD
• c4d.modules.character.CAWeightMgr

• c4d.modules.mograph.C4D_Falloff

• c4d.plugins.PreferenceData

• c4d.utils.PolygonReduction

Methods

• BaseDocument.GetRealActiveObject()
• BaseDocument.Record()
• BaseDocument.GetDefaultKey()
• BaseDocument.SetDefaultKey()
• BaseDocument.GetPickSession()
• BaseDocument.StartPickSession()
• BaseDocument.StopPickSession()

• BaseDraw.GetHighlightPassColor()
• BaseDraw.GetHighlightFramebuffer()

• BaseDrawHelp.SetDisplay()

• BaseObject.GetModelingAxis()
• BaseObject.SetModelingAxis()

• BaseSelect.GetRange()
• BaseSelect.FindSegment()
• BaseSelect.Cross()

• C4DAtom.GetHDirty()
• C4DAtom.SetHDirty()

• CameraObject.StereoGetCameraCount()
• CameraObject.StereoGetCameraInfo()

• CAMorphNode.GetPSDReference()

• CAPoseMorphTag.GetPSDFeedbackColor()
• CAPoseMorphTag.SetPSDFeedbackColor()
• CAPoseMorphTag.GetPSDFeedbackColorEnabled()
• CAPoseMorphTag.SetPSDFeedbackColorEnabled()
• CAPoseMorphTag.GetPSDOrientThreshold()
• CAPoseMorphTag.SetPSDOrientThreshold()
• CAPoseMorphTag.GetPSDTwistThreshold()
• CAPoseMorphTag.SetPSDTwistThreshold()
• CAPoseMorphTag.GetPSDPositionThreshold()
• CAPoseMorphTag.SetPSDPositionThreshold()
• CAPoseMorphTag.GetMorphPSDID()

• CCurve.GetStartTime()
• CCurve.GetEndTime()
• CCurve.FindNextUnmuted()
• CCurve.FindPrevUnmuted()

• CTrack.GetTimeTrack()
• CTrack.SetTimeTrack()
• CTrack.Draw()
• CTrack.GetTrackInformation()
• CTrack.SetTrackInformation()

• GeDialog.AddPopupButton()
• GeDialog.SetPopup()
• GeDialog.AddChildren()
• GeDialog.AddSubDialog()
• GeDialog.AttachSubDialog()

• GeListNode.GetBranchInfo()

• Neighbor.GetPointOneRingPoints()

• PolygonObject.GetShadingBreak()

• VoronoiFracture.GetSourceSettingsContainerForIndex()
• VoronoiFracture.GetSourceSettingsContainerForObject()

Functions

• c4d.plugins.RegisterPluginHelpCallback()
• c4d.plugins.RegisterPreferencePlugin()

Attributes

• FalloffDataData.inverseFalloff

Messages

• MSG_DESCRIPTION_CUSTOMGUI_NOTIFICATION: See MSG Messages

Changes

• The following functions now return a c4d.GeListHead object:
  • c4d.AllocListHead()
  • GeListNode.GetListHead()
  • BaseList2D.GetCTrackRoot() and BaseList2D.GetNLARoot()

• The following functions now accept or return a c4d.documents.BaseVideoPost:
  • RenderData.GetFirstVideoPost()/RenderData.InsertVideoPost()/RenderData.InsertVideoPostLast()

• The following c4d.modules.motiontracker types no longer use Sdk suffix:
  • FootageDataSdk renamed as MtFootageData
  • Mt2dTrackDataSdk renamed as Mt2dTrackData
  • Mt2dTrackSdk renamed as Mt2dTrack
  • MtDataSdk renamed as MtData
  • MtTrkGidSdk renamed as MtTrkGid

R19.024

Methods

• BaseDraw.IsMarkedAsGPURenderer()
• BaseDraw.IsGPURenderer()

• BaseObject.GetLastTag()

• BaseShader.HasGPURendererSupport()

• GeUserArea.HandleMouseDrag()

• PolygonObject.GetNGonTranslationMap()

• TreeViewFunctions.DragStart()
• TreeViewFunctions.SetDragObject()

Parameters

• New optional parameter dirtyflags for BaseObject.GetHierarchyClone() and BaseObject.AddDependence()
• New optional parameter col for c4d.gui.ColorDialog() to initialize default color

Miscellaneous

• PolygonObject.GetPolygonTranslationMap() now returns a tuple with the number of N-gons and the list of N-gon indices

R19.053

• c4d.gui.ActiveObjectManager_SetObjects()

• Description.GetParameter()/GetParameterI() parameter ar is optional
• SoundEffectorData.Sample() returns None values if it fails
• CalcVertexMap() name should be used instead of old naming PointObject.CalcVertexmap()

R19.068

• New optional parameter visible for c4d.utils.CalculateVisiblePoints()