Radio Shack TRS-80 User manual

LIMITED WARRANTY
RADIO SHACK Software is licensed on an "AS IS" basis, without warranty. The original
CUSTOMER'S exclusive remedy, in the event of a Software manufacturing defect, is its repair or
replacement within thirty (30) calendar days of the date of the Radio Shack sales document
received upon license of the Software. The defective Software shall be returned to a Radio Shack
Computer Center, a Radio Shack retail store, participating Radio Shack franchisee or Radio Shack
dealer along with the sales document.
Except as provided herein, RADIO SHACK MAKES NO WARRANTIES, INCLUDING
WARRANTIES OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
Some states do not allow limitations on how long an implied warranty lasts, so the above
limitation(s) may not apply to CUSTOMER.
RADIO SHACK SHALL HAVE NO LIABILITY OR RESPONSIBILITY TO CUSTOMER OR ANY
OTHER PERSON OR ENTITY WITH RESPECT TO ANY LIABILITY, LOSS OR DAMAGE CAUSED OR
ALLEGED TO BE CAUSED DIRECTLY OR INDIRECTLY BY "SOFTWARE" LICENSED OR
FURNISHED BY RADIO SHACK, INCLUDING, BUT NOT LIMITED TO, ANY INTERRUPTION OF
SERVICE, LOSS OF BUSINESS OR ANTICIPATORY PROFITS OR INDIRECT, SPECIAL, OR
CONSEQUENTIAL DAMAGES.
Some states do not allow the limitation or exclusion of incidental or consequential damages, so
the above limitation(s) or exclusion(s) may not apply to CUSTOMER.
RADIO SHACK SOFTWARE LICENSE
RADIO SHACK grants to CUSTOMER a non-exclusive, paid-up license to use the RADIO SHACK
Software on one computer, subject to the following provisions:
A. Except as otherwise provided in this Software License, applicable copyright laws shall apply to
the Software.
B. Title to the medium on which the Software is recorded (cassette and/or diskette) or stored
(ROM) is transferred to CUSTOMER, but not title to the Software.
C. CUSTOMER shall not use, make, manufacture, or reproduce copies of Software except for use
on one computer and as is specifically provided in this Software License. Customer is
expressly prohibited from disassembling the Software.
D. CUSTOMER is permitted to make additional copies of the Software only for backup or archival
purposes or if additional copies are required in the operation of one computer with the
Software, but only to the extent the Software allows a backup copy to be made.
E. All copyright notices shall be retained on all copies of the Software.
The warranties granted herein give the original CUSTOMER specific legal rights, and the
original CUSTOMER may have other rights which vary from state to state.

Art Gallery™
!ladleIhaeK
ADIVISION OF TANDY CORPORATION
FORT WORTH. TEXAS
76102

Art Gallery Program:
©1981 Robert G. Kilgus
Licensed to Tandy Corporation.
All Rights Reaserved.
This applications software for the TRS-80 Color
microcomputer is retained in aread-only memory (ROM)
format. All portions of this software, whether in the ROM
format or other source code form format, and the ROM
circuitry, are copyrighted and are the proprietary and trade
secret information of Tandy Corporation and/ or its licensor.
Use, reproduction or publication of any portion of this material
without the prior written autorization by Tandy Corporation is
strictly prohibited. The license for using this software is printed
on the inside front cover of this manual.
Art Gallery Program Manual:
©1981 Tandy Corporation
All Rights Reserved.
Reproduction or use, without express written permission from
Tandy Corporation, of any portion of this manual is prohibited.
While reasonable efforts have been taken in the preparation of
this manual to assure its accuracy, Tandy Corporation assumes
no liability resulting from any errors or omissions in this
manual, or from the use of the information contained herein.
1098765432

Table of Contents
Introduction ........................................... .. 1
Loading the Program. ................................. .. 3
The Art Gallery Data Tape. ........................... .. 3
The Template. .......................................
.. 4
Running the Program 5
Draw or Change Picture 5
The Arrow Keys .................................
.. 5
Changing Colors .................................
.. 5
Changing the Size
of the Cursor. ................... .. 6
Connecting Lines. ................................
.. 6
Filling
an Outlined Area with Color 6
Drawing Triangles. ...............................
.. 7
Shrinking aPicture. ..............................
.. 7
Using Joysticks 7
Printing Letters on the Picture .....................
.. 8
Highlighting
Characters. .......................... .. 8
Saving Your Creation. ................................
.. 9
Loading aPicture from Tape .......................
.. 9
For 16K Users Only 11
Edit Text and Controls 11
Changing Controls 12
Changing the Color
12
Deleting Characters 13
Changing the Character Size 13
Changing Space Between Lines 14
Shadows 14
Multiple Colored Lines 15
Changing the Scrolling Speed 15
Horizontal Scrolling 15
Adjusting the Horizontal Line Placement 16
Tips on Using Horizontal Scrolling 16
Stop the Scrolling 17
Preparing Multi-Load Presentations 17
Appendices
A - More Fun with the Data Tape 19
B - Data Tape Pictures 21

Introduction
Introduction
You now have the opportunity to utilize your artistic talents without the mess of
paints and bother of stretching canvas. Art Gallery gives you the freedom to
create pictures with your video display as the canvas, the keyboard as your palette,
and the cursor
as your brush.
Leonardo da Vinci, Vincent van Gogh, and Henri Matisse would surely be jealous
if they could see you using your Color Computer to create masterpieces. And your
art can be preserved in your own personal art gallery -in the form
of acassette
tape.
For those with aAK or 16K Color Computer, Art Gallery lets you draw color
images on the screen and save them on tape for later touchups and viewing. (You
do
not have to have acassette recorder to use Art Gallery, but you cannot save
art for later viewing without one.) You can also type block letters in the size you
choose and view those later.
Also,
if you have a16K Color Computer you have atext editing screen, where you
type
text in your choice of size and then have it scroll horizontally or vertically.
If you have drawn apicture in the DRAW OR CHANGE PICTURE section, the
message you write in
EDIT TEXT AND CONTROLS will be scrolled across the
picture. This way you can make graphics with captions for public or private presen-
tations. These presentations can be stored on tape and shown later.
1

Loading the Program
Loading the Program
First, make sure the cassette recorder is connected properly. Turn on your TV
and insert
the cartridge in the slot in the right side of the computer. Now turn the
computer on by pressing the On/Off button at the left rear of your color
computer and the Art Gallery Menu shows:
ARTGALLERY
(C) R.G. KILGUS 1981
LICENSED TO TANDY CORP.
(TYPE CHOICE NUMBER)
1 DRAW OR CHANGE PICTURE
2 SAVE RESULTS ON TAPE
3 LOAD FROM TAPE
4 EDIT TEXT AND CONTROLS
5 DISPLAY DYNAMIC RESULTS
6 LOAD & RUN PRESENTATION
DRAW OR CHANGE PICTURE lets you make pictures and graphic illustra-
tions for your own pleasure or formal presentations.
2 SA VE RESULTS 0N TAP Elets you save your artwork on cassette tape for
retouches, or when you're ready to show those fastidious critics your "new
masterpiece".
3
LOAD FROM TAP Elets you see apicture that you previously saved on tape.
4
EDIT TEXT AND CONTROLS (only available on 16K Color Computer)
lets you type and revise scrolling text.
5 DISPLAY DYNAMIC RESULTS (also only available on 16K Color
Computer) lets
you see the results of the scrolling techniques that you
organized in Edit Text and Controls. You can make your edited text scroll
over an illustration.
6
LOAD & RUN PRESENTATION (only available on 16K Color Computer) .
lets you play back aseries of pictures and text in acontinous presentation.
The Art Gallery Data Tape
The Data tape, included as part of the Art Gallery package, should give you an
idea
of the versatility you have in drawing and storing your finished "attempts".
Unfortunately, those without acassette player cannot view the Data tape.
Make sure that your cassette player is properly connected to your Color
Computer. Insert
the cassette in the recorder and rewind the tape.
3

4
Loading the Program (continued)
If you have a4K Color Computer, you will have to load the Data tape presenta-
tion one picture at atime. Press rn
at the Menu.
The screen will show:
PREPARE RECORDER TO PLAY
PUSH "ENTER" WHEN READY
(OR "BREAK" TO GO BACK TO MENU)
Press (ENTER) and the screen will show: LOAD ING (with an @sign at the bottom
of the screen). After the picture is loaded, the Menu will return. Press CD to
see the picture. After the first picture has been viewed, press (BREAK) to return
to the Menu. Repeat this process until you have seen all 27 pictures on the Data
tape. The 27 images on
the Data tape are listed in Appendix Bon page 21.
If you have a16K Color Computer, you should refer to the last instruction,
6
LOAD & RUN PRESENTATION. Using this procedure, all of the images
are displayed without interruption. Those with a16K Color Computer have
the
option of using 3 LOAD FROM TAP E to view the Data tape pictures one at a
time.
After
you finish learning the key functions of Art Gallery, see Appendix Ato
find how
to use the Data tape to experiment with the key functions.
The Template
Atemplate is provided with key labels to help you locate and memorize the
various functions of Art Gallery. Place the overlay on the keyboard.

Running the Program
Running the Program
It takes practice to become adept at drawing pictures the way you want them to
look. Let's go over the different key functions before you begin drawing.
Draw or Change Picture
Press mfor DRAW OR CHANGE PICTURE. Asmall blinking cursor (a light
dot) will appear in the upper left comer
of your color video screen.
Pressing
~ will return you to the Menu.
The Arrow Keys
The four arrow keys will move the cursor in the direction of the arrow. Press
CSHfrr) and an arrow key to make the picture move in the direction of that
arrow. You can even scroll the picture off the screen in any direction. If you
scroll the picture off to the left, it will reappear from the right, so this is no way
to make abad drawing disappear.
The
(ENTER) key returns the cursor to the left side of the screen.
Changing Colors
Art Gallery has two color screens. The first screen is green. The cursor is clear
until you press one
of the keys to transform it to color. To change the cursor to
acolor, you press one of four color keys.
For red, press 00.
For blue, press m.
For green, press CID.
For yellow, press CD.
By pressing ®, the screen changes to a buff color. Red becomes orange. Blue
becomes magenta. Green becomes buff. Yellow becomes cyan.
If you don't like quasi-psychedelic colors, press ®again to return to the green
screen.
The
mAID key makes the cursor colorless. After pressing the (CLEAR) key, you
can move the cursor around to the desired point on your drawing without
affecting what you've already drawn. Then you press one
of the color keys to
continue drawing.
5

6
Running the Program (continued)
Changing the Size of the Cursor
The CD, (]J, 00, and [[) keys will change the cursor size. The cursor,
unchanged, is one unit. You can increase the cursor size up to 19 units in width
and height.
Press
the CD key and the cursor will become wider. Press the (]J key to
return the cursor to its normal size.
You can also make the cursor taller by pressing the 00 key. To return the
cursor to its normal size, press the [[) key.
Each time you press the m or 00 key, two units are added to the size of
the cursor. You may enlarge the cursor up to nine times. The larger the cursor,
the slower it moves around the screen.
Connecting Lines
The CO and CID keys may be used to connect two points on the screen with
the straightest possible line. Pressing CID will cause the computer to remember
the position of the cursor. You may then move the cursor to another point on the
screen without leaving atrail of color.
Pressing CO will connect the two points. The CO key will also cause the
computer to remember the current cursor position so you can connect it with
the next point. When you connect lines horizontally or vertically, astraight line
is produced. Connecting points diagonally will produce a"lightning bolt" effect.
This comes in real handy when you draw severe thunderstorms.
Filling an Outlined Area with Color
You can use the m key to fill an outlined area with the color of the outline.
To use this feature, first draw an outline. Press (CLEAR) to move the cursor inside
the outline. Press mand the area will be colored in.
Depending
on the shape of the outline, the outline may not be completely filled
with color the first time you use this option. Press (CLEAR) again, and move the
cursor to the area you want colored. Press m to complete the coloration.

Running the Program (continued)
Drawing Triangles
You can draw triangles by using the 00, CD, m, and 00 keys. The
triangle expands outward from
the cursor in adirection corresponding with the
position of the key in the block. The 00 key will cause the triangle to expand
to the top of the screen and to the left.
The CD key will cause the triangle to expand to the top of the screen and to
the right. The mkey will cause the cursor to expand to the bottom of the
screen and to the left. The 00 key will cause the triangle to expand to the
bottom of the screen and to the right.
Triangle expansion continues while the key is held down and expansion stops
when you release the key. Triangles will only expand to acertain point and then
stop whether the key is held down or not. You can also use any of the keys
simultaneously, change colors, and change the size of the cursor while drawing
atriangle.
The
(]J key makes adiamond, acting as if you pushed all four triangle keys at
once. You can maneuver the cursor just as you do in making triangles.
Shrinking aPicture
After drawing apicture, you may want to shrink it to make it asmall part of a
larger picture. Pressing
the (SHIFT) and ®keys will shrink the picture to one
halfits original size. You may
then use the (SHIFT) and arrow keys to move the
shrunken drawing anywhere on the screen. An excellent way to start over,
without pressing
the reset button, is to press the ~ and @keys until your
drawing disappears.
Using Joysticks
The left joystick can be used to move the cursor. Pressing (]J will transfer
control of the cursor to the joystick. The cursor will move in the direction you
move the joystick's lever.
Holding
the joystick's red button will make the cursor clear. Releasing the button
will make the cursor leave atrail of color. All of the functions may be activated
while the joystick is being used. To return control to the keyboard, simply press
one of the arrow keys.
Note: The keyboard functions will not work while the joystick's button is pushed.
7

8
Running the Program (continued)
Printing Letters on the Picture
Art Gallery lets you print letters and symbols in your choice of colors and sizes
Gust like buying shirts). To print letters,
you must first decide on the cursor size.
Each time you press the
CD or (]j keys, two units are added to the cursor's
size.
For the smallest letter you can print, press the CD key twice to make the
cursor 5units wide. Press
the rn key three times to make the cursor 7units tall.
You can make
the letters tall and thin, short and wide, or any other combination.
When you have decided what size
you want the letters, select acolor. To select
acolor, you press
the (CLEAR) key, then the key for the desired color. If you do
not press the (CLEAR) key before selecting the color, the cursor will type color
blocks, rather than color letters.
To make letters, press
the~key and the letter key. You can press the
(SHIIIJ and the CD) keys to lock the keyboard into an upper case mode, but you
must remember to press them again to change colors or cursor size.
For dual charact rkeys (1, !), the bottom character will print without the SHIFT
key and
the top character will print when the (SHIFT) key is pressed.
The cursor will move to
the right when acharacter is printed. When you get to
the end of aline press (ENTER) for the cursor to return to the left. You then need
to use the arrow keys to move the cursor up or down for the next line of letters.
Highlighting Characters
You can give your characters depth by reprinting the same letters in adifferent
color, one position lower than the first line. Follow this example:
1. Select alarge character size by pressing the CD and rn keys
several times.
2. Select yellow
as the first color by pressing the (CLEAR) and OJ
keys together.
3. Move the cursor
to the beginning of aline.
4. Press
the (SHIFT) key and type aline of characters.
5. Press
(ENTER) to return the cursor to the left, then carefully position
the cursor over the first letter. (Check the upper left corner of the
cursor and the character.)
6. Press
the (CLEAR) and CD keys together to change the color to blue.
7.
Move the cursor down by pressing the mkey once. Then move
the cursor to the right by pressing the 8key once.
8. Hold down the
(SHIFT) key and type the same letters again.

Running the Program (continued)
Saving Your Creation
After you draw apicture, you may want to save it on tape. Press ~ for the
Menu. Press rn for SAVE RESU LTS ON TAPE. Make sure the cassette recorder
is properly connected.
The screen will show:
PREPARE RECORDER TO RECORD
PUSH "ENTER" WHEN READY
(OR "BREAK" TO GO BACK TO MENU)
Press "Record" and "Play" on your tape recorder simultaneously. Set the tape
recorder counter to zero. When the tape and recorder are both set, press (ENTER).
If everything is correct, the screen will show:
RECORDING
An @sign will appear at the bottom left of the screen while the picture is being
saved. The Menu will appear when the drawing is recorded.
Be sure to identify the tape's contents by writing the counter number of each
recorded
entry on the label.
Loading aPicture from Tape
To load apicture you have previously saved, make sure the recorder is connected
properly, and insert the tape. Set the counter to zero, and if the picture you want
is not the first one on the tape, press the "Fast Forward" button to get to the
desired counter number. Press the "Rewind" button if you pass the precise number.
Press
"Play" on your tape recorder.
When everyt:ling is set, press rn
at the Menu for LOAD FROM TAPE.
The screen will show:
PREPARE RECORDER TO PLAY
PUSH "ENTER" WHEN READY
(OR "BREAK" TO GO BACK TO MENU)
Press (ENTER), and the screen will show: LOADI NG. An @sign will appear at the
bottom of the screen while the picture is being loaded. The screen then returns
to the Menu. If there is aproblem in loading, the screen will say READ ERR0 R.
If there is aproblem, rewind the tape and press (ENTER). If your second attempt
does not work, you need to start over by pressing ~ for the Menu.
9

For 16K Users Only
For 16K Users Only
If you are using a16K computer, you have access to a text editing function. Using
this function,
you can type words in your choice of sizes and colors and make
them scroll horizontally
or vertically on the screen at aspeed you designate.
If you have already drawn apicture in the DRAW OR CHANGE PICTURE section
the message you type in EDIT TEXT AND CONTROLS will scroll over the picture.
These features will let
you add movement to the screen and allow you to make
full presentations using
Art Gallery.
Edit Text and Controls
Press (BREAK) to return to the Menu. Press mfor EDIT TEXT AND CONTROLS.
The screen will have acursor flashing in the upper left corner. Each time you type
aletter,
the cursor moves to the next space. Anything typed will appear in upper
case letters.
This feature
of Art Gallery lets you type and edit text. You may type and edit up
to 191 lines. When you have finished typing the message or story, the
text will be
displayed when you press(BREAKhnd
rn for DISPLAY DYNAMIC RESULTS at
the Menu. If you drew apicture in DRAW OR CHANGE PICTURE, the message
will scroll over
that picture.
Color, size, scrolling direction and scrolling speed
of the message are your decisions.
Unless
you enter control information (described later), the text that follows an
asterisk
(*) will be scrolled vertically in red and will be 5points wide and 7points
high.
For example, type an asterisk (0) and oomcoco(]J. Press (BREAK) .
At the Menu, press rn for DISPLAY DYNAMIC RESULTS. Ared HELLO
should scroll vertically up the screen. The message will repeat until you press
(BREAK) to return to the Menu. Procedures of how to choose size, color,
direction, and speed
of the scrolling message are given next.
11

12
For 16K Users Only (continued)
Changing Controls
You may change the dimensions at any time by inserting control information in
front
of the text you just entered.
First, press the (SHIFT) and (3 keys four times to move the existing text to the
right.
Don't move it too far or it will not be visible on the screen.
The slash
(0) is acontrol key like the asterisk. The slash comes before the
asterisk.
It tells the program that more control information follows. Anything to
the left of the asterisk will not be scrolled when you display the picture.
Anything
to the right of the asterisk will be scrolled when you display your picture.
The different control options will always be between the slash and
the asterisk.
You can have
one control area that will govern the color, size, and spacing of the
next lines. To make all lines have the same size, color, etc., there should be acon-
trol area in
the first line. The rest of the lines only need an asterisk before the first
letter of each line. Lines will not be displayed if they do not have an asterisk before
the first letter of each line.
Position
the cursor over the asterisk. Press the (SHIFT) and (3 keys to move the
asterisk and
text over several spaces. Now press the 8key enough times to move
the cursor
to the flush left position on the screen. Type the slash mark. The area
between the slash and the asterisk
is called the control area.
Note:
If you enter any incorrect information in the control area, it will be
detected when you "Display Dynamic Results." The line containing the error
will
be ignored and aquestion mark will be placed in the first position of the
line. If you see aquestion mark while you "Edit Text and Controls", correct
your error and change the question mark back to aslash. Then try again.
Changing the Color
Let's start by changing the color of the text. Type either a ([) for blue, ([) for
green,
Wfor yellow or an (]J for red in any space between the slash and the
asterisk.
The text will always be red unless you choose another color. The back-
ground screen will
be green or whatever colors you used when you drew your
background picture. If you choose green as your text color, the message will not
show up on the screen unless you have already made the background another color
in
Option 1 of the Menu.
You can also change
the displayed colors to orange, magenta, buff and cyan as you
did earlier in this manual (remember psychedelic?).
To do this, press (BREAK) andCI)
at the Menu. Press m to change the screen colors to orange, magenta, buff and
cyan. Press
(BREAK)and rn at the Menu. If you type (]J for redin the control
area, the message will be displayed as orange on a buff background, etc.
Press (BREAK) to go back to the Menu. Then press rn to view the results.

For 16K Users Only (continued)
The same color is repeated unless you change the color in the following control
areas.
For example, if you chose blue letters (by typing 000 0in the
first line), any lines following would be blue. You could make the next line
yellow by typing
0CYJ0. If you want to change the color for aline, you
need to insert your new color choice inside each line's control area.
For example:
0CYJ0 (for ayellow line) CIDwCTICTICID
0000 (for ared line). CIDWCTICTICID
o(following lines will be red until all lines
have been scrolled) CIDWCTICTICID
Press (BREAK) and rn to view the results. Press (BREAK) and GJ for the editing
screen.
Deleting Characters
You may delete letters by pressing the (SHIFT)and 8keys. If you are in the first
space (flush left) and press the (SHIFT) and 8keys, the entire line will be deleted.
To insert ablank line, place the cursor over the last space of aline (flush right) and
press the (SHIFT) and 8keys. The blank line will be below the cursor.
Changing the Character Size
You can control the letter size of the scrolling message. The character size
displayed will always be 5 by 7 if you do not designate aparticular character
size.
You can control the letter size of the scrolling message ..
Characters can be no smaller than 5 by 7. The first number is the width and the
second number is the height. As you did when printing letters on the screen, you
can choose your own combination of character sizes.
You choose
the desired character size inside the slash and asterisk. For 9by 11,
you would type CIDOOCDCDwith no spaces. Use the (SHIFT) and 8keys to
add
the necessary spaces for your line measurement. Lines following will be
9
by 11 unless you insert different character sizes for each line.
Now press
(BREAK) and rn in the Menu. The messages each have the same height
but are different colors on different lines.
Press
(BREAK) and GJ at the Menu.
If you want to change the wid th alone, type one number in the control area.
For example, 0CDrn 0would have acharacter width of 21 and acharacter
height
of 7. Another example would be 000CID0, which
means acharacter width of 5and acharacter height of 9.
13

For 16K Users Only (continued)
The wider the characters, the fewer will fit on the screen when you are scrolling
vertically. This table should be helpful.
Character Width: 5
Letters per Line:
21
7
16 9 11
11
10 13
8
15
717
619
5
21
5
14
Changing Space Between Lines
Changing character height may necessitate your changing the spacing between
lines. This
is only used for vertical scrolling. If characters are 7points high,
you usually should have 10 or more points between lines. Anew spacing is
indicated inside
the control area by typing aplus sign followed by a number
between 1and 99.
/+10* indicates a 5 by 7character size with 10 point spacing between each line.
!7X15+20* shows a 7
by 15 character size with a 20 point spacing between
each line.
Shadows
You can make your scrolled message (vertical only) look three-dimensional by
adding shadows. Type aline
of text with one color and only advance one or two lines.
Then type the same text choosing different color and advance the usual distance
between lines.
Continuing
with the example, use the (SHIFThnd (3 keys to make room in the
control area for the added characters. For the first line, make the line spacing
BCD. For the second line make the line spacing GCDc[). Your text screen
should look like this:
/B9X11+1
*HELLO
!Y+lO*HELLO
Press (BREAK) and rn at the Menu to see the result.
Press
(BREAK) and rnat the Menu.