This page (revision-270) was last changed on 26-Mar-2023 02:03 by Administrator 

This page was created on 20-Feb-2010 19:16 by Carsten Strotmann

Only authorized users are allowed to rename pages.

Only authorized users are allowed to delete pages.

Page revision history

Version Date Modified Size Author Changes ... Change note
270 26-Mar-2023 02:03 17 KB Administrator to previous
269 26-Mar-2023 02:02 17 KB Administrator to previous | to last
268 26-Mar-2023 02:01 17 KB Administrator to previous | to last
267 26-Mar-2023 02:00 17 KB Administrator to previous | to last ACTION Source Code ==> Action Source Code
266 26-Mar-2023 01:59 17 KB Administrator to previous | to last
265 26-Mar-2023 01:58 17 KB Administrator to previous | to last
264 26-Mar-2023 01:56 17 KB Administrator to previous | to last Remove links to delete manual pages
263 26-Mar-2023 01:22 17 KB Administrator to previous | to last Fix SF links
262 26-Mar-2023 01:21 17 KB Administrator to previous | to last
261 26-Mar-2023 01:18 17 KB Administrator to previous | to last Move manuals to Sourceforge

Page References

Incoming links Outgoing links
Action

Version management

Difference between version and

At line 1 changed one line
!!!ACTION!
!!!Action!
Clinton Parker, OSS, 1983
At line 6 added 52 lines
!Background
Action! is an Atari-specific programming language written by Clinton Parker and sold by Optimized Systems Software (OSS) in ROM cartridge form starting in August 1983. It is the only language other than [BASIC|Basic] and [assembler]) that had real popularity on the platform and saw any significant coverage in the Atari press; type-in programs and various technical articles were found in most magazines. In comparison, languages like [Forth] and [Logo] saw much less use and almost no press coverage.
Reviewers at the time gushed about the system. They noted that practically every aspect was superior to anything available at the time; compiling was almost instantaneous, the resulting code ran almost as fast as hand-coded assembler, the full-screen editor was universally loved, and the entire system took up only 8k due to clever memory management. The only complaint, also universal, was the poor quality of the original manual set.
Action! uses a greatly cut-down version of the ALGOL syntax, and thus bears strong similarities with [Pascal] and [C], which were also derived from ALGOL. Like those languages, Action! is procedural, with programs essentially consisting of a large collection of functions that call each other. It lacked encapsulation or data hiding, but that is not a serious concern in the limited program sizes available on an 8-bit machine. Syntactically it looks very similar to Pascal, with the exception that it uses ALGOL 68 DO/OD style bracketing rather than Pascal's BEGIN/END.
Action! included a number of features to allow it to run as fast as possible. Notably, it's main data types were BYTE, INT and CARD, 8-bit and 16-bit signed and unsigned values, respectively. These map directly onto the basic 6502-types. The language also included a syntax to directly refer to these objects in memory so they could be mapped into hardware registers. For instance, one could set a variable to {{BYTE RTCLOK=20}} which defined the 8-bit value at memory location 20 to be the value of the real-time clock. The user could then read or write to that register using the name {{RTCLOK}}.
These design details helped increase performance, but the primary reason Action! was much faster than other languages of the era was due to its memory management model. In languages like C and Pascal, procedure calls use a stack of records known as "activation records" that record the values of variables when the procedure was called. This allows a procedure to call itself, as each call can have its own values, and it is this feature that allows recursion. This concept requires the manipulation of a stack, which in the 6502 was a non-trivial prospect given the CPU stack was only 256 bytes.
Action! solved this problem by simply not implementing activation records. Instead, the storage space for variables was allocated at compile time (not dissimilar to Atari BASIC's model). This meant Action! could not support recursion, but also eliminated the necessity to build and manipulate a complex stack. This dramatically lowers the overhead of procedure calls, and in a language that organizes a program as a series of procedure calls, this represents a significant amount of time.
Action! had a number of limitations, none of them very serious. Curiously, Action! did not include support for floating-point types, although such support is built into the machine's OS ROM (see [Atari BASIC] for details) and available to any programming language. This is a significant limitation in some roles, although perhaps not for its target market. It also lacked most string handling routines, but made up for this somewhat with a series of PRINT commands that made formatted output easy.
Generally, Action! programs had performance on-par with reasonable-quality [assembler], while being much easier to program. In one review, it ran Byte's Sieve of Eratosthenes 219 times faster than Atari BASIC, while its source was only a few lines longer. In comparison, the assembler version's source ran on for several pages. Such performance, combined with terse code and library functions to access much of the platform's hardware, made it suitable for action games while still having a simple source format suitable for type-in programs. It deserved to be much more popular, and may have been had it been released earlier, or by Atari itself.
Action! inspired several similar languages that differ largely in syntax and various features that they do or do not support. Examples include [PL65] and [Quick].
!Examples
{{{
; Hello world in Action! programming language for the Atari 8-Bit computers
PROC Hello()
PrintE("Hello World!")
RETURN
}}}
The {{;}} is a comment marker, which was a commonly used as the comment marker in assembler as well. The {{PROC}} is the start of a PROCedure, which ends (perhaps oddly) with {{RETURN}}. In Action!, the last {{PROC}} in the program is the one that runs first, in this case "Hello". This is something of a mix between Pascal where the "global code" defines the program entry point, and C, where the function called "Main" is the entry point. The only line of code in this example is {{PrintE}}, which simply prints a string, while the more common {{PrintF}} is a formatted print similar to {{printf}} in C.
Like assembler, it was common for variables to be specified at a particular address that mapped onto one of the Atari's "shadow registers" that were used to communicate between the hardware and user programs. Here is a simple variation on Hello World that demonstrates this concept, as well as a basic loop:
{{{
; Hello world in a loop
PROC Hello()
BYTE RTCLOK=20, ; decimal address of system timer
CONSOL=$D01F ; hex address of the key-pressed register
CARD TIME
RTCLOK=0 ; reset the clock
WHILE CONSOL>6 ; did the user press a key?
DO
PRINTE("Hello World!")
OD
TIME = RTCLOK
PRINTF("Ran for %E %U jiffies",TIME)
RETURN
}}}
Note that the definitions of {{RTCLOK}} and {{CONSOL}} are not setting the values, but stating that they are at those memory locations. The syntax changes when those variables are accessed; the {{RTCLOK=0}} ''does'' set the value of that location. Also notice the syntax of loops, which work similarly to Pascal's {{BEGIN/END}} but use {{DO/OD}}.
There is a clever trick in this code. Note that {{RTCLOK}} is defined as a {{BYTE}} but {{TIME}} is defined as a {{CARD}}, a 16-bit value. This is because the clock value is stored in three bytes, 18, 19 and 20. By defining {{TIME}} as a {{CARD}}, when that value is read it automatically reads two bytes, thereby getting a value from both 20 and 19. This solution ignores the third byte, but since the value is from 0 to 65535 jiffies, about 36 minutes, this can safely be ignored for a program that is likely to run for a few seconds. This solution avoids the need to read two bytes and manipulate them into a 16-bit value, something that is commonly found in BASIC programs.
At line 21 changed 2 lines
Thank you Alfred\\
\\
Thank you Alfred
At line 24 changed 5 lines
Now just one ACTION!-file is missing and everything is restored: 'SIMPLEREL.ACT'
The one and only hint we do have is shown below. Any hint, any help is welcome at any time. We would really appreciate your help in that case.\\
ACTION OBJECT CODE RELOCATION PROGRAM:\\
The program SIMPLREL.ACT on this BBS may be used to cause an ACTION! program to load and run at a different address than that address at which it was compiled. The same program will also work for assembly language object files, providing you also follow the given instructions.
The program takes two object files as input and produces a third file which will load and run at a desired address. The relocating program prompts the user for the two input files, which must have been compiled one page (256 bytes) apart. It then prompts for an output file name (the relocated file), the page number of the starting address of the first file, and the page number of the desired destination address. Both page numbers must be decimal values. For example, specifying 32 as the destination page will cause the output file to load at address 32*256 ($2000), not $3200. See part V, "The ACTION! Compiler", chapter 2, page 144, for information on compiling programs to a specified address (Used to compile the two object files one page apart). In order to use the relocating program, download SIMPLEREL.ACT and read the instructions therein.
* [Action-Editor.asm] ; Source code for the ACTION! editor extracted out of the ACTION! source code. Mega-thanks to Alfred from AtariAge. :-)))
At line 30 removed 12 lines
!! Graphics Utilities Library and Shape Editor
One more thing: Graphics Utilities Library and Shape Editor and Animator are missing, too.:
[{Image src='Graphics Utilities Library 1.jpg' width=384 height=240 }]
Graphics Utilities Library for ACTION! screen 1\\
\\
[{Image src='Graphics Utilities Library 2.jpg' width=384 height=240 }]
Graphics Utilities Library for ACTION! screen 2\\
\\
[{Image src='Shape Editor and Animator.jpg' width=384 height=240 }]
Shape Editor and Animator for ACTION! \\
At line 43 removed one line
At line 45 changed 2 lines
!!Docs
* [ACTION! Handbuch] (German ACTION! Manual)
!!Manuals and Docs
* [Action_manual_3rd-revised_edition_2018_by_GBXL|action_rev_3-6_GBXL_2018.pdf] ; size: 991 KB ; 3rd revised and enlarged edition (p) 2018 by GBXL. There is no better version worldwide! Thank you so much GBXL. We are deep in your debt! :-)))
* [Action-Handbuch-komplett_2016_von_GBXL.pdf] ; Das komplette, vollständige, restaurierte und überarbeitete Action!-Handbuch in deutsch! Der totale Hammer, inkl. Editor, Monitor, Language, Compiler, Library, Run Time, Toolkit. Vollständig überarbeitete Version von 2016 von GoodByteXL. So müssen PDF-Dateien aussehen, es gibt weltweit nichts vergleichbares. AtariWiki empfiehlt die PDF-Datei auf das Wärmste! Wer diese nicht lädt, ist selber schuld. Wir bedanken uns an dieser Stelle sehr, sehr herzlich bei GoodByteXL für seine lange andauernde und intensive Arbeit an diesem Werk, dass er hiermit der Atari-Gemeinschaft zur Verfügung stellt. GoodByteXL mega-Danke für Deine Arbeit, die Gemeinschaft steht tief in Deiner Schuld. :-)))
* [Action_manual_3rd-revised_edition_2015_by_GBXL.pdf] ;The complete Action! manual! Editor, Monitor, Language, Compiler, Library, Run Time, Toolkit. 3rd revised edition 2015 by GoodByteXL. Highly recommended by the AtariWiki! This is, without any(!) doubt, the very best edition worldwide available. Nobody does it better. Mega-thanks to GoodByteXL for this outstanding work and the many hours of work to the community. We are deep in your debt! Thank you so much. :-)))
At line 87 added 3 lines
* [ACTION! Handbuch] (German ACTION! Manual)
* [The ACTION! Toolkit]
* [The ACTION! Run Time Package]
At line 50 removed 2 lines
* [The Action! Toolkit.pdf]
* [The ACTION! Run Time Package-A Reference GUIDE.pdf]
At line 98 added one line
* [Fix for the Bugs in divide in ACTION!]
At line 100 added one line
* [Optimized Systems Software, Inc. - SOFTWARE LICENSE AGREEMENT|Optimized_Systems_Software_Software_License_Agreement.pdf] ; thanks to Atarimania
At line 60 changed one line
!! Runtimes
!! New ACTION! versions > 3.6
* [Action! greater than version 3.6|http://www.wudsn.com/productions/atari800/action/action.zip] ; thanks to JAC! for compiling and fixing the known bugs. Please go ahead with your outstanding work in this, we really appreciate your help and work very much.
!! CAR-Images
* [ACTION_Version_3.6_(C)_1983_ACS_034M.car]
* [ACTION_Version_3.6_(C)_1983_ACS_M091.car]
!! ROM-Images
* [ACTION_Version_3.6_(C)_1983_ACS_034M.rom]
* [ACTION_Version_3.6_(C)_1983_ACS_M091.rom]
!! Runtimes
At line 121 added 3 lines
* [OSS_ACTION_3.6_and_REAL_files_with_DOS_XL_2.30p_Color.atr]
* [TURBO-DOS_XE_with_ACTION_Disk_1.atr]
* [TURBO-DOS_XE_with_ACTION_Disk_2.atr]
At line 125 added 4 lines
!! XEX-Files
* [ACTION.XEX] ; Thanks goes to Peter Dell for making the XEX-file out of the above source code. Peter, we owe you so much, please go ahead! :-)
* [Action_Editor-MADS.xex] ; If you rename the file to E.COM, you can even use it under SpartaDOS I for example with D1:E MYSRC.ACT to direct load the MYSRC.ACT file into the editor. Further, this editor can even be used for BASIC, PASCAL, FORTH etc... A Giga-thanks goes to Alfred from AtariAge for extracting the source code from Clinton Parker's original source code and JAC! from AtariAge for building the xex file from that very source code, while adapting to MADS. Great job, not only for Action! :-)))
At line 141 changed one line
* [SourceCodeDisk1] Disk Image with ACTION! Source code
* [SourceCodeDisk1] ; SpartaDOS X disk image with ACTION! source code
At line 204 added one line
At line 207 added one line
* [ACTION OBJECT CODE RELOCATION PROGRAM] ; Thank you so much Alfred from AtariAge, we all really appreciate your help here again.
At line 209 added 2 lines
* [acsterm.txt] ; ACSTERM is a terminal emulator for the Atari 800, 800XL, 1200XL and 130XE
* [How to find the revision number of ACTION]
At line 218 added 13 lines
!!Still missing: Graphics Utilities Library and Shape Editor
Now just these two are missing. Any hint, any help is welcome at any time. We would really appreciate your help in that case.\\
[{Image src='Graphics Utilities Library 1.jpg' width=384 height=240 }]
Graphics Utilities Library for ACTION! screen 1\\
\\
[{Image src='Graphics Utilities Library 2.jpg' width=384 height=240 }]
Graphics Utilities Library for ACTION! screen 2\\
\\
[{Image src='Shape Editor and Animator.jpg' width=384 height=240 }]
Shape Editor and Animator for ACTION! \\
At line 171 changed one line
|[Trails]|#50 (01/ 87)|en|
|[Trails]|#50 (01/ 87)|en|tool for using the KoalaPad in ACTION!
At line 204 changed one line
|[ACTION! Deel]| |nl|A collection of ACTION! Articles
|[ACTION! Deel]| |nl|A collection of ACTION! Articles
!ACTION! ads
[{Image src='00_first_ad_in_compute_Jul1983.jpg' width=600 height=802 }]
ACTION! first ad in Compute July, 1983 ; please take into account: 128-column screen and for Apple II & Commodore 64. Thanks to GoodByteXL!
!!!Cross Compiler for ACTION!
* [http://gury.atari8.info/effectus/] ; Thank you soooo much Gury! That is totally incredible, we now can use high end editors, eclipse and have the results in a flash! We are deep in your debt! Thank you so much, really. :-)