SDK Change Notes for Cinema 4D 2025.3¶
Summarizes the API and API documentation changes made between Cinema 4D version 2025.2.0 and 2025.3.0.
Documentation Changes¶
Major Changes¶
Extended the
c4d.documents.BatchRender
API to have the ability to choose the render settings, cameras and takes to render.Added a suite of new code examples around the subject of dialogs, including both simple beginner examples, as well as more complex examples covering subjects such as dynamic GUIs, value and layout persistence, and using resources to define dialogs and string translations. The new examples all begin with the prefix py-cmd_gui_, see our plugin examples overview for details.
Minor Changes¶
Added geometry_polygon_edges, a code example about handling edges and geometry metadata in geometry operations, here at the example of a script that splits the selected edges of a polygon object, while preserving UVW, vertex map, and vertex color metadata
Updated the plugin code examples overview page to be a better tool for finding the right example for a specific task.
Updated the py-offset_y_spline code example to support spline simulations and clarified the hacky nature of this code example.
Removed the py-commanddata_dialog_r13 example and deprecated the py-memory_viewer code example.
API Changes¶
Cinema API¶
Added
BatchRender.GetTextureError()
to get the texture error state.Added
BatchRender.SetTextureError()
to set the texture error state.Added
BatchRender.GetCheckTexture()
to get the check texture state.Added
BatchRender.SetCheckTexture()
to set the check texture state.Added
BatchRender.GetTakeCount()
to get the number of takes.Added
BatchRender.GetAllTakeNames()
to get the names of all takes.Added
BatchRender.GetActiveTakeIndex()
to get the active take index.Added
BatchRender.GetActiveTakeName()
to get the active take name.Added
BatchRender.SetActiveTakeIndex()
to set the active take index.Added
BatchRender.GetRenderSettingsCount()
to get the number of render settings.Added
BatchRender.GetAllRenderSettingsNames()
to get the names of all render settings.Added
BatchRender.GetActiveRenderSettingsIndex()
to get the active render settings index.Added
BatchRender.GetActiveRenderSettingsName()
to get the active render settings name.Added
BatchRender.SetActiveRenderSettingsIndex()
to set the active render settings index.Added
BatchRender.GetCameraCount()
to get the number of cameras.Added
BatchRender.GetAllCameraNames()
to get the names of all cameras.Added
BatchRender.GetActiveCameraIndex()
to get the active camera index.Added
BatchRender.GetActiveCameraName()
to get the active camera name.Added
BatchRender.SetActiveCameraIndex()
to set the active camera index.Added
GeUserArea.DrawBitmapRounded()
to draw a bitmap with rounded edges in the area.Added
c4d.utils.ViewportSelect.PickMaterial()
to pick a material from a viewport zone.Deprecated
CAWeightTag.SetWeight()
, use CAWeightTag.SetWeightMap which is more performant if you need to modify more than one value.
Maxon API¶
Nothing was changed in the Maxon API.
Mxutils API¶
Fixed an issue with the symbol parser that could fail if the folder to parse was read only.