vimp-engine 0.33.0 → 0.33.2

package/core/Cargo.toml

@@ -1,6 +1,6 @@
 [package]
 name = "vimp-engine-core"
-version = "0.15.0"
+version = "0.19.0"
 edition = "2024"
 description = "VIMP — движковый каркас симуляции (физика, карта, снапшот-фрейминг, интерполяция/предикт/raycast-примитивы, нав-утилиты). Без wasm-bindgen — обёртки для WASM-ABI собирает game-crate."
 license = "MIT"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "vimp-engine",
-  "version": "0.33.0",
+  "version": "0.33.2",
   "description": "VIMP — движок-приложение (мастер, P2P-транспорт, Worker-хост, мета, MVC-каркас клиента)",
   "license": "MIT",
   "repository": {

package/src/client/components/view/CanvasManager.js

@@ -36,6 +36,12 @@ export default class CanvasManagerView {
   // уже несёт и смещение, и масштаб последнего updateCoords, а
   // getBoundingClientRect закрывает случай, когда CSS растянул полотно
   // не один к одному с его буфером.
+  //
+  // Единицы — `renderer.screen`, а не пиксели буфера полотна: трансформ
+  // сцены живёт именно в них, а `canvas.width` умножен на `resolution`
+  // рендерера. Сегодня она равна единице, и числа совпадают, но стоит
+  // включить resolution/autoDensity — и указатель промахнётся ровно во
+  // столько же раз (та же причина, что у updateCoords ниже)
   toWorld(id, clientX, clientY) {
     const app = this._apps[id];
 
@@ -49,8 +55,9 @@ export default class CanvasManagerView {
       return null;
     }
 
-    const px = ((clientX - rect.left) * app.canvas.width) / rect.width;
-    const py = ((clientY - rect.top) * app.canvas.height) / rect.height;
+    const screen = app.renderer.screen;
+    const px = ((clientX - rect.left) * screen.width) / rect.width;
+    const py = ((clientY - rect.top) * screen.height) / rect.height;
     const { position, scale } = app.stage;
 
     if (!scale.x || !scale.y) {
@@ -63,15 +70,30 @@ export default class CanvasManagerView {
     };
   }
 
-  // вычисляет координаты для отображения и обновляет полотно
+  // Вычисляет координаты для отображения и двигает сцену.
+  //
+  // Размер берётся у `renderer.screen`, а не у `canvas`: сцену двигают в
+  // ЕЁ единицах, а буфер полотна умножен на `resolution` рендерера.
+  // Совпадают они только пока resolution равен единице, и промах здесь
+  // тихий — он не ломает картинку, а уводит центр камеры, который по
+  // трансформу сцены восстанавливают части игры (проекция высоты 2.5D в
+  // `vimp-tanks`).
+  //
+  // Отрисовки здесь НЕТ. Полотно рисует тикер — `TickerPlugin` держит
+  // `app.render` на `Ticker.shared` с приоритетом LOW, то есть после
+  // `renderTick` движка, когда кадр применён целиком. Собственный
+  // `app.render()` означал бы отрисовку на КАЖДЫЙ кадр камеры (за тик их
+  // два и больше: сперва камера дискретного кадра, следом предсказанная),
+  // то есть два-три полных обхода сцены на один видимый кадр — и, что
+  // хуже, промежуточные состояния кадра, на которых части считают своё
+  // `onRender`.
   updateCoords({ id, coords, scale }) {
     const app = this._apps[id];
-    const { width, height } = app.canvas;
+    const { width, height } = app.renderer.screen;
     const x = width / 2 - coords.x * scale;
     const y = height / 2 - coords.y * scale;
 
     app.stage.position.set(x, y);
     app.stage.scale.set(scale);
-    app.render();
   }
 }

package/src/client/main.js

@@ -642,8 +642,12 @@ function applyMapData(data, { notifyHost = true } = {}) {
   const staticData = {};
   let staticIndex = 0;
 
-  // мировых единиц на уровень: партам нужен для параллакса слоёв и
-  // экструзии объёмов. 0/undefined — движок подставил размер тайла
+  // мировых единиц на уровень — величина ФИЗИКИ: по ней ядро считает
+  // уклон рампы и падение. Вертикальный масштаб КАРТИНКИ задаёт игра
+  // (у танков — `parallax.shear`) и намеренно не зависит от карты, иначе
+  // слои разных карт разъезжались бы по виду. Поле едет в парт как есть —
+  // партам, которые мерят высоту в мировых единицах.
+  // 0/undefined — движок подставил размер тайла
   const levelHeight = (Number(data.levelHeight) || step) * scale;
 
   const pushLayers = (levelLayers, levelMap, level, solid, floor, volumes) => {