Aspose.3D FOSS
Java
Material

Material and PbrMaterial — Aspose.3D FOSS for Java

Package: com.aspose.threed.shading (aspose-3d-foss)

Aspose.3D FOSS for Java provides two material classes:

  • Material: abstract base class for all material types. Provides a name and a property collection for numeric and colour parameters.
  • PbrMaterial: Physically Based Rendering material with metalness, roughness, albedo, and emissive properties. Used by glTF 2.0 and other PBR-capable formats.

Materials are assigned to a Node via node.setMaterial(material).

Material (base class) 

public abstract class Material extends A3DObject

Inheritance

A3DObject -> Material

Material is the abstract base for all material types. It provides the name property and a Properties collection for user-defined metadata. You do not instantiate Material directly; use PbrMaterial instead.

PbrMaterial 

public class PbrMaterial extends Material

Inheritance

A3DObject -> Material -> PbrMaterial

PBR (Physically Based Rendering) material. Used by glTF 2.0 and other PBR-capable formats. Assigned to a Node via node.setMaterial(material).

Constructor 

PbrMaterial()
PbrMaterial(String name)
PbrMaterial(String name, Vector4 albedo)

Properties

PropertyTypeGetterSetterDescription
albedoVector4getAlbedo()setAlbedo(Vector4)Base color (albedo) of the surface as RGBA. Default null.
metallicFactordoublegetMetallicFactor()setMetallicFactor(double)Metallic contribution: 0.0 = fully dielectric, 1.0 = fully metallic.
roughnessFactordoublegetRoughnessFactor()setRoughnessFactor(double)Surface roughness: 0.0 = smooth/mirror, 1.0 = fully rough.
emissiveColorVector3getEmissiveColor()setEmissiveColor(Vector3)Self-emitted light color. Default null.
transparencydoublegetTransparency()setTransparency(double)Opacity level: 0.0 = fully opaque, 1.0 = fully transparent.

Usage Example 

import com.aspose.threed.*;
import com.aspose.threed.shading.PbrMaterial;

Scene scene = new Scene();

Mesh mesh = new Mesh();
mesh.getControlPoints().add(new Vector4(0, 0, 0, 1));
mesh.getControlPoints().add(new Vector4(1, 0, 0, 1));
mesh.getControlPoints().add(new Vector4(0.5, 1, 0, 1));
mesh.createPolygon(0, 1, 2);

PbrMaterial mat = new PbrMaterial("pbr-metal");
mat.setAlbedo(new Vector4(0.8, 0.6, 0.2, 1.0));    // gold-ish base color
mat.setMetallicFactor(0.9);
mat.setRoughnessFactor(0.2);

Node node = scene.getRootNode().createChildNode("mesh", mesh);
node.setMaterial(mat);

scene.save("pbr.glb");

Semi-Transparent PBR Material 

import com.aspose.threed.shading.PbrMaterial;

PbrMaterial mat = new PbrMaterial("glass");
mat.setAlbedo(new Vector4(0.7, 0.9, 1.0, 1.0));
mat.setTransparency(0.7);   // 70% transparent
mat.setRoughnessFactor(0.1);

Read Material from Imported Scene 

import com.aspose.threed.*;
import com.aspose.threed.shading.PbrMaterial;

Scene scene = new Scene();
scene.open("model.gltf");

inspectNode(scene.getRootNode());

static void inspectNode(Node node) {
    if (node.getMaterial() != null) {
        Material m = node.getMaterial();
        if (m instanceof PbrMaterial) {
            PbrMaterial pbr = (PbrMaterial) m;
            System.out.println("Node '" + node.getName() + "': PbrMaterial");
            System.out.println("  albedo=" + pbr.getAlbedo());
            System.out.println("  metallic=" + pbr.getMetallicFactor());
            System.out.println("  roughness=" + pbr.getRoughnessFactor());
        } else {
            System.out.println("Node '" + node.getName() + "': " + m.getClass().getSimpleName());
        }
    }
    for (Node child : node.getChildNodes()) {
        inspectNode(child);
    }
}

See Also