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
// SPDX-License-Identifier: Apache-2.0
// SPDX-FileCopyrightText: Copyright (c) 2024-present ESEngine Team
import { describe, it, expect, vi } from 'vitest';
import { CameraViewAPI } from '../src/camera/Camera';
const mockUICameraData = {
viewProjection: new Float32Array([
1, 0, 0, 0,
0, 1, 0, 0,
0, 0, 1, 0,
0, 0, 0, 1,
]),
vpX: 0,
vpY: 0,
vpW: 800,
vpH: 600,
screenW: 800,
screenH: 600,
worldLeft: -400,
worldRight: 400,
worldBottom: -300,
worldTop: 300,
worldMouseX: 50,
worldMouseY: -25,
valid: true,
};
function makeCamera(cameraData = mockUICameraData): CameraViewAPI {
const app = { getResource: vi.fn(() => cameraData) } as any;
return new CameraViewAPI(app);
}
describe('CameraViewAPI', () => {
it('returns null when the camera is invalid', () => {
const cam = makeCamera({ ...mockUICameraData, valid: false });
expect(cam.screenToWorld(400, 300)).toBeNull();
expect(cam.worldToScreen(0, 0)).toBeNull();
expect(cam.getWorldMousePosition()).toBeNull();
expect(cam.getWorldBounds()).toBeNull();
});
it('converts screen center to world origin with identity VP', () => {
const result = makeCamera().screenToWorld(400, 300);
expect(result).not.toBeNull();
expect(result!.x).toBeCloseTo(0, 1);
expect(result!.y).toBeCloseTo(0, 1);
});
it('converts world origin back to screen center', () => {
const result = makeCamera().worldToScreen(0, 0);
expect(result).not.toBeNull();
expect(result!.x).toBeCloseTo(400, 0);
expect(result!.y).toBeCloseTo(300, 0);
});
it('returns the world mouse position', () => {
expect(makeCamera().getWorldMousePosition()).toEqual({ x: 50, y: -25 });
});
it('returns the world bounds', () => {
expect(makeCamera().getWorldBounds()).toEqual({
left: -400, right: 400, bottom: -300, top: 300,
});
});
// The whole point of F3: two Apps each have their own CameraViewAPI reading
// their own UICameraInfo — no shared global `app_` to bleed between them.
it('is isolated per App', () => {
const a = makeCamera({ ...mockUICameraData, worldMouseX: 1, worldMouseY: 2 });
const b = makeCamera({ ...mockUICameraData, worldMouseX: 9, worldMouseY: 8 });
expect(a.getWorldMousePosition()).toEqual({ x: 1, y: 2 });
expect(b.getWorldMousePosition()).toEqual({ x: 9, y: 8 });
expect(a.getWorldMousePosition()).toEqual({ x: 1, y: 2 });
});
});