Aspose.3D FOSS
TypeScript
Material

Material

Пакет: @aspose/3d (v24.12.0)

@aspose/3d поставляє три конкретні класи матеріалів, які розширюють абстрактний Material базовий. Вони охоплюють три моделі затінення, які найчастіше зустрічаються у форматах обміну 3D:

  • LambertMaterial — дифузний + навколишній + емісивний (використовується в OBJ/MTL та старіших FBX ресурсах)
  • PhongMaterial — розширює Lambert властивостями спекулярного підсвічування
  • PbrMaterial — фізично‑основана модель, що відповідає визначенню матеріалу glTF 2.0

Усі класи матеріалів експортуються з головного @aspose/3d точки входу.

import { LambertMaterial, PhongMaterial, PbrMaterial } from '@aspose/3d';

Клас Material (абстрактна база)

Material є абстрактним базовим класом для всіх матеріалів. Він розширює A3DObject, надаючи name властивість та API слоту текстури.

export class Material extends A3DObject

Enumerations

NameTypeAccessDescription
MAP_SPECULAR``ReadGets the map specular.
MAP_DIFFUSE``ReadGets the map diffuse.
MAP_EMISSIVE``ReadGets the map emissive.
MAP_AMBIENT``ReadGets the map ambient.
MAP_NORMAL``ReadGets the map normal.

Enumerations

getTexture(slotName)

Повертає TextureBase призначений до іменованого слоту, або null якщо жодного не було призначено.

getTexture(slotName: string): TextureBase | null

setTexture(slotName, texture)

Призначає TextureBase екземпляр у названий слот.

setTexture(slotName: string, texture: TextureBase): void

Клас LambertMaterial

LambertMaterial моделює дифузне відбиття з необов’язковими внесками навколишнього та емісійного світла. Це тип матеріалу, який зазвичай створюється при завантаженні OBJ‑файлів за допомогою .mtl бібліотек.

export class LambertMaterial extends Material

Enumerations

A3DObject ← Material ← LambertMaterial

Enumerations

Призначте червоний дифузний матеріал вузлу.

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

SignatureDescription
`constructor(name: stringnull)`
getTexture(_slotName: string) → `TextureBasenull`
setTexture(_slotName: string, _texture: TextureBase)Sets the texture value.

Клас PhongMaterial

PhongMaterial розширює LambertMaterial з підтримкою спекулярних підсвічувань, реалізуючи класичну модель затінення Phong. Це поширено в активі FBX та COLLADA.

export class PhongMaterial extends LambertMaterial

Enumerations

A3DObject ← Material ← LambertMaterial ← PhongMaterial

Enumerations

Створіть блискучий синій Phong-матеріал.

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

Клас PbrMaterial

PbrMaterial реалізує модель PBR metallic-roughness glTF 2.0. Використовуйте цей клас для сцен, які будуть збережені як glTF/GLB, або коли вихідний ресурс FBX містить PBR‑матеріали.

export class PbrMaterial extends Material

Enumerations

A3DObject ← Material ← PbrMaterial

Enumerations

Створіть золотий PBR-матеріал і збережіть його у файлі glTF.

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

Статичні методи

PbrMaterial.fromMaterial(material)

Створює новий PbrMaterial з загального Material екземпляр, копіюючи the name.

static fromMaterial(material: Material): PbrMaterial
 Українська