View source for Super Expander 64

'''Super Expander 64''' is a cartridge-based extension to the built in [[BASIC]] [[Interpreter (computing)|interpreter]] of [[Commodore 64]] [[home computer]]. It was published by [[Commodore Business Machines]] in 1983. The built-in BASIC of the C64, [[Commodore BASIC]], was adapted from the [[Commodore PET|PET]] and [[VIC 20]], and the language does not have direct support for the system's sound and graphics hardware. Access to the hardware had to be done though directly accessing the memory locations [[memory map|mapped]] to the specific [[hardware register]]s using <code>[[PEEK_and_POKE|PEEK]]</code> and <code>[[PEEK and POKE|POKE]]</code> statements. Super Expander 64 adds functions for drawing graphics, using [[sprite (computer graphics)|sprites]], reading joysticks, playing audio, and other features.

The extra code is mapped into the "lower cartridge" 8 kilobytes area at <code>$8000-$9FFF</code>, reducing the 38,911 bytes for user programs by said 8K.

==Graphics==
After initializing the screen for "high-resolution" (320 × 200 monochrome pixels) or multicolor (160 wide × 200 pixels in four colors) graphics with the <code>GRAPHIC</code> command, one could draw lines, circles, ellipses, arcs, boxes and more using the <code>DRAW</code>, <code>CIRCLE</code>, and <code>BOX</code> commands. <code>PAINT</code> would "flood-fill" an area enclosed by lines, e.g. the interior of a <code>CIRCLE</code> or <code>BOX</code>. A <code>CHAR</code> command was used to "print" characters from the [[character generator]] [[read-only memory|ROM]] onto the [[bitmap graphics]] screen. <code>SSHAPE</code> and <code>GSHAPE</code> would store the contents of a rectangular area of the high-res graphics into a [[String (computer science)|string]] [[Variable (computer science)|variable]], and <code>GSHAPE</code> would "stamp" it back onto the screen at arbitrary locations. Such "graphics-in-a-string" could also be used to transfer something drawn on the hi-res screen into one of the eight sprite patterns.

===Sprites===
Besides a range of commands to initialize, position and move sprites (or Movable Object Blocks as Commodore called them; hardware-supported graphic elements that could move freely on the screen independently of other graphics and text on the screen), Super Expander had a built in tool to edit the pattern of 8 sprites (called upon with the <code>SPRDEF</code> command), either in high-res (24 × 21 pixels) or multicolor (12 wide × 21 pixels) mode.

There was even a way of implementing "interrupts" in the BASIC program if two sprites collided, if a sprite collided with other graphics and/or text on the screen, or if an attached light pen was activated. A <code>COLINT</code> command set up the interrupt, pointing to the beginning BASIC line number of the "[[interrupt handler]]", which had to end in a <code>RETURN</code> statement (part of standard, unexpanded BASIC) in order to transfer control back to the interrupted, "mainline" part of the program.

==Sound==
Playing a sequence of musical notes was hooked onto the standard BASIC <code>PRINT</code> command by the use of a special "control character", much like the cursor control, color changes and other control characters. E.g. {{code|2=cbmbas|1=PRINT CHR$(6);"CDEFGAB"}} played a rising scale. Commands like <code>TEMPO</code> and <code>TUNE</code> was used to set the playback tempo and the timbre of the note sequence.

A "quirk" of this feature is that by typing the special control character (by pressing {{keypress|CTRL|F}}) along with a quote mark, then deleting the quote mark, the machine would "play" whatever was typed while editing the program; hit the G key, and the machine played a "Pling!" with the pitch of a G note...!

==Hardware I/O==
Functions like <code>RJOY</code>, <code>RPEN</code> and <code>RPOT</code> would read the state of a connected joystick, [[light pen]], or analog [[Paddle (game controller)|paddle]]. In combination with the sprite-motion-related commands, it only took a single line of BASIC code to make a sprite move in the direction indicated by a connected joystick.

==Miscellaneous==
A <code>KEY</code> command was available, which would set up the four function keys on the 64's keyboard to "enter" an arbitrary string. By default, these keys were set up to type commands like <code>RUN</code>, <code>LIST</code>, <code>SPRDEF</code>, <code>GRAPHICS</code> and others, but the user could change this using the <code>KEY</code> command in either direct mode or under program control.

==Technical issues==
All the versions of BASIC on Commodore's 8-bit machines used a scheme of replacing BASIC keywords with single-byte code -- e.g. the word "{{code|PRINT}}" would be substituted by a single byte value, or ''token'', rather than the five ASCII-codes for the five letters in the word. Super Expander added more commands than this system could accommodate, so a system of two-byte tokens for the new commands was implemented.

Because of a quirk in the BASIC interpreter (the handling of the "THEN-part" of an IF/THEN construct didn't jump through a vector in RAM but instead took a direct JuMP to the standard, unexpanded BASIC command decoding routine), IF/THEN statements needed to have an extra colon (:) inserted right after the THEN keyword, if the following command was one of Super Expander's non-standard BASIC keywords. For instance, {{code|2=cbmbas|IF (condition) THEN DRAW ...}} would yield a {{code|2=cbmbas|?SYNTAX ERROR}} message &mdash; one had to write it like {{code|2=cbmbas|IF (condition) THEN:DRAW ...}} &mdash; note the colon between THEN and the Super Expander-added command DRAW.


The manual is available online as an [[etext]].<ref>{{cite web|url=http://project64.c64.org/hw/se64eng.txt|title=SUPER EXPANDER 64 cartridge user manual|archiveurl=https://web.archive.org/web/20070929084200/http://project64.c64.org/hw/se64eng.txt|
archivedate=29 September 2007}}</ref>



== References ==
<references/>

{{Commodore International}}
{{BASIC}}

[[Category:CBM software]]
[[Category:Commodore 64]]
[[Category:BASIC extensions]]
[[Category:Commodore 64 software]]