Material

LambertMaterial and PhongMaterial — Aspose.3D FOSS for Python API Reference

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

Aspose.3D FOSS klasik gölgelendirme hiyerarşisinde iki malzeme sınıfı sağlar:

LambertMaterial: difüz mat gölgelendirme (parlaklık yok)
PhongMaterial: Lambert’i speküler vurgular ve parlaklıkla genişletir

İkisi de bir Node aracılığıyla node.material. Renkler şununla ayarlanır Vector3(r, g, b) bileşenlerin olduğu yer [0.0, 1.0].

LambertMaterial

class LambertMaterial(Material):

A3DObject → Material → LambertMaterial

LambertMaterial(name: str = None)


`ambient_color`	`Vector3	None`
`diffuse_color`	`Vector3	None`
`emissive_color`	`Vector3	None`
`transparent_color`	`Vector3	None`
`transparency`	`float`	Opaklık seviyesi: `0.0` = tamamen opak, `1.0` = tamamen şeffaf. Şuna sınırlı `[0.0, 1.0]`.

PhongMaterial

class PhongMaterial(LambertMaterial):

A3DObject → Material → LambertMaterial → PhongMaterial

Hepsini devralır LambertMaterial özellikler ve ekler:

Ek Özellikler


`specular_color`	`Vector3	None`
`specular_factor`	`float`	Specular katkısının ölçeği. Varsayılan `0.0`.
`shininess`	`float`	Phong parlaklık üssü. Daha yüksek = daha sıkı/küçük vurgular. Varsayılan `0.0`.
`reflection_color`	`Vector3	None`
`reflection_factor`	`float`	Yansıma için karıştırma miktarı. Varsayılan `0.0`.

Kullanım Örnekleri

Lambert Mat Malzeme

from aspose.threed import Scene
from aspose.threed.entities import Mesh
from aspose.threed.shading import LambertMaterial
from aspose.threed.utilities import Vector3, Vector4

scene = Scene()

# Build a simple triangle mesh
mesh = Mesh()
mesh.control_points.append(Vector4(0, 0, 0, 1))
mesh.control_points.append(Vector4(1, 0, 0, 1))
mesh.control_points.append(Vector4(0.5, 1, 0, 1))
mesh.create_polygon(0, 1, 2)

# Create a matte red material
mat = LambertMaterial("red-matte")
mat.diffuse_color = Vector3(0.8, 0.1, 0.1)    # R, G, B in [0, 1]
mat.ambient_color = Vector3(0.1, 0.05, 0.05)

node = scene.root_node.create_child_node("triangle", mesh)
node.material = mat

scene.save("lambert.obj")

Phong Parlak Malzeme

from aspose.threed import Scene
from aspose.threed.entities import Mesh
from aspose.threed.shading import PhongMaterial
from aspose.threed.utilities import Vector3, Vector4

scene = Scene()

mesh = Mesh()
mesh.control_points.append(Vector4(0, 0, 0, 1))
mesh.control_points.append(Vector4(1, 0, 0, 1))
mesh.control_points.append(Vector4(0.5, 1, 0, 1))
mesh.create_polygon(0, 1, 2)

mat = PhongMaterial("shiny-blue")
mat.diffuse_color = Vector3(0.1, 0.2, 0.8)   # blue
mat.specular_color = Vector3(1.0, 1.0, 1.0)  # white highlights
mat.specular_factor = 0.5
mat.shininess = 64.0                           # tight specular lobe
mat.ambient_color = Vector3(0.05, 0.05, 0.1)

node = scene.root_node.create_child_node("mesh", mesh)
node.material = mat

scene.save("phong.obj")

Yarı Şeffaf Malzeme

from aspose.threed.shading import LambertMaterial
from aspose.threed.utilities import Vector3

mat = LambertMaterial("glass")
mat.diffuse_color = Vector3(0.7, 0.9, 1.0)   # faint blue tint
mat.transparency = 0.7                         # 70% transparent

İçe Aktarılan Sahneden Malzeme Oku

from aspose.threed import Scene
from aspose.threed.shading import LambertMaterial, PhongMaterial

scene = Scene()
scene.open("model.obj")

def inspect_node(node):
    if node.material:
        m = node.material
        kind = "Phong" if isinstance(m, PhongMaterial) else "Lambert"
        print(f"Node '{node.name}': {kind}: diffuse={m.diffuse_color}")
        if isinstance(m, PhongMaterial):
            print(f"  shininess={m.shininess}")
    for child in node.child_nodes:
        inspect_node(child)

inspect_node(scene.root_node)

PbrMaterial

class PbrMaterial(Material):

A3DObject → Material → PbrMaterial

PBR (Fiziksel Tabanlı Render) malzemesi. glTF 2.0 ve diğer PBR‑uyumlu formatlar tarafından kullanılır. Birine atanır Node aracılığıyla node.material.

PbrMaterial(name: str = None, albedo: Vector3 = None)


`albedo`	`Vector3	None`
`albedo_texture`	herhangi	Albedo kanalının doku haritası.
`normal_texture`	herhangi	Normal harita dokusu.
`metallic_factor`	`float`	Metalik katkı: `0.0` = tamamen dielektrik, `1.0` = tamamen metalik.
`roughness_factor`	`float`	Yüzey pürüzlülüğü: `0.0` = pürüzsüz/ayna, `1.0` = tamamen pürüzlü.
`metallic_roughness`	herhangi	Birleştirilmiş metallic-roughness dokusu (glTF konvansiyonu: B=metallic, G=roughness).
`occlusion_texture`	herhangi	Ambient occlusion dokusu.
`occlusion_factor`	`float`	ambient occlusion etkisinin gücü.
`emissive_texture`	herhangi	Kendiliğinden aydınlatılmış bölgeler için Emissive doku.
`emissive_color`	`Vector3	None`
`transparency`	`float`	Opaklık seviyesi: `0.0` = tamamen opak, `1.0` = tamamen şeffaf.

Sınıf Metodu

	Dönüş Tipi
`PbrMaterial.from_material(material)`	`PbrMaterial`	Birini dönüştürür `LambertMaterial` veya `PhongMaterial` bir `PbrMaterial` yaklaşım.

Kullanım Örneği

from aspose.threed import Scene
from aspose.threed.entities import Mesh
from aspose.threed.shading import PbrMaterial
from aspose.threed.utilities import Vector3, Vector4

scene = Scene()

mesh = Mesh()
mesh.control_points.append(Vector4(0, 0, 0, 1))
mesh.control_points.append(Vector4(1, 0, 0, 1))
mesh.control_points.append(Vector4(0.5, 1, 0, 1))
mesh.create_polygon(0, 1, 2)

mat = PbrMaterial("pbr-metal")
mat.albedo = Vector3(0.8, 0.6, 0.2)    # gold-ish base color
mat.metallic_factor = 0.9
mat.roughness_factor = 0.2

node = scene.root_node.create_child_node("mesh", mesh)
node.material = mat

scene.save("pbr.glb")