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.
TypeScript 2d-game-engine3d3d-game-engineandroidcppecsgame-editorgame-enginegamedeviostypescriptwebassemblywebglwebgpuwechat-minigame
feat(tilemap): brush footprint preview in the viewport
esenginef343bafc28ec
diff --git a/desktop/src/panels/Viewport.tsx b/desktop/src/panels/Viewport.tsxindex 542d4dc39..e667926e3 100644--- a/desktop/src/panels/Viewport.tsx+++ b/desktop/src/panels/Viewport.tsx@@ -19,6 +19,7 @@ import { SceneStore } from '@/engine/SceneStore';import { StatsStore } from '@/engine/StatsStore';import type { ToolMode } from '@/types';import { resolveActiveTool, type EditorTool, type ToolContext, type PointerInput } from '@/tools';+import { cursorTile } from '@/tools/tileTools';// A React pointer event → the tool-facing PointerInput (no DOM coupling in tools).const toInput = (e: ReactPointerEvent): PointerInput => ({@@ -198,6 +199,8 @@ export function Viewport() {const gizmoRef = useRef<HTMLDivElement>(null);const selectionRef = useRef<HTMLDivElement>(null);const tileSelRef = useRef<HTMLDivElement>(null);+ const tilePreviewRef = useRef<HTMLDivElement>(null);+ const hoverTileRef = useRef<{ x: number; y: number } | null>(null);// Camera pan (middle/right drag) is built-in navigation, separate from tools.const panRef = useRef<{ px: number; py: number } | null>(null);// The tool that owns the in-progress left-button stroke (move/up route to it).@@ -334,6 +337,31 @@ export function Viewport() {} else {ts.style.opacity = '0';}++ // Brush footprint preview: a ghost rect at the hovered tile sized to the active+ // stamp (1×1 for erase/bucket/terrain), so painting isn't blind.+ const pv = tilePreviewRef.current;+ if (pv) {+ const FOOT: Record<string, boolean> = { brush: true, erase: true, bucket: true, terrain: true };+ const hov = hoverTileRef.current;+ const showFoot = paint.tool != null && FOOT[paint.tool] && hov && cs?.cellSize && origin;+ if (showFoot && hov && cs?.cellSize && origin) {+ const fw = paint.tool === 'brush' ? paint.stamp.w : 1;+ const fh = paint.tool === 'brush' ? paint.stamp.h : 1;+ const tl = ViewportController.worldToClient(origin.x + hov.x * cs.cellSize.x, origin.y - hov.y * cs.cellSize.y);+ const br = ViewportController.worldToClient(origin.x + (hov.x + fw) * cs.cellSize.x, origin.y - (hov.y + fh) * cs.cellSize.y);+ if (tl && br) {+ pv.style.transform = `translate(${tl.x}px, ${tl.y}px)`;+ pv.style.width = `${br.x - tl.x}px`;+ pv.style.height = `${br.y - tl.y}px`;+ pv.style.opacity = '1';+ } else {+ pv.style.opacity = '0';+ }+ } else {+ pv.style.opacity = '0';+ }+ }}// Scene-camera gizmos — only in edit mode (in play the viewport IS the@@ -459,6 +487,13 @@ export function Viewport() {panRef.current.py = e.clientY;return;}+ // Track the hovered tile for the brush preview (only over the selected TilemapLayer+ // with a paint tool active; the rAF draws the footprint).+ const sid = useTilemapPaint.getState().tool ? useSelection.getState().selectedId : null;+ const isTm = sid != null+ && !!SceneModel.entityBySource(sid)?.components.some((c) => c.type === 'TilemapLayer');+ hoverTileRef.current = sid != null && isTm ? cursorTile(e.clientX, e.clientY, sid) : null;+activeToolRef.current?.onPointerMove(toInput(e), toolCtx);};@@ -553,7 +588,7 @@ export function Viewport() {onPointerMove={onPointerMove}onPointerUp={endDrag}onPointerCancel={endDrag}- onPointerLeave={() => StatsStore.clearCursor()}+ onPointerLeave={() => { StatsStore.clearCursor(); hoverTileRef.current = null; }}onContextMenu={(e) => e.preventDefault()}onDragOver={onDragOver}onDrop={onDrop}@@ -618,6 +653,7 @@ export function Viewport() {<div ref={selectionRef} className="viewport__selection" aria-hidden="true" /><div ref={tileSelRef} className="viewport__tilesel" aria-hidden="true" />+ <div ref={tilePreviewRef} className="viewport__tilepreview" aria-hidden="true" /><div ref={gizmoRef} className="viewport__gizmo" aria-hidden="true"><GizmoGlyph tool={tool} />diff --git a/desktop/src/theme/app.css b/desktop/src/theme/app.cssindex f03787818..5b71b14eb 100644--- a/desktop/src/theme/app.css+++ b/desktop/src/theme/app.css@@ -594,6 +594,18 @@background: rgba(90, 200, 250, 0.12);will-change: transform, width, height, opacity;}+.viewport__tilepreview {+ position: absolute;+ top: 0;+ left: 0;+ z-index: 1;+ opacity: 0;+ pointer-events: none;+ border: 1px solid rgba(255, 255, 255, 0.85);+ background: rgba(255, 255, 255, 0.1);+ box-shadow: inset 0 0 0 1px rgba(14, 15, 18, 0.5);+ will-change: transform, width, height, opacity;+}.viewport__stage.has-grid {background-image:linear-gradient(var(--line-soft) 1px, transparent 1px),diff --git a/desktop/src/tools/tileTools.ts b/desktop/src/tools/tileTools.tsindex 141d57590..9c5167707 100644--- a/desktop/src/tools/tileTools.ts+++ b/desktop/src/tools/tileTools.ts@@ -24,7 +24,7 @@ import type { EditorTool, PointerInput } from './EditorTool';// Cursor (client px) → tile grid coords on a TilemapLayer entity: client→world via// the editor camera, then world→tile around the layer's world origin (its Transform).-function cursorTile(clientX: number, clientY: number, sourceId: number): { x: number; y: number } | null {+export function cursorTile(clientX: number, clientY: number, sourceId: number): { x: number; y: number } | null {const rt = SceneModel.runtimeFor(sourceId);const wp = ViewportController.canvasToWorld(clientX, clientY);const ep = rt != null ? ViewportController.getEntityXY(rt) : null;