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 type { App } from '../app/app';
import type { Entity } from '../types';
import { engineApi } from '../ecs/bridge/engineApi';
import { PlanarReflection } from '../ecs/component';
/** The latest capture for one surface in one view. @experimental */
export interface PlanarReflectionStatus {
state: 'inactive' | 'budget-excluded' | 'unavailable' | 'ready';
width?: number;
height?: number;
draws?: number;
bytes?: number;
rejected?: number;
updated?: boolean;
}
/** A view is the camera that drew it: a game view is its runtime camera entity, the editor's own eye is EDITOR_VIEW_ENTITY,
* and 0 is a draw that named no camera. @experimental */
export function planarReflectionStatus(app: App, entity: Entity, view: Entity = 0): PlanarReflectionStatus {
const read = engineApi(app)?.renderer_getPlanarReflectionStatus;
if (!read) return { state: 'unavailable' };
return JSON.parse(read(view >>> 0, entity >>> 0)) as PlanarReflectionStatus;
}
/** Refreshes an OnDemand capture through the same component mutation path as authoring. @experimental */
export function refreshPlanarReflection(app: App, entity: Entity): void {
const value = app.world.get(entity, PlanarReflection);
app.world.set(entity, PlanarReflection, { ...value, revision: (value.revision + 1) >>> 0 });
}