README.md

Codepage module

JavaScript module that provides 8-Bit PC codepage to Unicode mappings.

Generating codepage_tables.js

Python script import_cp.py generates codepage_tables.js from a set of automatically downloaded codepage mapping files defined in source_urls.json.

Usage

$ python import_cp.py -h
usage: import_cp [-h] [-i FILE] [-o FILE]

Generates 8-bit codepage to Unicode mappings.

options:
  -h, --help  show this help message and exit
  -i FILE     input file name, default: source_urls.json
  -o FILE     output file name, default: codepage_tables.js

Using codepage_tables.js

Copy Javascript modules codepage_tables.js and codepage_lib.js into your project, then use module codepage_lib.js to access the codepage mappings.

Example usage:

<script type="module">

// import functions and consts from module codepage_lib.js (which imports codepage_tables.js)
import * as cp from "./codepage_lib.js";

// retrieve available codepage mappings
for(const [cp_id, cp_description] of Object.entries(cp.get_available_codepages()))
{
    // ...
}

const emulator = new V86({ ... });

// use codepage with cp_id "cp858" (ISO 8859-1) in V86
emulator.v86.cpu.devices.vga.screen.set_charmap(cp.get_charmap("cp858"));

</script>