Files
esengine/packages/tilemap-editor/src/components/TilemapCanvas.tsx
YHH 63f006ab62 feat: 添加跨平台运行时、资产系统和UI适配功能 (#256)
* feat(platform-common): 添加WASM加载器和环境检测API

* feat(rapier2d): 新增Rapier2D WASM绑定包

* feat(physics-rapier2d): 添加跨平台WASM加载器

* feat(asset-system): 添加运行时资产目录和bundle格式

* feat(asset-system-editor): 新增编辑器资产管理包

* feat(editor-core): 添加构建系统和模块管理

* feat(editor-app): 重构浏览器预览使用import maps

* feat(platform-web): 添加BrowserRuntime和资产读取

* feat(engine): 添加材质系统和着色器管理

* feat(material): 新增材质系统和着色器编辑器

* feat(tilemap): 增强tilemap编辑器和动画系统

* feat(modules): 添加module.json配置

* feat(core): 添加module.json和类型定义更新

* chore: 更新依赖和构建配置

* refactor(plugins): 更新插件模板使用ModuleManifest

* chore: 添加第三方依赖库

* chore: 移除BehaviourTree-ai和ecs-astar子模块

* docs: 更新README和文档主题样式

* fix: 修复Rust文档测试和添加rapier2d WASM绑定

* fix(tilemap-editor): 修复画布高DPI屏幕分辨率适配问题

* feat(ui): 添加UI屏幕适配系统(CanvasScaler/SafeArea)

* fix(ecs-engine-bindgen): 添加缺失的ecs-framework-math依赖

* fix: 添加缺失的包依赖修复CI构建

* fix: 修复CodeQL检测到的代码问题

* fix: 修复构建错误和缺失依赖

* fix: 修复类型检查错误

* fix(material-system): 修复tsconfig配置支持TypeScript项目引用

* fix(editor-core): 修复Rollup构建配置添加tauri external

* fix: 修复CodeQL检测到的代码问题

* fix: 修复CodeQL检测到的代码问题
2025-12-03 22:15:22 +08:00

497 lines
17 KiB
TypeScript

/**
* Tilemap Canvas - Main editing canvas
*/
import React, { useRef, useEffect, useState, useCallback } from 'react';
import type { TilemapComponent } from '@esengine/tilemap';
import { tilemapAnimationSystem } from '@esengine/tilemap';
import { useTilemapEditorStore } from '../stores/TilemapEditorStore';
import type { ITilemapTool, ToolContext } from '../tools/ITilemapTool';
import { BrushTool } from '../tools/BrushTool';
import { EraserTool } from '../tools/EraserTool';
import { FillTool } from '../tools/FillTool';
import { RectangleTool } from '../tools/RectangleTool';
import { SelectTool } from '../tools/SelectTool';
interface TilemapCanvasProps {
tilemap: TilemapComponent;
tilesetImage: HTMLImageElement | null;
onTilemapChange?: () => void;
}
const tools: Record<string, ITilemapTool> = {
brush: new BrushTool(),
eraser: new EraserTool(),
fill: new FillTool(),
rectangle: new RectangleTool(),
select: new SelectTool(),
};
export const TilemapCanvas: React.FC<TilemapCanvasProps> = ({
tilemap,
tilesetImage,
onTilemapChange,
}) => {
const canvasRef = useRef<HTMLCanvasElement>(null);
const containerRef = useRef<HTMLDivElement>(null);
const {
currentTool,
zoom,
panX,
panY,
showGrid,
showCollision,
selectedTiles,
brushSize,
currentLayer,
editingCollision,
tileWidth,
tileHeight,
tilesetColumns,
layers,
setPan,
setZoom,
pushUndo,
} = useTilemapEditorStore();
// Get layer locked state
const layerLocked = layers[currentLayer]?.locked ?? false;
// Create a dependency key from layers state to trigger redraw when visibility/opacity changes
const layersKey = layers.map(l => `${l.visible}-${l.opacity}`).join(',');
const [isPanning, setIsPanning] = useState(false);
const lastPanPosRef = useRef({ x: 0, y: 0 });
const [mousePos, setMousePos] = useState<{ tileX: number; tileY: number } | null>(null);
const [spacePressed, setSpacePressed] = useState(false);
const [animationTime, setAnimationTime] = useState(0);
const lastFrameTimeRef = useRef<number>(0);
const animationFrameRef = useRef<number | null>(null);
// Get canvas size
const canvasWidth = tilemap.width * tileWidth;
const canvasHeight = tilemap.height * tileHeight;
// Draw the tilemap
const draw = useCallback(() => {
const canvas = canvasRef.current;
if (!canvas) return;
const ctx = canvas.getContext('2d');
if (!ctx) return;
const dpr = window.devicePixelRatio || 1;
// Clear
ctx.fillStyle = '#2d2d2d';
ctx.fillRect(0, 0, canvas.width, canvas.height);
ctx.save();
ctx.scale(dpr, dpr);
ctx.translate(panX, panY);
ctx.scale(zoom, zoom);
// Draw tilemap background
ctx.fillStyle = '#1a1a1a';
ctx.fillRect(0, 0, canvasWidth, canvasHeight);
// Draw tiles from all visible layers (from bottom to top)
if (tilesetImage) {
ctx.imageSmoothingEnabled = false;
// Draw all layers from tilemap component, respecting visibility and opacity
const tilemapLayers = tilemap.layers;
for (let layerIndex = tilemapLayers.length - 1; layerIndex >= 0; layerIndex--) {
const tilemapLayer = tilemapLayers[layerIndex];
if (!tilemapLayer || !tilemapLayer.visible) continue; // Skip undefined or invisible layers
// Apply layer opacity
const savedAlpha = ctx.globalAlpha;
ctx.globalAlpha = tilemapLayer.opacity ?? 1;
for (let y = 0; y < tilemap.height; y++) {
for (let x = 0; x < tilemap.width; x++) {
const tileIndex = tilemap.getTile(layerIndex, x, y);
if (tileIndex > 0) {
// Get the tileset index for this tile (assuming single tileset for now)
// tileIndex is 1-based (0 = empty), so tileId = tileIndex - 1
const tileId = tileIndex - 1;
// Get current animation frame tile ID (returns original if not animated)
const displayTileId = tilemapAnimationSystem.getCurrentTileId(0, tileId);
// Calculate source position in tileset
const srcX = (displayTileId % tilesetColumns) * tileWidth;
const srcY = Math.floor(displayTileId / tilesetColumns) * tileHeight;
// Only draw if tile is within tileset bounds
if (srcX + tileWidth <= tilesetImage.width && srcY + tileHeight <= tilesetImage.height) {
ctx.drawImage(
tilesetImage,
srcX, srcY, tileWidth, tileHeight,
x * tileWidth, y * tileHeight, tileWidth, tileHeight
);
}
}
}
}
// Restore opacity
ctx.globalAlpha = savedAlpha;
}
}
// Draw collision overlay
if (showCollision) {
ctx.fillStyle = 'rgba(255, 0, 0, 0.3)';
for (let y = 0; y < tilemap.height; y++) {
for (let x = 0; x < tilemap.width; x++) {
if (tilemap.hasCollision(x, y)) {
ctx.fillRect(x * tileWidth, y * tileHeight, tileWidth, tileHeight);
}
}
}
}
// Draw grid
if (showGrid) {
ctx.strokeStyle = 'rgba(255, 255, 255, 0.1)';
ctx.lineWidth = 1 / zoom;
for (let x = 0; x <= tilemap.width; x++) {
ctx.beginPath();
ctx.moveTo(x * tileWidth, 0);
ctx.lineTo(x * tileWidth, canvasHeight);
ctx.stroke();
}
for (let y = 0; y <= tilemap.height; y++) {
ctx.beginPath();
ctx.moveTo(0, y * tileHeight);
ctx.lineTo(canvasWidth, y * tileHeight);
ctx.stroke();
}
}
// Draw tool preview
if (mousePos && tools[currentTool]?.getPreviewTiles) {
const tool = tools[currentTool];
const toolContext: ToolContext = {
tilemap,
selectedTiles,
currentLayer,
layerLocked,
brushSize,
editingCollision,
tileWidth,
tileHeight,
};
const previewTiles = tool.getPreviewTiles!(mousePos.tileX, mousePos.tileY, toolContext);
ctx.fillStyle = editingCollision ? 'rgba(255, 0, 0, 0.3)' : 'rgba(0, 120, 212, 0.3)';
for (const tile of previewTiles) {
if (tile.x >= 0 && tile.x < tilemap.width && tile.y >= 0 && tile.y < tilemap.height) {
ctx.fillRect(tile.x * tileWidth, tile.y * tileHeight, tileWidth, tileHeight);
}
}
}
ctx.restore();
}, [tilemap, tilesetImage, zoom, panX, panY, showGrid, showCollision, mousePos, currentTool, selectedTiles, brushSize, currentLayer, layerLocked, editingCollision, tileWidth, tileHeight, tilesetColumns, canvasWidth, canvasHeight, layersKey, animationTime]);
// Update canvas size
useEffect(() => {
const canvas = canvasRef.current;
const container = containerRef.current;
if (!canvas || !container) return;
let rafId: number | null = null;
const resizeObserver = new ResizeObserver(() => {
// 使用 requestAnimationFrame 避免 ResizeObserver loop 错误
// Use requestAnimationFrame to avoid ResizeObserver loop errors
if (rafId !== null) {
cancelAnimationFrame(rafId);
}
rafId = requestAnimationFrame(() => {
const dpr = window.devicePixelRatio || 1;
const newWidth = container.clientWidth;
const newHeight = container.clientHeight;
const scaledWidth = Math.floor(newWidth * dpr);
const scaledHeight = Math.floor(newHeight * dpr);
if (canvas.width !== scaledWidth || canvas.height !== scaledHeight) {
canvas.width = scaledWidth;
canvas.height = scaledHeight;
canvas.style.width = `${newWidth}px`;
canvas.style.height = `${newHeight}px`;
draw();
}
rafId = null;
});
});
resizeObserver.observe(container);
return () => {
if (rafId !== null) {
cancelAnimationFrame(rafId);
}
resizeObserver.disconnect();
};
}, [draw]);
useEffect(() => {
draw();
}, [draw]);
// Register tileset animations when tilemap changes
useEffect(() => {
tilemapAnimationSystem.clear();
for (let i = 0; i < tilemap.tilesets.length; i++) {
const tilesetRef = tilemap.tilesets[i];
if (tilesetRef.data) {
tilemapAnimationSystem.registerTileset(i, tilesetRef.data);
}
}
return () => {
tilemapAnimationSystem.clear();
};
}, [tilemap]);
// Animation loop for animated tiles
useEffect(() => {
const animate = (time: number) => {
if (lastFrameTimeRef.current === 0) {
lastFrameTimeRef.current = time;
}
const deltaTime = time - lastFrameTimeRef.current;
lastFrameTimeRef.current = time;
tilemapAnimationSystem.update(deltaTime);
setAnimationTime(time);
animationFrameRef.current = requestAnimationFrame(animate);
};
animationFrameRef.current = requestAnimationFrame(animate);
return () => {
if (animationFrameRef.current !== null) {
cancelAnimationFrame(animationFrameRef.current);
}
};
}, []);
// Center view on first mount
useEffect(() => {
const container = containerRef.current;
if (!container) return;
// Only center if pan is at default position (0, 0)
if (panX === 0 && panY === 0) {
const containerWidth = container.clientWidth;
const containerHeight = container.clientHeight;
const mapPixelWidth = canvasWidth * zoom;
const mapPixelHeight = canvasHeight * zoom;
const centerX = (containerWidth - mapPixelWidth) / 2;
const centerY = (containerHeight - mapPixelHeight) / 2;
setPan(centerX, centerY);
}
}, []); // Only run on mount
// Space key for panning mode
useEffect(() => {
const handleKeyDown = (e: KeyboardEvent) => {
if (e.code === 'Space' && !e.repeat) {
e.preventDefault();
setSpacePressed(true);
}
};
const handleKeyUp = (e: KeyboardEvent) => {
if (e.code === 'Space') {
setSpacePressed(false);
setIsPanning(false);
}
};
window.addEventListener('keydown', handleKeyDown);
window.addEventListener('keyup', handleKeyUp);
return () => {
window.removeEventListener('keydown', handleKeyDown);
window.removeEventListener('keyup', handleKeyUp);
};
}, []);
// Convert screen coordinates to tile coordinates
const screenToTile = useCallback((screenX: number, screenY: number) => {
const x = (screenX - panX) / zoom;
const y = (screenY - panY) / zoom;
return {
tileX: Math.floor(x / tileWidth),
tileY: Math.floor(y / tileHeight),
};
}, [panX, panY, zoom, tileWidth, tileHeight]);
// Mouse handlers
const handleMouseDown = (e: React.MouseEvent) => {
const rect = canvasRef.current?.getBoundingClientRect();
if (!rect) return;
const x = e.clientX - rect.left;
const y = e.clientY - rect.top;
// Middle mouse button, Alt+left click, or Space+left click for panning
if (e.button === 1 || (e.button === 0 && (e.altKey || spacePressed))) {
setIsPanning(true);
lastPanPosRef.current = { x: e.clientX, y: e.clientY };
return;
}
// Save undo state
const layerData = tilemap.getLayerData(currentLayer);
if (layerData) {
pushUndo(layerData.slice());
}
const { tileX, tileY } = screenToTile(x, y);
const tool = tools[currentTool];
if (tool) {
const toolContext: ToolContext = {
tilemap,
selectedTiles,
currentLayer,
layerLocked,
brushSize,
editingCollision,
tileWidth,
tileHeight,
};
tool.onMouseDown(tileX, tileY, toolContext);
onTilemapChange?.();
// draw() 由 useEffect 统一处理,避免重复绘制导致闪烁
}
};
const handleMouseMove = (e: React.MouseEvent) => {
const rect = canvasRef.current?.getBoundingClientRect();
if (!rect) return;
const x = e.clientX - rect.left;
const y = e.clientY - rect.top;
// Handle panning
if (isPanning) {
const dx = e.clientX - lastPanPosRef.current.x;
const dy = e.clientY - lastPanPosRef.current.y;
const state = useTilemapEditorStore.getState();
setPan(state.panX + dx, state.panY + dy);
lastPanPosRef.current = { x: e.clientX, y: e.clientY };
return;
}
const { tileX, tileY } = screenToTile(x, y);
setMousePos({ tileX, tileY });
// Handle tool drag
if (e.buttons === 1) {
const tool = tools[currentTool];
if (tool) {
const toolContext: ToolContext = {
tilemap,
selectedTiles,
currentLayer,
layerLocked,
brushSize,
editingCollision,
tileWidth,
tileHeight,
};
tool.onMouseMove(tileX, tileY, toolContext);
onTilemapChange?.();
}
}
// draw() 由 setMousePos 触发的 useEffect 统一处理
};
const handleMouseUp = (e: React.MouseEvent) => {
if (isPanning) {
setIsPanning(false);
return;
}
const rect = canvasRef.current?.getBoundingClientRect();
if (!rect) return;
const x = e.clientX - rect.left;
const y = e.clientY - rect.top;
const { tileX, tileY } = screenToTile(x, y);
const tool = tools[currentTool];
if (tool) {
const toolContext: ToolContext = {
tilemap,
selectedTiles,
currentLayer,
layerLocked,
brushSize,
editingCollision,
tileWidth,
tileHeight,
};
tool.onMouseUp(tileX, tileY, toolContext);
}
};
const handleMouseLeave = () => {
setMousePos(null);
// draw() 由 setMousePos 触发的 useEffect 统一处理
};
const handleWheel = (e: React.WheelEvent) => {
e.preventDefault();
const delta = e.deltaY > 0 ? 0.9 : 1.1;
const newZoom = Math.max(0.1, Math.min(10, zoom * delta));
// Zoom towards mouse position
const rect = canvasRef.current?.getBoundingClientRect();
if (rect) {
const mouseX = e.clientX - rect.left;
const mouseY = e.clientY - rect.top;
const newPanX = mouseX - (mouseX - panX) * (newZoom / zoom);
const newPanY = mouseY - (mouseY - panY) * (newZoom / zoom);
setPan(newPanX, newPanY);
}
setZoom(newZoom);
};
// Determine cursor style
const getCursor = () => {
if (isPanning) return 'grabbing';
if (spacePressed) return 'grab';
return tools[currentTool]?.cursor || 'crosshair';
};
return (
<div ref={containerRef} className="tilemap-canvas-container">
<canvas
ref={canvasRef}
className="tilemap-canvas"
onMouseDown={handleMouseDown}
onMouseMove={handleMouseMove}
onMouseUp={handleMouseUp}
onMouseLeave={handleMouseLeave}
onWheel={handleWheel}
onContextMenu={(e) => e.preventDefault()}
style={{ cursor: getCursor() }}
/>
</div>
);
};