@vyr/three 0.0.33 → 0.0.36

package/build/descriptor/light/HemisphereLight.d.ts

@@ -0,0 +1,21 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+import { Light } from "./Light";
+/**
+ * HemisphereLight类
+ * 半球光类
+ *
+ * 作用：创建和管理半球光实例，用于模拟天空光和地面反射光
+ */
+export declare class HemisphereLight extends Node implements Light {
+    /**类类型标识 */
+    static type: string;
+    /**光源标识 */
+    readonly isLight = true;
+    /**天空颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string;
+    /**光源强度 @default 1 */
+    intensity: number;
+    /**地面颜色，使用十六进制颜色值 @default "#ffffff" */
+    groundColor: string;
+    constructor(descriptor?: Partial<DeserializationObject<HemisphereLight>>);
+}

package/build/descriptor/light/HemisphereLight.js

@@ -0,0 +1,27 @@
+import { Node } from "@vyr/engine";
+/**
+ * HemisphereLight类
+ * 半球光类
+ *
+ * 作用：创建和管理半球光实例，用于模拟天空光和地面反射光
+ */
+export class HemisphereLight extends Node {
+    /**类类型标识 */
+    static type = 'HemisphereLight';
+    /**光源标识 */
+    isLight = true;
+    /**天空颜色，使用十六进制颜色值 @default "#ffffff" */
+    color;
+    /**光源强度 @default 1 */
+    intensity;
+    /**地面颜色，使用十六进制颜色值 @default "#ffffff" */
+    groundColor;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.color = descriptor.color ?? '#ffffff';
+        this.intensity = descriptor.intensity ?? 1;
+        this.groundColor = descriptor.groundColor ?? '#ffffff';
+    }
+}
+Node.register(HemisphereLight);
+//# sourceMappingURL=HemisphereLight.js.map

package/build/descriptor/light/HemisphereLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"HemisphereLight.js","sourceRoot":"","sources":["../../../src/descriptor/light/HemisphereLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;GAKG;AACH,MAAM,OAAO,eAAgB,SAAQ,IAAI;IACrC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,iBAAiB,CAAA;IAC/B,UAAU;IACD,OAAO,GAAG,IAAI,CAAA;IACvB,uCAAuC;IACvC,KAAK,CAAQ;IACb,qBAAqB;IACrB,SAAS,CAAQ;IACjB,uCAAuC;IACvC,WAAW,CAAQ;IAEnB,YAAY,aAA8D,EAAE;QACxE,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,SAAS,CAAA;QAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,WAAW,GAAG,UAAU,CAAC,WAAW,IAAI,SAAS,CAAA;IAC1D,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,CAAA"}

package/build/descriptor/light/Light.d.ts

@@ -0,0 +1,15 @@
+import { Node } from "@vyr/engine";
+/**
+ * Light接口
+ * 光源接口
+ *
+ * 作用：定义光源的基本属性，所有光源类都应实现此接口
+ */
+export interface Light extends Node {
+    /**光源标识，用于标识对象是否为光源 */
+    readonly isLight: boolean;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string;
+    /**光源强度 @default 1 */
+    intensity: number;
+}

package/build/descriptor/light/Light.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=Light.js.map

package/build/descriptor/light/Light.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Light.js","sourceRoot":"","sources":["../../../src/descriptor/light/Light.ts"],"names":[],"mappings":""}

package/build/descriptor/light/PointLight.d.ts

@@ -0,0 +1,32 @@
+import { DeserializationObject, Node, Vector2 } from "@vyr/engine";
+import { Light } from "./Light";
+/**
+ * PointLight类
+ * 点光源类
+ *
+ * 作用：创建和管理点光源实例，用于提供从一点向各个方向发射的照明
+ */
+export declare class PointLight extends Node implements Light {
+    /**类类型标识 */
+    static type: string;
+    /**光源标识 */
+    readonly isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string;
+    /**光源强度 @default 1 */
+    intensity: number;
+    /**光源照射距离，0表示无限远 @default 0 */
+    distance: number;
+    /**光源衰减指数 @default 2 */
+    decay: number;
+    /**光源功率 @default 1 */
+    power: number;
+    /**阴影贴图尺寸 @default {x:512, y:512} */
+    mapSize: Vector2;
+    /**点光源相机参数 @default { near: 0.5, far: 500 } */
+    camera: {
+        near: number;
+        far: number;
+    };
+    constructor(descriptor?: Partial<DeserializationObject<PointLight>>);
+}

package/build/descriptor/light/PointLight.js

@@ -0,0 +1,39 @@
+import { Descriptor, Node, Vector2 } from "@vyr/engine";
+/**
+ * PointLight类
+ * 点光源类
+ *
+ * 作用：创建和管理点光源实例，用于提供从一点向各个方向发射的照明
+ */
+export class PointLight extends Node {
+    /**类类型标识 */
+    static type = 'PointLight';
+    /**光源标识 */
+    isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color;
+    /**光源强度 @default 1 */
+    intensity;
+    /**光源照射距离，0表示无限远 @default 0 */
+    distance;
+    /**光源衰减指数 @default 2 */
+    decay;
+    /**光源功率 @default 1 */
+    power;
+    /**阴影贴图尺寸 @default {x:512, y:512} */
+    mapSize;
+    /**点光源相机参数 @default { near: 0.5, far: 500 } */
+    camera;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.color = descriptor.color ?? '#ffffff';
+        this.intensity = descriptor.intensity ?? 1;
+        this.distance = descriptor.distance ?? 0;
+        this.decay = descriptor.decay ?? 2;
+        this.power = descriptor.power ?? 1;
+        this.mapSize = descriptor.mapSize ? Vector2.create(descriptor.mapSize) : Vector2.create(512, 512);
+        this.camera = descriptor.camera ? Descriptor.deepClone(descriptor.camera) : { near: 0.5, far: 500 };
+    }
+}
+Node.register(PointLight);
+//# sourceMappingURL=PointLight.js.map

package/build/descriptor/light/PointLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PointLight.js","sourceRoot":"","sources":["../../../src/descriptor/light/PointLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG/E;;;;;GAKG;AACH,MAAM,OAAO,UAAW,SAAQ,IAAI;IAChC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,YAAY,CAAA;IAC1B,UAAU;IACD,OAAO,GAAG,IAAI,CAAA;IACvB,uCAAuC;IACvC,KAAK,CAAQ;IACb,qBAAqB;IACrB,SAAS,CAAQ;IACjB,8BAA8B;IAC9B,QAAQ,CAAQ;IAChB,uBAAuB;IACvB,KAAK,CAAQ;IACb,qBAAqB;IACrB,KAAK,CAAQ;IACb,oCAAoC;IACpC,OAAO,CAAS;IAChB,8CAA8C;IAC9C,MAAM,CAA+B;IAErC,YAAY,aAAyD,EAAE;QACnE,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,SAAS,CAAA;QAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACjG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACvG,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAA"}

package/build/descriptor/light/RectAreaLight.d.ts

@@ -0,0 +1,25 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+import { Light } from "./Light";
+/**
+ * RectAreaLight类
+ * 矩形区域光类
+ *
+ * 作用：创建和管理矩形区域光实例，用于提供面光源照明
+ */
+export declare class RectAreaLight extends Node implements Light {
+    /**类类型标识 */
+    static type: string;
+    /**光源标识 */
+    readonly isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string;
+    /**光源强度 @default 1 */
+    intensity: number;
+    /**光源宽度 @default 10 */
+    width: number;
+    /**光源高度 @default 10 */
+    height: number;
+    /**光源功率 @default 1 */
+    power: number;
+    constructor(descriptor?: Partial<DeserializationObject<RectAreaLight>>);
+}

package/build/descriptor/light/RectAreaLight.js

@@ -0,0 +1,33 @@
+import { Node } from "@vyr/engine";
+/**
+ * RectAreaLight类
+ * 矩形区域光类
+ *
+ * 作用：创建和管理矩形区域光实例，用于提供面光源照明
+ */
+export class RectAreaLight extends Node {
+    /**类类型标识 */
+    static type = 'RectAreaLight';
+    /**光源标识 */
+    isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color;
+    /**光源强度 @default 1 */
+    intensity;
+    /**光源宽度 @default 10 */
+    width;
+    /**光源高度 @default 10 */
+    height;
+    /**光源功率 @default 1 */
+    power;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.color = descriptor.color ?? '#ffffff';
+        this.intensity = descriptor.intensity ?? 1;
+        this.width = descriptor.width ?? 10;
+        this.height = descriptor.height ?? 10;
+        this.power = descriptor.power ?? 1;
+    }
+}
+Node.register(RectAreaLight);
+//# sourceMappingURL=RectAreaLight.js.map

package/build/descriptor/light/RectAreaLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RectAreaLight.js","sourceRoot":"","sources":["../../../src/descriptor/light/RectAreaLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,IAAI,EAAE,MAAM,aAAa,CAAC;AAG1D;;;;;GAKG;AACH,MAAM,OAAO,aAAc,SAAQ,IAAI;IACnC,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,eAAe,CAAA;IAC7B,UAAU;IACD,OAAO,GAAG,IAAI,CAAA;IACvB,uCAAuC;IACvC,KAAK,CAAQ;IACb,qBAAqB;IACrB,SAAS,CAAQ;IACjB,sBAAsB;IACtB,KAAK,CAAQ;IACb,sBAAsB;IACtB,MAAM,CAAQ;IACd,qBAAqB;IACrB,KAAK,CAAQ;IAEb,YAAY,aAA4D,EAAE;QACtE,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,SAAS,CAAA;QAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,EAAE,CAAA;QACnC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAA;QACrC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;IACtC,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,aAAa,CAAC,CAAA"}

package/build/descriptor/light/SpotLight.d.ts

@@ -0,0 +1,38 @@
+import { DeserializationObject, Node, Vector2 } from "@vyr/engine";
+import { Light } from "./Light";
+/**
+ * SpotLight类
+ * 聚光灯类
+ *
+ * 作用：创建和管理聚光灯实例，用于提供方向性的锥形照明
+ */
+export declare class SpotLight extends Node implements Light {
+    /**类类型标识 */
+    static type: string;
+    /**光源标识 */
+    readonly isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color: string;
+    /**光源强度 @default 1 */
+    intensity: number;
+    /**聚光角度（弧度） @default Math.PI / 3 */
+    angle: number;
+    /**光源衰减指数 @default 2 */
+    decay: number;
+    /**光源照射距离，0表示无限远 @default 0 */
+    distance: number;
+    /**半影系数 @default 0 */
+    penumbra: number;
+    /**光源功率 @default 1 */
+    power: number;
+    /**光源目标引用 @default "" */
+    target: string;
+    /**阴影贴图尺寸 @default {x:512, y:512} */
+    mapSize: Vector2;
+    /**聚光灯相机参数 @default { near: 0.5, far: 500 } */
+    camera: {
+        near: number;
+        far: number;
+    };
+    constructor(descriptor?: Partial<DeserializationObject<SpotLight>>);
+}

package/build/descriptor/light/SpotLight.js

@@ -0,0 +1,48 @@
+import { Descriptor, Node, Vector2 } from "@vyr/engine";
+/**
+ * SpotLight类
+ * 聚光灯类
+ *
+ * 作用：创建和管理聚光灯实例，用于提供方向性的锥形照明
+ */
+export class SpotLight extends Node {
+    /**类类型标识 */
+    static type = 'SpotLight';
+    /**光源标识 */
+    isLight = true;
+    /**光源颜色，使用十六进制颜色值 @default "#ffffff" */
+    color;
+    /**光源强度 @default 1 */
+    intensity;
+    /**聚光角度（弧度） @default Math.PI / 3 */
+    angle;
+    /**光源衰减指数 @default 2 */
+    decay;
+    /**光源照射距离，0表示无限远 @default 0 */
+    distance;
+    /**半影系数 @default 0 */
+    penumbra;
+    /**光源功率 @default 1 */
+    power;
+    /**光源目标引用 @default "" */
+    target;
+    /**阴影贴图尺寸 @default {x:512, y:512} */
+    mapSize;
+    /**聚光灯相机参数 @default { near: 0.5, far: 500 } */
+    camera;
+    constructor(descriptor = {}) {
+        super(descriptor);
+        this.color = descriptor.color ?? '#ffffff';
+        this.intensity = descriptor.intensity ?? 1;
+        this.angle = descriptor.angle ?? Math.PI / 3;
+        this.decay = descriptor.decay ?? 2;
+        this.distance = descriptor.distance ?? 0;
+        this.penumbra = descriptor.penumbra ?? 0;
+        this.power = descriptor.power ?? 1;
+        this.target = descriptor.target ?? '';
+        this.mapSize = descriptor.mapSize ? Vector2.create(descriptor.mapSize) : Vector2.create(512, 512);
+        this.camera = descriptor.camera ? Descriptor.deepClone(descriptor.camera) : { near: 0.5, far: 500 };
+    }
+}
+Node.register(SpotLight);
+//# sourceMappingURL=SpotLight.js.map

package/build/descriptor/light/SpotLight.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SpotLight.js","sourceRoot":"","sources":["../../../src/descriptor/light/SpotLight.ts"],"names":[],"mappings":"AAAA,OAAO,EAAyB,UAAU,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAG/E;;;;;GAKG;AACH,MAAM,OAAO,SAAU,SAAQ,IAAI;IAC/B,WAAW;IACX,MAAM,CAAC,IAAI,GAAG,WAAW,CAAA;IACzB,UAAU;IACD,OAAO,GAAG,IAAI,CAAA;IACvB,uCAAuC;IACvC,KAAK,CAAQ;IACb,qBAAqB;IACrB,SAAS,CAAQ;IACjB,mCAAmC;IACnC,KAAK,CAAQ;IACb,uBAAuB;IACvB,KAAK,CAAQ;IACb,8BAA8B;IAC9B,QAAQ,CAAQ;IAChB,qBAAqB;IACrB,QAAQ,CAAQ;IAChB,qBAAqB;IACrB,KAAK,CAAQ;IACb,wBAAwB;IACxB,MAAM,CAAQ;IACd,oCAAoC;IACpC,OAAO,CAAS;IAChB,8CAA8C;IAC9C,MAAM,CAA+B;IAErC,YAAY,aAAwD,EAAE;QAClE,KAAK,CAAC,UAAU,CAAC,CAAA;QACjB,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,SAAS,CAAA;QAC1C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,CAAC,CAAA;QAC1C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,IAAI,CAAC,EAAE,GAAG,CAAC,CAAA;QAC5C,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,CAAC,CAAA;QACxC,IAAI,CAAC,KAAK,GAAG,UAAU,CAAC,KAAK,IAAI,CAAC,CAAA;QAClC,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,IAAI,EAAE,CAAA;QACrC,IAAI,CAAC,OAAO,GAAG,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;QACjG,IAAI,CAAC,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAA;IACvG,CAAC;;AAEL,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAA"}

package/build/descriptor/material/Material.d.ts

@@ -0,0 +1,109 @@
+import { Descriptor } from '@vyr/engine';
+/**
+ * MaterialSide枚举
+ * 材质面枚举
+ *
+ * 作用：定义材质的渲染面
+ */
+export declare enum MaterialSide {
+    /**正面 */
+    FrontSide = 0,
+    /**背面 */
+    BackSide = 1,
+    /**双面 */
+    DoubleSide = 2
+}
+/**
+ * MaterialDepthFunc枚举
+ * 材质深度函数枚举
+ *
+ * 作用：定义深度测试的比较函数
+ */
+export declare enum MaterialDepthFunc {
+    /**从不通过 */
+    NeverDepth = 0,
+    /**始终通过 */
+    AlwaysDepth = 1,
+    /**小于时通过 */
+    LessDepth = 2,
+    /**小于等于时通过 */
+    LessEqualDepth = 3,
+    /**大于等于时通过 */
+    GreaterEqualDepth = 5,
+    /**大于时通过 */
+    GreaterDepth = 6,
+    /**不等于时通过 */
+    NotEqualDepth = 7
+}
+/**
+ * MaterialDlending枚举
+ * 材质混合模式枚举
+ *
+ * 作用：定义材质的颜色混合模式
+ */
+export declare enum MaterialDlending {
+    /**无混合 */
+    NoBlending = 0,
+    /**正常混合 */
+    NormalBlending = 1,
+    /** additive混合 */
+    AdditiveBlending = 2,
+    /** 减法混合 */
+    SubtractiveBlending = 3,
+    /** 乘法混合 */
+    MultiplyBlending = 4
+}
+/**
+ * MaterialCombine枚举
+ * 材质组合模式枚举
+ *
+ * 作用：定义材质属性的组合方式
+ */
+export declare enum MaterialCombine {
+    /**乘法操作 */
+    MultiplyOperation = 0,
+    /**混合操作 */
+    MixOperation = 1,
+    /**加法操作 */
+    AddOperation = 2
+}
+/**
+ * MaterialNormalMapType枚举
+ * 材质法线贴图类型枚举
+ *
+ * 作用：定义法线贴图的坐标空间
+ */
+export declare enum MaterialNormalMapType {
+    /**切线空间法线贴图 */
+    TangentSpaceNormalMap = 0,
+    /**对象空间法线贴图 */
+    ObjectSpaceNormalMap = 1
+}
+/**
+ * Material接口
+ * 材质接口
+ *
+ * 作用：定义材质的基本属性，所有材质类都应实现此接口
+ */
+export interface Material extends Descriptor {
+    /**透明度测试阈值 @default 0 */
+    alphaTest: number;
+    /**材质是否透明 @default false */
+    transparent: boolean;
+    /**材质渲染面 @default MaterialSide.FrontSide */
+    side: MaterialSide;
+    /**是否渲染材质的颜色 @default true */
+    colorWrite: boolean;
+    /**是否启用深度测试 @default true */
+    depthTest: boolean;
+    /**是否写入深度 @default true */
+    depthWrite: boolean;
+    /**深度函数 @default MaterialDepthFunc.LessEqualDepth */
+    depthFunc: MaterialDepthFunc;
+    /**混合模式，混合效果见 https://threejs.org/examples/#webgl_materials_blending @default MaterialDlending.NormalBlending */
+    blending: MaterialDlending;
+    /**是否使用顶点着色 @default false */
+    vertexColors: boolean;
+    /**材质标识，用于标识对象是否为材质 */
+    isMaterial: true;
+}

package/build/descriptor/material/Material.js

@@ -0,0 +1,86 @@
+/**
+ * MaterialSide枚举
+ * 材质面枚举
+ *
+ * 作用：定义材质的渲染面
+ */
+export var MaterialSide;
+(function (MaterialSide) {
+    /**正面 */
+    MaterialSide[MaterialSide["FrontSide"] = 0] = "FrontSide";
+    /**背面 */
+    MaterialSide[MaterialSide["BackSide"] = 1] = "BackSide";
+    /**双面 */
+    MaterialSide[MaterialSide["DoubleSide"] = 2] = "DoubleSide";
+})(MaterialSide || (MaterialSide = {}));
+/**
+ * MaterialDepthFunc枚举
+ * 材质深度函数枚举
+ *
+ * 作用：定义深度测试的比较函数
+ */
+export var MaterialDepthFunc;
+(function (MaterialDepthFunc) {
+    /**从不通过 */
+    MaterialDepthFunc[MaterialDepthFunc["NeverDepth"] = 0] = "NeverDepth";
+    /**始终通过 */
+    MaterialDepthFunc[MaterialDepthFunc["AlwaysDepth"] = 1] = "AlwaysDepth";
+    /**小于时通过 */
+    MaterialDepthFunc[MaterialDepthFunc["LessDepth"] = 2] = "LessDepth";
+    /**小于等于时通过 */
+    MaterialDepthFunc[MaterialDepthFunc["LessEqualDepth"] = 3] = "LessEqualDepth";
+    /**大于等于时通过 */
+    MaterialDepthFunc[MaterialDepthFunc["GreaterEqualDepth"] = 5] = "GreaterEqualDepth";
+    /**大于时通过 */
+    MaterialDepthFunc[MaterialDepthFunc["GreaterDepth"] = 6] = "GreaterDepth";
+    /**不等于时通过 */
+    MaterialDepthFunc[MaterialDepthFunc["NotEqualDepth"] = 7] = "NotEqualDepth";
+})(MaterialDepthFunc || (MaterialDepthFunc = {}));
+/**
+ * MaterialDlending枚举
+ * 材质混合模式枚举
+ *
+ * 作用：定义材质的颜色混合模式
+ */
+export var MaterialDlending;
+(function (MaterialDlending) {
+    /**无混合 */
+    MaterialDlending[MaterialDlending["NoBlending"] = 0] = "NoBlending";
+    /**正常混合 */
+    MaterialDlending[MaterialDlending["NormalBlending"] = 1] = "NormalBlending";
+    /** additive混合 */
+    MaterialDlending[MaterialDlending["AdditiveBlending"] = 2] = "AdditiveBlending";
+    /** 减法混合 */
+    MaterialDlending[MaterialDlending["SubtractiveBlending"] = 3] = "SubtractiveBlending";
+    /** 乘法混合 */
+    MaterialDlending[MaterialDlending["MultiplyBlending"] = 4] = "MultiplyBlending";
+})(MaterialDlending || (MaterialDlending = {}));
+/**
+ * MaterialCombine枚举
+ * 材质组合模式枚举
+ *
+ * 作用：定义材质属性的组合方式
+ */
+export var MaterialCombine;
+(function (MaterialCombine) {
+    /**乘法操作 */
+    MaterialCombine[MaterialCombine["MultiplyOperation"] = 0] = "MultiplyOperation";
+    /**混合操作 */
+    MaterialCombine[MaterialCombine["MixOperation"] = 1] = "MixOperation";
+    /**加法操作 */
+    MaterialCombine[MaterialCombine["AddOperation"] = 2] = "AddOperation";
+})(MaterialCombine || (MaterialCombine = {}));
+/**
+ * MaterialNormalMapType枚举
+ * 材质法线贴图类型枚举
+ *
+ * 作用：定义法线贴图的坐标空间
+ */
+export var MaterialNormalMapType;
+(function (MaterialNormalMapType) {
+    /**切线空间法线贴图 */
+    MaterialNormalMapType[MaterialNormalMapType["TangentSpaceNormalMap"] = 0] = "TangentSpaceNormalMap";
+    /**对象空间法线贴图 */
+    MaterialNormalMapType[MaterialNormalMapType["ObjectSpaceNormalMap"] = 1] = "ObjectSpaceNormalMap";
+})(MaterialNormalMapType || (MaterialNormalMapType = {}));
+//# sourceMappingURL=Material.js.map

package/build/descriptor/material/Material.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Material.js","sourceRoot":"","sources":["../../../src/descriptor/material/Material.ts"],"names":[],"mappings":"AAEA;;;;;GAKG;AACH,MAAM,CAAN,IAAY,YAOX;AAPD,WAAY,YAAY;IACpB,QAAQ;IACR,yDAAa,CAAA;IACb,QAAQ;IACR,uDAAY,CAAA;IACZ,QAAQ;IACR,2DAAc,CAAA;AAClB,CAAC,EAPW,YAAY,KAAZ,YAAY,QAOvB;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,iBAeX;AAfD,WAAY,iBAAiB;IACzB,UAAU;IACV,qEAAc,CAAA;IACd,UAAU;IACV,uEAAe,CAAA;IACf,WAAW;IACX,mEAAa,CAAA;IACb,aAAa;IACb,6EAAkB,CAAA;IAClB,aAAa;IACb,mFAAqB,CAAA;IACrB,WAAW;IACX,yEAAgB,CAAA;IAChB,YAAY;IACZ,2EAAiB,CAAA;AACrB,CAAC,EAfW,iBAAiB,KAAjB,iBAAiB,QAe5B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,gBAWX;AAXD,WAAY,gBAAgB;IACxB,SAAS;IACT,mEAAc,CAAA;IACd,UAAU;IACV,2EAAkB,CAAA;IAClB,iBAAiB;IACjB,+EAAoB,CAAA;IACpB,WAAW;IACX,qFAAuB,CAAA;IACvB,WAAW;IACX,+EAAoB,CAAA;AACxB,CAAC,EAXW,gBAAgB,KAAhB,gBAAgB,QAW3B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,eAOX;AAPD,WAAY,eAAe;IACvB,UAAU;IACV,+EAAqB,CAAA;IACrB,UAAU;IACV,qEAAgB,CAAA;IAChB,UAAU;IACV,qEAAgB,CAAA;AACpB,CAAC,EAPW,eAAe,KAAf,eAAe,QAO1B;AAED;;;;;GAKG;AACH,MAAM,CAAN,IAAY,qBAKX;AALD,WAAY,qBAAqB;IAC7B,cAAc;IACd,mGAAyB,CAAA;IACzB,cAAc;IACd,iGAAwB,CAAA;AAC5B,CAAC,EALW,qBAAqB,KAArB,qBAAqB,QAKhC"}

package/build/descriptor/material/MeshBasicMaterial.d.ts

@@ -0,0 +1,69 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine";
+import { MaterialCombine, Material, MaterialSide, MaterialDepthFunc, MaterialDlending } from "./Material";
+/**
+ * MeshBasicMaterial类
+ * 基础网格材质类
+ *
+ * 作用：创建和管理基础网格材质实例，用于基本的无光照渲染
+ */
+export declare class MeshBasicMaterial extends Descriptor implements Material {
+    /**类类型标识 */
+    static type: string;
+    /**材质标识 */
+    readonly isMaterial = true;
+    /**透明度测试阈值 @default 0 */
+    alphaTest: number;
+    /**材质是否透明 @default false */
+    transparent: boolean;
+    /**材质渲染面 @default MaterialSide.FrontSide */
+    side: MaterialSide;
+    /**是否渲染材质的颜色 @default true */
+    colorWrite: boolean;
+    /**是否启用深度测试 @default true */
+    depthTest: boolean;
+    /**是否写入深度 @default true */
+    depthWrite: boolean;
+    /**深度函数 @default MaterialDepthFunc.LessEqualDepth */
+    depthFunc: MaterialDepthFunc;
+    /**混合模式，混合效果见 https://threejs.org/examples/#webgl_materials_blending @default MaterialDlending.NormalBlending */
+    blending: MaterialDlending;
+    /**是否使用顶点着色 @default false */
+    vertexColors: boolean;
+    /**
+     * 漫反射颜色
+     * @default '#ffffff'
+     */
+    color: string;
+    /**
+     * 透明度
+     * @default 1
+     */
+    opacity: number;
+    /**漫反射贴图 @default "" */
+    map: string;
+    /**透明度贴图 @default "" */
+    alphaMap: string;
+    /**表面颜色与环境贴图如何结合 @default MaterialCombine.MultiplyOperation
+     * - 0 它将环境贴图和物体表面颜色进行相乘
+     * - 1 使用反射率来混和两种颜色
+     * - 2 用于对两种颜色进行相加
+     */
+    combine: MaterialCombine;
+    /**环境贴图对表面的影响程度 @default 1 */
+    reflectivity: number;
+    /**空气折射率 @default 0.98 */
+    refractionRatio: number;
+    /**烘焙光的强度 @default 1 */
+    lightMapIntensity: number;
+    /**环境贴图 @default "" */
+    envMap: string;
+    /**光照贴图 @default "" */
+    lightMap: string;
+    /**高光贴图 @default "" */
+    specularMap: string;
+    /**材质是否受雾影响 @default true */
+    fog: boolean;
+    /**将几何体渲染为线框 @default false */
+    wireframe: boolean;
+    constructor(descriptor?: Partial<DeserializationObject<MeshBasicMaterial>>);
+}