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

Table Of Contents

• What was New in R16
  • In R16.050
    • Fixes
    • API Changes
  • In R16.038
    • Documentation Changes
    • New Color Property for TP Particles
    • API Changes
    • Documentation Changes
  • In R16.021
    • CallFunction
    • Sculpt Brushes
    • HyperFile Refactoring
    • NET/Team Render Changes
    • Other API Changes
      • Methods
      • Functions
      • Parameters
      • Fixes
    • Documentation Changes