                          Hires Instructions
                        Copyright 1987 : Mel Patrick

Welcome to the wonderful world of hires (thats HI RES, not like hires root
beer). I have been toying around with a MicroLabs hi res board and
found a file called MACDSP/CMD which allowed a MacPaint picture to be displayed
on a TRS-80 Model 4 with a hi-res board. While MACDSP worked it left a lot
to be desired so I decided to write some routines of my own. The result is
this program call HIRES/CMD. The features although basic in their nature
should make working with a hi-res board more enjoyable.

This short manual will explain most of the important features as they appear.

ERASE - will simple erase any image currently stored in the hi-res boards
       memory. Its absolute so be careful.

INV - will invert the currently stored image. What happens here is that all of
     the pixels (not to be confused with fairies), will compliment their
     current state. i.e. those which are on will turn off and vice versa. You
     can use this command as many times as you like without harming the image.

PRINT - will send the current hi-res screen image to an EPSON or ROLAND printer
        (printing the normal sideways down the page). I do not have a Radio
        Shack printer so I can not program the print option to work on those
        brands. If you have a compatible printer it should work as well.
      - you do get an option as to the size of the printout you receive. One
        is expanded the other is normal. What does that mean? Well simply the
        normal one will give you a printout which is 1 to 1 with the video
        display. This picture will be approx 8x4 when completed. Although it
        doesn't match your screen it is more accurate for truly hi res work.
        The second one is expanded actually doubles up on the dots that are
        printed. i.e. if you had 1 dot showing on the screen it would print out
        as 2 dots (side by side). Why? Well because this gives you the effect
        of having the proportion printout to screen size. However, you will
        notice that any angle lines you have drawn get pretty raunchy looking.
        Which ever one you choose is up to you and your application. Try them
        both and see which one you like.

VIEW - will allow you to view the current image on the hi-res screen.

DSPLY - if you have successfully loaded a MACPAINT image, this will allow you
        to re-display it on the video. Note that a MacPaint image is 576 pixels
        by 720 pixels (720 long). You screen can only show 640 x 240, so you
        have to have 3 separate screens to view one complete MacPaint image.
        Use the SPACE BAR to advance to the next screen or press <BREAK> to
        exit.
      - before actually viewing it, you have the option of seeing it in normal
        or inverse mode. Which I call POSITIVE or NEGATIVE. Use which ever one
        you prefer. Remember the Mac's screen is normally all ON, and you get
        characters by turning OFF pixels. The TRS screen is the opposite.

READ - this command will read in a MACPAINT file from disk and then enter the
       DSPLY routine automatically (if desired). It loads incredibly fast and
       doesn't require you to have more than 64K (unlike MACDSP which required
       you have 128K). If the file is non-MacPaint, strange things are gonna
       happen to the display.

SAVE - you may not be aware of it, but MacPaint images are compressed using a
       simple formula. I decided to duplicate this formula for the Model 4 and
       allow a save and load as an ENCODED file. What this means is that
       normally a /HR (hi-res Model 4 file) will use 19.5K cause they save it
       bit by bit, but if you save it using my program, it can take as little
       as 3K for the same file. Try it, it will always generate a smaller file
       which translates to more disk space. I suggest you use an extension for
       pictures you save using this command such as /HRC (Hi-Res-Compressed).
       Or something equally incomprehensible to any other individual.

GET - this command was included so that you can read in one of those whopping
      19.5K /HR files and then save it using my encoded process to save a lot
      of disk space.

LOAD - this will load a COMPRESSED file only. If you try to load a normal file
       or something equally absurd, its going to go to lunch without you. As it
       reads in an ENCODED file, it DECODES and displays the information.

BREAK - gets you back to TRSDOS or LS-DOS ready.

CATALOG - just stuck in so you can see what went where and how.

Some tips. I suggest you download MacPaint files using CRC Xmodem. I haven't
tried Xmodem CHECKSUM on a MacPaint file so I don't know what format it comes
in for that way. However I have received many with Xmodem CRC and they work
just fine with my HIRES program.

I have tested this program with a MicroLabs Hires board. I don't know anyone
with a Radio Shack board so I can not attest to it working with that board.
If someone owns one of these and can try this program and it works, add a by
line to this text file. If it doesn't work, and you know why, writing me with
some suggestions would be appreciated since I can add some code to wake up
the RS board.

Want to use this program with other programs? Easy, use Radio Shack's program
called Double Duty which allows two programs to run at the same time. It works
because we have gotten DRAW on one partition and HIRES on the other. Or maybe
Rembrant (from 80 micro). Course you have to have Double Duty AND 128K, but
they do work together.

Now for the most interesting part of all. I don't own a hi-res board. Notice
nowhere in this file do I say I own one. I have considered owning one but I
have a Mac and it does quite nicely. However a good friend owns one and thats
how we tested this program, rather he tested it and reported problems which I
sorted out. Interesting to write a program without access to SEE whats going
on.

If you have a friend with a Mac and want some of his images, get him to keep
the images at the top left corner of his MacPaint file. If he has rulers tell
him not to draw lower than about 3.5 inches but he can use the full width of
his screen (and then some). Of course some pictures are going to take the whole
display so you don't get much of a choice on those. I use Red Ryder on the Mac
to talk to my Model 4 (Red is a Mac Terminal program, I use FastTerm on the
Model 4). And CRC Xmodem for transfering pictures to the 4. Works well with a
null modem cable. Compuserve also has a million images in their MACUS section.

This program is not SHAREWARE (such as FastTerm or OverVue), its PUBLIC DOMAIN.
However if you feel that its is useful and worth something, no contribution
would be turned down and would be greatly appreciated for the work I did on it.
If you would like to write with questions or suggestions please feel free to
do so.

Write to : Mel Patrick:13699 70A Ave.:Surrey,B.C.:Canada:V3W 2J8

Alternatively if you have a modem, I am also the author of Fast80 and the
soon to be released FastPlus (both BBS systems), and I maintain a BBS at
(604) 594-7398 - 8N1 - 300/1200 and it runs when I am not programming with the
Model 4.

Enjoy!
                                                                                                                              