Materials — LambertMaterial, PhongMaterial, PbrMaterial
Paket: @aspose/3d (v24.12.0)
@aspose/3d soyut sınıfı genişleten üç somut malzeme sınıfı sunar Material temel. 3D değişim formatlarında en yaygın bulunan üç gölgelendirme modelini kapsarlar:
LambertMaterial— diffuse + ambient + emissive (OBJ/MTL ve eski FBX varlıkları tarafından kullanılır)PhongMaterial— Lambert’ı speküler vurgulama özellikleriyle genişletirPbrMaterial— glTF 2.0 malzeme tanımına uyan fiziksel temelli model
Tüm malzeme sınıfları ana @aspose/3d giriş noktasından dışa aktarılır.
import { LambertMaterial, PhongMaterial, PbrMaterial } from '@aspose/3d';Sınıf Material (soyut temel)
Material tüm malzemeler için soyut temel sınıftır. Şunu genişletir A3DObject, şu özelliği sağlayarak name özelliği ve doku yuvası API’sini.
export class Material extends A3DObjectEnumerations
| Enumerations | Enumerations | Enumerations |
|---|---|---|
name | string | Sahne grafiğinde ve dışa aktarma çıktısında göründüğü gibi malzeme adı. |
Enumerations
getTexture(slotName)
Belirtilen TextureBase adlandırılmış yuvaya atanmış olanı döndürür, ya da null eğer hiçbiri atanmadıysa.
getTexture(slotName: string): TextureBase | nullsetTexture(slotName, texture)
Atar bir TextureBase örneği adlandırılmış yuvaya.
setTexture(slotName: string, texture: TextureBase): voidSınıf LambertMaterial
LambertMaterial opsiyonel ortam ve ışınım katkılarıyla difüz yansımayı modeller. OBJ dosyaları yüklenirken yaygın olarak üretilen malzeme tipidir with .mtl kütüphaneler.
export class LambertMaterial extends MaterialEnumerations
A3DObject ← Material ← LambertMaterial
Enumerations
Bir düğüme kırmızı difüz malzeme ata.
import { Scene, LambertMaterial } from '@aspose/3d';
import { Vector3 } from '@aspose/3d/utilities';
const scene = new Scene();
scene.open('model.obj');
const mat = new LambertMaterial('RedSurface');
mat.diffuseColor = new Vector3(1, 0, 0); // R=1, G=0, B=0
mat.ambientColor = new Vector3(0.1, 0, 0);
mat.transparency = 0;
// Assign material to the first child node's entity
const firstNode = scene.rootNode.childNodes[0];
if (firstNode && firstNode.entity) {
(firstNode.entity as any).material = mat;
}
scene.save('output.fbx');Enumerations
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
diffuseColor | `Vector3 | null` | null |
ambientColor | `Vector3 | null` | null |
emissiveColor | `Vector3 | null` | null |
transparentColor | `Vector3 | null` | null |
transparency | number | 0.0 | Opaklık faktörü 0.0 (tamamen opak) ile 1.0 (tamamen şeffaf) arasında. Otomatik olarak sınırlanır. |
Sınıf PhongMaterial
PhongMaterial genişletir LambertMaterial specular vurgulama desteğiyle, klasik Phong gölgelendirme modelini uygular. FBX ve COLLADA varlıklarında yaygındır.
export class PhongMaterial extends LambertMaterialEnumerations
A3DObject ← Material ← LambertMaterial ← PhongMaterial
Enumerations
Parlak mavi bir Phong malzeme oluştur.
import { PhongMaterial } from '@aspose/3d';
import { Vector3 } from '@aspose/3d/utilities';
const mat = new PhongMaterial('ShinyBlue');
mat.diffuseColor = new Vector3(0, 0.2, 0.8);
mat.specularColor = new Vector3(1, 1, 1);
mat.shininess = 64;
mat.specularFactor = 0.8;
console.log(`Shininess: ${mat.shininess}`); // Shininess: 64
Enumerations
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
specularColor | `Vector3 | null` | null |
specularFactor | number | 0.0 | Specular katkı için skaler çarpan. |
shininess | number | 0.0 | Phong parlaklık üssü — daha yüksek değerler daha dar vurgular üretir. |
reflectionColor | `Vector3 | null` | null |
reflectionFactor | number | 0.0 | Yansıma katkısı için skaler çarpan. |
Sınıf PbrMaterial
PbrMaterial glTF 2.0 metalik-çözünürlük PBR modelini uygular. Bu sınıfı glTF/GLB olarak kaydedilecek sahneler için veya kaynak FBX varlığında PBR malzemeleri bulunduğunda kullanın.
export class PbrMaterial extends MaterialEnumerations
A3DObject ← Material ← PbrMaterial
Enumerations
Altın bir PBR malzeme oluştur ve bir glTF dosyasına kaydet.
import { Scene, PbrMaterial } from '@aspose/3d';
import { Vector3 } from '@aspose/3d/utilities';
import { GltfSaveOptions } from '@aspose/3d/formats/gltf';
const scene = new Scene();
scene.open('base-mesh.obj');
const gold = new PbrMaterial('Gold');
gold.albedo = new Vector3(1.0, 0.766, 0.336); // gold base color
gold.metallicFactor = 1.0;
gold.roughnessFactor = 0.3;
// Attach material to the first mesh node
const meshNode = scene.rootNode.childNodes[0];
if (meshNode && meshNode.entity) {
(meshNode.entity as any).material = gold;
}
const opts = new GltfSaveOptions();
opts.binaryMode = true;
scene.save('gold-model.glb', opts);Enumerations
| Enumerations | Enumerations | Enumerations | Enumerations |
|---|---|---|---|
albedo | `Vector3 | null` | null |
albedoTexture | `TextureBase | null` | null |
normalTexture | `TextureBase | null` | null |
metallicFactor | number | 0.0 | Metalik faktör 0–1 aralığında. 1.0 = tamamen metalik. |
roughnessFactor | number | 0.0 | Pürüzlülük faktörü 0–1 aralığında. 0.0 = ayna-düzgün. |
metallicRoughness | `TextureBase | null` | null |
occlusionTexture | `TextureBase | null` | null |
occlusionFactor | number | 0.0 | Ortam örtülme etkisinin gücü. |
emissiveColor | `Vector3 | null` | null |
emissiveTexture | `TextureBase | null` | null |
transparency | number | 0.0 | Saydamlık faktörü 0–1 aralığında. Otomatik olarak sınırlanır. |
Statik Yöntemler
PbrMaterial.fromMaterial(material)
Yeni bir şey oluşturur PbrMaterial genel bir Material örnek, kopyalayarak the name.
static fromMaterial(material: Material): PbrMaterial