Effectus

Year
2013
Publisher
Freeware (Bostjan Gorisek)
Type
Development tool
Category
Action! cross-compiler (PC)
Developer
Bostjan Gorisek (Gury), with contributions by Zbyti and others; uses Mad Pascal and MADS by Tomasz Biela (Tebe)
Language
Free Pascal (the compiler); compiles Action! source
Requirements
Windows (64-bit console build); Linux and macOS builds by contributors; output runs on any Atari XL/XE (and other Mad Pascal targets)
Windows command prompt showing Effectus 0.5.5 banner, references to Mad Pascal and MADS by Tomasz Biela, usage line and option list

Overview

Effectus lets you write programs in Action!, OSS's fast structured language for the Atari, on a modern PC, and get a ready-to-run Atari executable. It is written by Bostjan Gorisek, known as Gury, the author of the Atari 8-bit Forever portal, who is from Slovenia. Its stated goal is "to emulate Action! language as close as possible".

Original Action! programs need the Action! cartridge, or the separate run-time package, to run. Effectus programs don't: the result is a normal binary file (an .xex by default).

How it works

Effectus does not generate machine code itself. It hands the job to two modern tools by Tomasz Biela (Tebe):

  1. Effectus parses the Action! source and writes an equivalent Mad Pascal program.
  2. Mad Pascal compiles that program to 6502 assembly (an .a65 file).
  3. MADS (Mad Assembler) assembles it into the final binary.

Both tools are bundled with Effectus. Version 0.5.6 (August 2024) ships with Mad Pascal 1.7.1 and MADS 2.1.7 and was itself compiled with Free Pascal 3.2.2. Because Mad Pascal also targets other machines, the -target option can produce code for the Commodore 64, C16/Plus4 and a raw 6502 target as well as the Atari.

Language support and extras

Effectus covers the core of Action!: BYTE, CARD and INT variables, BYTE ARRAY, pointers, PROC and FUNC, IF/ELSEIF/FI, FOR, WHILE, DO ... OD and UNTIL, DEFINE constants and inline machine code. Added over the years:

  • INCLUDE files (one level deep), from version 0.5.1;
  • AND/OR in IF conditions (each condition in parentheses);
  • CIO-based I/O routines (Open, Close, XIO, PrintD, InputSD and others) for smaller, faster code;
  • PAS {} and ASM {} blocks (0.5.2) for dropping Mad Pascal or MADS code straight into an Action! listing;
  • proper string handling in BYTE ARRAYs (0.5.5–0.5.6);
  • command-line options to place variables in zero page, print summaries, log MADS output, or stop after translating to Pascal (-t).

Any text file can be compiled, so original .ACT listings work without renaming. The home page keeps a list of missing features and known bugs. Effectus is close to Action!, not identical, and some programs need small changes.

History

Effectus was already being discussed on AtariAge in early 2013. Gury described it as a work in progress, and an early AtariAge benchmark compared it with Action!, Quick and assembly. After a pause, development restarted in late 2019 with version 0.3.1, which added 64-bit builds, while forum members contributed Linux and macOS builds. A 2020 AtariAge thread for suggestions and bug reports became the main channel for its development. Much of the testing, many bug reports and many examples came from the forum member Zbyti, and Mariusz Buk hosts a GitHub copy with macOS builds.

Using it

Install the package, then run effectus program.eff from a console. Effectus writes the Pascal, assembly and final binary next to the source. Test the .xex in Altirra or on real hardware through any loader. If something doesn't compile, try the -t option to see the generated Mad Pascal, which usually makes the problem obvious. The examples folder is the best quick reference to what is supported.

Credits