# Super Expander

The VIC-1211 Super Expander is a cartridge for the VIC-20 home computer. It was designed to provide several extensions to the BASIC interpreter on the computer, mostly to help with programming graphics and sound. It also provided 3 KB of extra RAM (of which 136 bytes were used by the cartridge itself). The cartridge was created by Commodore Business Machines (CBM) and released in 1981.

## Description

The dialect of BASIC bundled with the VIC-20, Commodore BASIC V2.0, was notorious for its sparse functionality. It didn't even match the features of Commodore's older line of computers, the PET which, at that time, already featured Commodore BASIC version 4.0. As a result, it was outdated by the VIC-20's release and seemed quite primitive compared to BASIC dialects available on other microcomputers. To be fair, the decision by Commodore to recycle the old BASIC, and the fact that it could fit in just 16 KB ROM (including the KERNAL), helped keep the VIC-20's price to a minimum and so contributed to its huge success. Plus it was stable and almost entirely bug-free, which could not be said of some competing BASICs.
Nevertheless, not only did "VIC BASIC" lack commands considered fundamental to the BASIC language, such as "else" and "renum", but graphics and sound effects were completely unsupported. To use VIC-20's graphics and sound programmers had to "PEEK and POKE" bytes directly from/to the VIC-20's graphics/sound hardware, the 6560 Video Interface Chip (VIC). This made programming quite tedious and error prone since cryptic memory addresses and codes had to be used constantly, mistakes in these would usually crash the computer instead of giving an error message, and many statements were required to do even simple tasks. Such a thing was death in the tiny RAM and slow interpreted BASIC paradigm of the day.
Programmers could mitigate these problems by using machine code, to an extent, but this in itself was a tedious process with a rather steep learning curve. So to address these shortcomings Commodore created the Super Expander cartridge. It provided extra BASIC commands to facilitate using graphics and sound on the VIC-20. It also had commands to read the joystick and lightpen, and unlocked the use of function keys.

## Graphics

The VIC-20 did not support high resolution graphics directly. Hi-res graphics were implemented by "painting" the display with characters, and "redefining" the character bitmaps on the fly. This was a complex and long-winded process; implementing it in a BASIC program was virtually useless due to the execution time required to draw anything.
The Super Expander took care of all the hard work. It allowed the programmer to draw points, lines, ellipses and arcs, and to paint enclosed regions, with one-line statements. All the VIC-20's 16 colours could be used, although with restrictions due to limitations of the 6560 chip. Display resolution was 160×160 pixels, throttled down from 192×200 allowed by the 6560 chip, in order to permit per-pixel addressability. Multicolor hi-res was supported (with a resolution of 80×160) and could be mixed with normal hi-res.

## Sound

The VIC-20's sound capability was fairly simplistic, so programming sound effects using "PEEK and POKE" was not so much of a chore as programming graphics. Even so, the Super Expander provided a command to play simple tones on the VIC-20's four voice channels, and to control the volume.
Music playback was unsupported on the VIC-20; the usual way of implementing a musical note was to play a tone inside a for loop time delay. In contrast, with Super Expander musical scores could be played by simply PRINTing a string of characters. (Music strings were distinguished from regular strings using a special reverse-control-character, familiar to anyone who has used colours or cursor controls in VIC-20 programs.) Each of the VIC-20's four voice channels could play their own scores simultaneously, giving harmonious effects which could be striking by the standards of the time.

## Other devices

Super Expander provided commands to read the status of the joystick and paddles, and the position of the lightpen. In the case of the joystick, since it was the "digital" or "switch" type, further bit-fiddling was required to decode its position.

## Function keys

Ordinarily the VIC-20's function keys could only be used in a program, by scanning for the appropriate key code when reading the keyboard. In the VIC-20's direct mode they were not available to do anything. With the Super Expander the function keys could be assigned to execute commands in immediate mode. By default they came pre-programmed with the most common BASIC commands, in a similar fashion to GW-BASIC on the IBM PC. The user could then assign their own commands, or any arbitrary string in fact, to the function keys.

## Drawbacks

The following are the main limitations of the Super Expander's appeal and usefulness.
* Commodore designed the Super Expander to map the graphics display to a 1024×1024 coordinate system. Under this scheme, each video pixel was 6.4 (or 12.8) "virtual" pixels in size. This meant that in order to place pixels in exact positions on the screen a further scaling operation had to be coded in. Similar functionality was provided on BASIC 3.5 and 7.0 via the SCALE command, but in these versions of BASIC, scaling was optional and could be done to any arbitrary user-specified size.
* The aspect ratio of the output device (i.e. television set) was not taken into account by the coordinate system. So on NTSC, a circle sized, say, 300×300 would appear elliptical. Similarly, a line drawn from (0,0) to (300,300) would not be displayed as 45°.
* When drawing circle arcs, the starting and ending angles had to be specified in non-standard units of a 100 "gradians" to the circle (as opposed to 360 degrees or 400 actual gradians).
* The Super Expander had no capability to put a bitmap to the display. This meant arbitrary bitmaps, as might be used in a hi-res game, had to be drawn pixel-by-pixel. The slowness of the BASIC interpreter made this unsuitable for applications like arcade-style games. As a result, Super Expander's capability was mostly useful for shape-centric drawings such as charts and simple pictures, or adventure-style games with static images.
* Programs written using the extra Super Expander commands were not portable. While unavoidable (since programs would not fit into the memory of an unexpanded VIC-20, and the additional BASIC commands wouldn't be recognized anyway). A user needed to own the cartridge and have it installed before a program written with the additional commands would run. Loading the program onto an unexpanded VIC-20 gave errors. Therefore, the range of software released to take advantage of the Super Expander's capabilities, including type-in programs published in magazines, was very small.
In spite of the above, the Super Expander's features filled many of the gaps in the VIC-20's programming environment. Additionally, similar microcomputers on the market suffered the same, or equivalent, shortcomings.