add: input utils

Nightre · Nightre · commit d2f543c18d89 · 2025-08-06T18:26:29.000+08:00
diff --git a/dist/index.d.ts b/dist/index.d.ts
@@ -11,3 +11,5 @@ export * from "./interface";
 export * from "./texture";
 export * from "./render";
 export * from "./particle";
+export * from "./utils";
+export * from "./input";
diff --git a/dist/input.d.ts b/dist/input.d.ts
@@ -0,0 +1,60 @@
+import { Vec2 } from "./math";
+import Rapid from "./render";
+import { Entity } from "./utils";
+export declare class InputManager {
+    rapid: Rapid;
+    canvas: HTMLCanvasElement;
+    mousePosition: Vec2;
+    private keysDown;
+    private keysDownLastFrame;
+    private buttonsDown;
+    private buttonsDownLastFrame;
+    constructor(rapid: Rapid);
+    /**
+     * 附加所有必要的事件监听器
+     * @private
+     */
+    private attachEventListeners;
+    updateNextFrame(): void;
+    /**
+     * 检查某个按键当前是否被按下 (持续检测)
+     * @param key `event.code` 的值, e.g., "KeyW", "Space"
+     */
+    isKeyDown(key: string): boolean;
+    /**
+     * 检查某个按键当前是否是松开状态
+     * @param key `event.code` 的值
+     */
+    isKeyUp(key: string): boolean;
+    /**
+     * 检查某个按键是否在当前帧“刚刚被按下” (单次触发)
+     * @param key `event.code` 的值
+     */
+    wasKeyPressed(key: string): boolean;
+    /**
+     * 检查某个按键是否在当前帧“刚刚被松开” (单次触发)
+     * @param key `event.code` 的值
+     */
+    wasKeyReleased(key: string): boolean;
+    /**
+     * 检查某个鼠标按钮当前是否被按下 (持续检测)
+     * @param button 鼠标按钮编号
+     */
+    isButtonDown(button: number): boolean;
+    /**
+     * 检查某个鼠标按钮当前是否是松开状态
+     * @param button 鼠标按钮编号
+     */
+    isButtonUp(button: number): boolean;
+    /**
+     * 检查某个鼠标按钮是否在当前帧“刚刚被按下” (单次触发)
+     * @param button 鼠标按钮编号
+     */
+    wasButtonPressed(button: number): boolean;
+    /**
+     * 检查某个鼠标按钮是否在当前帧“刚刚被松开” (单次触发)
+     * @param button 鼠标按钮编号
+     */
+    wasButtonReleased(button: number): boolean;
+    getMouseLocal(entity: Entity): Vec2;
+}
diff --git a/dist/interface.d.ts b/dist/interface.d.ts
@@ -40,18 +40,26 @@ export interface IAttribute {
     stride: number;
     offset?: number;
 }
+export interface IEntityTransformOptions {
+    position?: Vec2;
+    scale?: Vec2 | number;
+    rotation?: number;
+    x?: number;
+    y?: number;
+    tags: string[];
+}
 export interface ITransformOptions {
+    restoreTransform?: boolean;
+    saveTransform?: boolean;
     position?: Vec2;
     scale?: Vec2 | number;
     rotation?: number;
-    offset?: Vec2;
     x?: number;
     y?: number;
+    offset?: Vec2;
     offsetX?: number;
     offsetY?: number;
     origin?: Vec2 | number;
-    restoreTransform?: boolean;
-    saveTransform?: boolean;
     afterSave?(): unknown;
     beforRestore?(): unknown;
 }
diff --git a/dist/math.d.ts b/dist/math.d.ts
@@ -326,6 +326,7 @@ export declare class Vec2 implements IMathObject<Vec2> {
      * @param y - The y coordinate (default is 0).
      */
     constructor(x?: number, y?: number);
+    set(x: number | number[], y?: number): this;
     /**
      * Adds another vector to this vector.
      * @param v - The vector to add.
diff --git a/dist/rapid.global.js b/dist/rapid.global.js
diff --git a/dist/rapid.js b/dist/rapid.js
diff --git a/dist/rapid.umd.cjs b/dist/rapid.umd.cjs
diff --git a/dist/render.d.ts b/dist/render.d.ts
@@ -249,5 +249,7 @@ declare class Rapid {
      */
     drawLightShadowMask(options: ILightRenderOptions): void;
     createParticleEmitter(options: IParticleOptions): ParticleEmitter;
+    cssToGameCoords(x: number | Vec2, y?: number): Vec2;
+    gameToCssCoords(x: number | Vec2, y?: number): Vec2;
 }
 export default Rapid;
diff --git a/dist/utils.d.ts b/dist/utils.d.ts
@@ -1 +1,26 @@
+import { IEntityTransformOptions } from "./interface";
+import { MatrixStack, Vec2 } from "./math";
+import Rapid from "./render";
 export declare const isPlainObject: (obj: any) => boolean;
+export declare class Entity {
+    position: Vec2;
+    scale: Vec2;
+    rotation: number;
+    parent: Entity | null;
+    readonly children: Entity[];
+    transform: MatrixStack;
+    rapid: Rapid;
+    tags: string[];
+    constructor(rapid: Rapid, options: IEntityTransformOptions);
+    getParentTransform(): MatrixStack;
+    update(deltaTime: number): void;
+    updateTransform(deep?: boolean): void;
+    render(): void;
+    postRender(): void;
+    postUpdate(deltaTime: number): void;
+    addChild(child: Entity): void;
+    removeChild(child: Entity): void;
+    root(dt: number): void;
+    findDescendant(predicate: (entity: Entity) => boolean, onlyFirst?: boolean): Entity[] | Entity | null;
+    findDescendantByTag(tags: string[], onlyFirst?: boolean): Entity | Entity[] | null;
+}
diff --git a/package.json b/package.json
@@ -1,6 +1,6 @@
 {
   "name": "rapid-render",
-  "version": "0.1.20",
+  "version": "0.1.21",
   "type": "module",
   "files": [
     "dist"
diff --git a/src/index.ts b/src/index.ts
@@ -21,4 +21,6 @@ export * from "./math";
 export * from "./interface"
 export * from "./texture"
 export * from "./render"
-export * from "./particle"
+export * from "./particle"
+export * from "./utils"
+export * from "./input"
diff --git a/src/input.ts b/src/input.ts
@@ -0,0 +1,144 @@
+import { Vec2 } from "./math";
+import Rapid from "./render";
+import { Entity } from "./utils";
+
+export class InputManager {
+    rapid: Rapid
+    canvas: HTMLCanvasElement
+    mousePosition: Vec2 = Vec2.ZERO
+
+    // --- 新增属性 ---
+
+    // 记录当前帧被按下的按键 (e.g., "KeyW", "Space", "ArrowUp")
+    private keysDown: Set<string> = new Set();
+    // 记录上一帧被按下的按键
+    private keysDownLastFrame: Set<string> = new Set();
+
+    // 记录当前帧被按下的鼠标按钮 (0: 左键, 1: 中键, 2: 右键)
+    private buttonsDown: Set<number> = new Set();
+    // 记录上一帧被按下的鼠标按钮
+    private buttonsDownLastFrame: Set<number> = new Set();
+
+
+    constructor(rapid: Rapid) {
+        this.rapid = rapid
+        this.canvas = rapid.canvas
+
+        this.attachEventListeners();
+    }
+
+    /**
+     * 附加所有必要的事件监听器
+     * @private
+     */
+    private attachEventListeners(): void {
+        const rect = this.canvas.getBoundingClientRect()
+        
+        // 鼠标移动
+        this.canvas.addEventListener('mousemove', (event) => {
+            this.mousePosition = this.rapid.cssToGameCoords(event.clientX - rect.left, event.clientY - rect.top);
+        });
+
+        // --- 新增事件监听 ---
+
+        // 键盘按下
+        window.addEventListener('keydown', (event) => {
+            this.keysDown.add(event.code);
+        });
+
+        // 键盘松开
+        window.addEventListener('keyup', (event) => {
+            this.keysDown.delete(event.code);
+        });
+
+        // 鼠标按下
+        this.canvas.addEventListener('mousedown', (event) => {
+            this.buttonsDown.add(event.button);
+        });
+
+        // 鼠标松开
+        this.canvas.addEventListener('mouseup', (event) => {
+            this.buttonsDown.delete(event.button);
+        });
+    }
+
+    public updateNextFrame(): void {
+        this.keysDownLastFrame = new Set(this.keysDown);
+        this.buttonsDownLastFrame = new Set(this.buttonsDown);
+    }
+
+
+    /**
+     * 检查某个按键当前是否被按下 (持续检测)
+     * @param key `event.code` 的值, e.g., "KeyW", "Space"
+     */
+    isKeyDown(key: string): boolean {
+        return this.keysDown.has(key);
+    }
+
+    /**
+     * 检查某个按键当前是否是松开状态
+     * @param key `event.code` 的值
+     */
+    isKeyUp(key: string): boolean {
+        return !this.keysDown.has(key);
+    }
+
+    /**
+     * 检查某个按键是否在当前帧“刚刚被按下” (单次触发)
+     * @param key `event.code` 的值
+     */
+    wasKeyPressed(key: string): boolean {
+        // 当前帧被按下，且上一帧没有被按下
+        return this.keysDown.has(key) && !this.keysDownLastFrame.has(key);
+    }
+
+    /**
+     * 检查某个按键是否在当前帧“刚刚被松开” (单次触发)
+     * @param key `event.code` 的值
+     */
+    wasKeyReleased(key: string): boolean {
+        // 当前帧没有被按下，但上一帧被按下了
+        return !this.keysDown.has(key) && this.keysDownLastFrame.has(key);
+    }
+
+
+    // --- 鼠标按钮 API ---
+    // button: 0=左键, 1=中键, 2=右键
+
+    /**
+     * 检查某个鼠标按钮当前是否被按下 (持续检测)
+     * @param button 鼠标按钮编号
+     */
+    isButtonDown(button: number): boolean {
+        return this.buttonsDown.has(button);
+    }
+
+    /**
+     * 检查某个鼠标按钮当前是否是松开状态
+     * @param button 鼠标按钮编号
+     */
+    isButtonUp(button: number): boolean {
+        return !this.buttonsDown.has(button);
+    }
+
+    /**
+     * 检查某个鼠标按钮是否在当前帧“刚刚被按下” (单次触发)
+     * @param button 鼠标按钮编号
+     */
+    wasButtonPressed(button: number): boolean {
+        return this.buttonsDown.has(button) && !this.buttonsDownLastFrame.has(button);
+    }
+
+    /**
+     * 检查某个鼠标按钮是否在当前帧“刚刚被松开” (单次触发)
+     * @param button 鼠标按钮编号
+     */
+    wasButtonReleased(button: number): boolean {
+        return !this.buttonsDown.has(button) && this.buttonsDownLastFrame.has(button);
+    }
+
+    getMouseLocal(entity: Entity): Vec2 {
+        return entity.transform.globalToLocal(this.mousePosition);
+    }
+}

Original file line number	Diff line number	Diff line change
`@@ -249,5 +249,7 @@ declare class Rapid {`
`249`	`249`	`*/`
`250`	`250`	`drawLightShadowMask(options: ILightRenderOptions): void;`
`251`	`251`	`createParticleEmitter(options: IParticleOptions): ParticleEmitter;`
	`252`	`+ cssToGameCoords(x: number \| Vec2, y?: number): Vec2;`
	`253`	`+ gameToCssCoords(x: number \| Vec2, y?: number): Vec2;`
`252`	`254`	`}`
`253`	`255`	`export default Rapid;`
Original file line number	Diff line number	Diff line change
`@@ -1,6 +1,6 @@`
`1`	`1`	`{`
`2`	`2`	`"name": "rapid-render",`
`3`		`- "version": "0.1.20",`
	`3`	`+ "version": "0.1.21",`
`4`	`4`	`"type": "module",`
`5`	`5`	`"files": [`
`6`	`6`	`"dist"`