Subpart Material

SubpartMaterial

Accessing Subpart Materials

• scene.listSubpartmaterials
• scene.getSubpartmaterial

Setting Subpart Materials

• scene.setSubpartMaterials
• scene.setSubpartMaterial

SubpartMaterial

Material Priority / Override Hierarchy

1. Subpart Material (Highest Priority)
   Assigned directly to a subpart using code (

   setSubpartMaterial

   ). This takes precedence over all other material assignments.
2. Occurrence Material
   Applied to a specific occurrence in the scene.
3. Inherited Material If no material is set at the above levels, a material can be inherited from a parent node or structure in the scene tree.
4. Submesh Material (Lowest Priority)
   The default material assigned to the submeshs(patches) during import or modeling. However, this is a legacy method and will be deprecated in future versions.

Example

Python Example: Assigning Materials to Subparts

Apply on subparts

# Define a list of RGBA colorscolors = [    [1.0, 0.0, 0.0, 1.0],  # Red    [0.0, 1.0, 0.0, 1.0],  # Green    [0.0, 0.0, 1.0, 1.0],  # Blue    [1.0, 1.0, 0.0, 1.0],  # Yellow    [0.0, 1.0, 1.0, 1.0],  # Cyan    [1.0, 0.0, 1.0, 1.0],  # Magenta]# Create a cube of dimensions 100x100x100cube = pxz.scene.createCube(100, 100, 100)# Set the cube's parent to the root node in the scenepxz.scene.setParent(cube, pxz.scene.getRoot())# Automatically identify patches (subparts) for material assignment. `identifyPatches` detects 6 planar faces on the cube, resulting in 6 submeshes (subparts).pxz.algo.identifyPatches([cube])# Assign a different material/color to each subpart of the cubefor i in range(6):    mat = pxz.material.createMaterial(f"mat{i}", "color")    pxz.material.setMaterialMainColor(mat, colors[i])    pxz.scene.setSubpartMaterial(cube, i, mat)

algo.identifyPatches

Apply on instances

# Define a list of colors for subpart materialscolors = [    [1.0, 0.0, 0.0, 1.0],  # Red    [0.0, 1.0, 0.0, 1.0],  # Green    [0.0, 0.0, 1.0, 1.0],  # Blue]# Create a base cube (shared geometry for all instances)cube = pxz.scene.createCube(100, 100, 100)# Assign a default gray material to the prototype (occurrence level)default_mat = pxz.material.createMaterial("default_mat", "color")pxz.material.setMaterialMainColor(default_mat, [0.5, 0.5, 0.5, 1.0])  # Graypxz.scene.setOccurrenceMaterial(cube, default_mat)# Create three instances and assign materialsfor i in range(3):    # Create a new occurrence and attach it to the scene    inst = pxz.scene.createOccurrence(f"instance{i+1}")    pxz.scene.setPrototype(inst, cube)    pxz.scene.setParent(inst, pxz.scene.getRoot())    # Offset each instance in X (skip the first one)    if i > 0:        matrix = pxz.scene.getLocalMatrix(inst)        matrix[0][3] += i * 150        pxz.scene.setLocalMatrix(inst, matrix)    # Create and assign a unique material to subpart 0 of each instance    mat = pxz.material.createMaterial(f"mat{i+1}", "color")    pxz.material.setMaterialMainColor(mat, colors[i])    pxz.scene.setSubpartMaterial(inst, 0, mat)

File Format Support

subpartMaterial