Skip to content

Included TRSE units

TRSE ships Turbo Rascal unit files (.tru) under the units/ directory in the source tree. They provide graphics helpers, drivers, music players, and other shared code you can pull into a project with the @use directive.

Platform pages list each unit file with procedure/function signatures and block-comment notes extracted from the source (auto-generated; edge cases may be missing).

How @use is resolved

When the compiler sees @use "some/path/name", it searches for some/path/name.tru in this order (parser.cpp):

  1. Project directory (where your main .ras file lives)
  2. units/<SYSTEM>/ — your project's system = ... target (folder name matches the system, e.g. C64, VIC20, TRS80COCO)
  3. units/cpu_specific/<CPU>/ — CPU for the current target (e.g. MOS6502, Z80, M6809). The special case Z180 uses the Z80 folder.
  4. units/global/ — shared across platforms

Place your own reusable .tru files in the project folder, or rely on these bundled libraries. The lists below reflect the upstream TRSE repository at doc generation time.

Totals: 209 .tru files across 40 top-level folders (including global and cpu_specific).

Catalog by platform folder

Folder Units
ACORN 2 View list
AGON 2 View list
AMIGA 8 View list
AMSTRADCPC 9 View list
APPLEII 1 View list
ATARI2600 1 View list
ATARI520ST 5 View list
ATARI800 1 View list
BBCM 6 View list
BK0010 1 View list
C128 1 View list
C64 11 View list
CHIP8 3 View list
DRAGON 4 View list
FOENIX 1 View list
GAMEBOY 2 View list
JDH8 2 View list
M1ARM 1 View list
MEGA65 4 View list
MSX 2 View list
PET 6 View list
PLUS4 2 View list
POKEMONMINI 1 View list
PRIMO 1 View list
SNES 5 View list
SPECTRUM 6 View list
THOMSON 2 View list
TIKI100 1 View list
TIM 9 View list
TRS80 1 View list
TRS80COCO 5 View list
TVC 6 View list
VECTREX 1 View list
VIC20 9 View list
VZ200 11 View list
WONDERSWAN 2 View list
X16 2 View list
X86 15 View list
cpu_specific 32 View list
global 25 View list

Regenerate this page and the per-folder lists with: python3 scripts/import_trse_units.py (with TRSE_REPO_ROOT or --repo-root if needed; deploy.sh runs it automatically.)