Package client.teavm.common.compiletime

package client.teavm.common.compiletime

Provides compile-time data bindings and configuration for the TeaVM-based builds of JSIDPlay2.

This package is responsible for embedding static emulator resources such as ROM images, palettes, SID configuration files, and audio lookup tables directly into the generated JavaScript or WebAssembly output. This approach avoids runtime file access and ensures that all required data is available immediately when the web application starts.

Key Responsibilities

• Embed C64 ROMs (BASIC, KERNAL, Character ROMs, drive ROMs, etc.) as Base64-encoded byte arrays for inclusion in TeaVM-generated builds.
• Provide preprocessed PAL palette data for the VIC-II video emulation.
• Expose SID identification and configuration data for chip emulation and playback accuracy.
• Embed precalculated floating-point lookup tables for efficient audio sample conversion and mixing.
• Offer static utility methods and default maps that replace traditional file I/O or resource loading in the browser runtime environment.

Design Overview

Classes in this package — such as RomsTeaVM, PaletteTeaVM, and IniConfigTeaVM — are executed during the TeaVM compilation process. Their outputs are compiled into Java constants that become part of the generated JavaScript or WebAssembly module. This ensures deterministic, fileless initialization of the emulator core at startup.

Autor:

Ken Händel

Zugehörige Packages

Package	Beschreibung
client.teavm.common	Common code shared between the TeaVM JavaScript and WebAssembly builds.
client.teavm.common.audio	Provides the TeaVM-specific audio and video drivers that connect the Java-based JSIDPlay2 emulator core with the browser runtime.
client.teavm.common.config	Contains classes and interfaces related to the configuration settings for the TeaVM implementation of the client-side application.
client.teavm.common.oscilloscope	Provides classes for visualizing SID chip activity in real time within the browser-based JSIDPlay2 TeaVM front end.
client.teavm.common.parameter	This package contains event parameter classes for controlling and interacting with the emulator via JavaScript and Web Worker functions.
client.teavm.common.video	Video rendering and PAL emulation support for TeaVM builds.

Klasse	Beschreibung
ICompileTime
IniConfigTeaVM	Pre- generated INI configuration to be included and used in the JavaScript and web assembly version builds.
LookupTableTeaVM	Pre- generated lookup table to prevent floating point division in audio production's hot code path to be included and used in the JavaScript and web assembly version builds.
PaletteTeaVM	Pre- generated PAL emulation color data to be included and used in the JavaScript and web assembly version builds.
RomsTeaVM	Emulator ROMS to be included and used in the JavaScript and web assembly version builds.
SidIdInfoTeaVM	Pre- generated Player ID Infos to be included and used in the JavaScript and web assembly version builds.
SidIdTeaVM	Pre- generated Player IDs to be included and used in the JavaScript and web assembly version builds.