SDK Change Notes for Cinema 4D S26.0¶
Summarizes the API and API documentation changes made between Cinema 4D version R25.25.113 and S26.013.
Documentation Changes¶
Major Changes¶
Added a plugin in Cinema 4D to exchange code between the Script Manager and Visual Studio Code. Read Cinema 4D Connector - Documentation for more details.
Added the Asset API. Its documentation can be found in the The Asset Framework page and example in the Script | 05_modules | assets folder.
Changed the access to frameworks in the maxon API for Python. Thus it is no longer necessary to import each framework explicitly.
import maxon from maxon.frameworks import volume # This line is not anymore needed.
Changed how to access objects from C++ frameworks. They are now directly accessible in the maxon module. Thus any code written in C++ for the Maxon API, is identical in python.
# C++ code #include <assets.h> maxon::AssetInterface::GetApplicationRepository(); # S26 Python import maxon maxon.AssetInterface.GetApplicationRepository() # R25 Python, still compatible with S26 import maxon from maxon.frameworks import asset maxon.frameworks.asset.AssetInterface.GetApplicationRepository()
Minor Changes¶
Added support for the “Script Word Wrap” option in the Script Editor and for the Pyton Console.
Added saving of the selected category in the console (Default, Python, Team Render, etc.) and restored each time Cinema 4D is started.
Added Python type hints in all default code.
Added Python type hints in the c4d Auto Completion Dummy Package.
Added CMD_HIDDEN flag, which hide a command if this value is returned in the
CommandData.GetState()
method.Added the type
c4d.NormalTag
to represent a Point Normal Tag.Added an API for the Variation Shader to manipulate inner layer through parameter access, an use case example can be found in shader_variation_s26.py in the Python Github Repository.
Fixed word wrapping in multi-line text for the Python console via the CTRL + Left / Right shortcuts.
API Changes¶
Classic API¶
Added
c4d.GetScriptHead()
.Added
c4d.GetDynamicScriptID()
.Added
c4d.SetActiveScriptObject()
.Added
c4d.CreateNewPythonScript()
.Added
c4d.LoadPythonScript()
.Added
Vector.GetHashCode()
.Added
Vector.IsEqual()
.Added
Vector.IsZero()
.Added
Vector.SetZero()
.Added
Vector.GetAverage()
.Added
Vector.GetSum()
.Added
Vector.ClampMin()
.Added
Vector.ClampMax()
.Added
Vector.Clamp01()
.Added
Vector.GetSquaredLength()
.Added
Vector.GetMin()
.Added
Vector.GetMax()
.Added
Vector.GetRightRotated()
.Added
Vector.Abs()
.Added
Vector.Min()
.Added
Vector.Max()
.Added
Vector.SetMin()
.Added
Vector.SetMax()
.Added
Vector.GetAngle()
.
Deprecated
Vector.GetLengthSquared()
, useVector.GetSquaredLength()
instead.
Maxon API¶
Added
Registry.__iter__()
.Added
Registry.__getitem__()
.Added
Registry.__len__()
.Added
maxon.Resource
Added
maxon.FilterInterface
.Added
maxon.FilterRef
.Added
maxon.FilterClasses
.Added
maxon.FilterCommandQueueRef
.Added
maxon.FilterContextInterface
.Added
maxon.FilterContextRef
.Added
maxon.FilterContextClasses
.Added
maxon.FilterImageInterface
.Added
maxon.FilterImageRef
.Added
maxon.FilterImageClasses
.Added
maxon.GraphModelHelper
.Added
maxon.NodePath.__init__()
.Added
maxon.AssetCreationInterface.SaveMemFileAsAssetWithCopyAsset()
.Added
maxon.AssetCreationInterface.GetAddDependencyDelegate()
.