nes-wasm 0.3.0 → 0.4.0

package/README.md

@@ -65,6 +65,7 @@ loop();
 | `run_frame()` | 运行一帧,返回帧号 |
 | `frame_rgba()` | RGBA 帧缓冲(256×240×4),可直接写 `ImageData` |
 | `frame_pixels()` | 8 位调色板索引帧;`palette_rgb()` 为 64 色系统调色板 |
+| `set_palette(bytes)` / `clear_palette()` | 加载/重置 `.pal` 调色板(FCEUX/Nestopia 格式,192=64 色或 1536=512 色);`palette_rgb_full()` 返回当前 512×3 字节 |
 | `audio_samples()` / `clear_audio_samples()` / `audio_sample_rate()` / `set_audio_sample_rate(rate)` | 音频 |
 | `set_controller_bits(port, bits)` / `set_button(port, name, pressed)` | 手柄输入 |
 | `save_state()` / `load_state(bytes)` | 快照存读档 |

package/nes_wasm.d.ts

@@ -20,10 +20,18 @@ export class NesWasm {
      * 清空累积的音频采样(每轮播放后调用)。
      */
     clear_audio_samples(): void;
+    /**
+     * 恢复默认调色板。
+     */
+    clear_palette(): void;
     /**
      * 当前手柄位掩码。
      */
     controller_bits(port: number): number;
+    /**
+     * 当前帧的颜色强调掩码(bit0=R, bit1=G, bit2=B)。
+     */
+    emphasis_bits(): number;
     /**
      * FDS 磁盘是否被写入过(写回 .sav 用);非 FDS 返回 false。
      */
@@ -46,6 +54,7 @@ export class NesWasm {
     frame_pixels(): Uint8Array;
     /**
      * RGBA 帧缓冲(256×240×4),可直接写入 `ImageData`。
+     * 已应用当前帧的颜色强调($2001 bit5-7)与当前调色板。
      */
     frame_rgba(): Uint8Array;
     /**
@@ -70,9 +79,19 @@ export class NesWasm {
     master_clock(): bigint;
     constructor();
     /**
-     * 系统调色板,64 色 × 3 字节 RGB。
+     * 系统调色板,64 色 × 3 字节 RGB(当前调色板的基色块,不含强调)。
+     */
+    palette_rgb(): Uint8Array;
+    /**
+     * 当前调色板完整 512 色 × 3 字节 RGB
+     * (8 个强调块,布局 `(emphasis<<6|color)*3`,供 JS 构建 LUT)。
+     */
+    palette_rgb_full(): Uint8Array;
+    /**
+     * 应用颜色强调后的系统调色板,64 色 × 3 字节 RGB
+     * (emphasis 为 `emphasis_bits` 返回的掩码,取自当前调色板)。
      */
-    static palette_rgb(): Uint8Array;
+    palette_rgb_tinted(emphasis: number): Uint8Array;
     /**
      * 模拟断电重启(CPU RAM 清零后复位)。
      */
@@ -106,6 +125,11 @@ export class NesWasm {
      * 设置手柄位掩码:A=1 B=2 Select=4 Start=8 Up=16 Down=32 Left=64 Right=128。
      */
     set_controller_bits(port: number, bits: number): void;
+    /**
+     * 加载 .pal 调色板文件内容(FCEUX/Nestopia 通用格式):
+     * 192 字节 = 64 色基色(强调块自动合成);1536 字节 = 512 色(自带强调块)。
+     */
+    set_palette(bytes: Uint8Array): void;
 }
 
 export type InitInput = RequestInfo | URL | Response | BufferSource | WebAssembly.Module;
@@ -117,7 +141,9 @@ export interface InitOutput {
     readonly neswasm_audio_samples: (a: number) => [number, number];
     readonly neswasm_battery_ram: (a: number) => [number, number];
     readonly neswasm_clear_audio_samples: (a: number) => void;
+    readonly neswasm_clear_palette: (a: number) => void;
     readonly neswasm_controller_bits: (a: number, b: number) => number;
+    readonly neswasm_emphasis_bits: (a: number) => number;
     readonly neswasm_fds_dirty: (a: number) => number;
     readonly neswasm_fds_side_lengths: (a: number) => [number, number];
     readonly neswasm_fds_sides_flattened: (a: number) => [number, number];
@@ -130,7 +156,9 @@ export interface InitOutput {
     readonly neswasm_load_state: (a: number, b: number, c: number) => [number, number];
     readonly neswasm_master_clock: (a: number) => bigint;
     readonly neswasm_new: () => number;
-    readonly neswasm_palette_rgb: () => [number, number];
+    readonly neswasm_palette_rgb: (a: number) => [number, number];
+    readonly neswasm_palette_rgb_full: (a: number) => [number, number];
+    readonly neswasm_palette_rgb_tinted: (a: number, b: number) => [number, number];
     readonly neswasm_power_cycle: (a: number) => void;
     readonly neswasm_reset: (a: number) => void;
     readonly neswasm_rom_md5_hex: (a: number) => [number, number];
@@ -139,6 +167,7 @@ export interface InitOutput {
     readonly neswasm_set_audio_sample_rate: (a: number, b: number) => void;
     readonly neswasm_set_button: (a: number, b: number, c: number, d: number, e: number) => void;
     readonly neswasm_set_controller_bits: (a: number, b: number, c: number) => void;
+    readonly neswasm_set_palette: (a: number, b: number, c: number) => [number, number];
     readonly __wbindgen_externrefs: WebAssembly.Table;
     readonly __wbindgen_free: (a: number, b: number, c: number) => void;
     readonly __wbindgen_malloc: (a: number, b: number) => number;

package/nes_wasm.js

@@ -48,6 +48,12 @@ export class NesWasm {
     clear_audio_samples() {
         wasm.neswasm_clear_audio_samples(this.__wbg_ptr);
     }
+    /**
+     * 恢复默认调色板。
+     */
+    clear_palette() {
+        wasm.neswasm_clear_palette(this.__wbg_ptr);
+    }
     /**
      * 当前手柄位掩码。
      * @param {number} port
@@ -57,6 +63,14 @@ export class NesWasm {
         const ret = wasm.neswasm_controller_bits(this.__wbg_ptr, port);
         return ret;
     }
+    /**
+     * 当前帧的颜色强调掩码(bit0=R, bit1=G, bit2=B)。
+     * @returns {number}
+     */
+    emphasis_bits() {
+        const ret = wasm.neswasm_emphasis_bits(this.__wbg_ptr);
+        return ret;
+    }
     /**
      * FDS 磁盘是否被写入过(写回 .sav 用);非 FDS 返回 false。
      * @returns {boolean}
@@ -108,6 +122,7 @@ export class NesWasm {
     }
     /**
      * RGBA 帧缓冲(256×240×4),可直接写入 `ImageData`。
+     * 已应用当前帧的颜色强调($2001 bit5-7)与当前调色板。
      * @returns {Uint8Array}
      */
     frame_rgba() {
@@ -179,11 +194,34 @@ export class NesWasm {
         return this;
     }
     /**
-     * 系统调色板,64 色 × 3 字节 RGB。
+     * 系统调色板,64 色 × 3 字节 RGB(当前调色板的基色块,不含强调)。
      * @returns {Uint8Array}
      */
-    static palette_rgb() {
-        const ret = wasm.neswasm_palette_rgb();
+    palette_rgb() {
+        const ret = wasm.neswasm_palette_rgb(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * 当前调色板完整 512 色 × 3 字节 RGB
+     * (8 个强调块,布局 `(emphasis<<6|color)*3`,供 JS 构建 LUT)。
+     * @returns {Uint8Array}
+     */
+    palette_rgb_full() {
+        const ret = wasm.neswasm_palette_rgb_full(this.__wbg_ptr);
+        var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
+        wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
+        return v1;
+    }
+    /**
+     * 应用颜色强调后的系统调色板,64 色 × 3 字节 RGB
+     * (emphasis 为 `emphasis_bits` 返回的掩码,取自当前调色板)。
+     * @param {number} emphasis
+     * @returns {Uint8Array}
+     */
+    palette_rgb_tinted(emphasis) {
+        const ret = wasm.neswasm_palette_rgb_tinted(this.__wbg_ptr, emphasis);
         var v1 = getArrayU8FromWasm0(ret[0], ret[1]).slice();
         wasm.__wbindgen_free(ret[0], ret[1] * 1, 1);
         return v1;
@@ -261,6 +299,19 @@ export class NesWasm {
     set_controller_bits(port, bits) {
         wasm.neswasm_set_controller_bits(this.__wbg_ptr, port, bits);
     }
+    /**
+     * 加载 .pal 调色板文件内容(FCEUX/Nestopia 通用格式):
+     * 192 字节 = 64 色基色(强调块自动合成);1536 字节 = 512 色(自带强调块)。
+     * @param {Uint8Array} bytes
+     */
+    set_palette(bytes) {
+        const ptr0 = passArray8ToWasm0(bytes, wasm.__wbindgen_malloc);
+        const len0 = WASM_VECTOR_LEN;
+        const ret = wasm.neswasm_set_palette(this.__wbg_ptr, ptr0, len0);
+        if (ret[1]) {
+            throw takeFromExternrefTable0(ret[0]);
+        }
+    }
 }
 if (Symbol.dispose) NesWasm.prototype[Symbol.dispose] = NesWasm.prototype.free;
 function __wbg_get_imports() {

package/package.json

@@ -2,7 +2,7 @@
   "name": "nes-wasm",
   "type": "module",
   "description": "WebAssembly bindings for the nes-sim NES emulator core.",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -19,4 +19,4 @@
   "sideEffects": [
     "./snippets/*"
   ]
-}
+}