bplinejs 0.0.101-beta.10

package/lib/Render/index.js

@@ -0,0 +1,347 @@
+import { GETID } from "../ID.js";
+import DepthManager from "./DepthManager.js";
+import DevelopmentValidator from "./DevelopmentValidator.js";
+import BufferManager from "./BufferManager.js";
+import DestroyManager from "./DestroyManager.js";
+import SamplerManager from "./SamplerManager.js";
+import DrawCallManager from "./DrawCallManager.js";
+import TextureManager from "./TextureManager.js";
+import PipelineManager from "./PipelineManager.js";
+import { InitCamera, InitScene, MatrixUpdate } from "./SceneUpdate.js";
+import { GetInner } from "bpmatrixjs/Utils";
+//#region src/scripts/Render/index.ts
+/**
+* WebGPU 2D 渲染器。
+* 负责生命周期和渲染流程调度，具体 GPU 资源由各管理器维护。
+* @class
+* @implements RenderLike
+*/
+var Render = class {
+	/**
+	* 当前 Render 的全局唯一 ID。
+	*/
+	id;
+	/**
+	* 对象类型。
+	*/
+	type = "Render";
+	/**
+	* 画布容器。
+	*/
+	container;
+	/**
+	* 渲染画布。
+	*/
+	canvas;
+	/**
+	* 每帧开始前用于清空画布的 RGBA 颜色。
+	*/
+	backgroundColor = {
+		r: 0,
+		g: 0,
+		b: 0,
+		a: 0
+	};
+	/**
+	* 当前 Render 的共享 WebGPU 资源。
+	*/
+	pipeline;
+	/**
+	* WebGPU 初始化完成状态。
+	*/
+	ready;
+	_alphaMode;
+	_resizeTimer;
+	_destroyed;
+	_dpr;
+	_renderMode;
+	bufferManager;
+	destroyManager;
+	drawCallManager;
+	pipelineManager;
+	textureManager;
+	/**
+	* 创建渲染器并开始异步初始化 WebGPU。
+	* @param div 容器节点或容器 ID
+	* @param renderMode Render 运行模式
+	*/
+	constructor(div, renderMode = "development") {
+		this.id = GETID();
+		if (typeof div === "string") {
+			const container = document.getElementById(div);
+			if (container === null) throw new Error(`Render container "${div}" was not found.`);
+			this.container = container;
+		} else this.container = div;
+		this.canvas = document.createElement("canvas");
+		this.canvas.style.display = "block";
+		this.canvas.style.width = "100%";
+		this.canvas.style.height = "100%";
+		this.container.appendChild(this.canvas);
+		this._alphaMode = "premultiplied";
+		this._resizeTimer = null;
+		this._destroyed = false;
+		this._dpr = GetInner().dpr;
+		this._renderMode = renderMode;
+		this.pipeline = {
+			pipelineTemplates: /* @__PURE__ */ new Map(),
+			textures: /* @__PURE__ */ new Map(),
+			samplers: /* @__PURE__ */ new Map(),
+			sceneResources: /* @__PURE__ */ new Map(),
+			buffers: {
+				meshMatrix: /* @__PURE__ */ new Map(),
+				meshDepth: /* @__PURE__ */ new Map(),
+				geometry: /* @__PURE__ */ new Map(),
+				meshStyle: /* @__PURE__ */ new Map(),
+				cameraUniform: []
+			}
+		};
+		this.destroyManager = new DestroyManager(this.pipeline);
+		this.textureManager = new TextureManager(this.pipeline);
+		const samplerManager = new SamplerManager(this.pipeline);
+		this.pipelineManager = new PipelineManager(this.pipeline, this.textureManager, samplerManager);
+		this.bufferManager = new BufferManager(this.pipeline);
+		this.drawCallManager = new DrawCallManager(this.pipeline, samplerManager);
+		this.ready = this.initWebGPU();
+	}
+	/**
+	* 创建当前画布对应的 WebGPU 设备与呈现上下文。
+	* @returns WebGPU 初始化完成状态
+	*/
+	async initWebGPU() {
+		const webGPU = navigator.gpu;
+		if (webGPU === void 0) throw new Error("WebGPU is not supported by this browser.");
+		const adapter = await webGPU.requestAdapter();
+		if (adapter === null) throw new Error("No compatible WebGPU adapter was found.");
+		if (this.isDestroyed()) return;
+		const device = await adapter.requestDevice();
+		if (this.isDestroyed()) {
+			device.destroy();
+			return;
+		}
+		const context = this.canvas.getContext("webgpu");
+		if (context === null) throw new Error("WebGPU canvas context could not be created.");
+		const format = webGPU.getPreferredCanvasFormat();
+		context.configure({
+			device,
+			format,
+			alphaMode: this._alphaMode
+		});
+		this.pipeline.adapter = adapter;
+		this.pipeline.device = device;
+		this.pipeline.context = context;
+		this.pipeline.format = format;
+		this.pipelineManager.initResources(device);
+	}
+	/**
+	* 设置 Canvas 与下层 HTML 内容的 Alpha 合成方式。
+	* @param alphaMode Alpha 合成方式
+	*/
+	set alphaMode(alphaMode) {
+		if (this._alphaMode === alphaMode) return;
+		this._alphaMode = alphaMode;
+		const device = this.pipeline.device;
+		const context = this.pipeline.context;
+		const format = this.pipeline.format;
+		if (device !== void 0 && context !== void 0 && format !== void 0) context.configure({
+			device,
+			format,
+			alphaMode
+		});
+	}
+	/**
+	* 获取 Canvas Alpha 合成方式。
+	* @returns Alpha 合成方式
+	*/
+	get alphaMode() {
+		return this._alphaMode;
+	}
+	/**
+	* 获取当前 Canvas 使用的设备像素比。
+	* @returns 设备像素比
+	*/
+	get dpr() {
+		return this._dpr;
+	}
+	/**
+	* 设置 Render 运行模式。
+	* production 会跳过 GPUBuffer 创建前的全部开发检查。
+	* @param renderMode Render 运行模式
+	*/
+	set renderMode(renderMode) {
+		this._renderMode = renderMode;
+	}
+	/**
+	* 获取 Render 运行模式。
+	* @returns 当前 Render 运行模式
+	*/
+	get renderMode() {
+		return this._renderMode;
+	}
+	/**
+	* 预热场景所需缓存，但不提交 DrawCall。
+	* @param scene 场景对象
+	* @param camera 相机对象
+	* @returns 无返回值
+	*/
+	warmup(scene, camera) {
+		if (this._destroyed || this.pipeline.device === void 0) return;
+		this.initScene(scene);
+		if (this.pipeline.sceneResources.get(scene.id)?.version !== scene.version) this.trim(scene);
+		this.matrixUpdate(scene);
+		this.initCamera(camera);
+		this.drawBuffers(scene, camera);
+		this.drawTextures(scene);
+		this.drawPipelines(scene);
+		this.drawCallManager.prepare(this.canvas.width, this.canvas.height);
+	}
+	/**
+	* 预热缓存并绘制当前场景。
+	* @param scene 场景对象
+	* @param camera 相机对象
+	* @returns 无返回值
+	*/
+	render(scene, camera) {
+		if (this._destroyed || this.pipeline.device === void 0) return;
+		this.warmup(scene, camera);
+		this.drawCall(scene);
+	}
+	/**
+	* 创建或更新当前场景的 GPUBuffer。
+	* @param scene 场景对象
+	* @param camera 相机对象
+	* @returns 无返回值
+	*/
+	drawBuffers(scene, camera) {
+		this.bufferManager.draw(scene, camera, this._dpr, this._renderMode);
+	}
+	/**
+	* 创建或更新当前场景的 GPUTexture。
+	* @param scene 场景对象
+	* @returns 无返回值
+	*/
+	drawTextures(scene) {
+		this.textureManager.draw(scene);
+	}
+	/**
+	* 创建或更新当前场景的 Pipeline 模板。
+	* @param scene 场景对象
+	* @returns 无返回值
+	*/
+	drawPipelines(scene) {
+		this.pipelineManager.draw(scene);
+	}
+	/**
+	* 编码并提交当前场景的绘制命令。
+	* @param scene 场景对象
+	* @returns 无返回值
+	*/
+	drawCall(scene) {
+		this.drawCallManager.draw(scene, this.backgroundColor, this._alphaMode);
+	}
+	/**
+	* 销毁指定 Mesh 缓存。
+	* @param mesh Mesh 对象或全局 ID
+	* @returns 是否销毁了任意资源
+	*/
+	destroyMesh(mesh) {
+		return this.destroyManager.destroyMesh(mesh);
+	}
+	/**
+	* 销毁指定 Texture 缓存。
+	* @param texture Texture 对象或全局 ID
+	* @returns 是否销毁了对应资源
+	*/
+	destroyTexture(texture) {
+		return this.destroyManager.destroyTexture(texture);
+	}
+	/**
+	* 销毁指定 Material 缓存。
+	* @param material Material 对象或全局 ID
+	* @returns 是否销毁了任意资源
+	*/
+	destroyMaterial(material) {
+		return this.destroyManager.destroyMaterial(material);
+	}
+	/**
+	* 销毁指定 Geometry 缓存。
+	* @param geometry Geometry 对象或全局 ID
+	* @returns 是否销毁了对应资源
+	*/
+	destroyGeometry(geometry) {
+		return this.destroyManager.destroyGeometry(geometry);
+	}
+	/**
+	* 回收所有场景均未引用的 GPU 缓存。
+	* @param scene 需要同步资源使用记录的场景
+	* @returns 无返回值
+	*/
+	trim(scene) {
+		this.destroyManager.trim(scene);
+	}
+	/**
+	* 更新场景版本落后的节点矩阵。
+	* @param scene 场景对象
+	* @returns 无返回值
+	*/
+	matrixUpdate(scene) {
+		MatrixUpdate(scene);
+	}
+	/**
+	* 根据版本更新 Scene 列表。
+	* @param scene 场景对象
+	* @returns 无返回值
+	*/
+	initScene(scene) {
+		InitScene(scene);
+	}
+	/**
+	* 根据版本更新 Camera 矩阵。
+	* @param camera 相机对象
+	* @returns 无返回值
+	*/
+	initCamera(camera) {
+		InitCamera(camera);
+	}
+	/**
+	* 销毁当前 Render 持有的全部资源并移除 Canvas。
+	* @returns 无返回值
+	*/
+	destroy() {
+		if (this._destroyed) return;
+		this._destroyed = true;
+		if (this._resizeTimer !== null) {
+			window.clearTimeout(this._resizeTimer);
+			this._resizeTimer = null;
+		}
+		this.destroyManager.destroyAll();
+		this.canvas.remove();
+	}
+	/**
+	* 延迟更新 Canvas 实际像素尺寸。
+	* 连续 100ms 没有新的调用时才执行。
+	* @returns 无返回值
+	*/
+	resize() {
+		if (this._destroyed) return;
+		const currentDpr = GetInner().dpr;
+		if (this._dpr !== currentDpr) this._dpr = currentDpr;
+		if (this._resizeTimer !== null) window.clearTimeout(this._resizeTimer);
+		this._resizeTimer = window.setTimeout(() => {
+			const inner = GetInner();
+			if (this.canvas.width !== inner.width) this.canvas.width = inner.width;
+			if (this.canvas.height !== inner.height) this.canvas.height = inner.height;
+			this._resizeTimer = null;
+		}, 100);
+	}
+	/**
+	* 获取当前 Render 销毁状态。
+	* @returns 是否已经销毁
+	*/
+	isDestroyed() {
+		return this._destroyed;
+	}
+};
+//#endregion
+export { BufferManager, DepthManager, DestroyManager, DevelopmentValidator, DrawCallManager, InitCamera, InitScene, MatrixUpdate, PipelineManager, SamplerManager, TextureManager, Render as default };
+
+//# sourceMappingURL=index.js.map

package/lib/Render/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/scripts/Render/index.ts"],"sourcesContent":["import { GetInner } from \"bpmatrixjs/Utils\";\nimport type Camera from \"../Camera\";\nimport type { GeoData } from \"../Geometry\";\nimport type { Material2d } from \"../global-types\";\nimport { GETID } from \"../ID\";\nimport type { MeshLike } from \"../Mesh\";\nimport type Scene from \"../Scene\";\nimport type { TextureResource } from \"../Texture/Layers\";\nimport BufferManager from \"./BufferManager\";\nimport DevelopmentValidator from \"./DevelopmentValidator\";\nimport DepthManager from \"./DepthManager\";\nimport DestroyManager from \"./DestroyManager\";\nimport DrawCallManager from \"./DrawCallManager\";\nimport PipelineManager from \"./PipelineManager\";\nimport SamplerManager from \"./SamplerManager\";\nimport { InitCamera, InitScene, MatrixUpdate } from \"./SceneUpdate\";\nimport TextureManager from \"./TextureManager\";\nimport type {\n    GeometryBufferLike,\n    GPUTextureResourceLike,\n    MeshStyleBufferLike,\n    PipelineLike,\n    PipelineTemplateLike,\n    RenderLike,\n    RenderMode,\n    SceneResourcesLike,\n} from \"./types\";\n\n/**\n * WebGPU 2D 渲染器。\n * 负责生命周期和渲染流程调度，具体 GPU 资源由各管理器维护。\n * @class\n * @implements RenderLike\n */\nclass Render implements RenderLike {\n    /**\n     * 当前 Render 的全局唯一 ID。\n     */\n    public readonly id: number;\n\n    /**\n     * 对象类型。\n     */\n    public readonly type: string = \"Render\";\n\n    /**\n     * 画布容器。\n     */\n    public container: HTMLElement;\n\n    /**\n     * 渲染画布。\n     */\n    public canvas: HTMLCanvasElement;\n\n    /**\n     * 每帧开始前用于清空画布的 RGBA 颜色。\n     */\n    public backgroundColor: GPUColorDict = { r: 0, g: 0, b: 0, a: 0 };\n\n    /**\n     * 当前 Render 的共享 WebGPU 资源。\n     */\n    public pipeline: PipelineLike;\n\n    /**\n     * WebGPU 初始化完成状态。\n     */\n    public readonly ready: Promise<void>;\n\n    private _alphaMode: GPUCanvasAlphaMode;\n    private _resizeTimer: number | null;\n    private _destroyed: boolean;\n    private _dpr: number;\n    private _renderMode: RenderMode;\n    private readonly bufferManager: BufferManager;\n    private readonly destroyManager: DestroyManager;\n    private readonly drawCallManager: DrawCallManager;\n    private readonly pipelineManager: PipelineManager;\n    private readonly textureManager: TextureManager;\n\n    /**\n     * 创建渲染器并开始异步初始化 WebGPU。\n     * @param div 容器节点或容器 ID\n     * @param renderMode Render 运行模式\n     */\n    public constructor(div: HTMLElement | string, renderMode: RenderMode = \"development\") {\n        this.id = GETID();\n\n        if (typeof div === \"string\") {\n            const container: HTMLElement | null = document.getElementById(div);\n\n            if (container === null) {\n                throw new Error(`Render container \"${div}\" was not found.`);\n            }\n\n            this.container = container;\n        } else {\n            this.container = div;\n        }\n\n        this.canvas = document.createElement(\"canvas\");\n        this.canvas.style.display = \"block\";\n        this.canvas.style.width = \"100%\";\n        this.canvas.style.height = \"100%\";\n        this.container.appendChild(this.canvas);\n        this._alphaMode = \"premultiplied\";\n        this._resizeTimer = null;\n        this._destroyed = false;\n        this._dpr = GetInner().dpr;\n        this._renderMode = renderMode;\n        this.pipeline = {\n            pipelineTemplates: new Map<string, PipelineTemplateLike>(),\n            textures: new Map<number, GPUTextureResourceLike>(),\n            samplers: new Map<string, GPUSampler>(),\n            sceneResources: new Map<number, SceneResourcesLike>(),\n            buffers: {\n                meshMatrix: new Map(),\n                meshDepth: new Map(),\n                geometry: new Map<number, GeometryBufferLike>(),\n                meshStyle: new Map<number, MeshStyleBufferLike>(),\n                cameraUniform: [],\n            },\n        };\n\n        this.destroyManager = new DestroyManager(this.pipeline);\n        this.textureManager = new TextureManager(this.pipeline);\n        const samplerManager = new SamplerManager(this.pipeline);\n\n        this.pipelineManager = new PipelineManager(this.pipeline, this.textureManager, samplerManager);\n        this.bufferManager = new BufferManager(this.pipeline);\n        this.drawCallManager = new DrawCallManager(this.pipeline, samplerManager);\n        this.ready = this.initWebGPU();\n    }\n\n    /**\n     * 创建当前画布对应的 WebGPU 设备与呈现上下文。\n     * @returns WebGPU 初始化完成状态\n     */\n    public async initWebGPU(): Promise<void> {\n        const webGPU: GPU | undefined = (navigator as { gpu?: GPU }).gpu;\n\n        if (webGPU === undefined) {\n            throw new Error(\"WebGPU is not supported by this browser.\");\n        }\n\n        const adapter: GPUAdapter | null = await webGPU.requestAdapter();\n\n        if (adapter === null) {\n            throw new Error(\"No compatible WebGPU adapter was found.\");\n        }\n\n        if (this.isDestroyed()) {\n            return;\n        }\n\n        const device: GPUDevice = await adapter.requestDevice();\n\n        if (this.isDestroyed()) {\n            device.destroy();\n            return;\n        }\n\n        const context: GPUCanvasContext | null = this.canvas.getContext(\"webgpu\");\n\n        if (context === null) {\n            throw new Error(\"WebGPU canvas context could not be created.\");\n        }\n\n        const format: GPUTextureFormat = webGPU.getPreferredCanvasFormat();\n\n        context.configure({\n            device,\n            format,\n            alphaMode: this._alphaMode,\n        });\n        this.pipeline.adapter = adapter;\n        this.pipeline.device = device;\n        this.pipeline.context = context;\n        this.pipeline.format = format;\n        this.pipelineManager.initResources(device);\n    }\n\n    /**\n     * 设置 Canvas 与下层 HTML 内容的 Alpha 合成方式。\n     * @param alphaMode Alpha 合成方式\n     */\n    public set alphaMode(alphaMode: GPUCanvasAlphaMode) {\n        if (this._alphaMode === alphaMode) {\n            return;\n        }\n\n        this._alphaMode = alphaMode;\n\n        const device: GPUDevice | undefined = this.pipeline.device;\n        const context: GPUCanvasContext | undefined = this.pipeline.context;\n        const format: GPUTextureFormat | undefined = this.pipeline.format;\n\n        if (device !== undefined && context !== undefined && format !== undefined) {\n            context.configure({ device, format, alphaMode });\n        }\n    }\n\n    /**\n     * 获取 Canvas Alpha 合成方式。\n     * @returns Alpha 合成方式\n     */\n    public get alphaMode(): GPUCanvasAlphaMode {\n        return this._alphaMode;\n    }\n\n    /**\n     * 获取当前 Canvas 使用的设备像素比。\n     * @returns 设备像素比\n     */\n    public get dpr(): number {\n        return this._dpr;\n    }\n\n    /**\n     * 设置 Render 运行模式。\n     * production 会跳过 GPUBuffer 创建前的全部开发检查。\n     * @param renderMode Render 运行模式\n     */\n    public set renderMode(renderMode: RenderMode) {\n        this._renderMode = renderMode;\n    }\n\n    /**\n     * 获取 Render 运行模式。\n     * @returns 当前 Render 运行模式\n     */\n    public get renderMode(): RenderMode {\n        return this._renderMode;\n    }\n\n    /**\n     * 预热场景所需缓存，但不提交 DrawCall。\n     * @param scene 场景对象\n     * @param camera 相机对象\n     * @returns 无返回值\n     */\n    public warmup(scene: Scene, camera: Camera): void {\n        if (this._destroyed || this.pipeline.device === undefined) {\n            return;\n        }\n\n        this.initScene(scene);\n        if (this.pipeline.sceneResources.get(scene.id)?.version !== scene.version) {\n            this.trim(scene);\n        }\n\n        this.matrixUpdate(scene);\n        this.initCamera(camera);\n        this.drawBuffers(scene, camera);\n        this.drawTextures(scene);\n        this.drawPipelines(scene);\n        this.drawCallManager.prepare(this.canvas.width, this.canvas.height);\n    }\n\n    /**\n     * 预热缓存并绘制当前场景。\n     * @param scene 场景对象\n     * @param camera 相机对象\n     * @returns 无返回值\n     */\n    public render(scene: Scene, camera: Camera): void {\n        if (this._destroyed || this.pipeline.device === undefined) {\n            return;\n        }\n\n        this.warmup(scene, camera);\n        this.drawCall(scene);\n    }\n\n    /**\n     * 创建或更新当前场景的 GPUBuffer。\n     * @param scene 场景对象\n     * @param camera 相机对象\n     * @returns 无返回值\n     */\n    public drawBuffers(scene: Scene, camera: Camera): void {\n        this.bufferManager.draw(scene, camera, this._dpr, this._renderMode);\n    }\n\n    /**\n     * 创建或更新当前场景的 GPUTexture。\n     * @param scene 场景对象\n     * @returns 无返回值\n     */\n    public drawTextures(scene: Scene): void {\n        this.textureManager.draw(scene);\n    }\n\n    /**\n     * 创建或更新当前场景的 Pipeline 模板。\n     * @param scene 场景对象\n     * @returns 无返回值\n     */\n    public drawPipelines(scene: Scene): void {\n        this.pipelineManager.draw(scene);\n    }\n\n    /**\n     * 编码并提交当前场景的绘制命令。\n     * @param scene 场景对象\n     * @returns 无返回值\n     */\n    public drawCall(scene: Scene): void {\n        this.drawCallManager.draw(scene, this.backgroundColor, this._alphaMode);\n    }\n\n    /**\n     * 销毁指定 Mesh 缓存。\n     * @param mesh Mesh 对象或全局 ID\n     * @returns 是否销毁了任意资源\n     */\n    public destroyMesh(mesh: MeshLike | number): boolean {\n        return this.destroyManager.destroyMesh(mesh);\n    }\n\n    /**\n     * 销毁指定 Texture 缓存。\n     * @param texture Texture 对象或全局 ID\n     * @returns 是否销毁了对应资源\n     */\n    public destroyTexture(texture: TextureResource | number): boolean {\n        return this.destroyManager.destroyTexture(texture);\n    }\n\n    /**\n     * 销毁指定 Material 缓存。\n     * @param material Material 对象或全局 ID\n     * @returns 是否销毁了任意资源\n     */\n    public destroyMaterial(material: Material2d | number): boolean {\n        return this.destroyManager.destroyMaterial(material);\n    }\n\n    /**\n     * 销毁指定 Geometry 缓存。\n     * @param geometry Geometry 对象或全局 ID\n     * @returns 是否销毁了对应资源\n     */\n    public destroyGeometry(geometry: GeoData | number): boolean {\n        return this.destroyManager.destroyGeometry(geometry);\n    }\n\n    /**\n     * 回收所有场景均未引用的 GPU 缓存。\n     * @param scene 需要同步资源使用记录的场景\n     * @returns 无返回值\n     */\n    public trim(scene: Scene): void {\n        this.destroyManager.trim(scene);\n    }\n\n    /**\n     * 更新场景版本落后的节点矩阵。\n     * @param scene 场景对象\n     * @returns 无返回值\n     */\n    public matrixUpdate(scene: Scene): void {\n        MatrixUpdate(scene);\n    }\n\n    /**\n     * 根据版本更新 Scene 列表。\n     * @param scene 场景对象\n     * @returns 无返回值\n     */\n    public initScene(scene: Scene): void {\n        InitScene(scene);\n    }\n\n    /**\n     * 根据版本更新 Camera 矩阵。\n     * @param camera 相机对象\n     * @returns 无返回值\n     */\n    public initCamera(camera: Camera): void {\n        InitCamera(camera);\n    }\n\n    /**\n     * 销毁当前 Render 持有的全部资源并移除 Canvas。\n     * @returns 无返回值\n     */\n    public destroy(): void {\n        if (this._destroyed) {\n            return;\n        }\n\n        this._destroyed = true;\n\n        if (this._resizeTimer !== null) {\n            window.clearTimeout(this._resizeTimer);\n            this._resizeTimer = null;\n        }\n\n        this.destroyManager.destroyAll();\n        this.canvas.remove();\n    }\n\n    /**\n     * 延迟更新 Canvas 实际像素尺寸。\n     * 连续 100ms 没有新的调用时才执行。\n     * @returns 无返回值\n     */\n    public resize(): void {\n        if (this._destroyed) {\n            return;\n        }\n\n        const currentDpr: number = GetInner().dpr;\n\n        if (this._dpr !== currentDpr) {\n            this._dpr = currentDpr;\n        }\n\n        if (this._resizeTimer !== null) {\n            window.clearTimeout(this._resizeTimer);\n        }\n\n        this._resizeTimer = window.setTimeout((): void => {\n            const inner = GetInner();\n\n            if (this.canvas.width !== inner.width) {\n                this.canvas.width = inner.width;\n            }\n            if (this.canvas.height !== inner.height) {\n                this.canvas.height = inner.height;\n            }\n\n            this._resizeTimer = null;\n        }, 100);\n    }\n\n    /**\n     * 获取当前 Render 销毁状态。\n     * @returns 是否已经销毁\n     */\n    private isDestroyed(): boolean {\n        return this._destroyed;\n    }\n}\n\nexport default Render;\nexport {\n    BufferManager,\n    DepthManager,\n    DevelopmentValidator,\n    DestroyManager,\n    DrawCallManager,\n    InitCamera,\n    InitScene,\n    MatrixUpdate,\n    PipelineManager,\n    SamplerManager,\n    TextureManager,\n};\nexport type {\n    DepthTextureLike,\n    MeshDepthBufferLike,\n    GeometryBufferPartLike,\n    GeometryBufferLike,\n    GPUTextureResourceLike,\n    MeshMatrixBufferLike,\n    MeshStyleBufferLike,\n    PipelineBuffersLike,\n    PipelineLike,\n    PipelineTemplateLike,\n    RenderLike,\n    RenderMode,\n    SceneResourcesLike,\n} from \"./types\";\nexport type { BufferManagerLike } from \"./BufferManager\";\nexport type { DevelopmentValidatorLike } from \"./DevelopmentValidator\";\nexport type { DestroyManagerLike } from \"./DestroyManager\";\nexport type { DrawCallManagerLike } from \"./DrawCallManager\";\nexport type { PipelineManagerLike } from \"./PipelineManager\";\nexport type { SamplerManagerLike } from \"./SamplerManager\";\nexport type { TextureManagerLike } from \"./TextureManager\";\n"],"mappings":"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"}

package/lib/Render/types.d.ts

@@ -0,0 +1,191 @@
+/// <reference types="@webgpu/types" preserve="true" />
+import type Camera from "../Camera";
+import type { GeoData } from "../Geometry";
+import type { Material2d } from "../global-types";
+import type { MeshLike } from "../Mesh";
+import type Scene from "../Scene";
+import type { TextureResource } from "../Texture/Layers";
+/**
+ * Render 运行模式。
+ * development 启用运行时资源检查，production 跳过全部开发检查。
+ */
+type RenderMode = "development" | "production";
+/** group(0) 的资源身份快照；所属矩阵缓存被替换时一起释放。 */
+interface MatrixBindGroupCache {
+    group: GPUBindGroup;
+    layout: GPUBindGroupLayout;
+    view: GPUBuffer;
+    projection: GPUBuffer;
+    parameters: GPUBuffer;
+    geometry: GPUBuffer;
+    depth: GPUBuffer;
+}
+/** group(1) 的资源身份快照；样式数值更新不使绑定失效。 */
+interface StyleBindGroupCache {
+    group: GPUBindGroup;
+    layout: GPUBindGroupLayout;
+    baseView: GPUTextureView;
+    edgeView: GPUTextureView;
+    pointsView: GPUTextureView;
+    baseSampler: GPUSampler;
+    edgeSampler: GPUSampler;
+    pointsSampler: GPUSampler;
+}
+/**
+ * 单个 Mesh 的世界矩阵缓冲位。
+ */
+interface MeshMatrixBufferLike {
+    /** 已创建的矩阵绑定组，只在绑定对象或布局变化后重建。 */
+    bindGroup?: MatrixBindGroupCache;
+    /**
+     * 对应 Mesh 的全局 ID。
+     */
+    meshId: number;
+    /**
+     * 当前 Render 创建的 GPU 矩阵缓冲。
+     */
+    buffer: GPUBuffer;
+    /** 当前数组容量，实例个数而非 float 个数。 */
+    capacity: number;
+    /** 已上传的 Mesh.matrixVersion。 */
+    version: number;
+}
+/** 每个 Mesh 独立的连续实例样式缓冲。 */
+interface MeshStyleBufferLike {
+    /** 已创建的样式绑定组，随该 Mesh 样式缓存一起回收。 */
+    bindGroup?: StyleBindGroupCache;
+    meshId: number;
+    /** 用于 destroyMaterial 清理当前绑定该材质的样式缓存。 */
+    materialId: number;
+    buffer: GPUBuffer;
+    capacity: number;
+    version: number;
+}
+/**
+ * 单种 Geometry 绘制模式对应的顶点、二维轮廓法线、UV 和索引缓冲。
+ */
+interface GeometryBufferPartLike {
+    vertex: GPUBuffer;
+    normal: GPUBuffer;
+    uv: GPUBuffer;
+    index: GPUBuffer;
+    miterScale?: GPUBuffer;
+    /** 点型逐顶点中心坐标缓冲。 */
+    position?: GPUBuffer;
+    /** 连续逐顶点类型缓冲，0 / 0.5 / 1 对应面 / 宽边框 / 关键点。 */
+    vertexType?: GPUBuffer;
+    /** 关键点在合并索引中的起始位置，供原生线框插入时保持覆盖顺序。 */
+    pointsFirstIndex: number;
+    /** 上传时保留的索引位宽，不能把 Uint32Array 强转为 Uint16Array。 */
+    indexFormat: GPUIndexFormat;
+}
+/**
+ * 单个 Geometry 对应的 WebGPU 缓存集合。
+ */
+interface GeometryBufferLike {
+    geometryId: number;
+    version: number;
+    uniform: GPUBuffer;
+    geometry?: GeometryBufferPartLike;
+    linePoints?: GeometryBufferPartLike;
+}
+/** 单个 Mesh 的层级起点和实例读取方向，静止帧不重复上传。 */
+interface MeshDepthBufferLike {
+    meshId: number;
+    buffer: GPUBuffer;
+    data: Uint32Array<ArrayBuffer>;
+}
+/** 与画布实际尺寸绑定的 Render 私有深度附件。 */
+interface DepthTextureLike {
+    texture: GPUTexture;
+    view: GPUTextureView;
+    width: number;
+    height: number;
+}
+interface PipelineBuffersLike {
+    meshDepth: Map<number, MeshDepthBufferLike>;
+    /** CPU 按 Mesh ID 查询缓冲对象；buffer 内仍是连续矩阵数值。 */
+    meshMatrix: Map<number, MeshMatrixBufferLike>;
+    geometry: Map<number, GeometryBufferLike>;
+    meshStyle: Map<number, MeshStyleBufferLike>;
+    cameraUniform: GPUBuffer[];
+}
+/**
+ * 单个 Scene 当前使用的 Render 缓存资源集合。
+ */
+interface SceneResourcesLike {
+    /** 当前 Render 已处理的 Scene 版本。 */
+    version: number;
+    meshIds: Set<number>;
+    geometryIds: Set<number>;
+    materialIds: Set<number>;
+    textureIds: Set<number>;
+    pipelineKeys: Set<string>;
+}
+/**
+ * 单个 Texture 对应的 WebGPU 贴图资源。
+ */
+interface GPUTextureResourceLike {
+    textureId: number;
+    /** 层内源图 ID，显式销毁图片时同时失效引用它的层组。 */
+    sourceIds?: ReadonlySet<number>;
+    /** 当前 Render 已上传的贴图版本，不随其他 Render 清理标记而变化。 */
+    version: number;
+    texture: GPUTexture;
+    view: GPUTextureView;
+}
+/**
+ * 相同材质 key 共享的 WebGPU 管线模板。
+ */
+interface PipelineTemplateLike {
+    key: string;
+    renderPipeline?: GPURenderPipeline;
+    lineRenderPipeline?: GPURenderPipeline;
+    defaultBindGroupLayout: GPUBindGroupLayout;
+    materialBindGroupLayout: GPUBindGroupLayout;
+}
+interface PipelineLike {
+    adapter?: GPUAdapter;
+    device?: GPUDevice;
+    context?: GPUCanvasContext;
+    format?: GPUTextureFormat;
+    pipelineTemplates: Map<string, PipelineTemplateLike>;
+    defaultBindGroupLayout?: GPUBindGroupLayout;
+    baseMaterialBindGroupLayout?: GPUBindGroupLayout;
+    textures: Map<number, GPUTextureResourceLike>;
+    samplers: Map<string, GPUSampler>;
+    fallbackTexture?: GPUTextureResourceLike;
+    depthTexture?: DepthTextureLike;
+    sceneResources: Map<number, SceneResourcesLike>;
+    buffers: PipelineBuffersLike;
+}
+interface RenderLike {
+    readonly id: number;
+    readonly type: string;
+    readonly dpr: number;
+    renderMode: RenderMode;
+    container: HTMLElement;
+    canvas: HTMLCanvasElement;
+    backgroundColor: GPUColorDict;
+    alphaMode: GPUCanvasAlphaMode;
+    pipeline: PipelineLike;
+    readonly ready: Promise<void>;
+    initWebGPU(): Promise<void>;
+    destroy(): void;
+    warmup(scene: Scene, camera: Camera): void;
+    render(scene: Scene, camera: Camera): void;
+    drawBuffers(scene: Scene, camera: Camera): void;
+    drawTextures(scene: Scene): void;
+    drawPipelines(scene: Scene): void;
+    drawCall(scene: Scene): void;
+    destroyMesh(mesh: MeshLike | number): boolean;
+    destroyMaterial(material: Material2d | number): boolean;
+    destroyGeometry(geometry: GeoData | number): boolean;
+    destroyTexture(texture: TextureResource | number): boolean;
+    trim(scene: Scene): void;
+    matrixUpdate(scene: Scene): void;
+    initScene(scene: Scene): void;
+    initCamera(camera: Camera): void;
+    resize(): void;
+}
+export type { DepthTextureLike, MeshDepthBufferLike, GeometryBufferPartLike, GeometryBufferLike, GPUTextureResourceLike, MeshMatrixBufferLike, MeshStyleBufferLike, PipelineBuffersLike, PipelineLike, PipelineTemplateLike, RenderLike, RenderMode, SceneResourcesLike, };