What is New

Note

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

New in version R16.021.

In R16.021

Sculpt Brushes

• It is now possible to implement sculpt brushes with the R16 Python API using SculptBrushToolData.

• New classes have been added for this purpose:

  • BrushDabData
  • SculptBrushParams
  • SculptBrushToolData
  • SculptModifierInterface

• And SculptBrushToolData plugin examples have been added too:

  • Py-SculptGrabBrush
  • Py-SculptPaintBrush
  • Py-SculptPullBrush
  • Py-SculptTwistBrush

HyperFile Refactoring

• HyperFile Read and Write methods have been refactored:

• Added:

  • HyperFile.WriteFloat32()
  • HyperFile.WriteVector32()
  • HyperFile.WriteMatrix32()
  • HyperFile.ReadFloat32()
  • HyperFile.ReadVector32()
  • HyperFile.ReadMatrix32()

• Deprecated:

  • HyperFile.WriteWord()
  • HyperFile.WriteUWord()
  • HyperFile.WriteLong()
  • HyperFile.WriteULong()
  • HyperFile.WriteLLong()
  • HyperFile.WriteReal()
  • HyperFile.WriteLReal()
  • HyperFile.WriteLFloat()
  • HyperFile.WriteLVector()
  • HyperFile.WriteLMatrix()
  • HyperFile.ReadWord()
  • HyperFile.ReadUWord()
  • HyperFile.ReadLong()
  • HyperFile.ReadULong()
  • HyperFile.ReadLLong()
  • HyperFile.ReadReal()
  • HyperFile.ReadLReal()
  • HyperFile.ReadLVector()
  • HyperFile.ReadLMatrix()

• Removed:

  • HyperFile.WriteInt()
  • HyperFile.WriteFloat()
  • HyperFile.ReadInt()
  • HyperFile.ReadLFLoat()

NET/Team Render Changes

• New class

  • Repository

Changes in NetRenderService:

• Added:

  • NetRenderService.Message()
  • NetRenderService.ClearResults()
  • NetRenderService.GetNetPreferences()
  • NetRenderService.GetMachinesList()
  • NetRenderService.GetUserPool()
  • NetRenderService.GetJobsList()
  • NetRenderService.CreateRenderJob()
  • NetRenderService.StartRendering()
  • NetRenderService.InitRendering()
  • NetRenderService.InitAndStartRenderingFullAsync()
  • NetRenderService.StopRendering()
  • NetRenderService.DeleteRenderJob()
  • NetRenderService.InsertJobAfter()
  • NetRenderService.InsertJobBefore()
  • NetRenderService.SetDefaultSceneName()
  • NetRenderService.GetRepository()
  • NetRenderService.AddLogToJob()
  • NetRenderService.AddLogToMachine()
  • NetRenderService.GetName()
  • NetRenderService.NetConsoleOutput()

• Removed:

  • NetRenderService.GetJSONMachines() (Use new method NetRenderService.GetMachinesList() instead.)
  • NetRenderService.GetJsonJobs() (Use new method NetRenderService.GetJobsList() instead.)

Changes in UserPool:

• UserPool.EditUserInfo()

• UserPool.EditUserPassword()

• UserPool.ChangeUserAccountType()

• UserPool.ChangeLanguage()

• UserPool.GetUsers()

• Changed

  • UserPool.DeleteUser() and UserPool.ChangePassword(): Renamed username to userUuid and changed type from str to UUID.

• c4d.modules.net

  • JobStateToString()
  • NetSpecialEventAdd()
  • NetGeSyncMessage()

Other API Changes

Here is the list of other API changes in the R16 Python API:

Methods

• BaseDocument.GetDocumentData()
• BaseDocument.SetDocumentData()
• BaseDocument.RecordKey()
• BaseDocument.AutoKey()

• BaseList2D.AddEventNotification()
• BaseList2D.RemoveEventNotification()
• BaseList2D.FindEventNotification()

• C4DAtom.IsInstanceOf()
• C4DAtom.GetParameter()
• C4DAtom.SetParameter()
• C4DAtom.FindUniqueID()
• C4DAtom.AddUniqueID()
• C4DAtom.GetUniqueIDCount()

• BaseContainer.GetUuid()
• BaseContainer.SetUuid()

• CPolygon.IsTriangle()
• CPolygon.Find()
• CPolygon.FindEdge()
• CPolygon.EdgePoints()

• PaintLayer.ToPaintLayerBmp()

• PaintLayerBmp.GetPixelCnt()
• PaintLayerBmp.SetPixelCnt()

• SculptObject.GetMaskCachePoint()
• SculptObject.UpdateMask()
• SculptObject.InitOpenGL()
• SculptObject.IsPointSelected()
• SculptObject.IsPolygonSelected()
• SculptObject.GetPolygon()
• SculptObject.GetDisplayPolygonObject()

Functions

• c4d

  • Cast()
  • CallFunction()

• c4d.plugins

  • RegisterSculptBrushPlugin()
  • RegisterDescription()

• c4d.storage

  • GetFreeVolumeSpace()

• c4d.threading

  • GeGetCurrentThreadCount()
  • Deprecated GeGetCPUCount()

• c4d.utils

  • SphereLineIntersection()
  • CircleLineIntersection()

Parameters

• New:

  • flags for BaseDraw.DrawArc().
  • isNet for BaseDocument.GetAllTextures()

Fixes

• BaseDraw.GetGridStep() does not take any parameter.
• BaseDocument.ExecutePasses() was always running in the main thread.

Documentation Changes

• Added sculpt plugin examples.

• Added warning notes to BaseDocument.GetLayerObjectRoot(), BaseSelect.SelectAll() and VariableTag.GetDataCount().

• Added previsouly undocumented methods in PaintTexture:

  • PaintTexture.CreateNewTexture()
  • PaintTexture.GetTextureDefaults()
  • PaintTexture.SetSelected_Texture()
  • PaintTexture.GetSelectedTexture()

Older Releases

• What was New in R15
• What was New in R14
• What was New in R13