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()