bplinejs 0.0.101-beta.10

package/lib/Render/SamplerManager.js

@@ -0,0 +1,42 @@
+//#region src/scripts/Render/SamplerManager.ts
+/**
+* 管理当前 Render 对应 GPUDevice 创建的 Sampler 缓存。
+* 相同 U/V 寻址组合在多个材质和 DrawCall 之间复用同一个 GPUSampler。
+* @class
+*/
+var SamplerManager = class {
+	pipeline;
+	/**
+	* 创建 Sampler 管理器。
+	* @param pipeline 当前 Render 的共享管线资源
+	*/
+	constructor(pipeline) {
+		this.pipeline = pipeline;
+	}
+	/**
+	* 获取或创建指定寻址组合的 Sampler。
+	* @param addressModeU 水平方向寻址方式
+	* @param addressModeV 垂直方向寻址方式
+	* @returns 可复用 Sampler，GPUDevice 尚未就绪时返回 undefined
+	*/
+	get(addressModeU, addressModeV) {
+		const device = this.pipeline.device;
+		if (device === void 0) return;
+		const key = addressModeU + "_" + addressModeV;
+		const cachedSampler = this.pipeline.samplers.get(key);
+		if (cachedSampler !== void 0) return cachedSampler;
+		const sampler = device.createSampler({
+			label: "Texture Sampler " + key,
+			addressModeU,
+			addressModeV,
+			magFilter: "linear",
+			minFilter: "linear"
+		});
+		this.pipeline.samplers.set(key, sampler);
+		return sampler;
+	}
+};
+//#endregion
+export { SamplerManager as default };
+
+//# sourceMappingURL=SamplerManager.js.map

package/lib/Render/SamplerManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SamplerManager.js","names":[],"sources":["../../src/scripts/Render/SamplerManager.ts"],"sourcesContent":["import type { PipelineLike } from \"./types\";\n\ninterface SamplerManagerLike {\n    get(addressModeU: GPUAddressMode, addressModeV: GPUAddressMode): GPUSampler | undefined;\n}\n\n/**\n * 管理当前 Render 对应 GPUDevice 创建的 Sampler 缓存。\n * 相同 U/V 寻址组合在多个材质和 DrawCall 之间复用同一个 GPUSampler。\n * @class\n */\nclass SamplerManager implements SamplerManagerLike {\n    private readonly pipeline: PipelineLike;\n\n    /**\n     * 创建 Sampler 管理器。\n     * @param pipeline 当前 Render 的共享管线资源\n     */\n    public constructor(pipeline: PipelineLike) {\n        this.pipeline = pipeline;\n    }\n\n    /**\n     * 获取或创建指定寻址组合的 Sampler。\n     * @param addressModeU 水平方向寻址方式\n     * @param addressModeV 垂直方向寻址方式\n     * @returns 可复用 Sampler，GPUDevice 尚未就绪时返回 undefined\n     */\n    public get(addressModeU: GPUAddressMode, addressModeV: GPUAddressMode): GPUSampler | undefined {\n        const device: GPUDevice | undefined = this.pipeline.device;\n\n        if (device === undefined) {\n            return undefined;\n        }\n\n        const key: string = addressModeU + \"_\" + addressModeV;\n        const cachedSampler: GPUSampler | undefined = this.pipeline.samplers.get(key);\n\n        if (cachedSampler !== undefined) {\n            return cachedSampler;\n        }\n\n        const sampler: GPUSampler = device.createSampler({\n            label: \"Texture Sampler \" + key,\n            addressModeU,\n            addressModeV,\n            magFilter: \"linear\",\n            minFilter: \"linear\",\n        });\n\n        this.pipeline.samplers.set(key, sampler);\n        return sampler;\n    }\n}\n\nexport default SamplerManager;\nexport type { SamplerManagerLike };\n"],"mappings":";;;;;;AAWA,IAAM,iBAAN,MAAmD;CAC/C;;;;;CAMA,YAAmB,UAAwB;EACvC,KAAK,WAAW;CACpB;;;;;;;CAQA,IAAW,cAA8B,cAAsD;EAC3F,MAAM,SAAgC,KAAK,SAAS;EAEpD,IAAI,WAAW,KAAA,GACX;EAGJ,MAAM,MAAc,eAAe,MAAM;EACzC,MAAM,gBAAwC,KAAK,SAAS,SAAS,IAAI,GAAG;EAE5E,IAAI,kBAAkB,KAAA,GAClB,OAAO;EAGX,MAAM,UAAsB,OAAO,cAAc;GAC7C,OAAO,qBAAqB;GAC5B;GACA;GACA,WAAW;GACX,WAAW;EACf,CAAC;EAED,KAAK,SAAS,SAAS,IAAI,KAAK,OAAO;EACvC,OAAO;CACX;AACJ"}

package/lib/Render/SceneUpdate.d.ts

@@ -0,0 +1,9 @@
+import type Camera from "../Camera";
+import type Scene from "../Scene";
+/** @param scene 场景对象；祖先按版本更新，静止节点不重复计算矩阵 */
+declare const MatrixUpdate: (scene: Scene) => void;
+/** @param scene 场景对象；按版本准备 CPU 列表，不清除任何 Render 的上传状态 */
+declare const InitScene: (scene: Scene) => void;
+/** @param camera 相机对象；按输入和世界矩阵版本准备投影及视图矩阵 */
+declare const InitCamera: (camera: Camera) => void;
+export { InitCamera, InitScene, MatrixUpdate };

package/lib/Render/SceneUpdate.js

@@ -0,0 +1,18 @@
+//#region src/scripts/Render/SceneUpdate.ts
+/** @param scene 场景对象；祖先按版本更新，静止节点不重复计算矩阵 */
+var MatrixUpdate = (scene) => {
+	scene.ensureWorldMatrix();
+	for (const mesh of scene.drawList) mesh.ensureWorldMatrix();
+};
+/** @param scene 场景对象；按版本准备 CPU 列表，不清除任何 Render 的上传状态 */
+var InitScene = (scene) => {
+	scene.ensureLists();
+};
+/** @param camera 相机对象；按输入和世界矩阵版本准备投影及视图矩阵 */
+var InitCamera = (camera) => {
+	camera.ensureCameraMatrix();
+};
+//#endregion
+export { InitCamera, InitScene, MatrixUpdate };
+
+//# sourceMappingURL=SceneUpdate.js.map

package/lib/Render/SceneUpdate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SceneUpdate.js","names":[],"sources":["../../src/scripts/Render/SceneUpdate.ts"],"sourcesContent":["import type Camera from \"../Camera\";\nimport type Scene from \"../Scene\";\n\n/** @param scene 场景对象；祖先按版本更新，静止节点不重复计算矩阵 */\nconst MatrixUpdate = (scene: Scene): void => {\n    scene.ensureWorldMatrix();\n    for (const mesh of scene.drawList) mesh.ensureWorldMatrix();\n};\n\n/** @param scene 场景对象；按版本准备 CPU 列表，不清除任何 Render 的上传状态 */\nconst InitScene = (scene: Scene): void => {\n    scene.ensureLists();\n};\n\n/** @param camera 相机对象；按输入和世界矩阵版本准备投影及视图矩阵 */\nconst InitCamera = (camera: Camera): void => {\n    camera.ensureCameraMatrix();\n};\n\nexport { InitCamera, InitScene, MatrixUpdate };\n"],"mappings":";;AAIA,IAAM,gBAAgB,UAAuB;CACzC,MAAM,kBAAkB;CACxB,KAAK,MAAM,QAAQ,MAAM,UAAU,KAAK,kBAAkB;AAC9D;;AAGA,IAAM,aAAa,UAAuB;CACtC,MAAM,YAAY;AACtB;;AAGA,IAAM,cAAc,WAAyB;CACzC,OAAO,mBAAmB;AAC9B"}

package/lib/Render/TextureManager.d.ts

@@ -0,0 +1,33 @@
+import type Scene from "../Scene";
+import type { GPUTextureResourceLike, PipelineLike } from "./types";
+interface TextureManagerLike {
+    draw(scene: Scene): void;
+    createFallbackTexture(device: GPUDevice): GPUTextureResourceLike;
+}
+/** 按 textureList 上传图片；单张图片和多层图片统一使用 2d-array 视图。 */
+declare class TextureManager implements TextureManagerLike {
+    private readonly pipeline;
+    /** @param pipeline Render 资源 */
+    constructor(pipeline: PipelineLike);
+    /** @param scene 当前场景，按资源自己的版本更新，不清除共享版本 */
+    draw(scene: Scene): void;
+    /** @param device 当前设备 @returns 只有一层的白色后备贴图 */
+    createFallbackTexture(device: GPUDevice): GPUTextureResourceLike;
+    /**
+     * 释放旧纹理及引用其视图的绑定缓存，重建时不会误用旧视图。
+     * @param resource 被替换或失效的纹理资源
+     */
+    private releaseTexture;
+    /**
+     * 层号由 CPU 层表决定，空源和 loading 都写白色，不能跳过层造成编号错位。
+     * 同组图片统一到最大宽高，缩放整张图片，不裁切 UV。
+     * @param device 当前设备
+     * @param textureId 数组资源 ID
+     * @param version 本次上传版本
+     * @param layers 有序图片，单图长度为 1
+     * @returns 完整纹理资源
+     */
+    private createTexture;
+}
+export default TextureManager;
+export type { TextureManagerLike };

package/lib/Render/TextureManager.js

@@ -0,0 +1,152 @@
+import TextureLayers from "../Texture/Layers.js";
+//#region src/scripts/Render/TextureManager.ts
+/** 按 textureList 上传图片；单张图片和多层图片统一使用 2d-array 视图。 */
+var TextureManager = class {
+	pipeline;
+	/** @param pipeline Render 资源 */
+	constructor(pipeline) {
+		this.pipeline = pipeline;
+	}
+	/** @param scene 当前场景，按资源自己的版本更新，不清除共享版本 */
+	draw(scene) {
+		const device = this.pipeline.device;
+		if (device === void 0) return;
+		for (const resource of scene.textureList) {
+			const cached = this.pipeline.textures.get(resource.id);
+			if (cached?.version === resource.version) continue;
+			const layers = resource instanceof TextureLayers ? resource.layers : [resource];
+			if (layers.length === 0 || !(resource instanceof TextureLayers) && !IsReady(resource)) {
+				this.releaseTexture(cached);
+				this.pipeline.textures.delete(resource.id);
+				continue;
+			}
+			const created = this.createTexture(device, resource.id, resource.version, layers);
+			this.releaseTexture(cached);
+			this.pipeline.textures.set(resource.id, created);
+		}
+	}
+	/** @param device 当前设备 @returns 只有一层的白色后备贴图 */
+	createFallbackTexture(device) {
+		return this.createTexture(device, -1, 0, [void 0]);
+	}
+	/**
+	* 释放旧纹理及引用其视图的绑定缓存，重建时不会误用旧视图。
+	* @param resource 被替换或失效的纹理资源
+	*/
+	releaseTexture(resource) {
+		if (resource === void 0) return;
+		for (const entry of this.pipeline.buffers.meshStyle.values()) {
+			const binding = entry.bindGroup;
+			if (binding?.baseView === resource.view || binding?.edgeView === resource.view || binding?.pointsView === resource.view) entry.bindGroup = void 0;
+		}
+		resource.texture.destroy();
+	}
+	/**
+	* 层号由 CPU 层表决定，空源和 loading 都写白色，不能跳过层造成编号错位。
+	* 同组图片统一到最大宽高，缩放整张图片，不裁切 UV。
+	* @param device 当前设备
+	* @param textureId 数组资源 ID
+	* @param version 本次上传版本
+	* @param layers 有序图片，单图长度为 1
+	* @returns 完整纹理资源
+	*/
+	createTexture(device, textureId, version, layers) {
+		let width = 1;
+		let height = 1;
+		const sourceIds = /* @__PURE__ */ new Set();
+		for (const image of layers) {
+			if (image !== void 0) sourceIds.add(image.id);
+			if (IsReady(image)) {
+				width = Math.max(width, image.width);
+				height = Math.max(height, image.height);
+			}
+		}
+		if (layers.length > device.limits.maxTextureArrayLayers) throw new RangeError("Texture layers exceed maxTextureArrayLayers.");
+		if (width > device.limits.maxTextureDimension2D || height > device.limits.maxTextureDimension2D) throw new RangeError("Texture dimensions exceed maxTextureDimension2D.");
+		const texture = device.createTexture({
+			label: textureId === -1 ? "Fallback White Texture" : "Texture " + String(textureId),
+			size: {
+				width,
+				height,
+				depthOrArrayLayers: layers.length
+			},
+			format: "rgba8unorm",
+			usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT
+		});
+		try {
+			let staging;
+			for (let layer = 0; layer < layers.length; layer++) {
+				const image = layers[layer];
+				const source = IsReady(image) ? image.source : null;
+				const destination = {
+					texture,
+					origin: {
+						x: 0,
+						y: 0,
+						z: layer
+					}
+				};
+				const extent = {
+					width,
+					height,
+					depthOrArrayLayers: 1
+				};
+				if (source === null && width === 1 && height === 1) {
+					device.queue.writeTexture(destination, new Uint8Array([
+						255,
+						255,
+						255,
+						255
+					]), {
+						bytesPerRow: 4,
+						rowsPerImage: 1
+					}, extent);
+					continue;
+				}
+				const imageData = typeof ImageData !== "undefined" && source instanceof ImageData;
+				if (source !== null && !imageData && image?.width === width && image.height === height) {
+					device.queue.copyExternalImageToTexture({
+						source,
+						flipY: true
+					}, destination, extent);
+					continue;
+				}
+				staging ??= new OffscreenCanvas(width, height);
+				const context = staging.getContext("2d");
+				if (context === null) throw new Error("Cannot create texture normalization canvas.");
+				context.clearRect(0, 0, width, height);
+				if (source === null) {
+					context.fillStyle = "#ffffff";
+					context.fillRect(0, 0, width, height);
+				} else if (imageData) {
+					const pixels = source;
+					const input = new OffscreenCanvas(pixels.width, pixels.height);
+					const inputContext = input.getContext("2d");
+					if (inputContext === null) throw new Error("Cannot upload ImageData.");
+					inputContext.putImageData(pixels, 0, 0);
+					context.drawImage(input, 0, 0, width, height);
+				} else context.drawImage(source, 0, 0, width, height);
+				device.queue.copyExternalImageToTexture({
+					source: staging,
+					flipY: true
+				}, destination, extent);
+			}
+			return {
+				textureId,
+				version,
+				sourceIds,
+				texture,
+				view: texture.createView({ dimension: "2d-array" })
+			};
+		} catch (error) {
+			texture.destroy();
+			throw error;
+		}
+	}
+};
+/** @param image 源图 @returns 是否具有可上传的有效源 */
+var IsReady = (image) => image !== void 0 && image.loaded && image.source !== null && Number.isInteger(image.width) && Number.isInteger(image.height) && image.width > 0 && image.height > 0;
+//#endregion
+export { TextureManager as default };
+
+//# sourceMappingURL=TextureManager.js.map

package/lib/Render/TextureManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"TextureManager.js","names":[],"sources":["../../src/scripts/Render/TextureManager.ts"],"sourcesContent":["import type Scene from \"../Scene\";\nimport type { TextureLike, TextureSource } from \"../Texture\";\nimport TextureLayers from \"../Texture/Layers\";\nimport type { GPUTextureResourceLike, PipelineLike } from \"./types\";\n\ninterface TextureManagerLike {\n    draw(scene: Scene): void;\n    createFallbackTexture(device: GPUDevice): GPUTextureResourceLike;\n}\n\n/** 按 textureList 上传图片；单张图片和多层图片统一使用 2d-array 视图。 */\nclass TextureManager implements TextureManagerLike {\n    private readonly pipeline: PipelineLike;\n\n    /** @param pipeline Render 资源 */\n    public constructor(pipeline: PipelineLike) {\n        this.pipeline = pipeline;\n    }\n\n    /** @param scene 当前场景，按资源自己的版本更新，不清除共享版本 */\n    public draw(scene: Scene): void {\n        const device: GPUDevice | undefined = this.pipeline.device;\n        if (device === undefined) return;\n        for (const resource of scene.textureList) {\n            const cached = this.pipeline.textures.get(resource.id);\n            if (cached?.version === resource.version) continue;\n            const layers = resource instanceof TextureLayers ? resource.layers : [resource];\n            if (layers.length === 0 || (!(resource instanceof TextureLayers) && !IsReady(resource))) {\n                // 无效单图只移除自己的视图，不能反复误删其他仍使用此源的层组。\n                this.releaseTexture(cached);\n                this.pipeline.textures.delete(resource.id);\n                continue;\n            }\n            const created = this.createTexture(device, resource.id, resource.version, layers);\n            // 新资源全部创建成功后才释放旧资源，失败不会留下一个“已上传”的假快照。\n            this.releaseTexture(cached);\n            this.pipeline.textures.set(resource.id, created);\n        }\n    }\n\n    /** @param device 当前设备 @returns 只有一层的白色后备贴图 */\n    public createFallbackTexture(device: GPUDevice): GPUTextureResourceLike {\n        return this.createTexture(device, -1, 0, [undefined]);\n    }\n\n    /**\n     * 释放旧纹理及引用其视图的绑定缓存，重建时不会误用旧视图。\n     * @param resource 被替换或失效的纹理资源\n     */\n    private releaseTexture(resource: GPUTextureResourceLike | undefined): void {\n        if (resource === undefined) return;\n        for (const entry of this.pipeline.buffers.meshStyle.values()) {\n            const binding = entry.bindGroup;\n            if (binding?.baseView === resource.view || binding?.edgeView === resource.view\n                || binding?.pointsView === resource.view) entry.bindGroup = undefined;\n        }\n        resource.texture.destroy();\n    }\n\n    /**\n     * 层号由 CPU 层表决定，空源和 loading 都写白色，不能跳过层造成编号错位。\n     * 同组图片统一到最大宽高，缩放整张图片，不裁切 UV。\n     * @param device 当前设备\n     * @param textureId 数组资源 ID\n     * @param version 本次上传版本\n     * @param layers 有序图片，单图长度为 1\n     * @returns 完整纹理资源\n     */\n    private createTexture(device: GPUDevice, textureId: number, version: number, layers: readonly (TextureLike | undefined)[]): GPUTextureResourceLike {\n        let width: number = 1;\n        let height: number = 1;\n        const sourceIds = new Set<number>();\n        for (const image of layers) {\n            if (image !== undefined) sourceIds.add(image.id);\n            if (IsReady(image)) {\n                width = Math.max(width, image.width);\n                height = Math.max(height, image.height);\n            }\n        }\n        if (layers.length > device.limits.maxTextureArrayLayers) throw new RangeError(\"Texture layers exceed maxTextureArrayLayers.\");\n        if (width > device.limits.maxTextureDimension2D || height > device.limits.maxTextureDimension2D) {\n            throw new RangeError(\"Texture dimensions exceed maxTextureDimension2D.\");\n        }\n        const texture = device.createTexture({\n            label: textureId === -1 ? \"Fallback White Texture\" : \"Texture \" + String(textureId),\n            size: { width, height, depthOrArrayLayers: layers.length },\n            format: \"rgba8unorm\",\n            usage: GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_DST | GPUTextureUsage.RENDER_ATTACHMENT,\n        });\n        try {\n            let staging: OffscreenCanvas | undefined;\n            for (let layer = 0; layer < layers.length; layer++) {\n                const image = layers[layer];\n                const source: TextureSource | null = IsReady(image) ? image.source : null;\n                const destination: GPUCopyExternalImageDestInfo = { texture, origin: { x: 0, y: 0, z: layer } };\n                const extent: GPUExtent3DDict = { width, height, depthOrArrayLayers: 1 };\n                if (source === null && width === 1 && height === 1) {\n                    device.queue.writeTexture(destination, new Uint8Array([255, 255, 255, 255]), { bytesPerRow: 4, rowsPerImage: 1 }, extent);\n                    continue;\n                }\n                const imageData: boolean = typeof ImageData !== \"undefined\" && source instanceof ImageData;\n                if (source !== null && !imageData && image?.width === width && image.height === height) {\n                    device.queue.copyExternalImageToTexture({ source: source, flipY: true }, destination, extent);\n                    continue;\n                }\n                staging ??= new OffscreenCanvas(width, height);\n                const context = staging.getContext(\"2d\");\n                if (context === null) throw new Error(\"Cannot create texture normalization canvas.\");\n                context.clearRect(0, 0, width, height);\n                if (source === null) {\n                    context.fillStyle = \"#ffffff\";\n                    context.fillRect(0, 0, width, height);\n                } else if (imageData) {\n                    const pixels = source as ImageData;\n                    const input = new OffscreenCanvas(pixels.width, pixels.height);\n                    const inputContext = input.getContext(\"2d\");\n                    if (inputContext === null) throw new Error(\"Cannot upload ImageData.\");\n                    inputContext.putImageData(pixels, 0, 0);\n                    context.drawImage(input, 0, 0, width, height);\n                } else {\n                    context.drawImage(source as HTMLImageElement | ImageBitmap, 0, 0, width, height);\n                }\n                device.queue.copyExternalImageToTexture({ source: staging, flipY: true }, destination, extent);\n            }\n            return { textureId, version, sourceIds, texture, view: texture.createView({ dimension: \"2d-array\" }) };\n        } catch (error) {\n            texture.destroy();\n            throw error;\n        }\n    }\n}\n\n/** @param image 源图 @returns 是否具有可上传的有效源 */\nconst IsReady = (image: TextureLike | undefined): image is TextureLike => image !== undefined\n    && image.loaded && image.source !== null && Number.isInteger(image.width) && Number.isInteger(image.height)\n    && image.width > 0 && image.height > 0;\n\nexport default TextureManager;\nexport type { TextureManagerLike };\n"],"mappings":"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"}

package/lib/Render/index.d.ts

@@ -0,0 +1,212 @@
+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";
+import BufferManager from "./BufferManager";
+import DevelopmentValidator from "./DevelopmentValidator";
+import DepthManager from "./DepthManager";
+import DestroyManager from "./DestroyManager";
+import DrawCallManager from "./DrawCallManager";
+import PipelineManager from "./PipelineManager";
+import SamplerManager from "./SamplerManager";
+import { InitCamera, InitScene, MatrixUpdate } from "./SceneUpdate";
+import TextureManager from "./TextureManager";
+import type { PipelineLike, RenderLike, RenderMode } from "./types";
+/**
+ * WebGPU 2D 渲染器。
+ * 负责生命周期和渲染流程调度，具体 GPU 资源由各管理器维护。
+ * @class
+ * @implements RenderLike
+ */
+declare class Render implements RenderLike {
+    /**
+     * 当前 Render 的全局唯一 ID。
+     */
+    readonly id: number;
+    /**
+     * 对象类型。
+     */
+    readonly type: string;
+    /**
+     * 画布容器。
+     */
+    container: HTMLElement;
+    /**
+     * 渲染画布。
+     */
+    canvas: HTMLCanvasElement;
+    /**
+     * 每帧开始前用于清空画布的 RGBA 颜色。
+     */
+    backgroundColor: GPUColorDict;
+    /**
+     * 当前 Render 的共享 WebGPU 资源。
+     */
+    pipeline: PipelineLike;
+    /**
+     * WebGPU 初始化完成状态。
+     */
+    readonly ready: Promise<void>;
+    private _alphaMode;
+    private _resizeTimer;
+    private _destroyed;
+    private _dpr;
+    private _renderMode;
+    private readonly bufferManager;
+    private readonly destroyManager;
+    private readonly drawCallManager;
+    private readonly pipelineManager;
+    private readonly textureManager;
+    /**
+     * 创建渲染器并开始异步初始化 WebGPU。
+     * @param div 容器节点或容器 ID
+     * @param renderMode Render 运行模式
+     */
+    constructor(div: HTMLElement | string, renderMode?: RenderMode);
+    /**
+     * 创建当前画布对应的 WebGPU 设备与呈现上下文。
+     * @returns WebGPU 初始化完成状态
+     */
+    initWebGPU(): Promise<void>;
+    /**
+     * 设置 Canvas 与下层 HTML 内容的 Alpha 合成方式。
+     * @param alphaMode Alpha 合成方式
+     */
+    set alphaMode(alphaMode: GPUCanvasAlphaMode);
+    /**
+     * 获取 Canvas Alpha 合成方式。
+     * @returns Alpha 合成方式
+     */
+    get alphaMode(): GPUCanvasAlphaMode;
+    /**
+     * 获取当前 Canvas 使用的设备像素比。
+     * @returns 设备像素比
+     */
+    get dpr(): number;
+    /**
+     * 设置 Render 运行模式。
+     * production 会跳过 GPUBuffer 创建前的全部开发检查。
+     * @param renderMode Render 运行模式
+     */
+    set renderMode(renderMode: RenderMode);
+    /**
+     * 获取 Render 运行模式。
+     * @returns 当前 Render 运行模式
+     */
+    get renderMode(): RenderMode;
+    /**
+     * 预热场景所需缓存，但不提交 DrawCall。
+     * @param scene 场景对象
+     * @param camera 相机对象
+     * @returns 无返回值
+     */
+    warmup(scene: Scene, camera: Camera): void;
+    /**
+     * 预热缓存并绘制当前场景。
+     * @param scene 场景对象
+     * @param camera 相机对象
+     * @returns 无返回值
+     */
+    render(scene: Scene, camera: Camera): void;
+    /**
+     * 创建或更新当前场景的 GPUBuffer。
+     * @param scene 场景对象
+     * @param camera 相机对象
+     * @returns 无返回值
+     */
+    drawBuffers(scene: Scene, camera: Camera): void;
+    /**
+     * 创建或更新当前场景的 GPUTexture。
+     * @param scene 场景对象
+     * @returns 无返回值
+     */
+    drawTextures(scene: Scene): void;
+    /**
+     * 创建或更新当前场景的 Pipeline 模板。
+     * @param scene 场景对象
+     * @returns 无返回值
+     */
+    drawPipelines(scene: Scene): void;
+    /**
+     * 编码并提交当前场景的绘制命令。
+     * @param scene 场景对象
+     * @returns 无返回值
+     */
+    drawCall(scene: Scene): void;
+    /**
+     * 销毁指定 Mesh 缓存。
+     * @param mesh Mesh 对象或全局 ID
+     * @returns 是否销毁了任意资源
+     */
+    destroyMesh(mesh: MeshLike | number): boolean;
+    /**
+     * 销毁指定 Texture 缓存。
+     * @param texture Texture 对象或全局 ID
+     * @returns 是否销毁了对应资源
+     */
+    destroyTexture(texture: TextureResource | number): boolean;
+    /**
+     * 销毁指定 Material 缓存。
+     * @param material Material 对象或全局 ID
+     * @returns 是否销毁了任意资源
+     */
+    destroyMaterial(material: Material2d | number): boolean;
+    /**
+     * 销毁指定 Geometry 缓存。
+     * @param geometry Geometry 对象或全局 ID
+     * @returns 是否销毁了对应资源
+     */
+    destroyGeometry(geometry: GeoData | number): boolean;
+    /**
+     * 回收所有场景均未引用的 GPU 缓存。
+     * @param scene 需要同步资源使用记录的场景
+     * @returns 无返回值
+     */
+    trim(scene: Scene): void;
+    /**
+     * 更新场景版本落后的节点矩阵。
+     * @param scene 场景对象
+     * @returns 无返回值
+     */
+    matrixUpdate(scene: Scene): void;
+    /**
+     * 根据版本更新 Scene 列表。
+     * @param scene 场景对象
+     * @returns 无返回值
+     */
+    initScene(scene: Scene): void;
+    /**
+     * 根据版本更新 Camera 矩阵。
+     * @param camera 相机对象
+     * @returns 无返回值
+     */
+    initCamera(camera: Camera): void;
+    /**
+     * 销毁当前 Render 持有的全部资源并移除 Canvas。
+     * @returns 无返回值
+     */
+    destroy(): void;
+    /**
+     * 延迟更新 Canvas 实际像素尺寸。
+     * 连续 100ms 没有新的调用时才执行。
+     * @returns 无返回值
+     */
+    resize(): void;
+    /**
+     * 获取当前 Render 销毁状态。
+     * @returns 是否已经销毁
+     */
+    private isDestroyed;
+}
+export default Render;
+export { BufferManager, DepthManager, DevelopmentValidator, DestroyManager, DrawCallManager, InitCamera, InitScene, MatrixUpdate, PipelineManager, SamplerManager, TextureManager, };
+export type { DepthTextureLike, MeshDepthBufferLike, GeometryBufferPartLike, GeometryBufferLike, GPUTextureResourceLike, MeshMatrixBufferLike, MeshStyleBufferLike, PipelineBuffersLike, PipelineLike, PipelineTemplateLike, RenderLike, RenderMode, SceneResourcesLike, } from "./types";
+export type { BufferManagerLike } from "./BufferManager";
+export type { DevelopmentValidatorLike } from "./DevelopmentValidator";
+export type { DestroyManagerLike } from "./DestroyManager";
+export type { DrawCallManagerLike } from "./DrawCallManager";
+export type { PipelineManagerLike } from "./PipelineManager";
+export type { SamplerManagerLike } from "./SamplerManager";
+export type { TextureManagerLike } from "./TextureManager";