R25 Release

Add nodes example within scripts\05_modules\node
Update symbols to remove deprecated one

Author: gr4ph0s

plugins/py-liquid_painter_r12/py-liquid_painter_r12.pyp

@@ -128,14 +128,14 @@ class LiquidTool(c4d.plugins.ToolData):
             raise MemoryError("Failed to create a Phong Tag.")
 
         # Adds an undo step
-        doc.AddUndo(c4d.UNDO_NEW, metaball)
+        doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, metaball)
 
         # Inserts the object in the active document and set it as active one.
         doc.InsertObject(metaball)
         doc.SetActiveObject(metaball)
 
         # Updates the Viewport (so the metaball is drawn)
-        c4d.DrawViews(c4d.DA_ONLY_ACTIVE_VIEW | c4d.DA_NO_THREAD | c4d.DA_NO_ANIMATION)
+        c4d.DrawViews(c4d.DRAWFLAGS_ONLY_ACTIVE_VIEW | c4d.DRAWFLAGS_NO_THREAD | c4d.DRAWFLAGS_NO_ANIMATION)
 
         # Retrieves the X/Y screen position of the mouse.
         mx = msg[c4d.BFM_INPUT_X]
@@ -171,7 +171,7 @@ class LiquidTool(c4d.plugins.ToolData):
             sphere.InsertUnder(metaball)
 
             # Updates the Viewport (so the metaball with the newly created sphere is drawn)
-            c4d.DrawViews(c4d.DA_ONLY_ACTIVE_VIEW | c4d.DA_NO_THREAD | c4d.DA_NO_ANIMATION)
+            c4d.DrawViews(c4d.DRAWFLAGS_ONLY_ACTIVE_VIEW | c4d.DRAWFLAGS_NO_THREAD | c4d.DRAWFLAGS_NO_ANIMATION)
 
             # Updates drag information
             result, dx, dy, channel = win.MouseDrag()

plugins/py-rounded_tube_r13/py-rounded_tube_r13.pyp

@@ -227,7 +227,7 @@ class RoundedTube(c4d.plugins.ObjectData, RoundedTubeHelper):
         """
         # Disable the following lines because cache flag was set
         # So the cache build is done before this method is called
-        # dirty = op.CheckCache(hierarchyhelp) or op.IsDirty(c4d.DIRTY_DATA)
+        # dirty = op.CheckCache(hierarchyhelp) or op.IsDirty(c4d.DIRTYFLAGS_DATA)
         # if dirty is False: return op.GetCache(hierarchyhelp)
 
         # Retrieves parameters value from the generator object

plugins/py-spherify_modifier_r13/py-spherify_modifier_r13.pyp

@@ -341,7 +341,7 @@ class SpherifyModifier(c4d.plugins.ObjectData):
 
             if self.falloff is not None and not skipFalloff:
                 if not self.falloff.InitFalloff(op.GetDataInstance(), bh.GetDocument(), op):
-                    return c4d.DRAWRESULT_ERROR
+                    return c4d.DRAWRESULT_FAILURE
 
             # Retrieves the object color
             bd.SetPen(bd.GetObjectColor(bh, op))

plugins/py-texture_baker_r18/py-texture_baker_r18.pyp

@@ -82,7 +82,7 @@ class TextureBakerThread(c4d.threading.C4DThread):
             return False
 
         # Starts bake thread
-        self.Start(c4d.THREADMODE_ASYNC, c4d.THREADPRIORITY_BELOW)
+        self.Start(c4d.THREADMODE_ASYNC, c4d.THREADPRIORITEXY_BELOW)
 
         return True
 

plugins/py-tooldata_ui_r15/py-tooldata_ui_r15.pyp

@@ -250,7 +250,7 @@ class ToolDataWithUiExample(c4d.plugins.ToolData):
             doc.StartUndo()
 
         # Adds an undo step
-        doc.AddUndo(c4d.UNDO_NEW, cloned)
+        doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, cloned)
 
         # Inserts the cloned object in the active document.
         doc.InsertObject(cloned)

scripts/03_application_development/gui/description/description_check_descid_r18.py

@@ -23,7 +23,7 @@ def main():
         raise RuntimeError("Failed to retrieve the description.")
 
     # Builds the object's X position parameter DescID
-    descId = c4d.DescID(c4d.DescLevel(c4d.ID_BASEOBJECT_POSITION, 0, 0), c4d.DescLevel(c4d.VECTOR_X, 0, 0))
+    descId = c4d.DescID(c4d.DescLevel(c4d.ID_BASEOBJECT_REL_POSITION, 0, 0), c4d.DescLevel(c4d.VECTOR_X, 0, 0))
 
     # Prints previously built DescID
     print(descId)

scripts/04_3d_concepts/modeling/read_write_normal_tag_r13.py

@@ -23,6 +23,7 @@
 
 QUARTER_PI = math.pi * .25
 
+
 def ReadNormalTag(tag):
     """Reads a c4d.NormalTag to a list of c4d.Vector.
 
@@ -59,6 +60,7 @@ def ReadNormalTag(tag):
                        data[i-1] * factor)
             for i in range(3, len(data) + 3, 3)]
 
+
 def WriteNormalTag(tag, normals, doNormalize=True):
     """Writes a list of c4d.Vector to a c4d.NormalTag.
     
@@ -106,6 +108,7 @@ def WriteNormalTag(tag, normals, doNormalize=True):
     data = data.tobytes()
     buffer[:len(data)] = data
 
+
 def main():
     """Entry point."""
     # Raise an error when the primary selection is not a PolygonObject.
@@ -128,7 +131,7 @@ def main():
 
     # Get the normals from the newly allocated NormalTag.
     normals = ReadNormalTag(normalTag)
-    print (f"Normals of the newly allocated tag: {normals}")
+    print(f"Normals of the newly allocated tag: {normals}")
 
     # This should not happen.
     if len(phongNormals) != len(normals):
@@ -139,20 +142,21 @@ def main():
 
     # Inspect our write operation in the console.
     normals = ReadNormalTag(normalTag)
-    print (f"Normals after writing the phong normals: {normals}")
+    print(f"Normals after writing the phong normals: {normals}")
 
     # Start an undo block.
     doc.StartUndo()
     # Insert our NormalTag.
     op.InsertTag(normalTag)
     # For insertions the undo has to be added after the operation.
-    doc.AddUndo(c4d.UNDOTYPE_NEW, normalTag)
+    doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, normalTag)
     # End the undo block.
     doc.EndUndo()
 
     # Notify Cinema and the object that we did made changes.
     op.Message(c4d.MSG_UPDATE)
     c4d.EventAdd()
 
+
 if __name__ == "__main__":
     main()

scripts/04_3d_concepts/scene_elements/animation/ctrack_copy_r14.py

@@ -38,7 +38,7 @@ def main():
 
     # Defines a list that will contains the ID of parameters we want to copy.
     # Such ID can be found by drag-and-drop a parameter into the python console.
-    trackListToCopy = [c4d.ID_BASEOBJECT_POSITION, c4d.ID_BASEOBJECT_ROTATION, c4d.ID_BASEOBJECT_SCALE]
+    trackListToCopy = [c4d.ID_BASEOBJECT_REL_POSITION, c4d.ID_BASEOBJECT_REL_ROTATION, c4d.ID_BASEOBJECT_REL_SCALE]
 
     # Start the Undo process.
     doc.StartUndo()
@@ -56,15 +56,15 @@ def main():
         foundTrack = fixedBox.FindCTrack(did)
         if foundTrack:
             # Removes the track if found.
-            doc.AddUndo(c4d.UNDOTYPE_DELETE, foundTrack)
+            doc.AddUndo(c4d.UNDOTYPE_DELETEOBJ, foundTrack)
             foundTrack.Remove()
 
         # Copies the initial CTrack in memory. All CCurve and CKey are kept in this CTrack.
         clone = track.GetClone()
 
         # Inserts the copied CTrack to the static object.
         fixedBox.InsertTrackSorted(clone)
-        doc.AddUndo(c4d.UNDOTYPE_NEW, clone)
+        doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, clone)
 
     # Ends the Undo Process.
     doc.EndUndo()

scripts/04_3d_concepts/scene_elements/animation/ctrack_create_keys_r13.py

@@ -62,7 +62,7 @@ def main():
     obj = c4d.BaseObject(c4d.Ocube)
 
     # Creates the track in memory. Defined by it's DescID
-    trackY = c4d.CTrack(obj, c4d.DescID(c4d.DescLevel(c4d.ID_BASEOBJECT_POSITION, c4d.DTYPE_VECTOR, 0),
+    trackY = c4d.CTrack(obj, c4d.DescID(c4d.DescLevel(c4d.ID_BASEOBJECT_REL_POSITION, c4d.DTYPE_VECTOR, 0),
                                         c4d.DescLevel(c4d.VECTOR_Y, c4d.DTYPE_REAL, 0)))
 
     # Gets curves for the track

scripts/04_3d_concepts/scene_elements/materials_shading/material_set_to_selected_poly_r13.py

@@ -31,7 +31,7 @@ def AssignMatToObject(obj, matList, onlyToSelection=False):
     for mat in matList:
         # Creates the texture Tag
         textureTag = obj.MakeTag(c4d.Ttexture)
-        doc.AddUndo(c4d.UNDOTYPE_NEW, textureTag)
+        doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, textureTag)
 
         # If the texture tag is not available at this point, something went wrong
         if textureTag is None:
@@ -63,7 +63,7 @@ def AssignMatToObject(obj, matList, onlyToSelection=False):
 
         # Creates the selection tag
         selectionTag = obj.MakeTag(c4d.Tpolygonselection)
-        doc.AddUndo(c4d.UNDOTYPE_NEW, selectionTag)
+        doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, selectionTag)
 
         # Checks if there was no error during the creation of the selection tag
         if selectionTag is None:

scripts/04_3d_concepts/scene_elements/scene_management/basedocument_read_animated_mesh_r16.py

@@ -88,7 +88,7 @@ def main():
             null.SetName(str(frame))
 
             # Inserts the objects into the documents
-            doc.AddUndo(c4d.UNDOTYPE_NEW, null)
+            doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, null)
             doc.InsertObject(null)
 
             # Defines the position of the null with the position of the point from the deformed mesh

scripts/04_3d_concepts/scene_elements/scene_management/basedocument_undo_r13.py

@@ -30,19 +30,19 @@ def main():
 
     # Inserts a Material into the active document
     doc.InsertMaterial(mat)
-    doc.AddUndo(c4d.UNDOTYPE_NEW, mat)
+    doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, mat)
 
     # Inserts both objects
     doc.InsertObject(null)
-    doc.AddUndo(c4d.UNDOTYPE_NEW, null)
+    doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, null)
 
     # Inserts both objects
     doc.InsertObject(cube)
-    doc.AddUndo(c4d.UNDOTYPE_NEW, cube)
+    doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, cube)
 
     # Inserts the Texture Tag to the cube object
     cube.InsertTag(textureTag)
-    doc.AddUndo(c4d.UNDOTYPE_NEW, textureTag)
+    doc.AddUndo(c4d.UNDOTYPE_NEWOBJ, textureTag)
 
     # Defines the material used in the Texture Tag to our material
     doc.AddUndo(c4d.UNDOTYPE_CHANGE, textureTag)
@@ -60,7 +60,7 @@ def main():
     cube.InsertUnderLast(null)
 
     # Delete the Texture Tag
-    doc.AddUndo(c4d.UNDOTYPE_DELETE, textureTag)
+    doc.AddUndo(c4d.UNDOTYPE_DELETEOBJ, textureTag)
     textureTag.Remove()
 
     # Defines the final state of the scene

scripts/05_modules/mograph/voronoi_fracture_r18.py

@@ -26,7 +26,7 @@ def main():
     doc.InsertObject(cube)
 
     # Makes it editable and finally insert it as child of Voronoi Fracture object
-    editable = c4d.utils.SendModelingCommand(c4d.MCOMMAND_MAKEEDITABLE, list=[cube], mode=c4d.MODIFY_ALL, doc=doc)
+    editable = c4d.utils.SendModelingCommand(c4d.MCOMMAND_MAKEEDITABLE, list=[cube], mode=c4d.MODELINGCOMMANDMODE_ALL, doc=doc)
     if not editable:
         raise RuntimeError("Failed to do the SendModelingCommand operation.")
     doc.InsertObject(editable[0], parent=voronoi)

scripts/05_modules/node/create_nodematerial_r24.py

@@ -0,0 +1,109 @@
+"""
+Copyright: MAXON Computer GmbH
+Author: Manuel Magalhaes
+
+Description:
+    Creates a NodeMaterial for the current node space and for Redshift node 
+    space. 
+
+    NodeMaterials inherit from BaseMaterial. To be able to use the functions 
+    that are in the NodeMaterial class, the BaseMaterial must be cast to a 
+    NodeMaterial. This is done with the function GetNodeMaterialReference. To 
+    add a graph to an existing node space, one must use the function AddGraph.
+    If one wants to have access to an already added node graph, one must 
+    retrieve the nimbus reference which does store the graph. Once one has 
+    retrieved the graph, one can access the root that contains all the nodes.
+    
+Class/method highlighted:
+    - GetNodeMaterialReference
+    - AddGraph
+    - GetActiveNodeSpaceId
+    - GetChildren
+    - GetNimbusRef
+"""
+import c4d
+import maxon
+import maxon.frameworks.nodespace
+import maxon.frameworks.nodes
+
+# Define a function that will create the node material for the passed
+# nodespace Id and return the root of the created Graph
+
+
+def CreateMaterialForNodeSpace(nodespaceId):
+    # Create a baseMaterial first
+    mat = c4d.BaseMaterial(c4d.Mmaterial)
+    if mat is None:
+        raise ValueError("Cannot create a BaseMaterial.")
+
+    # Retrieve the reference of the material as a node material.
+    nodeMaterial = mat.GetNodeMaterialReference()
+    if nodeMaterial is None:
+        raise ValueError("Cannot retrieve nodeMaterial reference.")
+
+    # Add a graph for the space Id
+    addedGraph = nodeMaterial.AddGraph(nodespaceId)
+    if addedGraph is None:
+        raise ValueError("Cannot add a GraphNode for this NodeSpace.")
+
+    # Retrieve the Nimbus reference for a specific NodeSpace
+    nimbusRef = mat.GetNimbusRef(nodespaceId)
+    if nimbusRef is None:
+        raise ValueError(
+            "Cannot retrieve the nimbus reference for that NodeSpace.")
+
+    # Retrieve the graph corresponding to that NodeSpace.
+    graph = nimbusRef.GetGraph()
+    if graph is None:
+        raise ValueError("Cannot retrieve the graph of this nimbus NodeSpace.")
+
+    # Retrieve the root of the graph
+    root = graph.GetRoot()
+
+    # Insert the material in the document
+    doc.InsertMaterial(mat)
+    return root
+
+
+# Define a function that will recursively print all the child of the root node.
+def PrintChildren(node):
+    if node is None:
+        return None
+    # Print the current Node
+    print(node)
+
+    # Call GetChildren on this node with the delegate function
+    node.GetChildren(PrintChildren, maxon.frameworks.graph.NODE_KIND.ALL_MASK)
+
+    # Important that the delegate return True or False
+    return True
+
+
+def main():
+
+    # Retrieve the current node space Id
+    nodespaceId = c4d.GetActiveNodeSpaceId()
+
+    # Create the material and retrieve the root of the graph
+    root = CreateMaterialForNodeSpace(nodespaceId)
+
+    # Start the recursive process on the first node
+    PrintChildren(root)
+
+    # Do the same with the Redshift node space. The Redshift plugin is not 
+    # installed by default, so we call the function in an exception handling
+    # context.
+    redShiftNodeSpPaceId = maxon.Id(
+        'com.redshift3d.redshift4c4d.class.nodespace')
+    try:
+        root = CreateMaterialForNodeSpace(redShiftNodeSpPaceId)
+        PrintChildren(root)
+    except:
+        print(f"The node space with id {redShiftNodeSpPaceId} does not exist")
+
+    # Pushes an update event to Cinema 4D
+    c4d.EventAdd()
+
+
+if __name__ == "__main__":
+    main()