TIMEX BASIC 64
User Manual for TC2068

Graphic pack Basic 64 TC2068
Graphic pack Basic 64
Extension to Sinclair Basic
Version for TC2068
Graphic Pack Basic 64

Note: The Basic64 routines can be used in the user programs.
Comercial programs must refer that the Basic64 routines are used.

CAP 0 – Introduction

The Basic 64 program, version 1.1, gives the possibility to the user, to use the extended graphic capabilities and special text printing, supported by the design of the TC2068 (in native 2068 mode).

Two special channels are used, to print in 64 columns (channel #4) or print in a variable number of columns (channel #5). There is implemented a new group of Basic commands in addition to the existing ones, allowing the use of those graphics modes in Basic programs. Is possible too, the use machine code routines to use those capabilities.

CAP 1 – System initialization

Put the Basic64 tape in the tape recorder and type:

LOAD “”

After the LOADER stop to LOAD, this message appears on the screen:

TEM O SISTEMA FDD LIGADO AO COMPUTADOR? (S/N)
(Do you have the FDD system connected to the computer (Y/N))

If the answer is no, so the BASEST1A code block is loaded. If the answer is yes, the BASEST1 code block is loaded, what justifies, is that with the FDD connected, the machine code routine is a little different. Then the second code block is loaded, then a message appears on the screen:

0 OK, 0:2

Now you can verify that a line 0 exists and include a direct call to the routine and a copyright message. The call to the routine, will relocate BASIC, start the new system variables introduced by Basic64, open the new channels (#4 and #5), and prepare the Basic interpreter, so it accepts the syntax of the new commands.

The user must execute a RANDOMIZE USR 32280, after a CLEAN n, RUN n or a GOSUB n to access the extended commands. You are advised to edit the Basic programs in 32 columns mode, so execute the following command:

OUT 255,0

After editing, you can return to extended mode with the INK *n or PAPER *n.

1.1 SAVE and LOAD Basic64 programs

There are two ways of saving programs in Basic64, one of them involving, the change of the basic program in the tape.

In the first step, common to both processes, the program is saved in the tape by the usual way. To call it, you can LOAD the Basic64 routine and then LOAD the program. If you want to LOAD all in a single step (using just one LOAD””), you must perform the following way: first, make a NEW and then from the Basic64 tape execute MERGE””, after that, you make a LIST and see that line 15 have a comment. Replace that line with one with a LOAD”name” to LOAD the program in Basic64 and save this LOADER with SAVE “BASIC64” LINE 10

CAP 2 -Extended Basic

2.1 Resolution modes

The user has two graphic modes permitted by the system:

0 – 256×192 pixels (256×176 pixels in the zone dedicated to printing)
1 – 512×192 pixeis (512×176 pixeis, the same)

Those modes, both using the two DISPLAY FILES, are relative to the new graphical commands, which we will introduce and will be explained in the next section:

• PLOT* x,y
• LINE x,y
• LINE x,y,z
• CIRCLE* x,y,r
• SCREEN$ n

The modes 0 and 1 can be used in the same program and are independent of the printing commands. It’s possible in any of both, to use the channels #4 and/or #5 in the following way:

#4: This channel is specially dedicated to printing in 64 columns. It uses the character set in the ROM, appointed by the system variable CHARS. Each character is defined in a matrix with 8×8 pixels. The printing is invoked by the commands PRINT #4… and LIST #4…

#5: This channel permits a flexible printing because it is programable by the user. It has two steps of freedom.

-Number of columns in screen (system variable MAXCL)

-Number of pixels, in the horizontal, of the pixels matrix of the definition of the characters (system variable LARG).

There is a new character set defined in a 6×8 pixel matrix, pointed by the system variable CHRST. This set is used to print in 80/85 columns and can be used to print in 64 columns. So the #5 channel is defined, by default, in the following way:

-Printing the new character set in 85 columns and with a 6×8 pixels matrix, using the PRINT #5… and LIST #5… commands.

2.2 New Basic Commands

2.2.1 Text printing commands

• PRINT #n… The n parameter is the used channel (#4 or #5). The field … indicates a sequence of the PRINT command, separated by separators (, ; and “). The parameters can be numerical and string expressions and control characters (AT m,n TAB n).
• LIST #n;m The n parameter is the used channel (#4 or #5). This command lists the program starting from line m. If m is not specified, then the list will be made from the first line of the program.

2.2.2 Graphical commands

• CLS* Erases the two DISPLAY FILES.
• INK* n The user can only put a combined INK and PAPER for both DISPLAY FILES. This command puts INK=n and PAPER=7-n.
• PAPER* n Like INK*n. Puts PAPER=n, INK=7-n
• SCREEN$ n Sets the resolution mode.
  • n=1, the mode 512×192 is active.
  • n=0, the mode 256×192 is active.
• PLOT* x,y Puts a PLOT of INK in the pixel x,y and updates the PLOT position. OVER and INVERSE act as normal.
• LINE x,y,z Draws a line from the PLOT position, changing horizontally x and vertically y and making an arc of a circle.
• LINE x,y LINE x,y,0
• CIRCLE* x,y,r Draw a circle with center x,y, and radius r, if the screen mode is 0. If screen mode is 1, it draws an oval.

2.3 Memory organization

The new memory map is characterized by the existence of two DISPLAY FILES and the relocation of the reserved BASIC area, STACK area, and RAM RESIDENT CODE area. The BASIC area is moved to address 34313 (pointed out by the system variable PROG). Next to the CHANNEL area (CHANS), is the new character set (lenght=768 bytes), the Basic64 routine (lenght=2030 bytes), which is followed by the BASIC area. The STACK and RAM RESIDENT CODE areas stay in the upper 8K RAM block.

Basically, we have: