ac6502 1.3.0 → 1.4.1

package/dist/components/IO/Video.d.ts

@@ -0,0 +1,141 @@
+import { IO } from '../IO';
+/**
+ * TMS9918 Video Display Processor Emulation
+ *
+ * Port mapping (address bit 0):
+ *   Even address (bit 0 = 0): VRAM data read/write
+ *   Odd  address (bit 0 = 1): Register/address write / status read
+ *
+ * Display modes:
+ *   Graphics I   - 32x24 tiles, 8x8 patterns, 1-of-8 color groups
+ *   Graphics II  - 32x24 tiles, 8x8 patterns, per-row color
+ *   Text         - 40x24 tiles, 6x8 patterns, no sprites
+ *   Multicolor   - 32x24 blocks, 4x4 colored cells
+ *
+ * Output: 256x192 active area centered in a 320x240 RGBA buffer
+ *
+ * Reference: vrEmuTms9918 by Troy Schrapel
+ * https://github.com/visrealm/vrEmuTms9918
+ */
+export declare enum TmsMode {
+    GRAPHICS_I = 0,
+    GRAPHICS_II = 1,
+    TEXT = 2,
+    MULTICOLOR = 3
+}
+export declare enum TmsColor {
+    TRANSPARENT = 0,
+    BLACK = 1,
+    MED_GREEN = 2,
+    LT_GREEN = 3,
+    DK_BLUE = 4,
+    LT_BLUE = 5,
+    DK_RED = 6,
+    CYAN = 7,
+    MED_RED = 8,
+    LT_RED = 9,
+    DK_YELLOW = 10,
+    LT_YELLOW = 11,
+    DK_GREEN = 12,
+    MAGENTA = 13,
+    GREY = 14,
+    WHITE = 15
+}
+export declare class Video implements IO {
+    raiseIRQ: () => void;
+    raiseNMI: () => void;
+    /** Eight write-only registers */
+    private registers;
+    /** Status register (read-only from CPU side) */
+    private status;
+    /** Current VRAM address for CPU access (auto-increments) */
+    private currentAddress;
+    /** Address / register write stage (0 or 1) */
+    private regWriteStage;
+    /** Holds first stage byte written to the control port */
+    private regWriteStage0Value;
+    /** Read-ahead buffer for VRAM reads */
+    private readAheadBuffer;
+    /** Current display mode (derived from registers) */
+    private mode;
+    /** 16 KB Video RAM */
+    private vram;
+    /** Per-pixel sprite collision mask for the current scanline */
+    private rowSpriteBits;
+    /** Temporary scanline pixel buffer (color palette indices) */
+    private scanlinePixels;
+    /** 320 × 240 RGBA output buffer for SDL rendering (front buffer – always a complete frame) */
+    buffer: Buffer;
+    /** Back buffer where scanlines are rendered progressively */
+    private backBuffer;
+    /** True when a complete frame has been copied to the front buffer */
+    frameReady: boolean;
+    /** Cycle accumulator for scanline timing */
+    private cycleAccumulator;
+    /** Current scanline being processed (0 – 261) */
+    private currentScanline;
+    read(address: number): number;
+    write(address: number, data: number): void;
+    tick(frequency: number): void;
+    reset(_coldStart: boolean): void;
+    /**
+     * Write to the control (address / register) port.
+     * Two-stage write:
+     *   Stage 0 – latches the low byte (address LSB or register value)
+     *   Stage 1 – interprets the high byte:
+     *     bit 7 set   → register write  (bits 0-2 = register index)
+     *     bit 7 clear → address set      (bit 6: 0 = read, 1 = write)
+     */
+    private writeAddr;
+    /** Write data to VRAM at the current address (auto-increments) */
+    private writeData;
+    /**
+     * Read the status register.
+     * Clears the status flags and resets the write stage.
+     */
+    private readStatus;
+    /** Read data from VRAM via the read-ahead buffer (auto-increments) */
+    private readData;
+    private updateMode;
+    private nameTableAddr;
+    private colorTableAddr;
+    private patternTableAddr;
+    private spriteAttrTableAddr;
+    private spritePatternTableAddr;
+    /** Backdrop / border color (low nibble of register 7) */
+    private mainBgColor;
+    /** Text-mode foreground (high nibble of register 7, transparent → backdrop) */
+    private mainFgColor;
+    /** Foreground from a color byte (high nibble, transparent → backdrop) */
+    private fgColor;
+    /** Background from a color byte (low nibble, transparent → backdrop) */
+    private bgColor;
+    private spriteSize;
+    private spriteMag;
+    private displayEnabled;
+    private processScanline;
+    private renderScanline;
+    private graphicsIScanLine;
+    private graphicsIIScanLine;
+    private textScanLine;
+    private multicolorScanLine;
+    private outputSprites;
+    /** Fill entire back buffer with the current backdrop color */
+    private fillBackground;
+    /** Write a rendered scanline into the back buffer at the correct position */
+    private writeScanlineToBuffer;
+    /** Read a VDP register value */
+    getRegister(reg: number): number;
+    /** Write a VDP register value directly (bypasses control-port staging) */
+    setRegister(reg: number, value: number): void;
+    /** Read a VRAM byte directly (does not affect read-ahead buffer) */
+    getVramByte(addr: number): number;
+    /** Write a VRAM byte directly (does not affect address pointer) */
+    setVramByte(addr: number, value: number): void;
+    /** Peek at the status register without clearing it */
+    getStatus(): number;
+    /** Get the current display mode */
+    getMode(): TmsMode;
+    /** Get the display-enabled state */
+    isDisplayEnabled(): boolean;
+}