Feature/render pipeline (#232)
* refactor(engine): 重构2D渲染管线坐标系统 * feat(engine): 完善2D渲染管线和编辑器视口功能 * feat(editor): 实现Viewport变换工具系统 * feat(editor): 优化Inspector渲染性能并修复Gizmo变换工具显示 * feat(editor): 实现Run on Device移动预览功能 * feat(editor): 添加组件属性控制和依赖关系系统 * feat(editor): 实现动画预览功能和优化SpriteAnimator编辑器 * feat(editor): 修复SpriteAnimator动画预览功能并迁移CI到pnpm * feat(editor): 修复SpriteAnimator动画预览并迁移到pnpm * feat(editor): 修复SpriteAnimator动画预览并迁移到pnpm * feat(editor): 修复SpriteAnimator动画预览并迁移到pnpm * feat(editor): 修复SpriteAnimator动画预览并迁移到pnpm * feat(ci): 迁移项目到pnpm并修复CI构建问题 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 迁移CI工作流到pnpm并添加WASM构建支持 * chore: 移除 network 相关包 * chore: 移除 network 相关包
This commit is contained in:
YHH
GitHub
@@ -3,20 +3,14 @@
|
||||
* 管理Rust引擎生命周期的服务。
|
||||
*/
|
||||
|
||||
import { EngineBridge, SpriteComponent, EngineRenderSystem, ITransformComponent } from '@esengine/ecs-engine-bindgen';
|
||||
import { Core, Scene, Entity, Component, ECSComponent } from '@esengine/ecs-framework';
|
||||
import { EngineBridge, EngineRenderSystem, CameraConfig } from '@esengine/ecs-engine-bindgen';
|
||||
import { Core, Scene, Entity, SceneSerializer } from '@esengine/ecs-framework';
|
||||
import { TransformComponent, SpriteComponent, SpriteAnimatorSystem, SpriteAnimatorComponent } from '@esengine/ecs-components';
|
||||
import { EntityStoreService, MessageHub } from '@esengine/editor-core';
|
||||
import * as esEngine from '@esengine/engine';
|
||||
|
||||
/**
|
||||
* Transform component for editor entities.
|
||||
* 编辑器实体的变换组件。
|
||||
*/
|
||||
@ECSComponent('Transform')
|
||||
export class TransformComponent extends Component implements ITransformComponent {
|
||||
position = { x: 0, y: 0 };
|
||||
rotation = 0;
|
||||
scale = { x: 1, y: 1 };
|
||||
}
|
||||
import { AssetManager, EngineIntegration, AssetPathResolver, AssetPlatform } from '@esengine/asset-system';
|
||||
import { convertFileSrc } from '@tauri-apps/api/core';
|
||||
import { IdGenerator } from '../utils/idGenerator';
|
||||
|
||||
/**
|
||||
* Engine service singleton for editor integration.
|
||||
@@ -28,10 +22,17 @@ export class EngineService {
|
||||
private bridge: EngineBridge | null = null;
|
||||
private scene: Scene | null = null;
|
||||
private renderSystem: EngineRenderSystem | null = null;
|
||||
private animatorSystem: SpriteAnimatorSystem | null = null;
|
||||
private initialized = false;
|
||||
private running = false;
|
||||
private animationFrameId: number | null = null;
|
||||
private lastTime = 0;
|
||||
private sceneSnapshot: string | null = null;
|
||||
private assetManager: AssetManager | null = null;
|
||||
private engineIntegration: EngineIntegration | null = null;
|
||||
private assetPathResolver: AssetPathResolver | null = null;
|
||||
private assetSystemInitialized = false;
|
||||
private initializationError: Error | null = null;
|
||||
|
||||
private constructor() {}
|
||||
|
||||
@@ -64,29 +65,119 @@ export class EngineService {
|
||||
// Initialize WASM with pre-imported module | 使用预导入模块初始化WASM
|
||||
await this.bridge.initializeWithModule(esEngine);
|
||||
|
||||
// Set path resolver for Tauri asset URLs | 设置Tauri资产URL的路径解析器
|
||||
this.bridge.setPathResolver((path: string) => {
|
||||
// If already a URL, return as-is
|
||||
if (path.startsWith('http://') ||
|
||||
path.startsWith('https://') ||
|
||||
path.startsWith('data:') ||
|
||||
path.startsWith('asset://')) {
|
||||
return path;
|
||||
}
|
||||
// Convert file path to Tauri asset URL
|
||||
return convertFileSrc(path);
|
||||
});
|
||||
|
||||
// Initialize Core if not already | 初始化Core（如果尚未初始化）
|
||||
if (!Core.scene) {
|
||||
Core.create({ debug: false });
|
||||
}
|
||||
|
||||
// Create ECS scene and set it via Core | 通过Core创建并设置ECS场景
|
||||
this.scene = new Scene({ name: 'EditorScene' });
|
||||
// Use existing Core scene or create new one | 使用现有Core场景或创建新的
|
||||
if (Core.scene) {
|
||||
this.scene = Core.scene as Scene;
|
||||
} else {
|
||||
this.scene = new Scene({ name: 'EditorScene' });
|
||||
Core.setScene(this.scene);
|
||||
}
|
||||
|
||||
// Add render system | 添加渲染系统
|
||||
// Add sprite animator system (disabled by default in editor mode)
|
||||
// 添加精灵动画系统（编辑器模式下默认禁用）
|
||||
this.animatorSystem = new SpriteAnimatorSystem();
|
||||
this.animatorSystem.enabled = false;
|
||||
this.scene!.addSystem(this.animatorSystem);
|
||||
|
||||
// Add render system to the scene | 将渲染系统添加到场景
|
||||
this.renderSystem = new EngineRenderSystem(this.bridge, TransformComponent);
|
||||
this.scene.addSystem(this.renderSystem);
|
||||
this.scene!.addSystem(this.renderSystem);
|
||||
|
||||
// Set scene via Core | 通过Core设置场景
|
||||
Core.setScene(this.scene);
|
||||
// Initialize asset system | 初始化资产系统
|
||||
await this.initializeAssetSystem();
|
||||
|
||||
// Start the default world to enable system updates
|
||||
// 启动默认world以启用系统更新
|
||||
const defaultWorld = Core.worldManager.getWorld('__default__');
|
||||
if (defaultWorld && !defaultWorld.isActive) {
|
||||
defaultWorld.start();
|
||||
}
|
||||
|
||||
this.initialized = true;
|
||||
console.log('EngineService initialized | 引擎服务初始化完成');
|
||||
|
||||
// Sync viewport size immediately after initialization
|
||||
// 初始化后立即同步视口尺寸
|
||||
const canvas = document.getElementById(canvasId) as HTMLCanvasElement;
|
||||
if (canvas && canvas.parentElement) {
|
||||
// Get container size in CSS pixels
|
||||
// 获取容器尺寸（CSS像素）
|
||||
const rect = canvas.parentElement.getBoundingClientRect();
|
||||
const dpr = window.devicePixelRatio || 1;
|
||||
|
||||
// Canvas internal size uses DPR for sharpness
|
||||
// Canvas内部尺寸使用DPR以保持清晰
|
||||
canvas.width = Math.floor(rect.width * dpr);
|
||||
canvas.height = Math.floor(rect.height * dpr);
|
||||
canvas.style.width = `${rect.width}px`;
|
||||
canvas.style.height = `${rect.height}px`;
|
||||
|
||||
// Camera uses actual canvas pixels for correct rendering
|
||||
// 相机使用实际canvas像素以保证正确渲染
|
||||
this.bridge.resize(canvas.width, canvas.height);
|
||||
}
|
||||
|
||||
// Auto-start render loop for editor preview | 自动启动渲染循环用于编辑器预览
|
||||
this.startRenderLoop();
|
||||
} catch (error) {
|
||||
console.error('Failed to initialize engine | 引擎初始化失败:', error);
|
||||
throw error;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Start render loop (editor preview mode).
|
||||
* 启动渲染循环（编辑器预览模式）。
|
||||
*/
|
||||
private startRenderLoop(): void {
|
||||
if (this.animationFrameId !== null) {
|
||||
return;
|
||||
}
|
||||
this.lastTime = performance.now();
|
||||
this.renderLoop();
|
||||
}
|
||||
|
||||
private frameCount = 0;
|
||||
|
||||
/**
|
||||
* Render loop for editor preview (always runs).
|
||||
* 编辑器预览的渲染循环（始终运行）。
|
||||
*/
|
||||
private renderLoop = (): void => {
|
||||
const currentTime = performance.now();
|
||||
const deltaTime = (currentTime - this.lastTime) / 1000;
|
||||
this.lastTime = currentTime;
|
||||
|
||||
this.frameCount++;
|
||||
|
||||
// Update via Core (handles deltaTime internally) | 通过Core更新
|
||||
Core.update(deltaTime);
|
||||
|
||||
// Note: Rendering is handled by EngineRenderSystem.process()
|
||||
// Texture loading is handled automatically via Rust engine's path-based loading
|
||||
// 注意：渲染由 EngineRenderSystem.process() 处理
|
||||
// 纹理加载由Rust引擎的路径加载自动处理
|
||||
|
||||
this.animationFrameId = requestAnimationFrame(this.renderLoop);
|
||||
};
|
||||
|
||||
/**
|
||||
* Check if engine is initialized.
|
||||
* 检查引擎是否已初始化。
|
||||
@@ -114,19 +205,82 @@ export class EngineService {
|
||||
|
||||
this.running = true;
|
||||
this.lastTime = performance.now();
|
||||
|
||||
// Enable animator system and start auto-play animations
|
||||
// 启用动画系统并启动自动播放的动画
|
||||
if (this.animatorSystem) {
|
||||
this.animatorSystem.enabled = true;
|
||||
}
|
||||
this.startAutoPlayAnimations();
|
||||
|
||||
this.gameLoop();
|
||||
}
|
||||
|
||||
/**
|
||||
* Start all auto-play animations.
|
||||
* 启动所有自动播放的动画。
|
||||
*/
|
||||
private startAutoPlayAnimations(): void {
|
||||
if (!this.scene) return;
|
||||
|
||||
const entities = this.scene.entities.findEntitiesWithComponent(SpriteAnimatorComponent);
|
||||
for (const entity of entities) {
|
||||
const animator = entity.getComponent(SpriteAnimatorComponent);
|
||||
if (animator && animator.autoPlay && animator.defaultAnimation) {
|
||||
animator.play();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop all animations and reset to first frame.
|
||||
* 停止所有动画并重置到第一帧。
|
||||
*/
|
||||
private stopAllAnimations(): void {
|
||||
if (!this.scene) return;
|
||||
|
||||
const entities = this.scene.entities.findEntitiesWithComponent(SpriteAnimatorComponent);
|
||||
for (const entity of entities) {
|
||||
const animator = entity.getComponent(SpriteAnimatorComponent);
|
||||
if (animator) {
|
||||
animator.stop();
|
||||
|
||||
// Reset sprite texture to first frame
|
||||
// 重置精灵纹理到第一帧
|
||||
const sprite = entity.getComponent(SpriteComponent);
|
||||
if (sprite && animator.clips && animator.clips.length > 0) {
|
||||
const firstClip = animator.clips[0];
|
||||
if (firstClip && firstClip.frames && firstClip.frames.length > 0) {
|
||||
const firstFrame = firstClip.frames[0];
|
||||
if (firstFrame && firstFrame.texture) {
|
||||
sprite.texture = firstFrame.texture;
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Stop the game loop.
|
||||
* 停止游戏循环。
|
||||
*/
|
||||
stop(): void {
|
||||
this.running = false;
|
||||
if (this.animationFrameId !== null) {
|
||||
cancelAnimationFrame(this.animationFrameId);
|
||||
this.animationFrameId = null;
|
||||
|
||||
// Disable animator system and stop all animations
|
||||
// 禁用动画系统并停止所有动画
|
||||
if (this.animatorSystem) {
|
||||
this.animatorSystem.enabled = false;
|
||||
}
|
||||
this.stopAllAnimations();
|
||||
|
||||
// Note: Don't cancel animationFrameId here, as renderLoop should keep running
|
||||
// for editor preview. The renderLoop will continue but gameLoop will stop
|
||||
// because this.running is false.
|
||||
// 注意：这里不要取消 animationFrameId，因为 renderLoop 应该继续运行
|
||||
// 用于编辑器预览。renderLoop 会继续运行，但 gameLoop 会停止
|
||||
// 因为 this.running 是 false。
|
||||
}
|
||||
|
||||
/**
|
||||
@@ -185,6 +339,53 @@ export class EngineService {
|
||||
return entity;
|
||||
}
|
||||
|
||||
/**
|
||||
* Initialize asset system
|
||||
* 初始化资产系统
|
||||
*/
|
||||
private async initializeAssetSystem(): Promise<void> {
|
||||
try {
|
||||
// 创建资产管理器 / Create asset manager
|
||||
this.assetManager = new AssetManager();
|
||||
|
||||
// 创建路径解析器 / Create path resolver
|
||||
this.assetPathResolver = new AssetPathResolver({
|
||||
platform: AssetPlatform.Editor,
|
||||
pathTransformer: (path: string) => {
|
||||
// 编辑器平台使用Tauri的convertFileSrc
|
||||
// Use Tauri's convertFileSrc for editor platform
|
||||
if (!path.startsWith('http://') && !path.startsWith('https://') && !path.startsWith('data:')) {
|
||||
return convertFileSrc(path);
|
||||
}
|
||||
return path;
|
||||
}
|
||||
});
|
||||
|
||||
// 创建引擎集成 / Create engine integration
|
||||
if (this.bridge) {
|
||||
this.engineIntegration = new EngineIntegration(this.assetManager, this.bridge);
|
||||
}
|
||||
|
||||
this.assetSystemInitialized = true;
|
||||
this.initializationError = null;
|
||||
} catch (error) {
|
||||
this.assetSystemInitialized = false;
|
||||
this.initializationError = error instanceof Error ? error : new Error(String(error));
|
||||
console.error('Failed to initialize asset system:', error);
|
||||
|
||||
// Notify user of failure
|
||||
const messageHub = Core.services.tryResolve<MessageHub>(MessageHub);
|
||||
if (messageHub) {
|
||||
messageHub.publish('notification:error', {
|
||||
title: 'Asset System Error',
|
||||
message: 'Failed to initialize asset system. Some features may not work properly.'
|
||||
});
|
||||
}
|
||||
|
||||
throw this.initializationError;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Load texture.
|
||||
* 加载纹理。
|
||||
@@ -195,6 +396,70 @@ export class EngineService {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Load texture through asset system
|
||||
* 通过资产系统加载纹理
|
||||
*/
|
||||
async loadTextureAsset(path: string): Promise<number> {
|
||||
// Check if asset system is properly initialized
|
||||
if (!this.assetSystemInitialized || this.initializationError) {
|
||||
console.warn('Asset system not initialized, using fallback texture loading');
|
||||
const textureId = IdGenerator.nextId('texture-fallback');
|
||||
this.loadTexture(textureId, path);
|
||||
return textureId;
|
||||
}
|
||||
|
||||
if (!this.engineIntegration) {
|
||||
// 回退到直接加载 / Fallback to direct loading
|
||||
const textureId = IdGenerator.nextId('texture');
|
||||
this.loadTexture(textureId, path);
|
||||
return textureId;
|
||||
}
|
||||
|
||||
try {
|
||||
return await this.engineIntegration.loadTextureForComponent(path);
|
||||
} catch (error) {
|
||||
console.error('Failed to load texture asset:', error);
|
||||
// Return a valid fallback ID instead of 0
|
||||
const fallbackId = IdGenerator.nextId('texture-fallback');
|
||||
|
||||
// Notify about texture loading failure
|
||||
const messageHub = Core.services.tryResolve<MessageHub>(MessageHub);
|
||||
if (messageHub) {
|
||||
messageHub.publish('notification:warning', {
|
||||
title: 'Texture Loading Failed',
|
||||
message: `Could not load texture: ${path}`
|
||||
});
|
||||
}
|
||||
|
||||
return fallbackId;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get asset manager
|
||||
* 获取资产管理器
|
||||
*/
|
||||
getAssetManager(): AssetManager | null {
|
||||
return this.assetManager;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get engine integration
|
||||
* 获取引擎集成
|
||||
*/
|
||||
getEngineIntegration(): EngineIntegration | null {
|
||||
return this.engineIntegration;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get asset path resolver
|
||||
* 获取资产路径解析器
|
||||
*/
|
||||
getAssetPathResolver(): AssetPathResolver | null {
|
||||
return this.assetPathResolver;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get engine statistics.
|
||||
* 获取引擎统计信息。
|
||||
@@ -220,6 +485,45 @@ export class EngineService {
|
||||
return this.scene;
|
||||
}
|
||||
|
||||
/**
|
||||
* Enable animation preview in editor mode.
|
||||
* 在编辑器模式下启用动画预览。
|
||||
*/
|
||||
enableAnimationPreview(): void {
|
||||
if (this.animatorSystem && !this.running) {
|
||||
// Clear entity cache to force re-query when enabled
|
||||
// 清除实体缓存以便启用时强制重新查询
|
||||
this.animatorSystem.clearEntityCache();
|
||||
this.animatorSystem.enabled = true;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Disable animation preview in editor mode.
|
||||
* 在编辑器模式下禁用动画预览。
|
||||
*/
|
||||
disableAnimationPreview(): void {
|
||||
if (this.animatorSystem && !this.running) {
|
||||
this.animatorSystem.enabled = false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if animation preview is enabled.
|
||||
* 检查动画预览是否启用。
|
||||
*/
|
||||
isAnimationPreviewEnabled(): boolean {
|
||||
return this.animatorSystem?.enabled ?? false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Get the engine bridge.
|
||||
* 获取引擎桥接。
|
||||
*/
|
||||
getBridge(): EngineBridge | null {
|
||||
return this.bridge;
|
||||
}
|
||||
|
||||
/**
|
||||
* Resize the engine viewport.
|
||||
* 调整引擎视口大小。
|
||||
@@ -230,6 +534,278 @@ export class EngineService {
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set camera position, zoom, and rotation.
|
||||
* 设置相机位置、缩放和旋转。
|
||||
*/
|
||||
setCamera(config: CameraConfig): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.setCamera(config);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get camera state.
|
||||
* 获取相机状态。
|
||||
*/
|
||||
getCamera(): CameraConfig {
|
||||
if (this.bridge) {
|
||||
return this.bridge.getCamera();
|
||||
}
|
||||
return { x: 0, y: 0, zoom: 1, rotation: 0 };
|
||||
}
|
||||
|
||||
/**
|
||||
* Set grid visibility.
|
||||
* 设置网格可见性。
|
||||
*/
|
||||
setShowGrid(show: boolean): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.setShowGrid(show);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set clear color (background color).
|
||||
* 设置清除颜色（背景颜色）。
|
||||
*/
|
||||
setClearColor(r: number, g: number, b: number, a: number = 1.0): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.setClearColor(r, g, b, a);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set gizmo visibility.
|
||||
* 设置Gizmo可见性。
|
||||
*/
|
||||
setShowGizmos(show: boolean): void {
|
||||
if (this.renderSystem) {
|
||||
this.renderSystem.setShowGizmos(show);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get gizmo visibility.
|
||||
* 获取Gizmo可见性。
|
||||
*/
|
||||
getShowGizmos(): boolean {
|
||||
return this.renderSystem?.getShowGizmos() ?? true;
|
||||
}
|
||||
|
||||
// ===== Scene Snapshot API =====
|
||||
// ===== 场景快照 API =====
|
||||
|
||||
/**
|
||||
* Save a snapshot of the current scene state.
|
||||
* 保存当前场景状态的快照。
|
||||
*/
|
||||
saveSceneSnapshot(): boolean {
|
||||
if (!this.scene) {
|
||||
console.warn('Cannot save snapshot: no scene available');
|
||||
return false;
|
||||
}
|
||||
|
||||
try {
|
||||
// Use SceneSerializer from core library
|
||||
this.sceneSnapshot = SceneSerializer.serialize(this.scene, {
|
||||
format: 'json',
|
||||
pretty: false,
|
||||
includeMetadata: false
|
||||
}) as string;
|
||||
|
||||
return true;
|
||||
} catch (error) {
|
||||
console.error('Failed to save scene snapshot:', error);
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Restore scene state from saved snapshot.
|
||||
* 从保存的快照恢复场景状态。
|
||||
*/
|
||||
restoreSceneSnapshot(): boolean {
|
||||
if (!this.scene || !this.sceneSnapshot) {
|
||||
console.warn('Cannot restore snapshot: no scene or snapshot available');
|
||||
return false;
|
||||
}
|
||||
|
||||
try {
|
||||
// Use SceneSerializer from core library
|
||||
SceneSerializer.deserialize(this.scene, this.sceneSnapshot, {
|
||||
strategy: 'replace',
|
||||
preserveIds: true
|
||||
});
|
||||
|
||||
// Sync EntityStore with restored scene entities
|
||||
const entityStore = Core.services.tryResolve(EntityStoreService);
|
||||
const messageHub = Core.services.tryResolve(MessageHub);
|
||||
if (entityStore && messageHub) {
|
||||
// Remember selected entity ID before clearing
|
||||
const selectedEntity = entityStore.getSelectedEntity();
|
||||
const selectedId = selectedEntity?.id;
|
||||
|
||||
// Clear old entities from store
|
||||
entityStore.clear();
|
||||
|
||||
// Add restored entities to store
|
||||
for (const entity of this.scene.entities.buffer) {
|
||||
entityStore.addEntity(entity);
|
||||
}
|
||||
|
||||
// Re-select the same entity (now with new reference)
|
||||
if (selectedId !== undefined) {
|
||||
const newEntity = entityStore.getEntity(selectedId);
|
||||
if (newEntity) {
|
||||
entityStore.selectEntity(newEntity);
|
||||
}
|
||||
}
|
||||
|
||||
// Notify UI to refresh
|
||||
messageHub.publish('scene:restored', {});
|
||||
}
|
||||
|
||||
this.sceneSnapshot = null;
|
||||
return true;
|
||||
} catch (error) {
|
||||
console.error('Failed to restore scene snapshot:', error);
|
||||
return false;
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Check if a snapshot exists.
|
||||
* 检查是否存在快照。
|
||||
*/
|
||||
hasSnapshot(): boolean {
|
||||
return this.sceneSnapshot !== null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set selected entity IDs for gizmo display.
|
||||
* 设置选中的实体ID用于Gizmo显示。
|
||||
*/
|
||||
setSelectedEntityIds(ids: number[]): void {
|
||||
if (this.renderSystem) {
|
||||
this.renderSystem.setSelectedEntityIds(ids);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set transform tool mode.
|
||||
* 设置变换工具模式。
|
||||
*/
|
||||
setTransformMode(mode: 'select' | 'move' | 'rotate' | 'scale'): void {
|
||||
if (this.renderSystem) {
|
||||
this.renderSystem.setTransformMode(mode);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get transform tool mode.
|
||||
* 获取变换工具模式。
|
||||
*/
|
||||
getTransformMode(): 'select' | 'move' | 'rotate' | 'scale' {
|
||||
return this.renderSystem?.getTransformMode() ?? 'select';
|
||||
}
|
||||
|
||||
// ===== Multi-viewport API =====
|
||||
// ===== 多视口 API =====
|
||||
|
||||
/**
|
||||
* Register a new viewport.
|
||||
* 注册新视口。
|
||||
*/
|
||||
registerViewport(id: string, canvasId: string): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.registerViewport(id, canvasId);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Unregister a viewport.
|
||||
* 注销视口。
|
||||
*/
|
||||
unregisterViewport(id: string): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.unregisterViewport(id);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Set the active viewport.
|
||||
* 设置活动视口。
|
||||
*/
|
||||
setActiveViewport(id: string): boolean {
|
||||
if (this.bridge) {
|
||||
return this.bridge.setActiveViewport(id);
|
||||
}
|
||||
return false;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set camera for a specific viewport.
|
||||
* 为特定视口设置相机。
|
||||
*/
|
||||
setViewportCamera(viewportId: string, config: CameraConfig): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.setViewportCamera(viewportId, config);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get camera for a specific viewport.
|
||||
* 获取特定视口的相机。
|
||||
*/
|
||||
getViewportCamera(viewportId: string): CameraConfig | null {
|
||||
if (this.bridge) {
|
||||
return this.bridge.getViewportCamera(viewportId);
|
||||
}
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* Set viewport configuration.
|
||||
* 设置视口配置。
|
||||
*/
|
||||
setViewportConfig(viewportId: string, showGrid: boolean, showGizmos: boolean): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.setViewportConfig(viewportId, showGrid, showGizmos);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Resize a specific viewport.
|
||||
* 调整特定视口大小。
|
||||
*/
|
||||
resizeViewport(viewportId: string, width: number, height: number): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.resizeViewport(viewportId, width, height);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Render to a specific viewport.
|
||||
* 渲染到特定视口。
|
||||
*/
|
||||
renderToViewport(viewportId: string): void {
|
||||
if (this.bridge) {
|
||||
this.bridge.renderToViewport(viewportId);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* Get all registered viewport IDs.
|
||||
* 获取所有已注册的视口ID。
|
||||
*/
|
||||
getViewportIds(): string[] {
|
||||
if (this.bridge) {
|
||||
return this.bridge.getViewportIds();
|
||||
}
|
||||
return [];
|
||||
}
|
||||
|
||||
/**
|
||||
* Dispose engine resources.
|
||||
* 释放引擎资源。
|
||||
@@ -237,6 +813,19 @@ export class EngineService {
|
||||
dispose(): void {
|
||||
this.stop();
|
||||
|
||||
// Stop render loop | 停止渲染循环
|
||||
if (this.animationFrameId !== null) {
|
||||
cancelAnimationFrame(this.animationFrameId);
|
||||
this.animationFrameId = null;
|
||||
}
|
||||
|
||||
// Dispose asset system | 释放资产系统
|
||||
if (this.assetManager) {
|
||||
this.assetManager.dispose();
|
||||
this.assetManager = null;
|
||||
}
|
||||
this.engineIntegration = null;
|
||||
|
||||
// Scene doesn't have a destroy method, just clear reference
|
||||
// 场景没有destroy方法，只需清除引用
|
||||
this.scene = null;
|
||||
|
||||
Reference in New Issue
Block a user