

 <^><^><^><^><^><^><^><^><^><^><^><^><^<^><^><^><^><^><^><^><^><^><^><^><^>

                       \[>=< Beagle Graphics Docs >=<]\\\
                      \\[>=< By: The Masochist of >=<]\\
                     \\\[>=< Hi-Res</\>Hi-Jackers >=<]\

             Many thanx to:  The Unknown Hacker and The Ware-Wolf
 <^><^><^><^><^><^><^><^><^><^><^><^><^<^><^><^><^><^><^><^><^><^><^><^><^>

                           /^\ System Requirements : /^\

 An Apple //e (motherboard version "B") with at least 128K, or an Apple //c.

 <^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^>

Overview:

Beagle  graphics  is  a Graphics utility that lets you use the special
feacture  built  into  the  Apple  //e  &  //c  computers  to  display
Double-Hi-Res,  with  this  gem  of a program you can achieve graphics
that are double of that of the regular Apple //+ or an Apple //e  with
only  64K  or  a version "A" motherboard.  With this prog. you can get
560 X 191 instead of 279 X 191.  This is "Double" the  resolution  the
Apple's usually have plus 16 colors instead of 8. 

 <^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^>

Different Programs on the Beagle-Graphics disk: 

   -> Double Hi-Res Utilities:

        Slide.Show - Double Hi-res picture-display program.
       Font.Editor - Double Hi-res character editor.
       HGR.to.DHGR - Converts Hi-res Pictures to double-Hi-res.
  Convert.Hi-res.1 - Converts pictures to 1/2-size double Hi-Res.
  Convert.Hi-res.2 - Converts pictures to Full-Screen double hi-Res.
     Change.Colors - Changes any double Hi-res color to any other.
    Double.Scrunch - Compacts Pictures to save disk space.
     Cut.and.Paste - Lets you load, save & move picture sections.
            Page.2 - Lets you move and swap pictures between pages 1 and 2.

   -> Double Lo-Res Utilities:

         GR.to.DGR - Converts Lo-Res Programs to Double Lo-Res.
  Convert.Lo-Res.1 - Converts pictures to 1/2-Size double Lo-Res.
  Convert.Lo-Res.2 - Converts pictures to Full-Screen Double Hi-Res.
  Lo-Res.Load.Save - Lets you load and save double Lo-Res pictures or
                     80-Colomn text screens.

   -> Plus:

Many   different   pictures:   Beagle.pac,  Bbros.pac,  ect....   Many
different Character sets: Ascii.Font, Blippo.Font, ect.... 

 <^><^><^><^><^><^><^><^><^><^><^><^><^<^><^><^><^><^><^><^><^><^><^><^>

To use the features of Beagle-Graphics, you must  use  special  BBros.
commands.  Here is a list and a brief explanation of each of them: 

(All  commands  us  the "&" vector-meaning they all are preceded by an
"&".)

                 Here is a list of the Double Hi-Res commands: 

                               ________________

                                    & BCOLOR

Syntax:
& BCOLOR

Examples:
& BCOLOR=15
& BCOLOR=2

Purpose:
Sets the background color for clearing the screen (See &CLEAR) and
for Double Hi-Res text (See & PRINT).

Remarks:
Color value must be between 1-15 to specify a Doub Hi-Res color:

        0-Black     1-Magenta (Red)  2-Dark Blue   3-Violet      4-Dark Green
        5-Grey 1    6-Medium Blue    7-Light Blue  8-Brown       9-Orange
       10-Grey 2   11-Pink          12-Green      13-Yellow     14-Aqua
                                    15-White

                                ________________

                                     & BOX

Syntax:
& BOX (x length[,y length]) [AT x,y]

Purpose:
Draws a square.

Examples:
& BOX (50,25) at 80,80
& BOX (50) at 70,80
& BOX (100)

                                ________________

                                    & CIRCLE

Syntax:
& CIRCLE (x radius [,y radius]) [AT x,y]

Examples:
& CIRCLE (20,10) AT 100,100
& CIRCLE (40) at 70,96
& CIRCLE (100)

                                ________________

                                    & CLEAR

Syntax:
& CLEAR

Examples:
& BCOLOR =13: & CLEAR
& BCOLOR =0 : & CLEAR

Purpose:
Clears the entire double hi-res screen to the color specified by the
last & BCOLOR command.

                                ________________

                                     & DRAW

Syntax:
& DRAW shape number [AT x,y]

Examples:
& DRAW 4 at 50,100
& DRAW 3

Purpose:
Same as Applesoft DRAW command

                                ________________

                                    & FILL

Syntax:
& FILL (1st color [,2nd color]) [AT x,y]

Examples:
& FILL (2,3) at 20,34
& FILL (2)

Purpose:
Fills an outlined area with the specified color or pattern.

                                ________________

                                    & GOTO

Syntax:
& GOTO x,y

Examples:
& GOTO 50,75
& GOTO 99,123

Purpose:
Positions the invisible double hi-res cursor at the specified (x,y)
locations.  & GOTO is used for positioning text, boxes, circles,
shapes, fills, lines, and so on.

                                ________________

                                    & HCOLOR

Syntax:
& HCOLOR=color value

Examples:
& HCOLOR 9 (between 0 and 15)

Purpose:
Same as Applesoft HCOLOR command.

                                ________________

                                     & HGR

Syntax:
& HGR

Purpose:
Same as Applesoft HGR command, cept' for double Hi-Res.

                                ________________

                                     & HGR2

Syntax:
& HGR2

Purpose:
same as Applesoft HGR2 command, cept' for double Hi-Res.

                                ________________

                                    & HPLOT

Syntax:
x1,y1 [TO x2,y2...[TO xn,yn]]

Examples:
& HPLOT 75,20
& HPLOT 48,115 TO 79,84 TO 110,116
& HPLOT TO 125,10

Purpose:
Same as Applesoft HPLOT command, cept' for double Hi-Res.

                                ________________

                                     & HSCRN

Syntax
& HSCRN (x,y,variable)

Examples:
& HSCRN (50,70,A) : PRINT A
& HSCRN (100,0,B) : PRINT B

Purpose:
Returns the color value of the pixel at the specified (x,y) location.

                                ________________

                                     & LOAD

Syntax:
& LOAD main memory file, aux mem file

Examples:
& LOAD "PATTERNS","PATTERNS.AUX"
& LOAD " PIC,D2","MYPIC.AUX,D2"

Purpose:
loads a double Hi-Res Picture.

                                ________________

                                     & MODE

Syntax:
& MODE (mode number)

Examples:
& MODE (4)
           & MODE (1)

Purpose:
Selects a double Hi-Res Graphics Mode.

Remarks:
Mode number must be a numeric expression (1-4):

       1: 560 Mode
       2: 140 Mode
       3: 560 Mixed Mode
       4: 140 Mixed Mode

    & MODE can be used instead of & HGR or & HGR2 to display the double Hi-Res
    Screen without Clearing the screen to black.

                                ________________

                                     & NORM

Syntax:
& NORM

Purpose:
Turns off Hi-Res Text, Canceling the effect of & PRINT and & XPRINT.

                                ________________

                                    & PRINT

Syntax:
& PRINT

Example:
& PRINT (Sample prog. later)

Purpose:
Allows text output on the double Hi-Res screen using subsequent
PRINT statements.

Remarks:
Once & PRINT is executed, it will cause PRINT statements to print on
the double Hi-Res screen.

Important:
You must use & NORMAL before printing on the text screen and/or
before using a DOS command.
Not all Control characters can be printed, but the important ones
can.

Text Size:
In 560 Mode [& MODE (1) or & MODE (3)], you can display narrow
characters (80 columns x 24 lines). In 140 Mode [& MODE(2) or
& MODE (4)], you can display wide characters (20 columns x 24 lines)

Htab/Vtab:
HTAB and VTAB won't work. Use the & GOTO command.

Color:
The double Hi-Res text color (Foreground color) is changed with
& HCOLOR.  The Background color is changed by & BCOLOR.

Fonts:
Before using & PRINT you must load a Hi-Res Font ("character set")
into memroy.

Sample Program using:  & PRINT

20  F=16384: PRINT CHR$ (4);"BLOAD ASCII.FONT,A";F
30  L=PEEK (974) + PEEK (975) * 256 : REM DHGR LOCATION
40  POKE L + 3,0: POKE L + 4,64
100  & HGR2: & PRINT : &HCOLOR =15: & B COLOR=0
110  & MODE (1): & GOTO 0,0: PRINT "SMALL TYPE"
120  & MODE (2): PRINT "BIG TYPE"
125  PRINT : & HCOLOR= 1: PRINT "Color type in":PRINT
127  & HCOLOR= 2: PRINT "DIFFERENT STYLES!"
130  PRINT CHR$(4);"BLOAD COLOSAL.FONT"
140  & HCOLOR= 12: ?"DIFFERENT STYLES!": PRINT : PRINT : PRINT "PLUS..."
150  & GOTO 0,10: H = INT(RND(1)*16) : B=INT (RND(1)*16): IF B <> H THEN
       & HCOLOR= H: & B COLOR= B: PRINT SPC ( 15): PRINT : PRINT " MIXED
       COLORS! ": PRINT SPC ( 15)
155  IF PEEK (-16384) < 128 OR B = H THEN 150
160  HOME: & TEXT: & NORMAL : LIST

                                ________________

                                     & ROT

Syntax:
& ROT = rotation value

Examples:
& ROT =16

Purpose:
Sets the rotation for Double Hi-Res shapes to be drawn with
& DRAW or & XDRAW.

                                ________________

                                     & SAVE

Syntax:
& SAVE main mem file, aux mem file.

Examples:
& SAVE "PIC","PIC.AUX"
& SAVE A$,B$
& SAVE FILE.1,S6,D2","FILE.2,S7,D2"

Purpose:
Saves a double Hi-Res pictures to disk.

Remarks:
Double Hi-Res pictures are saved as two separate files, one from main
memory, and another from auxlilary memory.

                                ________________

                                     & XBOX

Syntax:
& XBOX (x length [,y length]) [AT x,y]

Examples & XBOX (50,25) at 80,80
         & XBOX (50) at 70,80
         & XBOX (100)

Purpose:
Draws a square or rectangle on the double Hi-Res screen.  This command
works just like the & BOX command, except that each point of the box
is plotted using the complement (opposite) of the color already
displayed at that point.

                                ________________

                                    & XCIRCLE

Syntax:
& CIRCLE (x radius [,y radius]) [AT x,y]

Examples:
& XCIRCLE (20,10) AT 100,100
& XCIRCLE (30) AT 70,96
& XCIRCLE (100)

Purpose:
Draws a circle or ellipse on the double Hi-Res screen.  This command
works just like & CIRCLE, except that each point of the circle is
plotted using the complement (oposite) of the color already displayed
at that point.

                                ________________

                                    & XDRAW

Syntax: & XDRAW shape number [AT x,y]

Examples:
& XDRAW 4 AT 50,100
& XDRAW 42

Purpose:
Same as Applesoft's XDRAW command, cept' for Double Hi-Res.

                                ________________

                                    & XLPOT

Syntax:
& XPLOT x1,y1 [TO x2,y2...[TO xn,yn]]
& XPLOT TO x2,y2...[TO xn,yn]

Examples:
& XPLOT 75,20
& XPLOT 48,115 TO 79,84 TO 110,115
& XPLOT TO 125,10

Purpose:
Plots a point or draws a line on the Double Hi-Res screen.  This
command works just like the & HPLOT command, except that each point
or line is plotted using the complement of the color currently
at that point or line.

                                ________________

                                    & XPRINT

Syntax:
& XPRINT

Examples:
& XPRINT

Purpose:
Allows text output anywhere on the Double Hi-Res screen.  This command
works just liek & PRINT, except that the color of each charater will1
be the complement of the existing color.

 <^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^><^>

               Here is a list of the Double Low-Res commands:

                                ________________

                                     & COLOR

Syntax:
& COLOR = color value

Examples:
& COLOR =11
& COLOR =15

Purpose:
Sets the display color for plotting double Lo-Res graphics.
The colors for Double Low-Res are the same as in Double Hi-Res.

                                ________________

                                      & GR

Syntax:
& GR

Example:
& GR

Purpose:
Exactlly the same as Applesoft's GR command, cept for Double Lo-Res.

                                ________________

                                     & GR2

Syntax:
& GR2

Example:
& GR2

Purpose:
Converts the screen display to fullscreen Double Lo-Res graphics
(80 x 48 pixels) with no text window at the bottom of the screen.

                               ________________

                                     & HLIN

Syntax:
& HLIN x1,y1 AT y

Examples:
& HLIN 0,79 at 0
& HLIN 20,25 at 25

Purpose:
Draws a horizontal double Lo-Res line.

                                ________________

                                     & PLOT

Syntax:
& PLOT x,y

Examples:
& PLOT 0,0
& PLOT 79,47

Purpose:
Same as Applesoft's PLOT command, cept' for Double Lo-Res.

                                ________________

                                     & SCRN

Syntax:
& SCRN (x,y variable)

Eamples:
& SCRN (5,10,A)
& SCRN (79,0, HUE)

Purpose:
Returns the color value of the block at the disignated position on the
Double Lo-Res screen.

                                ________________

                                     & TEXT

Syntax:
& TEXT

Example:
& TEXT

Purpose:
Returns to text display.

                                ________________

                                     & VLIN

Syntax:
& VLIN y1,y2 at x

Examples:
& VLIN 5,15 at 45
& VLIN 0,39 at 79

Purpose:
Draws a vertical line on the Double Lo-Res screen.

 <^><^>><^><^><^><^><^><^><^><^><^><^^><^><^><^><^><^><^><^><^><^><^><^>

That is all of the 33 new commands that Beagle Graphics gives  you  to
take advantage of the hi-quality graphical graphics on the Apple //e-c
computers. 

By  the  way,  if  you  want  to print-out any of those Double Hi-Res,
Double Lo-Res, or 80 collumn text screens, wait for  our  Tripple-Dump
also  from  Beagle Bros.  We should have it released before the end of
the month! 


 