Radio Shack TRS-80 User manual

Hi-Res Screen Print Utilities
.. ::~~:
f :
....
Cat. No.
26·3121
.l ________________ T_R __ S--B--0----------------~' '"

TERMS AND CONDITIONS OF SALE AND LICENSE OF RADIO SHACK
COMPUTER EQUIPMENT AND SOFTWARE PURCHASED FROM A
RADIO SHACK COMPANY-OWNED COMPUTER CENTER, RETAIL
STORE OR FROM A RADIO SHACK FRANCHISEE OR DEALER AT ITS
AUTHORIZED LOCATION
LIMITED WARRANTY
CUSTOMER OBLIGATIONS
A. CUSTOMER assumes full responsibility that this Radio Shack computer hardware purchased (the
" Equ i pment "), and any copies of Radio Shack software included with the Equipment or licensed
sepa rately (the "So ftware ") meets the specifications , capacity, capabilities , versatility. and other
requirements of CUSTOMER .
B. CUSTOMER assumes full responsibility for the condition and effectiveness of the operating
environment in which the Equipment and Software are to function , and for its insta llation .
RADIO SHACK LIMITED WARRANTIES AND CONDITIONS OF SALE
A. For a period of ninety (90) calendar days from the date of the Radio Shack sales document
received upon purchase of the Equipment . RADIO SHACK warrants to the original CUSTOMER that
the Equipment and the medium upon which the Software is stored is free from manufacturing
defects . THIS WARRANTY IS ONLY APPLICABLE TO PURCHASES OF RADIO SHACK EQUIPMENT
BY THE ORIGINAL CUSTOMER FROM RADIO SHACK COMPANY-OWNED COMPUTER CENTERS ,
RETAIL STORES AND FROM RADIO SHACK FRANCHISEES AND DEALERS AT ITS AUTHORIZED
LOCATION. The warranty is void if the Equipment's case or cabinet has been opened , or if the
Equipment or Software has been subjected to improper or abnormal use . If a manufacturing defect
is discovered during the stated warranty period , the defective Equipment must be returned to a
Radio Shack Computer Center, a Radio Shack retail store , participating Radio Shack franchisee or
Radio Shack dealer for repair, along with a copy of the sales document or lease agreement . The
original CUSTOMER'S sole and exclusive remedy in the event of a defect is limited to the
correction of the defect by repair , replacement , or tefund of the purchase price , at RADIO
SHACK 'S election and sole expense . RADIO SHACK has no obligation to replace or repair
expendable items .
B. RADIO SHACK makes no warranty as to the design , capability , capacity, or suitability for use of
the Software. except as provided in this paragraph . Software is licensed on an " AS IS " basis ,
without warranty . The original CUSTOMER 'S exclusive remedy , in the event of a Softw~re
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 sto re , participating Radio
Shack franchisee or Radio Shack dealer along with the sales document.
C. Except as provided herein no employee , agent , franchisee , dealer or other person is authorized to
give any warranties of any nature on behalf of RADIO SHACK .
D. Except as provided herein , RADIO SHACK MAKES NO WARRANTIES , INCLUDING WARRANTIES
OF MERCHANTABILITY OR FITNESS FOR A PARTICULAR PURPOSE.
E. Some states do not allow limitations on how long an implied warranty lasts, so the above
limitation(s) may not apply to CUSTOMER .
LIMITATION OF LIABILITY
A. EXCEPT AS PROVIDED HEREIN , 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
" EQUIPMENT " OR "SO FTWARE " SOLD, LEASED , LICENSED OR FURNISHED BY RADIO SHACK ,
INCLUDING , BUT NOT LIMITED TO , ANY INTERRUPTION OF SERVICE , LOSS OF BUSINESS OR
ANTICIPATORY PROFITS OR CONSEQUENTIAL DAMAGES RESULTING FROM THE USE OR
OPERATION OF THE " EQUIPMENT " OR "SOFTW ARE ". IN NO EVENT S HALL RADIO SHACK BE
LIABLE FOR LOSS OF PROFITS , OR ANY INDIRECT , SPECIAL. OR CONSEQUENTIAL DAMAGES
ARISING OUT OF ANY BREACH OF THIS WARRANT Y OR IN ANY MANNER ARISING OUT OF OR
CONNECTED WITH THE SALE , LEASE , LICENSE , USE OR ANTICIPATED USE OF THE "EQUIP MENT' '
OR "SOFTWARE ". continued

NOTWITHSTANDING THE ABOVE LIMITATIONS ANO WARRANTIES . RADIO S HACK 'S LIABILITY
HEREUNDER FOR DAMAGES INCURRED BY CUSTOMER OR OTHERS SHALL NOT EXCEED THE
AMOUNT PAID BY CUSTOMER FOR THE PARTICULAR " EQUIPMENT " OR " SO FTWARE "
INVOLVED .
B. RADIO SHACK shall not be liable for any damages caused by delay in delivering or furnishing
Equipment and / or Software .
C. No action arising out of any claimed breach of this Warranty or transactions under this Warranty
may be brought more than two (2) years after the cause of action has accrued or more than four
(4) years after the date of the Rad io Shack sales document for the Equipment or Software .
whichever first occurs .
0. Some states do not allow the li mi tation or exclus io n 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 di ske tte) or stored (ROM)
is transferred to CUSTOMER . but not title to the Software .
C. CUSTOMER may use Software on one host compu ter and access that Software through one or
more term i nals if the Software permits this function .
0. 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 di sassembling the Software .
E. CUSTOMER is permitted to make additional copies of the Software only for ba ck up or archival
purposes or if additional copies are required in the operation of one computer wi th the Software ,
but only to the extent the Software allows a backup copy to be made . However . for TRSDOS
Software , CUSTOMER is permitted to make a limited number of additional cop i es for
CUSTOMER'S own use .
F. CUSTOMER may resell or distribute unmodified copies of the Software provided CUSTOMER has
purchased one copy of the Software for each one sold or distributed . The provision s of this
Software License shall also be applicable to third parties receiving copies of the Software from
CUSTOMER .
G. All copyright notices shall be retained on all copies of the Software .
APPLICABILITY OF WARRANTY
A. The terms and conditions of this Warranty are applicable as between RADIO SHACK and
CUSTOMER to either a sale of the Equipment and / or Software License to CUSTOMER or to a
transaction whereby RADIO SHACK sells or conveys such Equipment to a third party for l ease to
CUSTOMER .
B. The limitations of li ability and Warranty provisions herein shall i nure to the benefit of RADIO
SHACK , the author , owner and / or licensor of the Software and any manufacturer of the Equipment
sold by RADIO SHACK .
STATE LAW RIGHTS
The warrant ies granted here in give the original CUSTOMER specific legal rights , and the original
CUSTOMER may have other rights which vary from state to state .

Hi-Res Screen Print
Utilities
A DIVISION OF TANDY CORPORATION
FORT WORTH, TEXAS 78102

Hi-Res Screen Print Utilities Programs:
©1983 Tandy Corporation
All Rights Reserved
Hi-Res Screen Print Utilities Program Manual:
©1983 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.
10 9 8 7 6 5 4 3 2 1

Contents
Int roduction . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 1
Requ ired Equipment . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 2
Loading CODUMP or BWDUMP . . . . . . . . . . . . . . . . . . . . . . . . 3
Operation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Color Printing . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Color Designation Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . 4
Monochrome Printing. . . . . . . . . . . . . . . . .. . . . . . . . . . . . . . 5
Shade Selection Keys . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 6
Program Relocation . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . . 7
For Micropainter Users ................................. 8
For Mini Disk D rive Users ................ .............. 9

Introduction
The tape provided with this package contains CODUMP
(Color Dump Program ) and BWDUMP ( Black and White
Dump Program ), which let you print high resolution graphic
displays (PMODE 3, and 4) from a TRS-80®Color Computer
in four colors or in black and white (monochrome ).
The programs load quickly, require minimum memory space,
and execute easily.
After loading CODUMP or BWDUMP , you have the ability
to produce hard copies of charts, graphs , logos, or any other
type of graphic displays. CODUMP works especially well
with Micropainter ® and gives you the option of selecting a
color-set for printing.
You'll discover that CODUMP and BWDUMP are valuable
software additions that provide the useful and practical
function of graphic display printing to your Color Computer.
1

Required Equipment
• Color Computer with at least 16K RAM and Extended
Basic
• Standard television (co lor recommended)
• CCR-81 Computer Recorder (26-1207) or equivalent
• Printer Cable (26-3020)
• CGP-220 Ink-Jet Printer for color printings (26-1268), or
any Radio Shack Dot Matrix Printer with Bit Image
capabilities for monochrome printings: LPVIII, DMP 100,
110, 120, 200, 400, and 420.
Note: If your printer prints half-width pictures, check the
printer's owner's manual for instructions on how to set
your printer to the expanded print mode.
2

LoailingCODUMPorBWDUMP
To load either program, follow this procedure:
l. Connect the cassette recorder to your Computer as
outlined in the Color Computer Operation Manual.
2. Rewind the tape and then press the play button .
3. Type CLEAR 200, 14848 and press (EN TE R ).
4. Type:
CLOADM "name" ( EN TER )
where "name" refers to either CODUMP, or BWDUMP.
The OK prompt ret u rns to the screen and the tape stops
after the program has been loaded.
4. Type EXEC and press (EN TER ).
Note: CODUMP changes the baud rate automatically to
2400. The CGP-220 Ink-Jet Printer supports this rate . This
is a desirable feature since color screen dumps require more
data than monochrome printings . If a differe nt baud rate is
desired, address 150 must be POKEd as specified in the
GOING AHEAD WITH EXTENDED COLOR BASIC
manual (pg. 210). BWDUMP leaves the baud rate as is.
3

Operation
Having loaded either CODUMP or BWDUMP, you may use
your Color Computer to execute a program that produces a
high resolution graphic display (PMODE 3, or 4). Then,
depending on which screen dump program you loaded, you
may obtain a color or monochrome printing of the graphic
image appearing on the screen.
Color Printing
1. Be sure that the computer is properly connected to the
serial port of the CGP-220 Ink-Jet Printer .
2. Press the right arrow key (E)) and then one of the color
designation keys - ([), OJ, or (2]. (See the section
below.)
The key pressed displays momentarily on the screen, the
cursor disappears, and printing begins. After printing is
complete, the cursor resumes flashing .
To cancel printing, press ( BREAK ). To print anot her picture,
simply repeat step 2.
Color Designation Keys
Graphic displays may appear on your screen in one of three
color-sets:
• Green, Yellow, Blue, and Red
• Buff , Cyan , Magenta , and Orange
• Black , Blue , Red, and White
With the color designation keys, ([), OJ, and (2J - which
correspond to each color set above respectively -you can
keep the colors displayed on the sc reen or change to a
different color-set for printing .
To keep the same color set, choose the color designation key
that matches the color-set of your screen . That is, if the
colors on the screen are Green, Yellow, Blue, and Red, use
color designation key ([) .
4

To send a different color set to the printer, press a color
designation key that does not correspond to the colors on the
screen. The graphic display is then printed in the newly
assigned color set according to a color conversion scheme
that is summarized by the table below:
Color Designation Printed Colors
Key
CID
Green Yellow Blue Red
i t i i
CD
Buff Cyan Magenta Orange
i i i i
m Black Blue Red White
Color Conversion Table
For example, if you choose color designation key CD for a
display that contains color set CID, the image is printed in
Buff , Cyan, Magenta, and Orange. Similarly, if you specify
color designation key (2], the image is printed in Black,
Blue, Red, and White.
Consider color conversion when choosing a color designation
key.
Monochrome Printing
The steps for creating monochrome (black and white)
printings of graphic displays are just as simple as those for
color screen dumps .
1. Be sure that the Color Computer is properly connected to
a Radio Shack printer with Bit Image capabilities.
2. Press the right arrow key CG) and one of the shade
selection keys, 00, ([), aJ, or CID. (See the section
below.)
The shade selection key you press displays momentarily
on the screen, the cursor disappears, and printing begins.
After printing is completed, the cursor resumes flashing
on the screen.
To cancel printing, press ( BREAK ). To print another
picture, repeat step 2.
5

Shade Selection Keys
In monochrome printings you also have some options as to
the selection of varying shad es of gray ( or dark to light
areas ) for printing. Thi s is accomplished by pr essi ng one of
the shade selection keys in step 2 above. The shade
selection key s and their respective printed s hade s are listed
below:
Shade Selection Display Colors Printed Shades
Keys
00 (4 color green light gray
display) yellow white
blue black
red dark gray
CID (4 color buff white
display) cyan black
magenta light gray
orange dark gray
m (4 color black black
display) blue dark gray
red light gray
white white
CID (2 color black black
display) green white
6

Program Relocation
Both CODUMP and BWDUMP are normally loaded at
address 14848. For this reason, it is recommended that you
load only the screen dump program you wish to use.
However, it is possible to load both programs by moving one
of them to a new address . For example, to load one of the
programs to address 12288 follow the steps below:
1. Decide which program you wish to load at an address
other than the default 14848.
2. Type CLEAR 200, 12288 (ENTER).
3. With the cassette recorder set on play , type :
CLOADM "program", (50688 + new address)
(ENTER )
where "program" is either CODUMP or BWDUMP and
"new address" is the substitute address to load the
program. In this example , 12288 is the new address .
(50688 simply resets the default address. )
3. Type EXEC and press ( ENTER).
4. Load the other program in the usual way.
5. Type EXEC and press ( ENTER).
When both programs are loaded, you can use either one in
the usual way. That is, if you want to use CO DUMP , simply
press the right arrow key ( E) ) and one of the color
designation keys. On the other hand, if you want to use
BWDUMP, press the right arrow key ( (3) and one of the
shade selection keys .
7

Fo r Micr o painte r Users
You can use both CODUMP and BWDUMP to print any
pictures created with Micropainter that you may have saved
on tape.
1. Load and execute CODUMP or BWDUMP .
2. Load the Micropainter picture to memory with the
CLOADM command.
3. Dump the picture to the printer by pressing G and one
of the color or shade de signation keys, whichever applies.
When you load the Micropainter picture to memory, it is not
displayed on the monitor. This does not prevent you from
sending it to the printer. However, if you wish to see the
pict ure before sending it, type PMODE 3, 1 then enter and
run the following program:
10 SCREEN 1, 0
20 GOTO 20
If the picture was done in the Black, Blue, Red, White color
set, add the following line to the above program :
15 POKE 65314, 248
8

For Mini Disk Drive Users
If your system is equipped with a Mini Disk Drive, you can
easily convert CODUMP and BWDUMP to disk files. Follow
these steps:
1. Load either of the screen dump programs from the tape
into the Color Computer ( as described in "Loading
CODUMP or BWDUMP" ).
2. Save the loaded program to disk by typing:
SAVEM "name", 14848, 16127, 14848 ( ENTER)
When the program is saved to disk , the OK prompt
returns to the screen.
After either , or both of the programs have been sa v ed to
disk, you may use them as described in the Operation
section. But remember , to load a program from disk, you
must type :
LOADM "name"
where "name" is either CODUMP or BWDUMP .
Technical note: The starting memory addre ss where both
CODUMP and BWDUMP obtain picture data is stored in
memory locations 186 and 187 as a two-byte address .
9

RADIO SHACK, A DIVISION OF TANDY CORPORATION
U.S.A.:.FORT WORTH, TEXAS 76102
CANADA: BARRIE, ONTARIO L4M 4W5
TANDY CORPORATION
AUSTRALIA BELGIUM U K.
91 KURRAJONG ROAD PARC INDUSTRIEL DE NANINNE
BI LS TO NROADW ED N ES OU RY
W ES T M IDL AN DSWSIO7JN
MOUNT DRUITT , N.S.W. 2770 5140NANINNE
7/84 MP Printed in U.S.A.