What was New in R16

In R16.050

Fixes

• Filename parameters can now be set passing a string value to either C4DAtom.SetParameter() or GeListNode.__setitem__()

• MSG_MENUPREPARE message can now be send

• NetRenderService.CreateRenderJob() username parameter

• PaintTexture.CreateNewTexture() path parameter

• c4d.plugins.RegisterDescription() unnecessary g parameter

• Copying of Gradient Custom GUI knots

• C4DAtom.AddUniqueID() now returns a bool

• COLORBYTES_COLORw attributes accessibility

• Reset of all BaseLinks from the passed node in c4d.storage.ReadHyperFile()

API Changes

• New functions in c4d module:

  • c4d.GenerateTexturePath()

  • c4d.IsInSearchPath()

  • c4d.StatusNetClear()

  • c4d.StatusSetNetBar()

  • c4d.StatusSetNetLoad()

  • c4d.StatusSetNetText()

  • c4d.AllocListHead()

• Added method C4DAtom.GetUniqueIDIndex()

• Added DescriptionCustomGui class

• net module:

  • New parameter logCount for NetRenderService.GetMachinesList()

  • New parameter printDebugErrors for c4d.modules.net.SetErrorLevel()

• thinkingparticles module:

  • New method TP_MasterSystem.UpdateGroup()

  • Added methods TP_PGroup.Cache() and TP_PGroup.IsCache()

In R16.038

Documentation Changes

New Color Property for TP Particles

A new color property has been added to Thinking Particles. TP Particles have now IN_PART_COLOR and OUT_PART_COLOR parameters. TP_MasterSystem has Color() and SetColor() new methods.

To preserve the old behavior PGROUP_USE_COLOR parameter has been added to Particle Groups. TP_PGroup class has GetUseColor() and SetUseColor() new methods.

API Changes

• In net module:

  • Added function c4d.modules.net.SetErrorLevel()

  • Added method NetRenderService.AddMachine()

  • Added parameter settings to NetRenderService.GetJobsList()

• BaseContainer.GetIndexData()

• BaseContainer.SetIndexData()

• TP_MasterSystem.Color()

• TP_MasterSystem.SetColor()

• TP_PGroup.SetUseColor()

• TP_PGroup.GetUseColor()

• c4d.threading.GeIsMainThreadAndNoDrawThread()

Documentation Changes

Note

For the Cinema 4D objects the operator [] (defined in GeListNode.__getitem__() and GeListNode.__setitem__()) is used to get/set their parameters data.

The corresponding functions of the C++ API are C4DAtom::GetParameter() and C4DAtom::SetParameter().

Notes have been added to GeListNode.__getitem__() and GeListNode.__setitem__().

• Added note to BitmapButtonCustomGui

• Added note to c4d.documents.LoadFile()

• Added important warning to c4d.CallButton()

• Added note and code snippet to GvNode.AddPort()

• Fixed information and added code snippet for BaseDocument.AddUndo()

• Added code snippet to c4d.documents.RenderDocument()

• Added documentation for:

  • c4d.RestartMe()

  • GeDialog.RemoveElement()

  • GeDialog.HideElement()

  • BatchRender.SetUseNet()

• TP_PGroup is now completely documented.

• New documentation style (CSS).

• Numerous minor fixes in the documentation.

In R16.021

CallFunction

With c4d.CallFunction() it is now possible to call a function defined within a scripting expression (Python and C.O.F.F.E.E. scripting tags, effectors, XPresso nodes, Interaction tags and Python generators). This allows better workflow and interaction between scripting expressions in the same document.

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:

• Added:

  • 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

  • c4d.modules.net.JobStateToString()

  • c4d.modules.net.NetSpecialEventAdd()

  • c4d.modules.net.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()

• c4d.CallFunction()

• c4d.plugins.RegisterSculptBrushPlugin()

• c4d.plugins.RegisterDescription()

• c4d.storage.GetFreeVolumeSpace()

• c4d.threading.GeGetCurrentThreadCount()

• Deprecated c4d.threading.GeGetCPUCount()

• c4d.utils.SphereLineIntersection()

• c4d.utils.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 plugins starting with py-sculpt prefix in the GitHub repository.

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