• Skypix Graphics

    From Spitfire@80:774/69 to All on Tue Mar 10 11:31:31 2020

    ####
    ## ##
    ### =============================================================
    #### K Y P I X C O M M A N D S 01 Sep 1994
    ### ===============================================================
    ## ##
    ####

    SkyPix is defined as a sub-set of the ANSI standard, and in fact most ANSI commands have the same effect in SkyPix mode. There are however several SkyPix-specific commands (each followed with a characteristic "!" [bang] terminator) which can only be used from a terminal equipped to emulate the SkyPix protocol (all 2 of 'em ;)

    NOTES:
    ------
    All SkyPix graphics are implemented on a default screen of 640x200
    (8 colours) with the default palette described below (unless the palette
    or number of number of bitplanes is changed.)

    All sequences should be entered WITHOUT SPACES - the spaces are included
    for readability only.

    Commands:
    1 - SET PIXEL 9 - PLAY SAMPLE 16 - XMODEM TRANSFER
    2 - DRAW LINE 10 - SET FONT 17 - SET DISPLAY MODE
    3 - AREA FILL 11 - NEW PALETTE 18 - SET PEN B COLOUR
    4 - RECTANGLE FILL 12 - RESET PALETTE 19 - POSITION CURSOR
    5 - ELLIPSE 13 - FILLED ELLIPSE 20 - (NOT IMPLEMENTED)
    6 - GRAB BRUSH 14 - DELAY (PAUSE) 21 - CONTROLLER RETURN
    7 - USE BRUSH (BLIT) 15 - SET PEN A COLOUR 22 - DEFINE GADGET
    8 - MOVE PEN

    Next Section Table of Contents

    Cammand#1

    1 - SET PIXEL ESC [ 1 ; x ; y !

    (Sets the pixel at the specified X and Y coordinates to whatever colour
    is in Pen A)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #2

    2 - DRAW LINE ESC [ 2 ; x ; y !

    (Draws a line in the current A pen colour from the existing pen
    position to the point X,Y)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #3

    3 - AREA FILL ESC [ 3 ; m ; x ; y !

    (Floods, in mode m, the area beginning at X,Y)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #4

    4 - RECTANGLE FILL ESC [ 4 ; x1 ; y1 ; x2 ; y2 !

    (Draws a filled rectangle in the current colour. Numeric parameters
    are the top left X and Y coordinates followed by the lower right X and
    Y coordinates)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #5

    5 - ELLIPSE ESC [ 5 ; x ; y ; a ; b !

    (Draws Ellipse with center at X,Y; major [horizontal] axis A pixels,
    and minor [vertical] axis B pixels)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #6

    6 - GRAB BRUSH ESC [ 6 ; x1 ; y1 ; a ; b !

    (Stores a piece of the screen as a brush in memory. From there it will
    behave exactly like a brush that has been received remotely. X1 and Y1
    define the starting point, A the width and B the height)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #7

    7 - USE BRUSH (BLIT) ESC [ 7 ; a ; b ; c ; d ; e ; f ; g ; h !

    A = upper-left X coord. of the source bitmap
    B = upper-left Y coord. of the source bitmap

    The above two will usually be 0. HOWEVER, you can use these to blit
    parts of a brush to the screen.

    C = upper-left X coord. of the destination (the screen X coord.)
    D = upper-left Y coord. of the destination (the screen Y coord.)
    E = horizontal (X) size of brush
    F = vertical (Y) size of brush
    G = MINTERM to be supplied to the blitter (commonly 192)
    H = MASK to be supplied to the blitter (commonly 255)

    The above commands blit what is in the brush buffer (following a
    CRC Transfer or a GRAB BRUSH command) - if no brush is found, the
    command aborts.

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #8

    8 - MOVE PEN ESC [ 8 ; x ; y !

    (Move the drawing pen to X,Y - NOT the cursor)

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #9

    9 - PLAY SAMPLE ESC [ 9 ; a ; b ; c ; d !

    (Plays a simple sample. A is the "speed" of the sample, B is the
    starting point in bytes, C is the ending point in bytes, and D is the
    number of loops to perform)

    NOTE: Parameters A-C are not yet implemented.

    SPINY'S NOTE: As of C-Net version 2.63, SkySound is not yet
    implemented. Hopefully it will be added by the developers in the
    future.

    Next Command 'SkyPix Commands' Menu Table of Contents

    0

    10- SET FONT ESC [ 10 ; y ! fontname.font !

    (Y is the size of the font, and fontname is the name of the font - the
    font must be in the fonts: directory of both the BBS and the Remote
    user for this command to work!)

    SPINY'S NOTE: It's wise to stick to just the basic 7 Workbench fonts,
    since you know everyone will have them available on their system disk.

    Next Command 'SkyPix Commands' Menu Table of Contents

    1

    11- NEW PALETTE ESC [ 11 ; c1 ; c2 ; c3 ; ... ; c15 ; c16 !

    Sets the palette to the sixteen colours C1-C16 [you must enter all 16
    colours even if you are just in 8-colour mode!] The parameters C1-C16
    are decimal numbers arrived at in the following way:

    Take a grey, for instance, whose R-G-B value is 12-12-12. Then convert
    that to C-C-C (since 12 is hex $0C). Now take the hex number CCC and
    convert back into Decimal, which gives you 3276.

    NOTE: Unless you are a massochist, I'd suggest using SKYPAINT since it
    does all of the above automatically. Even if you just need to set the
    palette, load up SKYPAINT and begin recording, go to the palette screen
    and set it to what you want, then end recording. You can then look at
    the tiny file you created and tell what ESC [ 11 command is needed in
    your final project.

    Next Command 'SkyPix Commands' Menu Table of Contents

    2

    12- RESET PALETTE ESC [ 12 !

    Resets to the SkyPix standard palette, which is

    R G B | R G B | R G B | R G B
    ----------------+------------------+------------------+----------------
    0 = 00 00 00 | 4 = 00 15 01 | 8 = 00 11 06 | 12 = 00 00 15
    1 = 01 01 15 | 5 = 03 10 15 | 9 = 00 13 13 | 13 = 07 00 15
    2 = 13 13 13 | 6 = 15 15 02 | 10 = 00 10 15 | 14 = 12 00 14
    3 = 15 00 00 | 7 = 12 00 14 | 11 = 00 07 12 | 15 = 12 00 08

    This would have the same effect as entering:
    ESC [ 11 ; 0 ; 287 ; 3549 ; 3840 ; 241 ; 943 ; 4082 ; 3086 ; 182 ;
    221 ; 175 ; 124 ; 15 ; 1807 ; 3086 ; 3080 !

    [See also Command #15 for info on the default palette]

    Next Command 'SkyPix Commands' Menu Table of Contents

    3

    13- FILLED ELLIPSE ESC [ 13 ; x ; y ; a ; b !

    (Same as standard Ellipse [Command #5], except this one is filled-in)

    Next Command 'SkyPix Commands' Menu Table of Contents

    4

    14- DELAY (PAUSE) ESC [ 14 ; a !

    (A is a value in jiffies [60ths of a second])

    Next Command 'SkyPix Commands' Menu Table of Contents

    5

    15- SET COLOUR OF PEN A ESC [ 15 ; a !

    Sets Pen A to colour a, where a is one of the following (assumes
    default palette)

    0 = black 4 = bright green 8 = dark green 12 = dark blue 2
    1 = dark blue 1 5 = med. blue 1 9 = cyan 13 = indigo
    2 = white 6 = yellow 10 = med. blue 2 14 = violet 2
    3 = bright red 7 = violet 1 11 = grey-blue 15 = magenta

    Next Command 'SkyPix Commands' Menu Table of Contents

    6

    16- CRC XMODEM TRANSFER ESC [ 16 ; m ; a ; b ! filename !

    Files will be sent to whichever directory BRU: is assigned.

    M (MODE) 1 = IFF Brush
    2 = IFF Sound Sample
    3 = FutureSound Sample
    20 = General Purpose (saves to default dir.)

    A & B are the X and Y size of the IFF brush, if that is what is being
    transmitted.

    Next Command 'SkyPix Commands' Menu Table of Contents

    7

    17- SELECT DISPLAY MODE ESC [ 17 ; m !

    M is 1 for a 3-bitplane display (first 8 colours) or 2 for a 4-bitplane
    display (all 16 colours allowed). Note that if M is 1, then the second
    8 colours (see Command #15) are disabled.

    Next Command 'SkyPix Commands' Menu Table of Contents

    8

    18- SET B PEN ESC [ 18 ; b !

    (Sets background pen to colour B [see Command #15] - this is useful
    for allowing ANSI commands to access more colours)

    Next Command 'SkyPix Commands' Menu Table of Contents

    9

    19- POSITION CURSOR ESC [ 19 ; x ; y !

    (Moves text cursor to X,Y. Does NOT affect the position of the
    drawing pen)

    NOTE: This is not the same as ESC [ [n] ; [m] H. In this case x and y
    refer to pixels on the screen and not to rows and columns of text.

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #21

    21- CONTROLLER RETURN ESC [ 21 ; c ; x ; y !

    (This is SENT from the terminal every time a controller is activated -
    c=1 for left button mouse click at coord. x,y ;
    c=2 for menu selection [x is the menu item #, y is ignored])

    SPINY'S NOTE: Due to a bug in JR-COMM 1.02 (which was fixed in 1.02a),
    the ESC code is not sent with this command. This should be taken into
    consideration when adding mouse control to your own applications.

    Next Command 'SkyPix Commands' Menu Table of Contents

    Command #22

    22- DEFINE A SKYPIX GADGET ESC [ 22 ; n ; c ; x1 ; y1 ; x2 ; y2 !

    (N is the gadget # (1-20), C is the command # associated with it; X1,Y1
    defines the top left corner and X2,Y2 the lower right. The gadget
    appears in the colour of Pen A [see Command #15])

    ####
    ## ##
    ### =============================================================
    #### P E C I A L N O T E S 03/10/2020
    ### ===============================================================
    ## ##
    ####

    Today there is only one Terminal Program that supports Skypix
    Graphics. [JR-Comm v1.02a] A good programmer can add this to a moden term.

    There are two known Bulletin Board Systems that currently use Skypix
    Graphics. There will be and can be many more if this Hyper Style ANSI is
    added to todays Terminal Programs. These boards are...

    -X-caliper BBS bbs.aholix.net::6800
    Reign of Fire BBS rofbbs.cnetbbs.net:2300

    --------------------------------------------------------------------------

    -Spitfire Inc presents 2 Unique Systems...

    Reign of Fire II BBS
    C-Net DS-2 BETA System - rof.cnet64.com:6400
    Reign of Fire BBS
    C-Net Amiga Pro BETA System - rofbbs.cnetbbs.net:2300 - 931-494-9100
    * C-Net/5

    * Origin: Reign of Fire C-Net Amiga Pro BETA System (80:774/69)