Cinema 4D 2024.0.0 Release

- Added an example that demonstrates accessing node materials and their graph contents in a scene. scripts\05_modules\nodesaccess_nodematerial_2024.py
- Added an example that demonstrates creating new node materials and adding graphs to them. scripts\05_modules\create_nodematerial_2024.py
- Added an example that demonstrates setting up a Redshift node material composed out of multiple nodes.. scripts\05_modules\create_redshift_nodematerial_2024.py
- Added an example that demonstrates setting up a Standard renderer node material composed out of multiple nodes. scripts\05_modules\reate_standard_nodematerial_2023_1.py

Author: maxon-madam

plugins/py-ies_meta_r12/py-ies-meta_loader.pyp renamed to plugins/py-ies_meta_r12/py-ies-meta-loader.pyp

@@ -22,8 +22,9 @@ import c4d
 # SceneLoader are registered earlier than Cinema 4D Resource parser.
 # To have all the constant defined in fies_loader.h, you need to manually parse them
 import os
-import symbol_parser
-symbol_parser.parse_and_export_in_caller(os.path.join(os.path.dirname(__file__), "res"))
+import mxutils
+
+mxutils.ImportSymbols(os.path.join(os.path.dirname(__file__), "res"))
 
 PLUGIN_ID = 1059408
 

plugins/readme.md

@@ -141,14 +141,7 @@ A data class for creating scene saver plugins (custom scene file format exporter
 
     Exporter, exporting all IES Meta information from the current document to a txt files.
     Iterates all objects present in the cache of each objects in the scene to retrieve IES light.
-	
-## SceneLoaderData
-A data class for creating custom scene file format importer.
-
-### py-ies_meta_loader
-
-	Importer, creating IES light from a file exported with the ies_meta_exporter.
-
+    
 ## BitmapLoaderData
 A data class for creating bitmap loader plugins (custom bitmap file format importer).
 

scripts/05_modules/node/access_nodematerial_2024.py

@@ -0,0 +1,66 @@
+#coding: utf-8
+"""Demonstrates accessing node materials and their graph contents in a scene.
+
+Topics:
+    * Accessing node materials in a document.
+    * Testing for and accessing graphs for node spaces in a node material.
+    * Iterating over nodes in a graph.
+"""
+__author__ = "Ferdinand Hoppe"
+__copyright__ = "Copyright (C) 2023 MAXON Computer GmbH"
+__date__ = "01/09/2023"
+__license__ = "Apache-2.0 License"
+__version__ = "2024.0.0"
+
+
+import c4d
+import maxon
+
+doc: c4d.documents.BaseDocument # The active document.
+
+def main():
+    """
+    """
+    # Node materials are instances of the classic API material type #BaseMaterial. The node data
+    # is attached to them as a #NodeMaterial. We can retrieve a #NodeMaterial instance for each 
+    # #BaseMaterial instance, whether or not this material actually is a node material or not.
+    # Because of that, we must iterate over all material in a document to find node materials and 
+    # retrieve the #NodeMaterial for each of them.
+
+    # For each #material in the currently active document get its #nodeMaterial reference.
+    material: c4d.BaseMaterial
+    for material in doc.GetMaterials():
+        nodeMaterial: c4d.NodeMaterial = material.GetNodeMaterialReference()
+    
+        # To test if a material has a graph for a specific space, we must use the method #HasSpace. 
+        # To support 3rd party render engines, you must ask them for their node space ID.
+        for nid in ("net.maxon.nodespace.standard",                 # Standard Renderer
+                    "com.redshift3d.redshift4c4d.class.nodespace"): # Redshift Renderer
+            if not nodeMaterial.HasSpace(nid):
+                continue
+            
+            # This material has a graph for the space #nid, we retrieve it.
+            graph: maxon.GraphModelInterface = nodeMaterial.GetGraph(nid)
+            if graph.IsNullValue():
+                raise RuntimeError("Found malformed empty graph associated with node space.")
+            
+            # Now we iterate over all items in the graph.
+            print (f"\nThe material '{material.GetName()}' has a graph in the node space '{nid}'.")
+            root: maxon.GraphNode = graph.GetRoot()
+
+            # Iterate over the direct children of the graph root.
+            node: maxon.GraphNode
+            for node in root.GetChildren():
+                print (f"\tDirect child of graph root: {node.GetId()}")
+            
+            print ("\t" + "-" * 60)
+            # Iterate over all nodes in the graph, i.e., unpack things like nodes nested in groups. 
+            # With the mask argument we could also include ports in this iteration.
+            for node in root.GetInnerNodes(mask=maxon.NODE_KIND.NODE, includeThis=False):
+                print (f"\tNode in the graph: {node}")
+            
+    c4d.EventAdd()
+
+
+if __name__ == "__main__":
+    main()

scripts/05_modules/node/create_nodematerial_2024.py

@@ -0,0 +1,76 @@
+#coding: utf-8
+"""Demonstrates creating new node materials and adding graphs to them.
+
+See the `create_redshift_nodematerial` and `create_standard_nodematerial` examples in this directory
+for also populating a graph with nodes and connecting them.
+
+Topics:
+    * Creating node materials.
+    * Adding and removing graphs to them.
+"""
+__author__ = "Ferdinand Hoppe"
+__copyright__ = "Copyright (C) 2023 MAXON Computer GmbH"
+__date__ = "01/09/2023"
+__license__ = "Apache-2.0 License"
+__version__ = "2024.0.0"
+
+import c4d
+import maxon
+
+doc: c4d.documents.BaseDocument # The active document.
+
+def main():
+    """
+    """
+    # Node materials are instances of the classic API material type #BaseMaterial. The node data
+    # is attached to them as a #NodeMaterial. We can retrieve a #NodeMaterial instance for each 
+    # #BaseMaterial instance, whether or not this material actually is a node material or not.
+
+    # Instantiate a classic API material.
+    material: c4d.BaseMaterial = c4d.BaseMaterial(c4d.Mmaterial)
+    if not material:
+        raise MemoryError(f"{material = }")
+    doc.InsertMaterial(material)
+
+    # Get the node material for it and add a graph for the currently active material space to it. 
+    nodeMaterial: c4d.NodeMaterial = material.GetNodeMaterialReference()
+    graph: maxon.GraphModelInterface = nodeMaterial.CreateDefaultGraph(c4d.GetActiveNodeSpaceId())
+    if graph.IsNullValue():
+        raise RuntimeError("Could not add graph to material.")
+    
+    # The method #CreateDefaultGraph we used above does not create an empty graph, but the setup
+    # the respective node space considers to be its default setup. For Redshift this is for example
+    # an RS Standard Material node connected to an Output end node.
+    print ("Nodes in CreateDefaultGraph setup:")
+    for node in graph.GetRoot().GetInnerNodes(mask=maxon.NODE_KIND.NODE, includeThis=False):
+        print (f"{node}")
+
+    # Remove the graph we just created.
+    nodeMaterial.RemoveGraph(c4d.GetActiveNodeSpaceId())
+
+    # We can also create an empty graph which contains no nodes at all with. 
+    graph: maxon.GraphModelInterface = nodeMaterial.CreateEmptyGraph(c4d.GetActiveNodeSpaceId())
+    if graph.IsNullValue():
+        raise RuntimeError("Could not add graph to material.")
+
+    print ("Nodes in CreateEmptyGraph setup:")
+    for node in graph.GetRoot().GetInnerNodes(mask=maxon.NODE_KIND.NODE, includeThis=False):
+        print (f"{node}")
+
+    # Remove the graph again.
+    nodeMaterial.RemoveGraph(c4d.GetActiveNodeSpaceId())
+
+    # Finally, we should be aware that node material can hold graphs for multiple node spaces and
+    # therefore can be used with multiple render engines. To do this, we can simply add multiple
+    # graphs for specific nodes spaces.
+
+    # Add a default graph for both the Redshift and Standard material node space, check the "Basic"
+    # tab of the material, it will list a graph for both spaces. When you switch between render 
+    # engines, the material will have its own graph for each engine. To support 3rd party render
+    # engines, you must ask their vendor for their node space ID.
+    nodeMaterial.CreateDefaultGraph("com.redshift3d.redshift4c4d.class.nodespace")
+    nodeMaterial.CreateDefaultGraph("net.maxon.nodespace.standard")
+
+
+if __name__ == "__main__":
+    main()