Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

docs(performance): texture streaming states what bistro downloads once grown on a GPU

yhh19590830a158
diff --git a/docs/astro/src/content/docs/performance/quality-levels.mdx b/docs/astro/src/content/docs/performance/quality-levels.mdx
index 1b671b98a..f5a5d685f 100644
--- a/docs/astro/src/content/docs/performance/quality-levels.mdx
+++ b/docs/astro/src/content/docs/performance/quality-levels.mdx
@@ -91,7 +91,9 @@ whole. Exported for the web at Low and run in a headless browser (software rende
| `bistro`, 120 s | — | 18.8 MB | 15 of 155 |
A headless browser draws in software, a frame or two a second, so it grows textures far slower than a GPU does: `bistro` was still
-fetching a file every five seconds or so at two minutes, and these are what was downloaded by then, not what it settles at. The
+fetching a file every five seconds or so at two minutes, and these are what was downloaded by then, not what it settles at. On a GPU
+in the editor, ten seconds in, 40 of 's textures had grown past their copies and their files come to 8.9 MB: with the 3.4 MB
+of copies, about 12.4 MB of textures to download where a build without them takes 35.3 MB. The
copies cost the package their own size (430 KB beside `dusk-fort`'s 42.6 MB of textures). A mini game downloads its package whole,
so no copies are made for one; nor for a texture something other than a mesh draws.
diff --git a/docs/astro/src/content/docs/zh-cn/performance/quality-levels.mdx b/docs/astro/src/content/docs/zh-cn/performance/quality-levels.mdx
index 88a48e661..c71e84948 100644
--- a/docs/astro/src/content/docs/zh-cn/performance/quality-levels.mdx
+++ b/docs/astro/src/content/docs/zh-cn/performance/quality-levels.mdx
@@ -63,7 +63,7 @@ import { Aside } from '@astrojs/starlight/components';
| `bistro`,20 秒 | 35.3 MB | 16.1 MB(其中副本 3.4 MB) | 155 张中 4 张 |
| `bistro`,120 秒 | — | 18.8 MB | 155 张中 15 张 |
-无头浏览器用软件渲染,一秒一两帧,长大贴图比 GPU 慢得多:`bistro` 到两分钟时还在每五秒左右下载一张原文件,所以这些是到那时为止下载的量,不是最终稳定的量。副本本身会增加包体(`dusk-fort` 42.6 MB 贴图旁多出 430 KB)。小游戏是整包下载,不生成副本;被网格以外的东西使用的贴图也不生成。
+无头浏览器用软件渲染,一秒一两帧,长大贴图比 GPU 慢得多:`bistro` 到两分钟时还在每五秒左右下载一张原文件,所以这些是到那时为止下载的量,不是最终稳定的量。在编辑器里用 GPU 跑十秒, 有 40 张贴图长到超过副本,它们的原文件合计 8.9 MB:加上 3.4 MB 副本,大约要下载 12.4 MB 贴图,不带副本的构建要 35.3 MB。副本本身会增加包体(`dusk-fort` 42.6 MB 贴图旁多出 430 KB)。小游戏是整包下载,不生成副本;被网格以外的东西使用的贴图也不生成。
它做不到的:在视图要求更大之前,贴图按起始尺寸绘制:场景开头的一两秒可能比之后模糊;一次缩放要在它落地的那一帧付出解码和上传,场景稳定之前会有一两帧几十毫秒。同时被精灵、UI、瓦片地图、粒子或拖尾使用的贴图会恢复原尺寸并保持不变。KTX2 文件直接从某一级截取,不用重新解码;宿主自己转码 KTX2 的平台(原生打包)做不到这一点,这类贴图保持原尺寸。