@vyr/three 0.0.33 → 0.0.36

package/src/descriptor/light/HemisphereLight.ts

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

package/src/descriptor/light/Light.ts

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

package/src/descriptor/light/PointLight.ts

@@ -0,0 +1,41 @@
+import { DeserializationObject, Descriptor, Node, Vector2 } from "@vyr/engine";
+import { Light } from "./Light";
+
+/**
+ * PointLight类
+ * 点光源类
+ * 
+ * 作用：创建和管理点光源实例，用于提供从一点向各个方向发射的照明
+ */
+export class PointLight extends Node implements Light {
+    /**类类型标识 */
+    static type = 'PointLight'
+    /**光源标识 */
+    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>> = {}) {
+        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)

package/src/descriptor/light/RectAreaLight.ts

@@ -0,0 +1,35 @@
+import { DeserializationObject, Node } from "@vyr/engine";
+import { Light } from "./Light";
+
+/**
+ * RectAreaLight类
+ * 矩形区域光类
+ * 
+ * 作用：创建和管理矩形区域光实例，用于提供面光源照明
+ */
+export class RectAreaLight extends Node implements Light {
+    /**类类型标识 */
+    static type = 'RectAreaLight'
+    /**光源标识 */
+    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>> = {}) {
+        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)

package/src/descriptor/light/SpotLight.ts

@@ -0,0 +1,50 @@
+import { DeserializationObject, Descriptor, Node, Vector2 } from "@vyr/engine";
+import { Light } from "./Light";
+
+/**
+ * SpotLight类
+ * 聚光灯类
+ * 
+ * 作用：创建和管理聚光灯实例，用于提供方向性的锥形照明
+ */
+export class SpotLight extends Node implements Light {
+    /**类类型标识 */
+    static type = 'SpotLight'
+    /**光源标识 */
+    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>> = {}) {
+        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)

package/src/descriptor/material/Material.ts

@@ -0,0 +1,115 @@
+import { Descriptor } from '@vyr/engine'
+
+/**
+ * MaterialSide枚举
+ * 材质面枚举
+ * 
+ * 作用：定义材质的渲染面
+ */
+export enum MaterialSide {
+    /**正面 */
+    FrontSide = 0,
+    /**背面 */
+    BackSide = 1,
+    /**双面 */
+    DoubleSide = 2,
+}
+
+/**
+ * MaterialDepthFunc枚举
+ * 材质深度函数枚举
+ * 
+ * 作用：定义深度测试的比较函数
+ */
+export enum MaterialDepthFunc {
+    /**从不通过 */
+    NeverDepth = 0,
+    /**始终通过 */
+    AlwaysDepth = 1,
+    /**小于时通过 */
+    LessDepth = 2,
+    /**小于等于时通过 */
+    LessEqualDepth = 3,
+    /**大于等于时通过 */
+    GreaterEqualDepth = 5,
+    /**大于时通过 */
+    GreaterDepth = 6,
+    /**不等于时通过 */
+    NotEqualDepth = 7,
+}
+
+/**
+ * MaterialDlending枚举
+ * 材质混合模式枚举
+ * 
+ * 作用：定义材质的颜色混合模式
+ */
+export enum MaterialDlending {
+    /**无混合 */
+    NoBlending = 0,
+    /**正常混合 */
+    NormalBlending = 1,
+    /** additive混合 */
+    AdditiveBlending = 2,
+    /** 减法混合 */
+    SubtractiveBlending = 3,
+    /** 乘法混合 */
+    MultiplyBlending = 4,
+}
+
+/**
+ * MaterialCombine枚举
+ * 材质组合模式枚举
+ * 
+ * 作用：定义材质属性的组合方式
+ */
+export enum MaterialCombine {
+    /**乘法操作 */
+    MultiplyOperation = 0,
+    /**混合操作 */
+    MixOperation = 1,
+    /**加法操作 */
+    AddOperation = 2,
+}
+
+/**
+ * MaterialNormalMapType枚举
+ * 材质法线贴图类型枚举
+ * 
+ * 作用：定义法线贴图的坐标空间
+ */
+export 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/src/descriptor/material/MeshBasicMaterial.ts

@@ -0,0 +1,96 @@
+import { DeserializationObject, Descriptor } from "@vyr/engine"
+import { MaterialCombine, Material, MaterialSide, MaterialDepthFunc, MaterialDlending } from "./Material"
+
+/**
+ * MeshBasicMaterial类
+ * 基础网格材质类
+ * 
+ * 作用：创建和管理基础网格材质实例，用于基本的无光照渲染
+ */
+export class MeshBasicMaterial extends Descriptor implements Material {
+    /**类类型标识 */
+    static type = 'MeshBasicMaterial'
+    /**材质标识 */
+    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>> = {}) {
+        super(descriptor)
+        this.alphaTest = descriptor.alphaTest ?? 0
+        this.transparent = descriptor.transparent ?? false
+        this.side = descriptor.side ?? MaterialSide.FrontSide
+        this.colorWrite = descriptor.colorWrite ?? true
+        this.depthTest = descriptor.depthTest ?? true
+        this.depthWrite = descriptor.depthWrite ?? true
+        this.depthFunc = descriptor.depthFunc ?? MaterialDepthFunc.LessEqualDepth
+        this.blending = descriptor.blending ?? MaterialDlending.NormalBlending
+        this.vertexColors = descriptor.vertexColors ?? false
+        this.color = descriptor.color ? descriptor.color : '#ffffff'
+        this.opacity = descriptor.opacity ?? 1
+        this.map = descriptor.map ?? ''
+        this.alphaMap = descriptor.alphaMap ?? ''
+        this.combine = descriptor.combine ?? MaterialCombine.MultiplyOperation
+        this.reflectivity = descriptor.reflectivity ?? 1
+        this.refractionRatio = descriptor.refractionRatio ?? 0.98
+        this.lightMapIntensity = descriptor.lightMapIntensity ?? 1
+        this.envMap = descriptor.envMap ?? ''
+        this.lightMap = descriptor.lightMap ?? ''
+        this.specularMap = descriptor.specularMap ?? ''
+        this.fog = descriptor.fog ?? true
+        this.wireframe = descriptor.wireframe ?? false
+    }
+}
+Descriptor.register(MeshBasicMaterial)

package/src/descriptor/material/MeshPhongMaterial.ts

@@ -0,0 +1,143 @@
+import {  DeserializationObject, Descriptor, Euler, Vector2 } from "@vyr/engine"
+import { MaterialCombine, Material, MaterialNormalMapType, MaterialSide, MaterialDepthFunc, MaterialDlending } from "./Material"
+
+/**
+ * MeshPhongMaterial类
+ * Phong网格材质类
+ * 
+ * 作用：创建和管理Phong网格材质实例，用于带高光的光照渲染
+ */
+export class MeshPhongMaterial extends Descriptor implements Material {
+    /**类类型标识 */
+    static type = 'MeshPhongMaterial'
+    /**材质标识 */
+    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 */
+    combine: MaterialCombine
+    /**环境贴图对表面的影响程度 @default 1 */
+    reflectivity: number
+    /**空气折射率 @default 0.98 */
+    refractionRatio: number
+    /**环境贴图 @default "" */
+    envMap: string
+    /**光照贴图 @default "" */
+    lightMap: string
+    /**烘焙光的强度 @default 1 */
+    lightMapIntensity: number
+    /**镜面反射贴图 @default "" */
+    specularMap: string
+    /**环境贴图的旋转（以弧度为单位） @default Euler.create() */
+    envMapRotation: Euler
+    /**环境遮挡贴图 @default "" */
+    aoMap: string
+    /**环境遮挡效果的强度 @default 1 */
+    aoMapIntensity: number
+    /**凹凸贴图 @default "" */
+    bumpMap: string
+    /**凹凸贴图强度 @default 1 */
+    bumpScale: number
+    /**位移贴图 @default "" */
+    displacementMap: string
+    /**位移贴图强度 @default 1 */
+    displacementScale: number
+    /**位移贴图偏移量 @default 0 */
+    displacementBias: number
+    /**自发光颜色 @default "#000000" */
+    emissive: string
+    /**自发光贴图 @default "" */
+    emissiveMap: string
+    /**自发光强度 @default 1 */
+    emissiveIntensity: number
+    /**法线贴图 @default "" */
+    normalMap: string
+    /**法线贴图类型 @default MaterialNormalMapType.TangentSpaceNormalMap */
+    normalMapType: MaterialNormalMapType
+    /**法线贴图强度 @default new Vector2(1, 1) */
+    normalScale: Vector2
+    /**高光亮度 @default 30 */
+    shininess: number
+    /**高光颜色 @default "#111111" */
+    specular: string
+    /**是否使用平面着色 @default false */
+    flatShading: boolean
+    /**材质是否受雾影响 @default true */
+    fog: boolean
+    /**将几何体渲染为线框 @default false */
+    wireframe: boolean
+
+    constructor(descriptor: Partial<DeserializationObject<MeshPhongMaterial>> = {}) {
+        super(descriptor)
+        this.alphaTest = descriptor.alphaTest ?? 0
+        this.transparent = descriptor.transparent ?? false
+        this.side = descriptor.side ?? MaterialSide.FrontSide
+        this.colorWrite = descriptor.colorWrite ?? true
+        this.depthTest = descriptor.depthTest ?? true
+        this.depthWrite = descriptor.depthWrite ?? true
+        this.depthFunc = descriptor.depthFunc ?? MaterialDepthFunc.LessEqualDepth
+        this.blending = descriptor.blending ?? MaterialDlending.NormalBlending
+        this.vertexColors = descriptor.vertexColors ?? false
+        this.alphaMap = descriptor.alphaMap ?? ''
+        this.aoMap = descriptor.aoMap ?? ''
+        this.aoMapIntensity = descriptor.aoMapIntensity ?? 1
+        this.bumpMap = descriptor.bumpMap ?? ''
+        this.bumpScale = descriptor.bumpScale ?? 1
+        this.color = descriptor.color ? descriptor.color : '#ffffff'
+        this.opacity = descriptor.opacity ?? 1
+        this.combine = descriptor.combine ?? MaterialCombine.MultiplyOperation
+        this.displacementMap = descriptor.displacementMap ?? ''
+        this.displacementScale = descriptor.displacementScale ?? 1
+        this.displacementBias = descriptor.displacementBias ?? 0
+        this.emissive = descriptor.emissive ?? '#000000'
+        this.emissiveMap = descriptor.emissiveMap ?? ''
+        this.emissiveIntensity = descriptor.emissiveIntensity ?? 1
+        this.envMap = descriptor.envMap ?? ''
+        this.envMapRotation = Euler.create(descriptor.envMapRotation)
+        this.flatShading = descriptor.flatShading ?? false
+        this.lightMap = descriptor.lightMap ?? ''
+        this.lightMapIntensity = descriptor.lightMapIntensity ?? 1
+        this.map = descriptor.map ?? ''
+        this.normalMap = descriptor.normalMap ?? ''
+        this.normalMapType = descriptor.normalMapType ?? MaterialNormalMapType.TangentSpaceNormalMap
+        this.normalScale = descriptor.normalScale ? Vector2.create(descriptor.normalScale) : Vector2.create(1, 1)
+        this.reflectivity = descriptor.reflectivity ?? 1
+        this.refractionRatio = descriptor.refractionRatio ?? 0.98
+        this.shininess = descriptor.shininess ?? 30
+        this.specular = descriptor.specular ?? '#111111'
+        this.specularMap = descriptor.specularMap ?? ''
+        this.fog = descriptor.fog ?? true
+        this.wireframe = descriptor.wireframe ?? false
+    }
+}
+Descriptor.register(MeshPhongMaterial)

package/src/descriptor/material/MeshStandardMaterial.ts

@@ -0,0 +1,141 @@
+import {  DeserializationObject, Descriptor, Euler, Vector2 } from "@vyr/engine"
+import { Material, MaterialNormalMapType, MaterialSide, MaterialDepthFunc, MaterialDlending } from "./Material"
+
+/**
+ * MeshStandardMaterial类
+ * 标准网格材质类
+ * 
+ * 作用：创建和管理标准网格材质实例，用于基于物理的渲染
+ */
+export class MeshStandardMaterial extends Descriptor implements Material {
+    /**类类型标识 */
+    static type = 'MeshStandardMaterial'
+    /**材质标识 */
+    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 "" */
+    envMap: string
+    /**环境贴图强度 @default 1 */
+    envMapIntensity: number
+    /**光照贴图 @default "" */
+    lightMap: string
+    /**烘焙光的强度 @default 1 */
+    lightMapIntensity: number
+    /**环境贴图的旋转（以弧度为单位） @default {x:0,y:0,z:0,order:'XYZ'} */
+    envMapRotation: Euler
+    /**环境遮挡贴图 @default "" */
+    aoMap: string
+    /**环境遮挡效果的强度 @default 1 */
+    aoMapIntensity: number
+    /**凹凸贴图 @default "" */
+    bumpMap: string
+    /**凹凸贴图强度 @default 1 */
+    bumpScale: number
+    /**位移贴图 @default "" */
+    displacementMap: string
+    /**位移贴图强度 @default 1 */
+    displacementScale: number
+    /**位移贴图偏移量 @default 0 */
+    displacementBias: number
+    /**自发光颜色 @default "#000000" */
+    emissive: string
+    /**自发光贴图 @default "" */
+    emissiveMap: string
+    /**自发光强度 @default 1 */
+    emissiveIntensity: number
+    /**金属度贴图 @default "" */
+    metalnessMap: string
+    /**金属度，0表示非金属，1表示金属 @default 0 */
+    metalness: number
+    /**法线贴图 @default "" */
+    normalMap: string
+    /**法线贴图类型 @default MaterialNormalMapType.TangentSpaceNormalMap */
+    normalMapType: MaterialNormalMapType
+    /**法线贴图强度 @default {x:1, y:1} */
+    normalScale: Vector2
+    /**粗糙度 @default 1 */
+    roughness: number
+    /**粗糙度贴图 @default "" */
+    roughnessMap: string
+    /**是否使用平面着色 @default false */
+    flatShading: boolean
+    /**材质是否受雾影响 @default true */
+    fog: boolean
+    /**将几何体渲染为线框 @default false */
+    wireframe: boolean
+
+    constructor(descriptor: Partial<DeserializationObject<MeshStandardMaterial>> = {}) {
+        super(descriptor)
+        this.alphaTest = descriptor.alphaTest ?? 0
+        this.transparent = descriptor.transparent ?? false
+        this.side = descriptor.side ?? MaterialSide.FrontSide
+        this.colorWrite = descriptor.colorWrite ?? true
+        this.depthTest = descriptor.depthTest ?? true
+        this.depthWrite = descriptor.depthWrite ?? true
+        this.depthFunc = descriptor.depthFunc ?? MaterialDepthFunc.LessEqualDepth
+        this.blending = descriptor.blending ?? MaterialDlending.NormalBlending
+        this.vertexColors = descriptor.vertexColors ?? false
+        this.color = descriptor.color ? descriptor.color : '#ffffff'
+        this.opacity = descriptor.opacity ?? 1
+        this.map = descriptor.map ?? ''
+        this.alphaMap = descriptor.alphaMap ?? ''
+        this.envMapIntensity = descriptor.envMapIntensity ?? 1
+        this.lightMapIntensity = descriptor.lightMapIntensity ?? 1
+        this.envMap = descriptor.envMap ?? ''
+        this.lightMap = descriptor.lightMap ?? ''
+
+        this.envMapRotation = Euler.create(descriptor.envMapRotation)
+        this.aoMap = descriptor.aoMap ?? ''
+        this.aoMapIntensity = descriptor.aoMapIntensity ?? 1
+        this.bumpMap = descriptor.bumpMap ?? ''
+        this.bumpScale = descriptor.bumpScale ?? 1
+        this.displacementMap = descriptor.displacementMap ?? ''
+        this.displacementScale = descriptor.displacementScale ?? 1
+        this.displacementBias = descriptor.displacementBias ?? 0
+        this.emissive = descriptor.emissive ?? '#000000'
+        this.emissiveMap = descriptor.emissiveMap ?? ''
+        this.emissiveIntensity = descriptor.emissiveIntensity ?? 1
+        this.metalness = descriptor.metalness ?? 0
+        this.metalnessMap = descriptor.metalnessMap ?? ''
+        this.normalMap = descriptor.normalMap ?? ''
+        this.normalMapType = descriptor.normalMapType ?? MaterialNormalMapType.TangentSpaceNormalMap
+        this.normalScale = descriptor.normalScale ? Vector2.create(descriptor.normalScale) : Vector2.create(1, 1)
+        this.roughness = descriptor.roughness ?? 1
+        this.roughnessMap = descriptor.roughnessMap ?? ''
+        this.flatShading = descriptor.flatShading ?? false
+        this.fog = descriptor.fog ?? true
+        this.wireframe = descriptor.wireframe ?? false
+    }
+}
+Descriptor.register(MeshStandardMaterial)