Home » Archimedes archive » Acorn User » AU 1998-05 A.adf » Freeware » multi/!Multishow/Docs/Gif2RPC

multi/!Multishow/Docs/Gif2RPC

This website contains an archive of files for the Acorn Electron, BBC Micro, Acorn Archimedes, Commodore 16 and Commodore 64 computers, which Dominic Ford has rescued from his private collection of floppy disks and cassettes.

Some of these files were originally commercial releases in the 1980s and 1990s, but they are now widely available online. I assume that copyright over them is no longer being asserted. If you own the copyright and would like files to be removed, please contact me.

Tape/disk: Home » Archimedes archive » Acorn User » AU 1998-05 A.adf » Freeware
Filename: multi/!Multishow/Docs/Gif2RPC
Read OK:
File size: 58A2 bytes
Load address: 0000
Exec address: 0000
File contents






                       db    od8o.o8bo
                       88[  ]8[]P8` 88[                         
                       YP   88[ Y8  ]88                         
                            88[  P` ]88                         
               o88bodboo8 .o88bo    d8[ .od,o8[.odbo88o   .d88o 
              ]8[ 88,""88   88[    .8P  "888"88'Y88`'88, .8P ]8[
              Y8[ 88`  88   88[    d8    88P '  ]8[  Y8b 88[  " 
              '8bo8P   88   88[   .8`    88[    ]8[  ]88 88[    
              .d""`    88   88[  .8`     88[    ]8[  88[ Y8[  .,
              ]8oooo,.o88b.o88bo.888888 o88bo   ]88bd88  '88oo8 
              '888888 """" """"` """""P '"""`   ]8['""     """  
              .  """8                           ]8[             
              8[   .8                           ]8b             
              '88o8P`                          ]8888            
             
        
        
                  A freeware GIF� -> RISC O S sprite converter
        
                     By Cy Booker <cy@cheepnis.demon.co.uk>

                           Version 1.02 21-Jan-1996




































 ================================================================ gif2rpc ==== 




     [1]        Synopsis  . . . . . . . . . . . . . . . . . . . . .  1
     [1.1]      License . . . . . . . . . . . . . . . . . . . . . .  1
     [1.2]      Trademarks  . . . . . . . . . . . . . . . . . . . .  2
     [2]        How to use  . . . . . . . . . . . . . . . . . . . .  2
     [2.1]      How to use with ArcWeb  . . . . . . . . . . . . . .  2
     [2.2]      How to use with Webster . . . . . . . . . . . . . .  3
     [2.3]      Command line parameters . . . . . . . . . . . . . .  3
     [2.4]      Default options: gif2rpc$options  . . . . . . . . .  8
     [3]        Output image format . . . . . . . . . . . . . . . .  9
     [4]        Why use gif2rpc . . . . . . . . . . . . . . . . . . 10
     [4.1]      Speed comparisons . . . . . . . . . . . . . . . . . 10
     [5]        Error codes . . . . . . . . . . . . . . . . . . . . 11
     [6]        History . . . . . . . . . . . . . . . . . . . . . . 12














































 ================================================================ gif2rpc ====



 [1] Synopsis


        gif2rpc is a program for RISC O S (>= 3.10) that converts
        GIF image files to native sprite files.
        
        A GIF file is a 2�256 colour image, with an associated
        24-bit palette and an optional �transparency� mask.

        This program was written mainly to allow the generation of
        32K colour images that look as good as they can.  This is
        because, despite what you intuitively feel, a 256 colour
        image displayed on a 32K colour screen does *not* look that
        good.

        [I mainly browse the World Wide Web in a 32K colour screen,
        and am generally disappointed with the way GIFs are
        displayed, and so wrote this program that provides a very
        good conversion of GIFs to 32K colour modes.]

        Since then it has extended to be a general image processing
        program.

        Note that gif2rpc is extremely lenient towards malformed
        GIF's (ie it won't crash if fed garbage).



 [1.1] License

        This software comes with NO WARANTEE.  It is distributed in
        the hope that it's useful.  The author will not be liable
        for any incurred damages, directly or indirectly due to the
        use or inability to use this software.

        It is FreeWare, and remains the copyright of the author.
        Portions of this code are copyright Stephen A. Bennet:

        * DECODE.C - An LZW decoder for GIF
        * Copyright (C) 1987, by Steven A. Bennett
        *
        * Permission is given by the author to freely redistribute
        * and include this code in any program as long as this
        * credit is given where due.

        The code to match a colour to the default wimp palette is
        based on a UseNet article:

                Message-ID: <12463@acorn.co.uk>
                Date:       30 Jan 92 12:20:23 GMT
                From:       RWilson@acorn.co.uk
                Subject:    How to find the closest colour out of
                            the RISC OS 256





                                  Page   1

 ================================================================ gif2rpc ====



 [1.2] Trademarks

        GIF is a trademark of Compuserve Inc.



 [2] How to use


        gif2rpc is a command line utility.  It takes quite a few
        parameters, but basic usage is:

           gif2rpc <in> <out>

        If you would like a logfile of any errors that are
        encountered then append � >>& logfile� to the command
        line, or use the -log parameter.

        Note that if you have he DDEutils module then gif2rpc will
        take advantage of the new facility for long command lines.



 [2.1] How to use with ArcWeb


        This applies to ArcWeb 1.14.  First open the Browser
        configuration window, and enable the �GIF87 handled by
        gif2spr� option.  Select OK.  Don't forget to choose the
        menu item �Configure->Save options�!

        Next make a back up copy of the file �!ArcWeb.gif2spr�.

        Finally copy these files:

                gif2rpc         -> !ArcWeb.gif2rpc
                WWW.gif2spr     -> !ArcWeb.gif2spr
                WWW.gif2rpcFE   -> !ArcWeb.gif2rpcFE

        And that is that.

        You may wish to modify the (new) �!ArcWeb.gif2spr� file to
        change the initialisation of the system variable
        �gif2rpc$options�.














                                  Page   2

 ================================================================ gif2rpc ====


        
 [2.2] How to use with Webster


        This applies to Webster v0.11.  First open the Choices
        dialogue box, and select the �Inlne Viewers� tab.  Ensure
        that the �GIF Decoder� value is left at the default of
        �<Webster$Dir>.gif2spr -q %0 %1�.  Click the Save button.

        Next make a back up copy of the file �!Webster.gif2spr�.

        Finally copy the *contents* of the WWW directory into the
        !Webster directory, i.e. creating the three files:

                gif2rpc         -> !Webster.gif2rpc
                WWW.gif2spr     -> !Webster.gif2spr
                WWW.gif2rpcFE   -> !Webster.gif2rpcFE

        And that is that.

        You may wish to modify the (new) �!Webster.gif2spr� file to
        change the initialisation of the system variable
        �gif2rpc$options�.



 [2.3] Command line parameters


        Here are all the parameters:

           [-gif] <file-name>
                this is the name of the GIF file.  It does not
                need to be type�d as a TIFF file, as this program
                will verify that the file is in GIF format


           [-sprite] <file-name>
                this will be the file that is produced, containing
                the single sprite representing the original GIF
                image
           [-help]
                produce some terse help on these parameters
        

           [-verbose <n>]
                by default <n> is 0, which disables all text
                output while the GIF file is being read and
                processed.  By setting <n> to 1, then some basic
                information is displayed.  This can be redirected
                to a file by appending �> file� to the command
                line.  By setting <n> to 2 then rather more
                information is displayed






                                  Page   3

 ================================================================ gif2rpc ====


        
           [-quiet]
                by default, if gif2rpc detects an error in the
                input GIF, then it will first display a textual
                message saying where and what failed, then attempt
                to continue (but see -fussy).  This message can be
                redirected to a a file by appending �2> file� to
                the command line, or using -log (below).  For a
                list of the error messages, see below


           [-hourglass]
                because some GIFs are big, they take a long time
                to process (even on an ARM 700).  Therefore you
                may tell gif2rpc to use the �hourglass� to
                give some visual feedback over how far it has got
                in processing the GIF.  The percentage indicator
                is used to show how much of the image has already
                been decoded

                After decoding, while the image is processed the
                percentage counts DOWN from 100% to 0%.  This is
                an arbitrary aesthetic decision


            [-name <text>]
                by default the image saved in the -sprite
                file-name will be �gif2rpc�.  If this offends
                you then you can rename it.  Note that names of
                sprites must be lower case.  gif2rpc enforces this
                by using the current locale�s idea of lower case.
                Also note that sprite names are limited to twelve
                characters.  See also -autoname


























                                  Page   4

 ================================================================ gif2rpc ====


        
             [-bpp <n>]
                bpp stands for bits per pixel.  This parameter
                determines what sort of sprite image gif2rpc will
                try to produce.  It takes the following values


                    0   use GIF�s palette to produce 1/2/4/8 bpp
                        image.  No image processing is done

                    1   produce a monochrome black/white image

                    2   produce a four colour image, using
                        default wimp palette (a grey scale)

                    4   produce a 16 colour image, using the
                        default wimp palette

                    8   produce a 256 colour image, using the
                        default wimp palette
        
                    16  produce a 32K colour image, with a fixed
                        palette
        
                    32  produce a 16M colour image

                    -1  (this is the good one) it uses the current
                        screen display to determine whether it
                        will produce a 2, 4, 16, 256, 32K, or 16M
                        colour image
                        also, the current screen palette is used

                the default value is -1


             [-accurate]
                when generating a 256 colour image, this will force
                the use of a more accurate colour matching
                algorithm that runs about 3-4 times slower


             [-force_66]
                when generating a 32K colour image, this will force
                the use of routines that use an internal resolution
                of 22 bits per red/green/blue.  Normally only 16
                bits are used.  These 66 bit routines are slower


             [-square]
                a GIF file can specify an aspect ratio for an
                image.  If a 32K or 16M colour image is produced
                then, by default, this aspect ratio information
                is embedded in the sprite.  For <= 256 colour
                images it is not possible for RISC O S to be told
                of the aspect ratio.  Using this switch will
                disable embedding this aspect ratio information



                                  Page   5

 ================================================================ gif2rpc ====


        
             [-autoname]
                the sprite in the spritefile can be give a name
                derived from the input GIF file with this option


             [stats]
                this will output a single text line to show how
                well (in terms of size) the conversion done,
                relative to keeping the 256 colour image

                The fields are
                        "gif2rpc "
                        "%s"    input file name
                        "("
                        "%4d"   horizontal pixel size
                        "x"
                        "%4d"   vertical pixel size
                        ":"
                        "%d"    input bits per pixel
                        "p"     [if palette in screen]
                        "s"     [if palette is sorted]
                        "."
                        "i"     [if interlaced]
                        "p"     [if palette in image]
                        "s"     [if palette is sorted]
                        "t"     [if transparent]
                        ") -> "
                        "%s"    output file name
                        "("
                        "%s"    output colours
                        ") "
                        "%d"    output size - gif2rpc output size
                        " "
                        "%f"    total duration, in seconds
                        " "
                        "%f"    percentage time spent filtering
                        " "
                        "%s"    filter used


             [-log <file>]
                if present, this overrides any command line re-
                direction of stdout and stderr


             [-fussy]
                by default gif2rpc will allow several mistakes in
                a GIF file, and silently (if -quiet) ignore them.
                With -fussy, these errors will cause conversion
                to fail, and no sprite to be produced








                                  Page   6

 ================================================================ gif2rpc ====



             [-filter <name>]
                If -bpp is not 0 then gif2rpc will process the
                image to produce a sprite.  These are the
                algorithms it will use (these are listed fastest
                to slowest)

                nearest:
                        you do *not* want this.  It is crap

                dither2x2:
                        strongly recommended.  It is only slightly
                        slower than nearest, and produces good
                        images (if >= 256 colours)

                sierra2_4a:
                        very good, very fast.  Personally, I think
                        it looks better than floyd-steinberg

                floyd_steinberg:
                        as used by ChangeFSI.  An old favourite

                burkes:
                        a 2-line filter as per floyd_steinberg,
                        where the coefficients are quick to
                        calculate

                sierra2:
                        very similar to burkes, but poor quality

                sierra3:
                        a 3-line filter

                stucki:
                        another 3-line filter, but slow to
                        calculate

                jarvis_judice_ninke:
                        a 3-line filter which is very slow (22
                        times slower than dither2x2).  It is
                        questionable whether it produces better
                        output



        Note that you can *not* use shortcuts for the switches (ie
        -v is not acceptable, use -verbose).












                                  Page   7

 ================================================================ gif2rpc ====



 [2.4] Default options: gif2rpc$options

        If the system variable �gif2rpc$Options� is defined, then
        it will be appended to any parameters given on the command
        line.

        This is particularly useful when using the logging
        facilities of the program.  For example, using

                *Set gif2rpc$Options -stats -log $.log

        will cause all calls to gif2rpc to append statistics
        information to the file �$.log�.



  2.5 Typical usage


        For no-hassle usage use:

                gif2rpc -quiet gif sprite


        For some reasonable information then use something like:

                gif2rpc -stats -log $.log gif sprite

        and the log file will be appended with any errors, and a
        single line giving some statistics of the conversion


        For �problem� gif's use:

                gif2rpc -verbose 2 -fussy gif sprite























                                  Page   8

 ================================================================ gif2rpc ====
        
        
        
 [3] Output image format


        You may think that -bpp 0 is the best option, as this will
        generate a sprite that contains all the information in the
        original GIF.

        But when you come to display that GIF, the OS has quite a
        bit of work to do before it can plonk the data on the
        screen.  The miriad of options provided by gif2rpc are
        there to do a lot of this work once, and not every time
        the GIF is displayed.

        The main processing that gif2rpc does is to remove any
        explicit palette information, and alter the image so that
        a default (RISC O S) palette is used.  This usually saves
        2K per image:

                Size      none         32K image    16M image
                8x8       2168            184          312
                16x16     2360            568         1080
                32x32     3128           2104         4152
                64x64     6200           8248        16440
                1024x4    6200           8248        16440
        
        
        And with a transparency mask
        
                Size      none        32K image    16M image
                8x8       2232            216          344
                16x16     2612            632         1144
                32x32     4152           2232         4280
                64x64    10296           8760        16952
                1024x4   10296           8760        16952


        Note that the -stat file may be used to give statistics
        about the file size (and savings) encountered.




















                                  Page   9

 ================================================================ gif2rpc ====



 [4] Why use gif2rpc


        There are two other programs out there that perform near
        identical functions:
        
                !ChangeFSI
                        This program, unfortunately, does not seem
                        to cope with �transparent� GIFs.  Since
                        these are the norm, rather than the
                        exception on the WWW, it is bad news
        
                gif2spr
                        This is a nice program, but has no support
                        for generating 32K colour images
        
        You�d use gif2rpc if you usually view GIFs in 32K modes,
        or would like to convert GIFs to 16M colour sprites.

        It�s logging facility, and fuller diagnostics of errors
        may be useful to you.

        Also, its' ability to use other filter algorithms (faster
        ones like dither2x2, or slower ones) can be very useful.



 [4.1] Speed comparisons

        As a test bed, a 128 colour 640x480 GIF was used.  It was
        converted to a sprite 10 times, and a script recorded the
        total time, accurate to +/- one second.  It was ran in a
        32K screen mode (1024x768), and a 32K image was generated:

              ChangeFSI dithered      36     (S16,90,90)
              gif2rpc floyd-steinberg 30     (-quiet, -bpp 16)
              ChangeFSI simple        24     (S16,90,90, -nodither)
              gif2spr                 11     (-q)
              gif2rpc 2x2 dither      11     (-quiet, -bpp 16)

        For generating a 256 colour image in a 256 colour screen
        mode (1600x1200):

              ChangeFSI dither slow   67     (28r)
              ChangeFSI dither fast   59     (28)
              ChangeFSI simple slow   52     (28r, -nodither)
              ChangeFSI simple fast   46     (28, -nodither)
              gif2spr                 11     (-q)
              gif2rpc                  8     (-quiet, -bpp 8)









                                  Page  10

 ================================================================ gif2rpc ====



 [5] Error codes

        These are the error numbers that will be reported (unless
        you use the -quiet option) if the GIF is found to be
        corrupted:


        10:     the start of the file was not a valid GIF header

        11:     invalid lzw table size (not in range [2, 9])

        12:     short file

        13:     unexpected record

        14:     corrupt graphic extension record size

        15:     there was no image in the file

        16:     image size invalid (pixel size less than one)

        17:     corrupt graphic extension record terminator

        18:     (internal error) processing mask

        19:     (internal error) processing image

        20:     no palette defined in screen or image

        21:     last row was incomplete

        22:     extra byte(s) after image found

        23:     bad end of image marker
























                                  Page  11

 ================================================================ gif2rpc ====



 [6] History

        Version 1.02 21-Jan-1996
                Better colour matching for 256 colour sprites

        Version 1.01 14-Jan-1996
                Added -autoname feature
                Tidied up this documentation
                Wrote the gif2rpcFE kludge program


        Version 1.00 21-Sep-1995
                This was never released, but was left
                languishing on the hard disc



  7 Author

       Program and documentation by (but see copyright notice
       above):


                                 Cy Booker
                              86 Church View
                                 Main Road
                                Crockenhill
                                  Swanley
                                   Kent
                                  BR8 8JW
                                   U.K.
                
                    Internet: cy@cheepnis.demon.co.uk
                Arcade BBS (Fidonet#2:254/27.0): Cy Booker
                
              Musical entertainment provided by Frank Zappa

00000000  0a 0a 0a 0a 0a 0a 0a 20  20 20 20 20 20 20 20 20  |.......         |
00000010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 64 62  |              db|
00000020  20 20 20 20 6f 64 38 6f  2e 6f 38 62 6f 0a 20 20  |    od8o.o8bo.  |
00000030  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000040  20 20 20 20 20 38 38 5b  20 20 5d 38 5b 5d 50 38  |     88[  ]8[]P8|
00000050  60 20 38 38 5b 20 20 20  20 20 20 20 20 20 20 20  |` 88[           |
00000060  20 20 20 20 20 20 20 20  20 20 20 20 20 20 0a 20  |              . |
00000070  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000080  20 20 20 20 20 20 59 50  20 20 20 38 38 5b 20 59  |      YP   88[ Y|
00000090  38 20 20 5d 38 38 20 20  20 20 20 20 20 20 20 20  |8  ]88          |
000000a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 0a  |               .|
000000b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000000c0  20 20 20 20 20 20 20 20  20 20 20 20 38 38 5b 20  |            88[ |
000000d0  20 50 60 20 5d 38 38 20  20 20 20 20 20 20 20 20  | P` ]88         |
000000e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000000f0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00000100  6f 38 38 62 6f 64 62 6f  6f 38 20 2e 6f 38 38 62  |o88bodboo8 .o88b|
00000110  6f 20 20 20 20 64 38 5b  20 2e 6f 64 2c 6f 38 5b  |o    d8[ .od,o8[|
00000120  2e 6f 64 62 6f 38 38 6f  20 20 20 2e 64 38 38 6f  |.odbo88o   .d88o|
00000130  20 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  | .              |
00000140  5d 38 5b 20 38 38 2c 22  22 38 38 20 20 20 38 38  |]8[ 88,""88   88|
00000150  5b 20 20 20 20 2e 38 50  20 20 22 38 38 38 22 38  |[    .8P  "888"8|
00000160  38 27 59 38 38 60 27 38  38 2c 20 2e 38 50 20 5d  |8'Y88`'88, .8P ]|
00000170  38 5b 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |8[.             |
00000180  20 59 38 5b 20 38 38 60  20 20 38 38 20 20 20 38  | Y8[ 88`  88   8|
00000190  38 5b 20 20 20 20 64 38  20 20 20 20 38 38 50 20  |8[    d8    88P |
000001a0  27 20 20 5d 38 5b 20 20  59 38 62 20 38 38 5b 20  |'  ]8[  Y8b 88[ |
000001b0  20 22 20 0a 20 20 20 20  20 20 20 20 20 20 20 20  | " .            |
000001c0  20 20 27 38 62 6f 38 50  20 20 20 38 38 20 20 20  |  '8bo8P   88   |
000001d0  38 38 5b 20 20 20 2e 38  60 20 20 20 20 38 38 5b  |88[   .8`    88[|
000001e0  20 20 20 20 5d 38 5b 20  20 5d 38 38 20 38 38 5b  |    ]8[  ]88 88[|
000001f0  20 20 20 20 0a 20 20 20  20 20 20 20 20 20 20 20  |    .           |
00000200  20 20 20 2e 64 22 22 60  20 20 20 20 38 38 20 20  |   .d""`    88  |
00000210  20 38 38 5b 20 20 2e 38  60 20 20 20 20 20 38 38  | 88[  .8`     88|
00000220  5b 20 20 20 20 5d 38 5b  20 20 38 38 5b 20 59 38  |[    ]8[  88[ Y8|
00000230  5b 20 20 2e 2c 0a 20 20  20 20 20 20 20 20 20 20  |[  .,.          |
00000240  20 20 20 20 5d 38 6f 6f  6f 6f 2c 2e 6f 38 38 62  |    ]8oooo,.o88b|
00000250  2e 6f 38 38 62 6f 2e 38  38 38 38 38 38 20 6f 38  |.o88bo.888888 o8|
00000260  38 62 6f 20 20 20 5d 38  38 62 64 38 38 20 20 27  |8bo   ]88bd88  '|
00000270  38 38 6f 6f 38 20 0a 20  20 20 20 20 20 20 20 20  |88oo8 .         |
00000280  20 20 20 20 20 27 38 38  38 38 38 38 20 22 22 22  |     '888888 """|
00000290  22 20 22 22 22 22 60 20  22 22 22 22 22 50 20 27  |" """"` """""P '|
000002a0  22 22 22 60 20 20 20 5d  38 5b 27 22 22 20 20 20  |"""`   ]8['""   |
000002b0  20 20 22 22 22 20 20 0a  20 20 20 20 20 20 20 20  |  """  .        |
000002c0  20 20 20 20 20 20 2e 20  20 22 22 22 38 20 20 20  |      .  """8   |
000002d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000002e0  20 20 20 20 20 20 20 20  5d 38 5b 20 20 20 20 20  |        ]8[     |
000002f0  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00000300  20 20 20 20 20 20 20 38  5b 20 20 20 2e 38 20 20  |       8[   .8  |
00000310  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000320  20 20 20 20 20 20 20 20  20 5d 38 62 20 20 20 20  |         ]8b    |
00000330  20 20 20 20 20 20 20 20  20 0a 20 20 20 20 20 20  |         .      |
00000340  20 20 20 20 20 20 20 20  27 38 38 6f 38 50 60 20  |        '88o8P` |
00000350  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000360  20 20 20 20 20 20 20 20  20 5d 38 38 38 38 20 20  |         ]8888  |
00000370  20 20 20 20 20 20 20 20  20 20 0a 20 20 20 20 20  |          .     |
00000380  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00000390  20 0a 20 20 20 20 20 20  20 20 0a 20 20 20 20 20  | .        .     |
000003a0  20 20 20 20 20 20 20 20  20 20 20 20 20 41 20 66  |             A f|
000003b0  72 65 65 77 61 72 65 20  47 49 46 8d 20 2d 3e 20  |reeware GIF. -> |
000003c0  52 49 53 43 20 4f 20 53  20 73 70 72 69 74 65 20  |RISC O S sprite |
000003d0  63 6f 6e 76 65 72 74 65  72 0a 20 20 20 20 20 20  |converter.      |
000003e0  20 20 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |  .             |
000003f0  20 20 20 20 20 20 20 20  42 79 20 43 79 20 42 6f  |        By Cy Bo|
00000400  6f 6b 65 72 20 3c 63 79  40 63 68 65 65 70 6e 69  |oker <cy@cheepni|
00000410  73 2e 64 65 6d 6f 6e 2e  63 6f 2e 75 6b 3e 0a 0a  |s.demon.co.uk>..|
00000420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000430  20 20 20 20 20 20 20 20  20 20 20 56 65 72 73 69  |           Versi|
00000440  6f 6e 20 31 2e 30 32 20  32 31 2d 4a 61 6e 2d 31  |on 1.02 21-Jan-1|
00000450  39 39 36 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |996.............|
00000460  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
00000470  0a 0a 0a 0a 0a 0a 0a 0c  0a 20 3d 3d 3d 3d 3d 3d  |......... ======|
00000480  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000004b0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 20 67 69 66 32 72  |========== gif2r|
000004c0  70 63 20 3d 3d 3d 3d 20  0a 0a 0a 0a 0a 20 20 20  |pc ==== .....   |
000004d0  20 20 5b 31 5d 20 20 20  20 20 20 20 20 53 79 6e  |  [1]        Syn|
000004e0  6f 70 73 69 73 20 20 2e  20 2e 20 2e 20 2e 20 2e  |opsis  . . . . .|
000004f0  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
*
00000510  20 20 31 0a 20 20 20 20  20 5b 31 2e 31 5d 20 20  |  1.     [1.1]  |
00000520  20 20 20 20 4c 69 63 65  6e 73 65 20 2e 20 2e 20  |    License . . |
00000530  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
*
00000550  2e 20 2e 20 2e 20 2e 20  20 31 0a 20 20 20 20 20  |. . . .  1.     |
00000560  5b 31 2e 32 5d 20 20 20  20 20 20 54 72 61 64 65  |[1.2]      Trade|
00000570  6d 61 72 6b 73 20 20 2e  20 2e 20 2e 20 2e 20 2e  |marks  . . . . .|
00000580  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
00000590  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 20  | . . . . . . .  |
000005a0  32 0a 20 20 20 20 20 5b  32 5d 20 20 20 20 20 20  |2.     [2]      |
000005b0  20 20 48 6f 77 20 74 6f  20 75 73 65 20 20 2e 20  |  How to use  . |
000005c0  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
*
000005e0  2e 20 2e 20 2e 20 20 32  0a 20 20 20 20 20 5b 32  |. . .  2.     [2|
000005f0  2e 31 5d 20 20 20 20 20  20 48 6f 77 20 74 6f 20  |.1]      How to |
00000600  75 73 65 20 77 69 74 68  20 41 72 63 57 65 62 20  |use with ArcWeb |
00000610  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
00000620  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 20 32 0a  | . . . . . .  2.|
00000630  20 20 20 20 20 5b 32 2e  32 5d 20 20 20 20 20 20  |     [2.2]      |
00000640  48 6f 77 20 74 6f 20 75  73 65 20 77 69 74 68 20  |How to use with |
00000650  57 65 62 73 74 65 72 20  2e 20 2e 20 2e 20 2e 20  |Webster . . . . |
00000660  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
00000670  2e 20 2e 20 20 33 0a 20  20 20 20 20 5b 32 2e 33  |. .  3.     [2.3|
00000680  5d 20 20 20 20 20 20 43  6f 6d 6d 61 6e 64 20 6c  |]      Command l|
00000690  69 6e 65 20 70 61 72 61  6d 65 74 65 72 73 20 2e  |ine parameters .|
000006a0  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
000006b0  20 2e 20 2e 20 2e 20 2e  20 2e 20 20 33 0a 20 20  | . . . . .  3.  |
000006c0  20 20 20 5b 32 2e 34 5d  20 20 20 20 20 20 44 65  |   [2.4]      De|
000006d0  66 61 75 6c 74 20 6f 70  74 69 6f 6e 73 3a 20 67  |fault options: g|
000006e0  69 66 32 72 70 63 24 6f  70 74 69 6f 6e 73 20 20  |if2rpc$options  |
000006f0  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
00000700  2e 20 20 38 0a 20 20 20  20 20 5b 33 5d 20 20 20  |.  8.     [3]   |
00000710  20 20 20 20 20 4f 75 74  70 75 74 20 69 6d 61 67  |     Output imag|
00000720  65 20 66 6f 72 6d 61 74  20 2e 20 2e 20 2e 20 2e  |e format . . . .|
00000730  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
00000740  20 2e 20 2e 20 2e 20 2e  20 20 39 0a 20 20 20 20  | . . . .  9.    |
00000750  20 5b 34 5d 20 20 20 20  20 20 20 20 57 68 79 20  | [4]        Why |
00000760  75 73 65 20 67 69 66 32  72 70 63 20 2e 20 2e 20  |use gif2rpc . . |
00000770  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
*
00000790  31 30 0a 20 20 20 20 20  5b 34 2e 31 5d 20 20 20  |10.     [4.1]   |
000007a0  20 20 20 53 70 65 65 64  20 63 6f 6d 70 61 72 69  |   Speed compari|
000007b0  73 6f 6e 73 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  |sons . . . . . .|
000007c0  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
000007d0  20 2e 20 2e 20 2e 20 31  30 0a 20 20 20 20 20 5b  | . . . 10.     [|
000007e0  35 5d 20 20 20 20 20 20  20 20 45 72 72 6f 72 20  |5]        Error |
000007f0  63 6f 64 65 73 20 2e 20  2e 20 2e 20 2e 20 2e 20  |codes . . . . . |
00000800  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 2e 20  |. . . . . . . . |
00000810  2e 20 2e 20 2e 20 2e 20  2e 20 2e 20 2e 20 31 31  |. . . . . . . 11|
00000820  0a 20 20 20 20 20 5b 36  5d 20 20 20 20 20 20 20  |.     [6]       |
00000830  20 48 69 73 74 6f 72 79  20 2e 20 2e 20 2e 20 2e  | History . . . .|
00000840  20 2e 20 2e 20 2e 20 2e  20 2e 20 2e 20 2e 20 2e  | . . . . . . . .|
*
00000860  20 2e 20 2e 20 31 32 0a  0a 0a 0a 0a 0a 0a 0a 0a  | . . 12.........|
00000870  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
*
00000890  0a 0a 0a 0a 0a 0c 0a 20  3d 3d 3d 3d 3d 3d 3d 3d  |....... ========|
000008a0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000008d0  3d 3d 3d 3d 3d 3d 3d 3d  20 67 69 66 32 72 70 63  |======== gif2rpc|
000008e0  20 3d 3d 3d 3d 0a 0a 0a  0a 20 5b 31 5d 20 53 79  | ====.... [1] Sy|
000008f0  6e 6f 70 73 69 73 0a 0a  0a 20 20 20 20 20 20 20  |nopsis...       |
00000900  20 67 69 66 32 72 70 63  20 69 73 20 61 20 70 72  | gif2rpc is a pr|
00000910  6f 67 72 61 6d 20 66 6f  72 20 52 49 53 43 20 4f  |ogram for RISC O|
00000920  20 53 20 28 3e 3d 20 33  2e 31 30 29 20 74 68 61  | S (>= 3.10) tha|
00000930  74 20 63 6f 6e 76 65 72  74 73 0a 20 20 20 20 20  |t converts.     |
00000940  20 20 20 47 49 46 20 69  6d 61 67 65 20 66 69 6c  |   GIF image fil|
00000950  65 73 20 74 6f 20 6e 61  74 69 76 65 20 73 70 72  |es to native spr|
00000960  69 74 65 20 66 69 6c 65  73 2e 0a 20 20 20 20 20  |ite files..     |
00000970  20 20 20 0a 20 20 20 20  20 20 20 20 41 20 47 49  |   .        A GI|
00000980  46 20 66 69 6c 65 20 69  73 20 61 20 32 8c 32 35  |F file is a 2.25|
00000990  36 20 63 6f 6c 6f 75 72  20 69 6d 61 67 65 2c 20  |6 colour image, |
000009a0  77 69 74 68 20 61 6e 20  61 73 73 6f 63 69 61 74  |with an associat|
000009b0  65 64 0a 20 20 20 20 20  20 20 20 32 34 2d 62 69  |ed.        24-bi|
000009c0  74 20 70 61 6c 65 74 74  65 20 61 6e 64 20 61 6e  |t palette and an|
000009d0  20 6f 70 74 69 6f 6e 61  6c 20 94 74 72 61 6e 73  | optional .trans|
000009e0  70 61 72 65 6e 63 79 95  20 6d 61 73 6b 2e 0a 0a  |parency. mask...|
000009f0  20 20 20 20 20 20 20 20  54 68 69 73 20 70 72 6f  |        This pro|
00000a00  67 72 61 6d 20 77 61 73  20 77 72 69 74 74 65 6e  |gram was written|
00000a10  20 6d 61 69 6e 6c 79 20  74 6f 20 61 6c 6c 6f 77  | mainly to allow|
00000a20  20 74 68 65 20 67 65 6e  65 72 61 74 69 6f 6e 20  | the generation |
00000a30  6f 66 0a 20 20 20 20 20  20 20 20 33 32 4b 20 63  |of.        32K c|
00000a40  6f 6c 6f 75 72 20 69 6d  61 67 65 73 20 74 68 61  |olour images tha|
00000a50  74 20 6c 6f 6f 6b 20 61  73 20 67 6f 6f 64 20 61  |t look as good a|
00000a60  73 20 74 68 65 79 20 63  61 6e 2e 20 20 54 68 69  |s they can.  Thi|
00000a70  73 20 69 73 0a 20 20 20  20 20 20 20 20 62 65 63  |s is.        bec|
00000a80  61 75 73 65 2c 20 64 65  73 70 69 74 65 20 77 68  |ause, despite wh|
00000a90  61 74 20 79 6f 75 20 69  6e 74 75 69 74 69 76 65  |at you intuitive|
00000aa0  6c 79 20 66 65 65 6c 2c  20 61 20 32 35 36 20 63  |ly feel, a 256 c|
00000ab0  6f 6c 6f 75 72 0a 20 20  20 20 20 20 20 20 69 6d  |olour.        im|
00000ac0  61 67 65 20 64 69 73 70  6c 61 79 65 64 20 6f 6e  |age displayed on|
00000ad0  20 61 20 33 32 4b 20 63  6f 6c 6f 75 72 20 73 63  | a 32K colour sc|
00000ae0  72 65 65 6e 20 64 6f 65  73 20 2a 6e 6f 74 2a 20  |reen does *not* |
00000af0  6c 6f 6f 6b 20 74 68 61  74 0a 20 20 20 20 20 20  |look that.      |
00000b00  20 20 67 6f 6f 64 2e 0a  0a 20 20 20 20 20 20 20  |  good...       |
00000b10  20 5b 49 20 6d 61 69 6e  6c 79 20 62 72 6f 77 73  | [I mainly brows|
00000b20  65 20 74 68 65 20 57 6f  72 6c 64 20 57 69 64 65  |e the World Wide|
00000b30  20 57 65 62 20 69 6e 20  61 20 33 32 4b 20 63 6f  | Web in a 32K co|
00000b40  6c 6f 75 72 20 73 63 72  65 65 6e 2c 0a 20 20 20  |lour screen,.   |
00000b50  20 20 20 20 20 61 6e 64  20 61 6d 20 67 65 6e 65  |     and am gene|
00000b60  72 61 6c 6c 79 20 64 69  73 61 70 70 6f 69 6e 74  |rally disappoint|
00000b70  65 64 20 77 69 74 68 20  74 68 65 20 77 61 79 20  |ed with the way |
00000b80  47 49 46 73 20 61 72 65  0a 20 20 20 20 20 20 20  |GIFs are.       |
00000b90  20 64 69 73 70 6c 61 79  65 64 2c 20 61 6e 64 20  | displayed, and |
00000ba0  73 6f 20 77 72 6f 74 65  20 74 68 69 73 20 70 72  |so wrote this pr|
00000bb0  6f 67 72 61 6d 20 74 68  61 74 20 70 72 6f 76 69  |ogram that provi|
00000bc0  64 65 73 20 61 20 76 65  72 79 0a 20 20 20 20 20  |des a very.     |
00000bd0  20 20 20 67 6f 6f 64 20  63 6f 6e 76 65 72 73 69  |   good conversi|
00000be0  6f 6e 20 6f 66 20 47 49  46 73 20 74 6f 20 33 32  |on of GIFs to 32|
00000bf0  4b 20 63 6f 6c 6f 75 72  20 6d 6f 64 65 73 2e 5d  |K colour modes.]|
00000c00  0a 0a 20 20 20 20 20 20  20 20 53 69 6e 63 65 20  |..        Since |
00000c10  74 68 65 6e 20 69 74 20  68 61 73 20 65 78 74 65  |then it has exte|
00000c20  6e 64 65 64 20 74 6f 20  62 65 20 61 20 67 65 6e  |nded to be a gen|
00000c30  65 72 61 6c 20 69 6d 61  67 65 20 70 72 6f 63 65  |eral image proce|
00000c40  73 73 69 6e 67 0a 20 20  20 20 20 20 20 20 70 72  |ssing.        pr|
00000c50  6f 67 72 61 6d 2e 0a 0a  20 20 20 20 20 20 20 20  |ogram...        |
00000c60  4e 6f 74 65 20 74 68 61  74 20 67 69 66 32 72 70  |Note that gif2rp|
00000c70  63 20 69 73 20 65 78 74  72 65 6d 65 6c 79 20 6c  |c is extremely l|
00000c80  65 6e 69 65 6e 74 20 74  6f 77 61 72 64 73 20 6d  |enient towards m|
00000c90  61 6c 66 6f 72 6d 65 64  0a 20 20 20 20 20 20 20  |alformed.       |
00000ca0  20 47 49 46 27 73 20 28  69 65 20 69 74 20 77 6f  | GIF's (ie it wo|
00000cb0  6e 27 74 20 63 72 61 73  68 20 69 66 20 66 65 64  |n't crash if fed|
00000cc0  20 67 61 72 62 61 67 65  29 2e 0a 0a 0a 0a 20 5b  | garbage)..... [|
00000cd0  31 2e 31 5d 20 4c 69 63  65 6e 73 65 0a 0a 20 20  |1.1] License..  |
00000ce0  20 20 20 20 20 20 54 68  69 73 20 73 6f 66 74 77  |      This softw|
00000cf0  61 72 65 20 63 6f 6d 65  73 20 77 69 74 68 20 4e  |are comes with N|
00000d00  4f 20 57 41 52 41 4e 54  45 45 2e 20 20 49 74 20  |O WARANTEE.  It |
00000d10  69 73 20 64 69 73 74 72  69 62 75 74 65 64 20 69  |is distributed i|
00000d20  6e 0a 20 20 20 20 20 20  20 20 74 68 65 20 68 6f  |n.        the ho|
00000d30  70 65 20 74 68 61 74 20  69 74 27 73 20 75 73 65  |pe that it's use|
00000d40  66 75 6c 2e 20 20 54 68  65 20 61 75 74 68 6f 72  |ful.  The author|
00000d50  20 77 69 6c 6c 20 6e 6f  74 20 62 65 20 6c 69 61  | will not be lia|
00000d60  62 6c 65 0a 20 20 20 20  20 20 20 20 66 6f 72 20  |ble.        for |
00000d70  61 6e 79 20 69 6e 63 75  72 72 65 64 20 64 61 6d  |any incurred dam|
00000d80  61 67 65 73 2c 20 64 69  72 65 63 74 6c 79 20 6f  |ages, directly o|
00000d90  72 20 69 6e 64 69 72 65  63 74 6c 79 20 64 75 65  |r indirectly due|
00000da0  20 74 6f 20 74 68 65 0a  20 20 20 20 20 20 20 20  | to the.        |
00000db0  75 73 65 20 6f 72 20 69  6e 61 62 69 6c 69 74 79  |use or inability|
00000dc0  20 74 6f 20 75 73 65 20  74 68 69 73 20 73 6f 66  | to use this sof|
00000dd0  74 77 61 72 65 2e 0a 0a  20 20 20 20 20 20 20 20  |tware...        |
00000de0  49 74 20 69 73 20 46 72  65 65 57 61 72 65 2c 20  |It is FreeWare, |
00000df0  61 6e 64 20 72 65 6d 61  69 6e 73 20 74 68 65 20  |and remains the |
00000e00  63 6f 70 79 72 69 67 68  74 20 6f 66 20 74 68 65  |copyright of the|
00000e10  20 61 75 74 68 6f 72 2e  0a 20 20 20 20 20 20 20  | author..       |
00000e20  20 50 6f 72 74 69 6f 6e  73 20 6f 66 20 74 68 69  | Portions of thi|
00000e30  73 20 63 6f 64 65 20 61  72 65 20 63 6f 70 79 72  |s code are copyr|
00000e40  69 67 68 74 20 53 74 65  70 68 65 6e 20 41 2e 20  |ight Stephen A. |
00000e50  42 65 6e 6e 65 74 3a 0a  0a 20 20 20 20 20 20 20  |Bennet:..       |
00000e60  20 2a 20 44 45 43 4f 44  45 2e 43 20 2d 20 41 6e  | * DECODE.C - An|
00000e70  20 4c 5a 57 20 64 65 63  6f 64 65 72 20 66 6f 72  | LZW decoder for|
00000e80  20 47 49 46 0a 20 20 20  20 20 20 20 20 2a 20 43  | GIF.        * C|
00000e90  6f 70 79 72 69 67 68 74  20 28 43 29 20 31 39 38  |opyright (C) 198|
00000ea0  37 2c 20 62 79 20 53 74  65 76 65 6e 20 41 2e 20  |7, by Steven A. |
00000eb0  42 65 6e 6e 65 74 74 0a  20 20 20 20 20 20 20 20  |Bennett.        |
00000ec0  2a 0a 20 20 20 20 20 20  20 20 2a 20 50 65 72 6d  |*.        * Perm|
00000ed0  69 73 73 69 6f 6e 20 69  73 20 67 69 76 65 6e 20  |ission is given |
00000ee0  62 79 20 74 68 65 20 61  75 74 68 6f 72 20 74 6f  |by the author to|
00000ef0  20 66 72 65 65 6c 79 20  72 65 64 69 73 74 72 69  | freely redistri|
00000f00  62 75 74 65 0a 20 20 20  20 20 20 20 20 2a 20 61  |bute.        * a|
00000f10  6e 64 20 69 6e 63 6c 75  64 65 20 74 68 69 73 20  |nd include this |
00000f20  63 6f 64 65 20 69 6e 20  61 6e 79 20 70 72 6f 67  |code in any prog|
00000f30  72 61 6d 20 61 73 20 6c  6f 6e 67 20 61 73 20 74  |ram as long as t|
00000f40  68 69 73 0a 20 20 20 20  20 20 20 20 2a 20 63 72  |his.        * cr|
00000f50  65 64 69 74 20 69 73 20  67 69 76 65 6e 20 77 68  |edit is given wh|
00000f60  65 72 65 20 64 75 65 2e  0a 0a 20 20 20 20 20 20  |ere due...      |
00000f70  20 20 54 68 65 20 63 6f  64 65 20 74 6f 20 6d 61  |  The code to ma|
00000f80  74 63 68 20 61 20 63 6f  6c 6f 75 72 20 74 6f 20  |tch a colour to |
00000f90  74 68 65 20 64 65 66 61  75 6c 74 20 77 69 6d 70  |the default wimp|
00000fa0  20 70 61 6c 65 74 74 65  20 69 73 0a 20 20 20 20  | palette is.    |
00000fb0  20 20 20 20 62 61 73 65  64 20 6f 6e 20 61 20 55  |    based on a U|
00000fc0  73 65 4e 65 74 20 61 72  74 69 63 6c 65 3a 0a 0a  |seNet article:..|
00000fd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00000fe0  4d 65 73 73 61 67 65 2d  49 44 3a 20 3c 31 32 34  |Message-ID: <124|
00000ff0  36 33 40 61 63 6f 72 6e  2e 63 6f 2e 75 6b 3e 0a  |63@acorn.co.uk>.|
00001000  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001010  44 61 74 65 3a 20 20 20  20 20 20 20 33 30 20 4a  |Date:       30 J|
00001020  61 6e 20 39 32 20 31 32  3a 32 30 3a 32 33 20 47  |an 92 12:20:23 G|
00001030  4d 54 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |MT.             |
00001040  20 20 20 46 72 6f 6d 3a  20 20 20 20 20 20 20 52  |   From:       R|
00001050  57 69 6c 73 6f 6e 40 61  63 6f 72 6e 2e 63 6f 2e  |Wilson@acorn.co.|
00001060  75 6b 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |uk.             |
00001070  20 20 20 53 75 62 6a 65  63 74 3a 20 20 20 20 48  |   Subject:    H|
00001080  6f 77 20 74 6f 20 66 69  6e 64 20 74 68 65 20 63  |ow to find the c|
00001090  6c 6f 73 65 73 74 20 63  6f 6c 6f 75 72 20 6f 75  |losest colour ou|
000010a0  74 20 6f 66 0a 20 20 20  20 20 20 20 20 20 20 20  |t of.           |
000010b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000010c0  20 74 68 65 20 52 49 53  43 20 4f 53 20 32 35 36  | the RISC OS 256|
000010d0  0a 0a 0a 0a 0a 0a 20 20  20 20 20 20 20 20 20 20  |......          |
000010e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000010f0  20 20 20 20 20 20 20 20  50 61 67 65 20 20 20 31  |        Page   1|
00001100  0a 0c 0a 20 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |... ============|
00001110  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001140  3d 3d 3d 3d 20 67 69 66  32 72 70 63 20 3d 3d 3d  |==== gif2rpc ===|
00001150  3d 0a 0a 0a 0a 20 5b 31  2e 32 5d 20 54 72 61 64  |=.... [1.2] Trad|
00001160  65 6d 61 72 6b 73 0a 0a  20 20 20 20 20 20 20 20  |emarks..        |
00001170  47 49 46 20 69 73 20 61  20 74 72 61 64 65 6d 61  |GIF is a tradema|
00001180  72 6b 20 6f 66 20 43 6f  6d 70 75 73 65 72 76 65  |rk of Compuserve|
00001190  20 49 6e 63 2e 0a 0a 0a  0a 20 5b 32 5d 20 48 6f  | Inc..... [2] Ho|
000011a0  77 20 74 6f 20 75 73 65  0a 0a 0a 20 20 20 20 20  |w to use...     |
000011b0  20 20 20 67 69 66 32 72  70 63 20 69 73 20 61 20  |   gif2rpc is a |
000011c0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 75 74 69  |command line uti|
000011d0  6c 69 74 79 2e 20 20 49  74 20 74 61 6b 65 73 20  |lity.  It takes |
000011e0  71 75 69 74 65 20 61 20  66 65 77 0a 20 20 20 20  |quite a few.    |
000011f0  20 20 20 20 70 61 72 61  6d 65 74 65 72 73 2c 20  |    parameters, |
00001200  62 75 74 20 62 61 73 69  63 20 75 73 61 67 65 20  |but basic usage |
00001210  69 73 3a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |is:..           |
00001220  67 69 66 32 72 70 63 20  3c 69 6e 3e 20 3c 6f 75  |gif2rpc <in> <ou|
00001230  74 3e 0a 0a 20 20 20 20  20 20 20 20 49 66 20 79  |t>..        If y|
00001240  6f 75 20 77 6f 75 6c 64  20 6c 69 6b 65 20 61 20  |ou would like a |
00001250  6c 6f 67 66 69 6c 65 20  6f 66 20 61 6e 79 20 65  |logfile of any e|
00001260  72 72 6f 72 73 20 74 68  61 74 20 61 72 65 0a 20  |rrors that are. |
00001270  20 20 20 20 20 20 20 65  6e 63 6f 75 6e 74 65 72  |       encounter|
00001280  65 64 20 74 68 65 6e 20  61 70 70 65 6e 64 20 94  |ed then append .|
00001290  20 3e 3e 26 20 6c 6f 67  66 69 6c 65 95 20 74 6f  | >>& logfile. to|
000012a0  20 74 68 65 20 63 6f 6d  6d 61 6e 64 0a 20 20 20  | the command.   |
000012b0  20 20 20 20 20 6c 69 6e  65 2c 20 6f 72 20 75 73  |     line, or us|
000012c0  65 20 74 68 65 20 2d 6c  6f 67 20 70 61 72 61 6d  |e the -log param|
000012d0  65 74 65 72 2e 0a 0a 20  20 20 20 20 20 20 20 4e  |eter...        N|
000012e0  6f 74 65 20 74 68 61 74  20 69 66 20 79 6f 75 20  |ote that if you |
000012f0  68 61 76 65 20 68 65 20  44 44 45 75 74 69 6c 73  |have he DDEutils|
00001300  20 6d 6f 64 75 6c 65 20  74 68 65 6e 20 67 69 66  | module then gif|
00001310  32 72 70 63 20 77 69 6c  6c 0a 20 20 20 20 20 20  |2rpc will.      |
00001320  20 20 74 61 6b 65 20 61  64 76 61 6e 74 61 67 65  |  take advantage|
00001330  20 6f 66 20 74 68 65 20  6e 65 77 20 66 61 63 69  | of the new faci|
00001340  6c 69 74 79 20 66 6f 72  20 6c 6f 6e 67 20 63 6f  |lity for long co|
00001350  6d 6d 61 6e 64 20 6c 69  6e 65 73 2e 0a 0a 0a 0a  |mmand lines.....|
00001360  20 5b 32 2e 31 5d 20 48  6f 77 20 74 6f 20 75 73  | [2.1] How to us|
00001370  65 20 77 69 74 68 20 41  72 63 57 65 62 0a 0a 0a  |e with ArcWeb...|
00001380  20 20 20 20 20 20 20 20  54 68 69 73 20 61 70 70  |        This app|
00001390  6c 69 65 73 20 74 6f 20  41 72 63 57 65 62 20 31  |lies to ArcWeb 1|
000013a0  2e 31 34 2e 20 20 46 69  72 73 74 20 6f 70 65 6e  |.14.  First open|
000013b0  20 74 68 65 20 42 72 6f  77 73 65 72 0a 20 20 20  | the Browser.   |
000013c0  20 20 20 20 20 63 6f 6e  66 69 67 75 72 61 74 69  |     configurati|
000013d0  6f 6e 20 77 69 6e 64 6f  77 2c 20 61 6e 64 20 65  |on window, and e|
000013e0  6e 61 62 6c 65 20 74 68  65 20 94 47 49 46 38 37  |nable the .GIF87|
000013f0  20 68 61 6e 64 6c 65 64  20 62 79 0a 20 20 20 20  | handled by.    |
00001400  20 20 20 20 67 69 66 32  73 70 72 95 20 6f 70 74  |    gif2spr. opt|
00001410  69 6f 6e 2e 20 20 53 65  6c 65 63 74 20 4f 4b 2e  |ion.  Select OK.|
00001420  20 20 44 6f 6e 27 74 20  66 6f 72 67 65 74 20 74  |  Don't forget t|
00001430  6f 20 63 68 6f 6f 73 65  20 74 68 65 0a 20 20 20  |o choose the.   |
00001440  20 20 20 20 20 6d 65 6e  75 20 69 74 65 6d 20 94  |     menu item .|
00001450  43 6f 6e 66 69 67 75 72  65 2d 3e 53 61 76 65 20  |Configure->Save |
00001460  6f 70 74 69 6f 6e 73 95  21 0a 0a 20 20 20 20 20  |options.!..     |
00001470  20 20 20 4e 65 78 74 20  6d 61 6b 65 20 61 20 62  |   Next make a b|
00001480  61 63 6b 20 75 70 20 63  6f 70 79 20 6f 66 20 74  |ack up copy of t|
00001490  68 65 20 66 69 6c 65 20  94 21 41 72 63 57 65 62  |he file .!ArcWeb|
000014a0  2e 67 69 66 32 73 70 72  95 2e 0a 0a 20 20 20 20  |.gif2spr....    |
000014b0  20 20 20 20 46 69 6e 61  6c 6c 79 20 63 6f 70 79  |    Finally copy|
000014c0  20 74 68 65 73 65 20 66  69 6c 65 73 3a 0a 0a 20  | these files:.. |
000014d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 67  |               g|
000014e0  69 66 32 72 70 63 20 20  20 20 20 20 20 20 20 2d  |if2rpc         -|
000014f0  3e 20 21 41 72 63 57 65  62 2e 67 69 66 32 72 70  |> !ArcWeb.gif2rp|
00001500  63 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |c.              |
00001510  20 20 57 57 57 2e 67 69  66 32 73 70 72 20 20 20  |  WWW.gif2spr   |
00001520  20 20 2d 3e 20 21 41 72  63 57 65 62 2e 67 69 66  |  -> !ArcWeb.gif|
00001530  32 73 70 72 0a 20 20 20  20 20 20 20 20 20 20 20  |2spr.           |
00001540  20 20 20 20 20 57 57 57  2e 67 69 66 32 72 70 63  |     WWW.gif2rpc|
00001550  46 45 20 20 20 2d 3e 20  21 41 72 63 57 65 62 2e  |FE   -> !ArcWeb.|
00001560  67 69 66 32 72 70 63 46  45 0a 0a 20 20 20 20 20  |gif2rpcFE..     |
00001570  20 20 20 41 6e 64 20 74  68 61 74 20 69 73 20 74  |   And that is t|
00001580  68 61 74 2e 0a 0a 20 20  20 20 20 20 20 20 59 6f  |hat...        Yo|
00001590  75 20 6d 61 79 20 77 69  73 68 20 74 6f 20 6d 6f  |u may wish to mo|
000015a0  64 69 66 79 20 74 68 65  20 28 6e 65 77 29 20 94  |dify the (new) .|
000015b0  21 41 72 63 57 65 62 2e  67 69 66 32 73 70 72 95  |!ArcWeb.gif2spr.|
000015c0  20 66 69 6c 65 20 74 6f  0a 20 20 20 20 20 20 20  | file to.       |
000015d0  20 63 68 61 6e 67 65 20  74 68 65 20 69 6e 69 74  | change the init|
000015e0  69 61 6c 69 73 61 74 69  6f 6e 20 6f 66 20 74 68  |ialisation of th|
000015f0  65 20 73 79 73 74 65 6d  20 76 61 72 69 61 62 6c  |e system variabl|
00001600  65 0a 20 20 20 20 20 20  20 20 94 67 69 66 32 72  |e.        .gif2r|
00001610  70 63 24 6f 70 74 69 6f  6e 73 95 2e 0a 0a 0a 0a  |pc$options......|
00001620  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 20 20 20 20 20  |...........     |
00001630  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001640  20 20 20 20 20 20 20 20  20 20 20 20 20 50 61 67  |             Pag|
00001650  65 20 20 20 32 0a 0c 0a  20 3d 3d 3d 3d 3d 3d 3d  |e   2... =======|
00001660  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001690  3d 3d 3d 3d 3d 3d 3d 3d  3d 20 67 69 66 32 72 70  |========= gif2rp|
000016a0  63 20 3d 3d 3d 3d 0a 0a  0a 20 20 20 20 20 20 20  |c ====...       |
000016b0  20 0a 20 5b 32 2e 32 5d  20 48 6f 77 20 74 6f 20  | . [2.2] How to |
000016c0  75 73 65 20 77 69 74 68  20 57 65 62 73 74 65 72  |use with Webster|
000016d0  0a 0a 0a 20 20 20 20 20  20 20 20 54 68 69 73 20  |...        This |
000016e0  61 70 70 6c 69 65 73 20  74 6f 20 57 65 62 73 74  |applies to Webst|
000016f0  65 72 20 76 30 2e 31 31  2e 20 20 46 69 72 73 74  |er v0.11.  First|
00001700  20 6f 70 65 6e 20 74 68  65 20 43 68 6f 69 63 65  | open the Choice|
00001710  73 0a 20 20 20 20 20 20  20 20 64 69 61 6c 6f 67  |s.        dialog|
00001720  75 65 20 62 6f 78 2c 20  61 6e 64 20 73 65 6c 65  |ue box, and sele|
00001730  63 74 20 74 68 65 20 94  49 6e 6c 6e 65 20 56 69  |ct the .Inlne Vi|
00001740  65 77 65 72 73 95 20 74  61 62 2e 20 20 45 6e 73  |ewers. tab.  Ens|
00001750  75 72 65 0a 20 20 20 20  20 20 20 20 74 68 61 74  |ure.        that|
00001760  20 74 68 65 20 94 47 49  46 20 44 65 63 6f 64 65  | the .GIF Decode|
00001770  72 95 20 76 61 6c 75 65  20 69 73 20 6c 65 66 74  |r. value is left|
00001780  20 61 74 20 74 68 65 20  64 65 66 61 75 6c 74 20  | at the default |
00001790  6f 66 0a 20 20 20 20 20  20 20 20 94 3c 57 65 62  |of.        .<Web|
000017a0  73 74 65 72 24 44 69 72  3e 2e 67 69 66 32 73 70  |ster$Dir>.gif2sp|
000017b0  72 20 2d 71 20 25 30 20  25 31 95 2e 20 20 43 6c  |r -q %0 %1..  Cl|
000017c0  69 63 6b 20 74 68 65 20  53 61 76 65 20 62 75 74  |ick the Save but|
000017d0  74 6f 6e 2e 0a 0a 20 20  20 20 20 20 20 20 4e 65  |ton...        Ne|
000017e0  78 74 20 6d 61 6b 65 20  61 20 62 61 63 6b 20 75  |xt make a back u|
000017f0  70 20 63 6f 70 79 20 6f  66 20 74 68 65 20 66 69  |p copy of the fi|
00001800  6c 65 20 94 21 57 65 62  73 74 65 72 2e 67 69 66  |le .!Webster.gif|
00001810  32 73 70 72 95 2e 0a 0a  20 20 20 20 20 20 20 20  |2spr....        |
00001820  46 69 6e 61 6c 6c 79 20  63 6f 70 79 20 74 68 65  |Finally copy the|
00001830  20 2a 63 6f 6e 74 65 6e  74 73 2a 20 6f 66 20 74  | *contents* of t|
00001840  68 65 20 57 57 57 20 64  69 72 65 63 74 6f 72 79  |he WWW directory|
00001850  20 69 6e 74 6f 20 74 68  65 0a 20 20 20 20 20 20  | into the.      |
00001860  20 20 21 57 65 62 73 74  65 72 20 64 69 72 65 63  |  !Webster direc|
00001870  74 6f 72 79 2c 20 69 2e  65 2e 20 63 72 65 61 74  |tory, i.e. creat|
00001880  69 6e 67 20 74 68 65 20  74 68 72 65 65 20 66 69  |ing the three fi|
00001890  6c 65 73 3a 0a 0a 20 20  20 20 20 20 20 20 20 20  |les:..          |
000018a0  20 20 20 20 20 20 67 69  66 32 72 70 63 20 20 20  |      gif2rpc   |
000018b0  20 20 20 20 20 20 2d 3e  20 21 57 65 62 73 74 65  |      -> !Webste|
000018c0  72 2e 67 69 66 32 72 70  63 0a 20 20 20 20 20 20  |r.gif2rpc.      |
000018d0  20 20 20 20 20 20 20 20  20 20 57 57 57 2e 67 69  |          WWW.gi|
000018e0  66 32 73 70 72 20 20 20  20 20 2d 3e 20 21 57 65  |f2spr     -> !We|
000018f0  62 73 74 65 72 2e 67 69  66 32 73 70 72 0a 20 20  |bster.gif2spr.  |
00001900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 57 57  |              WW|
00001910  57 2e 67 69 66 32 72 70  63 46 45 20 20 20 2d 3e  |W.gif2rpcFE   ->|
00001920  20 21 57 65 62 73 74 65  72 2e 67 69 66 32 72 70  | !Webster.gif2rp|
00001930  63 46 45 0a 0a 20 20 20  20 20 20 20 20 41 6e 64  |cFE..        And|
00001940  20 74 68 61 74 20 69 73  20 74 68 61 74 2e 0a 0a  | that is that...|
00001950  20 20 20 20 20 20 20 20  59 6f 75 20 6d 61 79 20  |        You may |
00001960  77 69 73 68 20 74 6f 20  6d 6f 64 69 66 79 20 74  |wish to modify t|
00001970  68 65 20 28 6e 65 77 29  20 94 21 57 65 62 73 74  |he (new) .!Webst|
00001980  65 72 2e 67 69 66 32 73  70 72 95 20 66 69 6c 65  |er.gif2spr. file|
00001990  20 74 6f 0a 20 20 20 20  20 20 20 20 63 68 61 6e  | to.        chan|
000019a0  67 65 20 74 68 65 20 69  6e 69 74 69 61 6c 69 73  |ge the initialis|
000019b0  61 74 69 6f 6e 20 6f 66  20 74 68 65 20 73 79 73  |ation of the sys|
000019c0  74 65 6d 20 76 61 72 69  61 62 6c 65 0a 20 20 20  |tem variable.   |
000019d0  20 20 20 20 20 94 67 69  66 32 72 70 63 24 6f 70  |     .gif2rpc$op|
000019e0  74 69 6f 6e 73 95 2e 0a  0a 0a 0a 20 5b 32 2e 33  |tions...... [2.3|
000019f0  5d 20 43 6f 6d 6d 61 6e  64 20 6c 69 6e 65 20 70  |] Command line p|
00001a00  61 72 61 6d 65 74 65 72  73 0a 0a 0a 20 20 20 20  |arameters...    |
00001a10  20 20 20 20 48 65 72 65  20 61 72 65 20 61 6c 6c  |    Here are all|
00001a20  20 74 68 65 20 70 61 72  61 6d 65 74 65 72 73 3a  | the parameters:|
00001a30  0a 0a 20 20 20 20 20 20  20 20 20 20 20 5b 2d 67  |..           [-g|
00001a40  69 66 5d 20 3c 66 69 6c  65 2d 6e 61 6d 65 3e 0a  |if] <file-name>.|
00001a50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001a60  74 68 69 73 20 69 73 20  74 68 65 20 6e 61 6d 65  |this is the name|
00001a70  20 6f 66 20 74 68 65 20  47 49 46 20 66 69 6c 65  | of the GIF file|
00001a80  2e 20 20 49 74 20 64 6f  65 73 20 6e 6f 74 0a 20  |.  It does not. |
00001a90  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 6e  |               n|
00001aa0  65 65 64 20 74 6f 20 62  65 20 74 79 70 65 91 64  |eed to be type.d|
00001ab0  20 61 73 20 61 20 54 49  46 46 20 66 69 6c 65 2c  | as a TIFF file,|
00001ac0  20 61 73 20 74 68 69 73  20 70 72 6f 67 72 61 6d  | as this program|
00001ad0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001ae0  20 77 69 6c 6c 20 76 65  72 69 66 79 20 74 68 61  | will verify tha|
00001af0  74 20 74 68 65 20 66 69  6c 65 20 69 73 20 69 6e  |t the file is in|
00001b00  20 47 49 46 20 66 6f 72  6d 61 74 0a 0a 0a 20 20  | GIF format...  |
00001b10  20 20 20 20 20 20 20 20  20 5b 2d 73 70 72 69 74  |         [-sprit|
00001b20  65 5d 20 3c 66 69 6c 65  2d 6e 61 6d 65 3e 0a 20  |e] <file-name>. |
00001b30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 74  |               t|
00001b40  68 69 73 20 77 69 6c 6c  20 62 65 20 74 68 65 20  |his will be the |
00001b50  66 69 6c 65 20 74 68 61  74 20 69 73 20 70 72 6f  |file that is pro|
00001b60  64 75 63 65 64 2c 20 63  6f 6e 74 61 69 6e 69 6e  |duced, containin|
00001b70  67 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |g.              |
00001b80  20 20 74 68 65 20 73 69  6e 67 6c 65 20 73 70 72  |  the single spr|
00001b90  69 74 65 20 72 65 70 72  65 73 65 6e 74 69 6e 67  |ite representing|
00001ba0  20 74 68 65 20 6f 72 69  67 69 6e 61 6c 20 47 49  | the original GI|
00001bb0  46 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |F.              |
00001bc0  20 20 69 6d 61 67 65 0a  20 20 20 20 20 20 20 20  |  image.        |
00001bd0  20 20 20 5b 2d 68 65 6c  70 5d 0a 20 20 20 20 20  |   [-help].     |
00001be0  20 20 20 20 20 20 20 20  20 20 20 70 72 6f 64 75  |           produ|
00001bf0  63 65 20 73 6f 6d 65 20  74 65 72 73 65 20 68 65  |ce some terse he|
00001c00  6c 70 20 6f 6e 20 74 68  65 73 65 20 70 61 72 61  |lp on these para|
00001c10  6d 65 74 65 72 73 0a 20  20 20 20 20 20 20 20 0a  |meters.        .|
00001c20  0a 20 20 20 20 20 20 20  20 20 20 20 5b 2d 76 65  |.           [-ve|
00001c30  72 62 6f 73 65 20 3c 6e  3e 5d 0a 20 20 20 20 20  |rbose <n>].     |
00001c40  20 20 20 20 20 20 20 20  20 20 20 62 79 20 64 65  |           by de|
00001c50  66 61 75 6c 74 20 3c 6e  3e 20 69 73 20 30 2c 20  |fault <n> is 0, |
00001c60  77 68 69 63 68 20 64 69  73 61 62 6c 65 73 20 61  |which disables a|
00001c70  6c 6c 20 74 65 78 74 0a  20 20 20 20 20 20 20 20  |ll text.        |
00001c80  20 20 20 20 20 20 20 20  6f 75 74 70 75 74 20 77  |        output w|
00001c90  68 69 6c 65 20 74 68 65  20 47 49 46 20 66 69 6c  |hile the GIF fil|
00001ca0  65 20 69 73 20 62 65 69  6e 67 20 72 65 61 64 20  |e is being read |
00001cb0  61 6e 64 0a 20 20 20 20  20 20 20 20 20 20 20 20  |and.            |
00001cc0  20 20 20 20 70 72 6f 63  65 73 73 65 64 2e 20 20  |    processed.  |
00001cd0  42 79 20 73 65 74 74 69  6e 67 20 3c 6e 3e 20 74  |By setting <n> t|
00001ce0  6f 20 31 2c 20 74 68 65  6e 20 73 6f 6d 65 20 62  |o 1, then some b|
00001cf0  61 73 69 63 0a 20 20 20  20 20 20 20 20 20 20 20  |asic.           |
00001d00  20 20 20 20 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  |     information|
00001d10  20 69 73 20 64 69 73 70  6c 61 79 65 64 2e 20 20  | is displayed.  |
00001d20  54 68 69 73 20 63 61 6e  20 62 65 20 72 65 64 69  |This can be redi|
00001d30  72 65 63 74 65 64 0a 20  20 20 20 20 20 20 20 20  |rected.         |
00001d40  20 20 20 20 20 20 20 74  6f 20 61 20 66 69 6c 65  |       to a file|
00001d50  20 62 79 20 61 70 70 65  6e 64 69 6e 67 20 94 3e  | by appending .>|
00001d60  20 66 69 6c 65 95 20 74  6f 20 74 68 65 20 63 6f  | file. to the co|
00001d70  6d 6d 61 6e 64 0a 20 20  20 20 20 20 20 20 20 20  |mmand.          |
00001d80  20 20 20 20 20 20 6c 69  6e 65 2e 20 20 42 79 20  |      line.  By |
00001d90  73 65 74 74 69 6e 67 20  3c 6e 3e 20 74 6f 20 32  |setting <n> to 2|
00001da0  20 74 68 65 6e 20 72 61  74 68 65 72 20 6d 6f 72  | then rather mor|
00001db0  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00001dc0  20 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 69 73  |  information is|
00001dd0  20 64 69 73 70 6c 61 79  65 64 0a 0a 0a 0a 0a 0a  | displayed......|
00001de0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001df0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00001e00  20 20 20 50 61 67 65 20  20 20 33 0a 0c 0a 20 3d  |   Page   3... =|
00001e10  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00001e40  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 20  |=============== |
00001e50  67 69 66 32 72 70 63 20  3d 3d 3d 3d 0a 0a 0a 20  |gif2rpc ====... |
00001e60  20 20 20 20 20 20 20 0a  20 20 20 20 20 20 20 20  |       .        |
00001e70  20 20 20 5b 2d 71 75 69  65 74 5d 0a 20 20 20 20  |   [-quiet].    |
00001e80  20 20 20 20 20 20 20 20  20 20 20 20 62 79 20 64  |            by d|
00001e90  65 66 61 75 6c 74 2c 20  69 66 20 67 69 66 32 72  |efault, if gif2r|
00001ea0  70 63 20 64 65 74 65 63  74 73 20 61 6e 20 65 72  |pc detects an er|
00001eb0  72 6f 72 20 69 6e 20 74  68 65 0a 20 20 20 20 20  |ror in the.     |
00001ec0  20 20 20 20 20 20 20 20  20 20 20 69 6e 70 75 74  |           input|
00001ed0  20 47 49 46 2c 20 74 68  65 6e 20 69 74 20 77 69  | GIF, then it wi|
00001ee0  6c 6c 20 66 69 72 73 74  20 64 69 73 70 6c 61 79  |ll first display|
00001ef0  20 61 20 74 65 78 74 75  61 6c 0a 20 20 20 20 20  | a textual.     |
00001f00  20 20 20 20 20 20 20 20  20 20 20 6d 65 73 73 61  |           messa|
00001f10  67 65 20 73 61 79 69 6e  67 20 77 68 65 72 65 20  |ge saying where |
00001f20  61 6e 64 20 77 68 61 74  20 66 61 69 6c 65 64 2c  |and what failed,|
00001f30  20 74 68 65 6e 20 61 74  74 65 6d 70 74 0a 20 20  | then attempt.  |
00001f40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 74 6f  |              to|
00001f50  20 63 6f 6e 74 69 6e 75  65 20 28 62 75 74 20 73  | continue (but s|
00001f60  65 65 20 2d 66 75 73 73  79 29 2e 20 20 54 68 69  |ee -fussy).  Thi|
00001f70  73 20 6d 65 73 73 61 67  65 20 63 61 6e 20 62 65  |s message can be|
00001f80  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00001f90  20 72 65 64 69 72 65 63  74 65 64 20 74 6f 20 61  | redirected to a|
00001fa0  20 61 20 66 69 6c 65 20  62 79 20 61 70 70 65 6e  | a file by appen|
00001fb0  64 69 6e 67 20 94 32 3e  20 66 69 6c 65 95 20 74  |ding .2> file. t|
00001fc0  6f 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |o.              |
00001fd0  20 20 74 68 65 20 63 6f  6d 6d 61 6e 64 20 6c 69  |  the command li|
00001fe0  6e 65 2c 20 6f 72 20 75  73 69 6e 67 20 2d 6c 6f  |ne, or using -lo|
00001ff0  67 20 28 62 65 6c 6f 77  29 2e 20 20 46 6f 72 20  |g (below).  For |
00002000  61 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |a.              |
00002010  20 20 6c 69 73 74 20 6f  66 20 74 68 65 20 65 72  |  list of the er|
00002020  72 6f 72 20 6d 65 73 73  61 67 65 73 2c 20 73 65  |ror messages, se|
00002030  65 20 62 65 6c 6f 77 0a  0a 0a 20 20 20 20 20 20  |e below...      |
00002040  20 20 20 20 20 5b 2d 68  6f 75 72 67 6c 61 73 73  |     [-hourglass|
00002050  5d 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |].              |
00002060  20 20 62 65 63 61 75 73  65 20 73 6f 6d 65 20 47  |  because some G|
00002070  49 46 73 20 61 72 65 20  62 69 67 2c 20 74 68 65  |IFs are big, the|
00002080  79 20 74 61 6b 65 20 61  20 6c 6f 6e 67 20 74 69  |y take a long ti|
00002090  6d 65 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |me.             |
000020a0  20 20 20 74 6f 20 70 72  6f 63 65 73 73 20 28 65  |   to process (e|
000020b0  76 65 6e 20 6f 6e 20 61  6e 20 41 52 4d 20 37 30  |ven on an ARM 70|
000020c0  30 29 2e 20 20 54 68 65  72 65 66 6f 72 65 20 79  |0).  Therefore y|
000020d0  6f 75 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ou.             |
000020e0  20 20 20 6d 61 79 20 74  65 6c 6c 20 67 69 66 32  |   may tell gif2|
000020f0  72 70 63 20 74 6f 20 75  73 65 20 74 68 65 20 94  |rpc to use the .|
00002100  68 6f 75 72 67 6c 61 73  73 95 20 74 6f 0a 20 20  |hourglass. to.  |
00002110  20 20 20 20 20 20 20 20  20 20 20 20 20 20 67 69  |              gi|
00002120  76 65 20 73 6f 6d 65 20  76 69 73 75 61 6c 20 66  |ve some visual f|
00002130  65 65 64 62 61 63 6b 20  6f 76 65 72 20 68 6f 77  |eedback over how|
00002140  20 66 61 72 20 69 74 20  68 61 73 20 67 6f 74 0a  | far it has got.|
00002150  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002160  69 6e 20 70 72 6f 63 65  73 73 69 6e 67 20 74 68  |in processing th|
00002170  65 20 47 49 46 2e 20 20  54 68 65 20 70 65 72 63  |e GIF.  The perc|
00002180  65 6e 74 61 67 65 20 69  6e 64 69 63 61 74 6f 72  |entage indicator|
00002190  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000021a0  20 69 73 20 75 73 65 64  20 74 6f 20 73 68 6f 77  | is used to show|
000021b0  20 68 6f 77 20 6d 75 63  68 20 6f 66 20 74 68 65  | how much of the|
000021c0  20 69 6d 61 67 65 20 68  61 73 20 61 6c 72 65 61  | image has alrea|
000021d0  64 79 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |dy.             |
000021e0  20 20 20 62 65 65 6e 20  64 65 63 6f 64 65 64 0a  |   been decoded.|
000021f0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00002200  20 41 66 74 65 72 20 64  65 63 6f 64 69 6e 67 2c  | After decoding,|
00002210  20 77 68 69 6c 65 20 74  68 65 20 69 6d 61 67 65  | while the image|
00002220  20 69 73 20 70 72 6f 63  65 73 73 65 64 20 74 68  | is processed th|
00002230  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00002240  20 20 70 65 72 63 65 6e  74 61 67 65 20 63 6f 75  |  percentage cou|
00002250  6e 74 73 20 44 4f 57 4e  20 66 72 6f 6d 20 31 30  |nts DOWN from 10|
00002260  30 25 20 74 6f 20 30 25  2e 20 20 54 68 69 73 20  |0% to 0%.  This |
00002270  69 73 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |is.             |
00002280  20 20 20 61 6e 20 61 72  62 69 74 72 61 72 79 20  |   an arbitrary |
00002290  61 65 73 74 68 65 74 69  63 20 64 65 63 69 73 69  |aesthetic decisi|
000022a0  6f 6e 0a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |on...           |
000022b0  20 5b 2d 6e 61 6d 65 20  3c 74 65 78 74 3e 5d 0a  | [-name <text>].|
000022c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000022d0  62 79 20 64 65 66 61 75  6c 74 20 74 68 65 20 69  |by default the i|
000022e0  6d 61 67 65 20 73 61 76  65 64 20 69 6e 20 74 68  |mage saved in th|
000022f0  65 20 2d 73 70 72 69 74  65 0a 20 20 20 20 20 20  |e -sprite.      |
00002300  20 20 20 20 20 20 20 20  20 20 66 69 6c 65 2d 6e  |          file-n|
00002310  61 6d 65 20 77 69 6c 6c  20 62 65 20 94 67 69 66  |ame will be .gif|
00002320  32 72 70 63 95 2e 20 20  49 66 20 74 68 69 73 20  |2rpc..  If this |
00002330  6f 66 66 65 6e 64 73 0a  20 20 20 20 20 20 20 20  |offends.        |
00002340  20 20 20 20 20 20 20 20  79 6f 75 20 74 68 65 6e  |        you then|
00002350  20 79 6f 75 20 63 61 6e  20 72 65 6e 61 6d 65 20  | you can rename |
00002360  69 74 2e 20 20 4e 6f 74  65 20 74 68 61 74 20 6e  |it.  Note that n|
00002370  61 6d 65 73 20 6f 66 0a  20 20 20 20 20 20 20 20  |ames of.        |
00002380  20 20 20 20 20 20 20 20  73 70 72 69 74 65 73 20  |        sprites |
00002390  6d 75 73 74 20 62 65 20  6c 6f 77 65 72 20 63 61  |must be lower ca|
000023a0  73 65 2e 20 20 67 69 66  32 72 70 63 20 65 6e 66  |se.  gif2rpc enf|
000023b0  6f 72 63 65 73 20 74 68  69 73 0a 20 20 20 20 20  |orces this.     |
000023c0  20 20 20 20 20 20 20 20  20 20 20 62 79 20 75 73  |           by us|
000023d0  69 6e 67 20 74 68 65 20  63 75 72 72 65 6e 74 20  |ing the current |
000023e0  6c 6f 63 61 6c 65 91 73  20 69 64 65 61 20 6f 66  |locale.s idea of|
000023f0  20 6c 6f 77 65 72 20 63  61 73 65 2e 0a 20 20 20  | lower case..   |
00002400  20 20 20 20 20 20 20 20  20 20 20 20 20 41 6c 73  |             Als|
00002410  6f 20 6e 6f 74 65 20 74  68 61 74 20 73 70 72 69  |o note that spri|
00002420  74 65 20 6e 61 6d 65 73  20 61 72 65 20 6c 69 6d  |te names are lim|
00002430  69 74 65 64 20 74 6f 20  74 77 65 6c 76 65 0a 20  |ited to twelve. |
00002440  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 63  |               c|
00002450  68 61 72 61 63 74 65 72  73 2e 20 20 53 65 65 20  |haracters.  See |
00002460  61 6c 73 6f 20 2d 61 75  74 6f 6e 61 6d 65 0a 0a  |also -autoname..|
00002470  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
00002480  0a 0a 0a 0a 0a 0a 0a 0a  0a 20 20 20 20 20 20 20  |.........       |
00002490  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000024a0  20 20 20 20 20 20 20 20  20 20 20 50 61 67 65 20  |           Page |
000024b0  20 20 34 0a 0c 0a 20 3d  3d 3d 3d 3d 3d 3d 3d 3d  |  4... =========|
000024c0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
000024f0  3d 3d 3d 3d 3d 3d 3d 20  67 69 66 32 72 70 63 20  |======= gif2rpc |
00002500  3d 3d 3d 3d 0a 0a 0a 20  20 20 20 20 20 20 20 0a  |====...        .|
00002510  20 20 20 20 20 20 20 20  20 20 20 20 20 5b 2d 62  |             [-b|
00002520  70 70 20 3c 6e 3e 5d 0a  20 20 20 20 20 20 20 20  |pp <n>].        |
00002530  20 20 20 20 20 20 20 20  62 70 70 20 73 74 61 6e  |        bpp stan|
00002540  64 73 20 66 6f 72 20 62  69 74 73 20 70 65 72 20  |ds for bits per |
00002550  70 69 78 65 6c 2e 20 20  54 68 69 73 20 70 61 72  |pixel.  This par|
00002560  61 6d 65 74 65 72 0a 20  20 20 20 20 20 20 20 20  |ameter.         |
00002570  20 20 20 20 20 20 20 64  65 74 65 72 6d 69 6e 65  |       determine|
00002580  73 20 77 68 61 74 20 73  6f 72 74 20 6f 66 20 73  |s what sort of s|
00002590  70 72 69 74 65 20 69 6d  61 67 65 20 67 69 66 32  |prite image gif2|
000025a0  72 70 63 20 77 69 6c 6c  0a 20 20 20 20 20 20 20  |rpc will.       |
000025b0  20 20 20 20 20 20 20 20  20 74 72 79 20 74 6f 20  |         try to |
000025c0  70 72 6f 64 75 63 65 2e  20 20 49 74 20 74 61 6b  |produce.  It tak|
000025d0  65 73 20 74 68 65 20 66  6f 6c 6c 6f 77 69 6e 67  |es the following|
000025e0  20 76 61 6c 75 65 73 0a  0a 0a 20 20 20 20 20 20  | values...      |
000025f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 30 20  |              0 |
00002600  20 20 75 73 65 20 47 49  46 91 73 20 70 61 6c 65  |  use GIF.s pale|
00002610  74 74 65 20 74 6f 20 70  72 6f 64 75 63 65 20 31  |tte to produce 1|
00002620  2f 32 2f 34 2f 38 20 62  70 70 0a 20 20 20 20 20  |/2/4/8 bpp.     |
00002630  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002640  20 20 20 69 6d 61 67 65  2e 20 20 4e 6f 20 69 6d  |   image.  No im|
00002650  61 67 65 20 70 72 6f 63  65 73 73 69 6e 67 20 69  |age processing i|
00002660  73 20 64 6f 6e 65 0a 0a  20 20 20 20 20 20 20 20  |s done..        |
00002670  20 20 20 20 20 20 20 20  20 20 20 20 31 20 20 20  |            1   |
00002680  70 72 6f 64 75 63 65 20  61 20 6d 6f 6e 6f 63 68  |produce a monoch|
00002690  72 6f 6d 65 20 62 6c 61  63 6b 2f 77 68 69 74 65  |rome black/white|
000026a0  20 69 6d 61 67 65 0a 0a  20 20 20 20 20 20 20 20  | image..        |
000026b0  20 20 20 20 20 20 20 20  20 20 20 20 32 20 20 20  |            2   |
000026c0  70 72 6f 64 75 63 65 20  61 20 66 6f 75 72 20 63  |produce a four c|
000026d0  6f 6c 6f 75 72 20 69 6d  61 67 65 2c 20 75 73 69  |olour image, usi|
000026e0  6e 67 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |ng.             |
000026f0  20 20 20 20 20 20 20 20  20 20 20 64 65 66 61 75  |           defau|
00002700  6c 74 20 77 69 6d 70 20  70 61 6c 65 74 74 65 20  |lt wimp palette |
00002710  28 61 20 67 72 65 79 20  73 63 61 6c 65 29 0a 0a  |(a grey scale)..|
00002720  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002730  20 20 20 20 34 20 20 20  70 72 6f 64 75 63 65 20  |    4   produce |
00002740  61 20 31 36 20 63 6f 6c  6f 75 72 20 69 6d 61 67  |a 16 colour imag|
00002750  65 2c 20 75 73 69 6e 67  20 74 68 65 0a 20 20 20  |e, using the.   |
00002760  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002770  20 20 20 20 20 64 65 66  61 75 6c 74 20 77 69 6d  |     default wim|
00002780  70 20 70 61 6c 65 74 74  65 0a 0a 20 20 20 20 20  |p palette..     |
00002790  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 38  |               8|
000027a0  20 20 20 70 72 6f 64 75  63 65 20 61 20 32 35 36  |   produce a 256|
000027b0  20 63 6f 6c 6f 75 72 20  69 6d 61 67 65 2c 20 75  | colour image, u|
000027c0  73 69 6e 67 20 74 68 65  0a 20 20 20 20 20 20 20  |sing the.       |
000027d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000027e0  20 64 65 66 61 75 6c 74  20 77 69 6d 70 20 70 61  | default wimp pa|
000027f0  6c 65 74 74 65 0a 20 20  20 20 20 20 20 20 0a 20  |lette.        . |
00002800  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002810  20 20 20 31 36 20 20 70  72 6f 64 75 63 65 20 61  |   16  produce a|
00002820  20 33 32 4b 20 63 6f 6c  6f 75 72 20 69 6d 61 67  | 32K colour imag|
00002830  65 2c 20 77 69 74 68 20  61 20 66 69 78 65 64 0a  |e, with a fixed.|
00002840  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002850  20 20 20 20 20 20 20 20  70 61 6c 65 74 74 65 0a  |        palette.|
00002860  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00002870  20 20 20 20 20 20 20 20  20 20 20 20 20 33 32 20  |             32 |
00002880  20 70 72 6f 64 75 63 65  20 61 20 31 36 4d 20 63  | produce a 16M c|
00002890  6f 6c 6f 75 72 20 69 6d  61 67 65 0a 0a 20 20 20  |olour image..   |
000028a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000028b0  20 2d 31 20 20 28 74 68  69 73 20 69 73 20 74 68  | -1  (this is th|
000028c0  65 20 67 6f 6f 64 20 6f  6e 65 29 20 69 74 20 75  |e good one) it u|
000028d0  73 65 73 20 74 68 65 20  63 75 72 72 65 6e 74 0a  |ses the current.|
000028e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000028f0  20 20 20 20 20 20 20 20  73 63 72 65 65 6e 20 64  |        screen d|
00002900  69 73 70 6c 61 79 20 74  6f 20 64 65 74 65 72 6d  |isplay to determ|
00002910  69 6e 65 20 77 68 65 74  68 65 72 20 69 74 0a 20  |ine whether it. |
00002920  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002930  20 20 20 20 20 20 20 77  69 6c 6c 20 70 72 6f 64  |       will prod|
00002940  75 63 65 20 61 20 32 2c  20 34 2c 20 31 36 2c 20  |uce a 2, 4, 16, |
00002950  32 35 36 2c 20 33 32 4b  2c 20 6f 72 20 31 36 4d  |256, 32K, or 16M|
00002960  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00002970  20 20 20 20 20 20 20 20  20 63 6f 6c 6f 75 72 20  |         colour |
00002980  69 6d 61 67 65 0a 20 20  20 20 20 20 20 20 20 20  |image.          |
00002990  20 20 20 20 20 20 20 20  20 20 20 20 20 20 61 6c  |              al|
000029a0  73 6f 2c 20 74 68 65 20  63 75 72 72 65 6e 74 20  |so, the current |
000029b0  73 63 72 65 65 6e 20 70  61 6c 65 74 74 65 20 69  |screen palette i|
000029c0  73 20 75 73 65 64 0a 0a  20 20 20 20 20 20 20 20  |s used..        |
000029d0  20 20 20 20 20 20 20 20  74 68 65 20 64 65 66 61  |        the defa|
000029e0  75 6c 74 20 76 61 6c 75  65 20 69 73 20 2d 31 0a  |ult value is -1.|
000029f0  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 5b  |..             [|
00002a00  2d 61 63 63 75 72 61 74  65 5d 0a 20 20 20 20 20  |-accurate].     |
00002a10  20 20 20 20 20 20 20 20  20 20 20 77 68 65 6e 20  |           when |
00002a20  67 65 6e 65 72 61 74 69  6e 67 20 61 20 32 35 36  |generating a 256|
00002a30  20 63 6f 6c 6f 75 72 20  69 6d 61 67 65 2c 20 74  | colour image, t|
00002a40  68 69 73 20 77 69 6c 6c  20 66 6f 72 63 65 0a 20  |his will force. |
00002a50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 74  |               t|
00002a60  68 65 20 75 73 65 20 6f  66 20 61 20 6d 6f 72 65  |he use of a more|
00002a70  20 61 63 63 75 72 61 74  65 20 63 6f 6c 6f 75 72  | accurate colour|
00002a80  20 6d 61 74 63 68 69 6e  67 0a 20 20 20 20 20 20  | matching.      |
00002a90  20 20 20 20 20 20 20 20  20 20 61 6c 67 6f 72 69  |          algori|
00002aa0  74 68 6d 20 74 68 61 74  20 72 75 6e 73 20 61 62  |thm that runs ab|
00002ab0  6f 75 74 20 33 2d 34 20  74 69 6d 65 73 20 73 6c  |out 3-4 times sl|
00002ac0  6f 77 65 72 0a 0a 0a 20  20 20 20 20 20 20 20 20  |ower...         |
00002ad0  20 20 20 20 5b 2d 66 6f  72 63 65 5f 36 36 5d 0a  |    [-force_66].|
00002ae0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002af0  77 68 65 6e 20 67 65 6e  65 72 61 74 69 6e 67 20  |when generating |
00002b00  61 20 33 32 4b 20 63 6f  6c 6f 75 72 20 69 6d 61  |a 32K colour ima|
00002b10  67 65 2c 20 74 68 69 73  20 77 69 6c 6c 20 66 6f  |ge, this will fo|
00002b20  72 63 65 0a 20 20 20 20  20 20 20 20 20 20 20 20  |rce.            |
00002b30  20 20 20 20 74 68 65 20  75 73 65 20 6f 66 20 72  |    the use of r|
00002b40  6f 75 74 69 6e 65 73 20  74 68 61 74 20 75 73 65  |outines that use|
00002b50  20 61 6e 20 69 6e 74 65  72 6e 61 6c 20 72 65 73  | an internal res|
00002b60  6f 6c 75 74 69 6f 6e 0a  20 20 20 20 20 20 20 20  |olution.        |
00002b70  20 20 20 20 20 20 20 20  6f 66 20 32 32 20 62 69  |        of 22 bi|
00002b80  74 73 20 70 65 72 20 72  65 64 2f 67 72 65 65 6e  |ts per red/green|
00002b90  2f 62 6c 75 65 2e 20 20  4e 6f 72 6d 61 6c 6c 79  |/blue.  Normally|
00002ba0  20 6f 6e 6c 79 20 31 36  0a 20 20 20 20 20 20 20  | only 16.       |
00002bb0  20 20 20 20 20 20 20 20  20 62 69 74 73 20 61 72  |         bits ar|
00002bc0  65 20 75 73 65 64 2e 20  20 54 68 65 73 65 20 36  |e used.  These 6|
00002bd0  36 20 62 69 74 20 72 6f  75 74 69 6e 65 73 20 61  |6 bit routines a|
00002be0  72 65 20 73 6c 6f 77 65  72 0a 0a 0a 20 20 20 20  |re slower...    |
00002bf0  20 20 20 20 20 20 20 20  20 5b 2d 73 71 75 61 72  |         [-squar|
00002c00  65 5d 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |e].             |
00002c10  20 20 20 61 20 47 49 46  20 66 69 6c 65 20 63 61  |   a GIF file ca|
00002c20  6e 20 73 70 65 63 69 66  79 20 61 6e 20 61 73 70  |n specify an asp|
00002c30  65 63 74 20 72 61 74 69  6f 20 66 6f 72 20 61 6e  |ect ratio for an|
00002c40  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00002c50  20 69 6d 61 67 65 2e 20  20 49 66 20 61 20 33 32  | image.  If a 32|
00002c60  4b 20 6f 72 20 31 36 4d  20 63 6f 6c 6f 75 72 20  |K or 16M colour |
00002c70  69 6d 61 67 65 20 69 73  20 70 72 6f 64 75 63 65  |image is produce|
00002c80  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
00002c90  20 20 74 68 65 6e 2c 20  62 79 20 64 65 66 61 75  |  then, by defau|
00002ca0  6c 74 2c 20 74 68 69 73  20 61 73 70 65 63 74 20  |lt, this aspect |
00002cb0  72 61 74 69 6f 20 69 6e  66 6f 72 6d 61 74 69 6f  |ratio informatio|
00002cc0  6e 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |n.              |
00002cd0  20 20 69 73 20 65 6d 62  65 64 64 65 64 20 69 6e  |  is embedded in|
00002ce0  20 74 68 65 20 73 70 72  69 74 65 2e 20 20 46 6f  | the sprite.  Fo|
00002cf0  72 20 3c 3d 20 32 35 36  20 63 6f 6c 6f 75 72 0a  |r <= 256 colour.|
00002d00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002d10  69 6d 61 67 65 73 20 69  74 20 69 73 20 6e 6f 74  |images it is not|
00002d20  20 70 6f 73 73 69 62 6c  65 20 66 6f 72 20 52 49  | possible for RI|
00002d30  53 43 20 4f 20 53 20 74  6f 20 62 65 20 74 6f 6c  |SC O S to be tol|
00002d40  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
00002d50  20 20 6f 66 20 74 68 65  20 61 73 70 65 63 74 20  |  of the aspect |
00002d60  72 61 74 69 6f 2e 20 20  55 73 69 6e 67 20 74 68  |ratio.  Using th|
00002d70  69 73 20 73 77 69 74 63  68 20 77 69 6c 6c 0a 20  |is switch will. |
00002d80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 64  |               d|
00002d90  69 73 61 62 6c 65 20 65  6d 62 65 64 64 69 6e 67  |isable embedding|
00002da0  20 74 68 69 73 20 61 73  70 65 63 74 20 72 61 74  | this aspect rat|
00002db0  69 6f 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 0a 0a  |io information..|
00002dc0  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00002dd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002de0  20 20 20 20 50 61 67 65  20 20 20 35 0a 0c 0a 20  |    Page   5... |
00002df0  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00002e30  20 67 69 66 32 72 70 63  20 3d 3d 3d 3d 0a 0a 0a  | gif2rpc ====...|
00002e40  20 20 20 20 20 20 20 20  0a 20 20 20 20 20 20 20  |        .       |
00002e50  20 20 20 20 20 20 5b 2d  61 75 74 6f 6e 61 6d 65  |      [-autoname|
00002e60  5d 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |].              |
00002e70  20 20 74 68 65 20 73 70  72 69 74 65 20 69 6e 20  |  the sprite in |
00002e80  74 68 65 20 73 70 72 69  74 65 66 69 6c 65 20 63  |the spritefile c|
00002e90  61 6e 20 62 65 20 67 69  76 65 20 61 20 6e 61 6d  |an be give a nam|
00002ea0  65 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |e.              |
00002eb0  20 20 64 65 72 69 76 65  64 20 66 72 6f 6d 20 74  |  derived from t|
00002ec0  68 65 20 69 6e 70 75 74  20 47 49 46 20 66 69 6c  |he input GIF fil|
00002ed0  65 20 77 69 74 68 20 74  68 69 73 20 6f 70 74 69  |e with this opti|
00002ee0  6f 6e 0a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |on...           |
00002ef0  20 20 5b 73 74 61 74 73  5d 0a 20 20 20 20 20 20  |  [stats].      |
00002f00  20 20 20 20 20 20 20 20  20 20 74 68 69 73 20 77  |          this w|
00002f10  69 6c 6c 20 6f 75 74 70  75 74 20 61 20 73 69 6e  |ill output a sin|
00002f20  67 6c 65 20 74 65 78 74  20 6c 69 6e 65 20 74 6f  |gle text line to|
00002f30  20 73 68 6f 77 20 68 6f  77 0a 20 20 20 20 20 20  | show how.      |
00002f40  20 20 20 20 20 20 20 20  20 20 77 65 6c 6c 20 28  |          well (|
00002f50  69 6e 20 74 65 72 6d 73  20 6f 66 20 73 69 7a 65  |in terms of size|
00002f60  29 20 74 68 65 20 63 6f  6e 76 65 72 73 69 6f 6e  |) the conversion|
00002f70  20 64 6f 6e 65 2c 0a 20  20 20 20 20 20 20 20 20  | done,.         |
00002f80  20 20 20 20 20 20 20 72  65 6c 61 74 69 76 65 20  |       relative |
00002f90  74 6f 20 6b 65 65 70 69  6e 67 20 74 68 65 20 32  |to keeping the 2|
00002fa0  35 36 20 63 6f 6c 6f 75  72 20 69 6d 61 67 65 0a  |56 colour image.|
00002fb0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00002fc0  20 54 68 65 20 66 69 65  6c 64 73 20 61 72 65 0a  | The fields are.|
00002fd0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00002fe0  20 20 20 20 20 20 20 20  22 67 69 66 32 72 70 63  |        "gif2rpc|
00002ff0  20 22 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  | ".             |
00003000  20 20 20 20 20 20 20 20  20 20 20 22 25 73 22 20  |           "%s" |
00003010  20 20 20 69 6e 70 75 74  20 66 69 6c 65 20 6e 61  |   input file na|
00003020  6d 65 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |me.             |
00003030  20 20 20 20 20 20 20 20  20 20 20 22 28 22 0a 20  |           "(". |
00003040  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003050  20 20 20 20 20 20 20 22  25 34 64 22 20 20 20 68  |       "%4d"   h|
00003060  6f 72 69 7a 6f 6e 74 61  6c 20 70 69 78 65 6c 20  |orizontal pixel |
00003070  73 69 7a 65 0a 20 20 20  20 20 20 20 20 20 20 20  |size.           |
00003080  20 20 20 20 20 20 20 20  20 20 20 20 20 22 78 22  |             "x"|
00003090  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000030a0  20 20 20 20 20 20 20 20  20 22 25 34 64 22 20 20  |         "%4d"  |
000030b0  20 76 65 72 74 69 63 61  6c 20 70 69 78 65 6c 20  | vertical pixel |
000030c0  73 69 7a 65 0a 20 20 20  20 20 20 20 20 20 20 20  |size.           |
000030d0  20 20 20 20 20 20 20 20  20 20 20 20 20 22 3a 22  |             ":"|
000030e0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000030f0  20 20 20 20 20 20 20 20  20 22 25 64 22 20 20 20  |         "%d"   |
00003100  20 69 6e 70 75 74 20 62  69 74 73 20 70 65 72 20  | input bits per |
00003110  70 69 78 65 6c 0a 20 20  20 20 20 20 20 20 20 20  |pixel.          |
00003120  20 20 20 20 20 20 20 20  20 20 20 20 20 20 22 70  |              "p|
00003130  22 20 20 20 20 20 5b 69  66 20 70 61 6c 65 74 74  |"     [if palett|
00003140  65 20 69 6e 20 73 63 72  65 65 6e 5d 0a 20 20 20  |e in screen].   |
00003150  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003160  20 20 20 20 20 22 73 22  20 20 20 20 20 5b 69 66  |     "s"     [if|
00003170  20 70 61 6c 65 74 74 65  20 69 73 20 73 6f 72 74  | palette is sort|
00003180  65 64 5d 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ed].            |
00003190  20 20 20 20 20 20 20 20  20 20 20 20 22 2e 22 0a  |            ".".|
000031a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000031b0  20 20 20 20 20 20 20 20  22 69 22 20 20 20 20 20  |        "i"     |
000031c0  5b 69 66 20 69 6e 74 65  72 6c 61 63 65 64 5d 0a  |[if interlaced].|
000031d0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000031e0  20 20 20 20 20 20 20 20  22 70 22 20 20 20 20 20  |        "p"     |
000031f0  5b 69 66 20 70 61 6c 65  74 74 65 20 69 6e 20 69  |[if palette in i|
00003200  6d 61 67 65 5d 0a 20 20  20 20 20 20 20 20 20 20  |mage].          |
00003210  20 20 20 20 20 20 20 20  20 20 20 20 20 20 22 73  |              "s|
00003220  22 20 20 20 20 20 5b 69  66 20 70 61 6c 65 74 74  |"     [if palett|
00003230  65 20 69 73 20 73 6f 72  74 65 64 5d 0a 20 20 20  |e is sorted].   |
00003240  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003250  20 20 20 20 20 22 74 22  20 20 20 20 20 5b 69 66  |     "t"     [if|
00003260  20 74 72 61 6e 73 70 61  72 65 6e 74 5d 0a 20 20  | transparent].  |
00003270  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003280  20 20 20 20 20 20 22 29  20 2d 3e 20 22 0a 20 20  |      ") -> ".  |
00003290  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000032a0  20 20 20 20 20 20 22 25  73 22 20 20 20 20 6f 75  |      "%s"    ou|
000032b0  74 70 75 74 20 66 69 6c  65 20 6e 61 6d 65 0a 20  |tput file name. |
000032c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000032d0  20 20 20 20 20 20 20 22  28 22 0a 20 20 20 20 20  |       "(".     |
000032e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000032f0  20 20 20 22 25 73 22 20  20 20 20 6f 75 74 70 75  |   "%s"    outpu|
00003300  74 20 63 6f 6c 6f 75 72  73 0a 20 20 20 20 20 20  |t colours.      |
00003310  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003320  20 20 22 29 20 22 0a 20  20 20 20 20 20 20 20 20  |  ") ".         |
00003330  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 22  |               "|
00003340  25 64 22 20 20 20 20 6f  75 74 70 75 74 20 73 69  |%d"    output si|
00003350  7a 65 20 2d 20 67 69 66  32 72 70 63 20 6f 75 74  |ze - gif2rpc out|
00003360  70 75 74 20 73 69 7a 65  0a 20 20 20 20 20 20 20  |put size.       |
00003370  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003380  20 22 20 22 0a 20 20 20  20 20 20 20 20 20 20 20  | " ".           |
00003390  20 20 20 20 20 20 20 20  20 20 20 20 20 22 25 66  |             "%f|
000033a0  22 20 20 20 20 74 6f 74  61 6c 20 64 75 72 61 74  |"    total durat|
000033b0  69 6f 6e 2c 20 69 6e 20  73 65 63 6f 6e 64 73 0a  |ion, in seconds.|
000033c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000033d0  20 20 20 20 20 20 20 20  22 20 22 0a 20 20 20 20  |        " ".    |
000033e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000033f0  20 20 20 20 22 25 66 22  20 20 20 20 70 65 72 63  |    "%f"    perc|
00003400  65 6e 74 61 67 65 20 74  69 6d 65 20 73 70 65 6e  |entage time spen|
00003410  74 20 66 69 6c 74 65 72  69 6e 67 0a 20 20 20 20  |t filtering.    |
00003420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003430  20 20 20 20 22 20 22 0a  20 20 20 20 20 20 20 20  |    " ".        |
00003440  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003450  22 25 73 22 20 20 20 20  66 69 6c 74 65 72 20 75  |"%s"    filter u|
00003460  73 65 64 0a 0a 0a 20 20  20 20 20 20 20 20 20 20  |sed...          |
00003470  20 20 20 5b 2d 6c 6f 67  20 3c 66 69 6c 65 3e 5d  |   [-log <file>]|
00003480  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00003490  20 69 66 20 70 72 65 73  65 6e 74 2c 20 74 68 69  | if present, thi|
000034a0  73 20 6f 76 65 72 72 69  64 65 73 20 61 6e 79 20  |s overrides any |
000034b0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 72 65 2d  |command line re-|
000034c0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000034d0  20 64 69 72 65 63 74 69  6f 6e 20 6f 66 20 73 74  | direction of st|
000034e0  64 6f 75 74 20 61 6e 64  20 73 74 64 65 72 72 0a  |dout and stderr.|
000034f0  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 5b  |..             [|
00003500  2d 66 75 73 73 79 5d 0a  20 20 20 20 20 20 20 20  |-fussy].        |
00003510  20 20 20 20 20 20 20 20  62 79 20 64 65 66 61 75  |        by defau|
00003520  6c 74 20 67 69 66 32 72  70 63 20 77 69 6c 6c 20  |lt gif2rpc will |
00003530  61 6c 6c 6f 77 20 73 65  76 65 72 61 6c 20 6d 69  |allow several mi|
00003540  73 74 61 6b 65 73 20 69  6e 0a 20 20 20 20 20 20  |stakes in.      |
00003550  20 20 20 20 20 20 20 20  20 20 61 20 47 49 46 20  |          a GIF |
00003560  66 69 6c 65 2c 20 61 6e  64 20 73 69 6c 65 6e 74  |file, and silent|
00003570  6c 79 20 28 69 66 20 2d  71 75 69 65 74 29 20 69  |ly (if -quiet) i|
00003580  67 6e 6f 72 65 20 74 68  65 6d 2e 0a 20 20 20 20  |gnore them..    |
00003590  20 20 20 20 20 20 20 20  20 20 20 20 57 69 74 68  |            With|
000035a0  20 2d 66 75 73 73 79 2c  20 74 68 65 73 65 20 65  | -fussy, these e|
000035b0  72 72 6f 72 73 20 77 69  6c 6c 20 63 61 75 73 65  |rrors will cause|
000035c0  20 63 6f 6e 76 65 72 73  69 6f 6e 0a 20 20 20 20  | conversion.    |
000035d0  20 20 20 20 20 20 20 20  20 20 20 20 74 6f 20 66  |            to f|
000035e0  61 69 6c 2c 20 61 6e 64  20 6e 6f 20 73 70 72 69  |ail, and no spri|
000035f0  74 65 20 74 6f 20 62 65  20 70 72 6f 64 75 63 65  |te to be produce|
00003600  64 0a 0a 0a 0a 0a 0a 0a  0a 0a 20 20 20 20 20 20  |d.........      |
00003610  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003620  20 20 20 20 20 20 20 20  20 20 20 20 50 61 67 65  |            Page|
00003630  20 20 20 36 0a 0c 0a 20  3d 3d 3d 3d 3d 3d 3d 3d  |   6... ========|
00003640  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00003670  3d 3d 3d 3d 3d 3d 3d 3d  20 67 69 66 32 72 70 63  |======== gif2rpc|
00003680  20 3d 3d 3d 3d 0a 0a 0a  0a 20 20 20 20 20 20 20  | ====....       |
00003690  20 20 20 20 20 20 5b 2d  66 69 6c 74 65 72 20 3c  |      [-filter <|
000036a0  6e 61 6d 65 3e 5d 0a 20  20 20 20 20 20 20 20 20  |name>].         |
000036b0  20 20 20 20 20 20 20 49  66 20 2d 62 70 70 20 69  |       If -bpp i|
000036c0  73 20 6e 6f 74 20 30 20  74 68 65 6e 20 67 69 66  |s not 0 then gif|
000036d0  32 72 70 63 20 77 69 6c  6c 20 70 72 6f 63 65 73  |2rpc will proces|
000036e0  73 20 74 68 65 0a 20 20  20 20 20 20 20 20 20 20  |s the.          |
000036f0  20 20 20 20 20 20 69 6d  61 67 65 20 74 6f 20 70  |      image to p|
00003700  72 6f 64 75 63 65 20 61  20 73 70 72 69 74 65 2e  |roduce a sprite.|
00003710  20 20 54 68 65 73 65 20  61 72 65 20 74 68 65 0a  |  These are the.|
00003720  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003730  61 6c 67 6f 72 69 74 68  6d 73 20 69 74 20 77 69  |algorithms it wi|
00003740  6c 6c 20 75 73 65 20 28  74 68 65 73 65 20 61 72  |ll use (these ar|
00003750  65 20 6c 69 73 74 65 64  20 66 61 73 74 65 73 74  |e listed fastest|
00003760  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00003770  20 74 6f 20 73 6c 6f 77  65 73 74 29 0a 0a 20 20  | to slowest)..  |
00003780  20 20 20 20 20 20 20 20  20 20 20 20 20 20 6e 65  |              ne|
00003790  61 72 65 73 74 3a 0a 20  20 20 20 20 20 20 20 20  |arest:.         |
000037a0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 79  |               y|
000037b0  6f 75 20 64 6f 20 2a 6e  6f 74 2a 20 77 61 6e 74  |ou do *not* want|
000037c0  20 74 68 69 73 2e 20 20  49 74 20 69 73 20 63 72  | this.  It is cr|
000037d0  61 70 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ap..            |
000037e0  20 20 20 20 64 69 74 68  65 72 32 78 32 3a 0a 20  |    dither2x2:. |
000037f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003800  20 20 20 20 20 20 20 73  74 72 6f 6e 67 6c 79 20  |       strongly |
00003810  72 65 63 6f 6d 6d 65 6e  64 65 64 2e 20 20 49 74  |recommended.  It|
00003820  20 69 73 20 6f 6e 6c 79  20 73 6c 69 67 68 74 6c  | is only slightl|
00003830  79 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |y.              |
00003840  20 20 20 20 20 20 20 20  20 20 73 6c 6f 77 65 72  |          slower|
00003850  20 74 68 61 6e 20 6e 65  61 72 65 73 74 2c 20 61  | than nearest, a|
00003860  6e 64 20 70 72 6f 64 75  63 65 73 20 67 6f 6f 64  |nd produces good|
00003870  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00003880  20 20 20 20 20 20 20 20  20 69 6d 61 67 65 73 20  |         images |
00003890  28 69 66 20 3e 3d 20 32  35 36 20 63 6f 6c 6f 75  |(if >= 256 colou|
000038a0  72 73 29 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |rs)..           |
000038b0  20 20 20 20 20 73 69 65  72 72 61 32 5f 34 61 3a  |     sierra2_4a:|
000038c0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000038d0  20 20 20 20 20 20 20 20  20 76 65 72 79 20 67 6f  |         very go|
000038e0  6f 64 2c 20 76 65 72 79  20 66 61 73 74 2e 20 20  |od, very fast.  |
000038f0  50 65 72 73 6f 6e 61 6c  6c 79 2c 20 49 20 74 68  |Personally, I th|
00003900  69 6e 6b 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ink.            |
00003910  20 20 20 20 20 20 20 20  20 20 20 20 69 74 20 6c  |            it l|
00003920  6f 6f 6b 73 20 62 65 74  74 65 72 20 74 68 61 6e  |ooks better than|
00003930  20 66 6c 6f 79 64 2d 73  74 65 69 6e 62 65 72 67  | floyd-steinberg|
00003940  0a 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
00003950  20 20 66 6c 6f 79 64 5f  73 74 65 69 6e 62 65 72  |  floyd_steinber|
00003960  67 3a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |g:.             |
00003970  20 20 20 20 20 20 20 20  20 20 20 61 73 20 75 73  |           as us|
00003980  65 64 20 62 79 20 43 68  61 6e 67 65 46 53 49 2e  |ed by ChangeFSI.|
00003990  20 20 41 6e 20 6f 6c 64  20 66 61 76 6f 75 72 69  |  An old favouri|
000039a0  74 65 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |te..            |
000039b0  20 20 20 20 62 75 72 6b  65 73 3a 0a 20 20 20 20  |    burkes:.    |
000039c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000039d0  20 20 20 20 61 20 32 2d  6c 69 6e 65 20 66 69 6c  |    a 2-line fil|
000039e0  74 65 72 20 61 73 20 70  65 72 20 66 6c 6f 79 64  |ter as per floyd|
000039f0  5f 73 74 65 69 6e 62 65  72 67 2c 0a 20 20 20 20  |_steinberg,.    |
00003a00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003a10  20 20 20 20 77 68 65 72  65 20 74 68 65 20 63 6f  |    where the co|
00003a20  65 66 66 69 63 69 65 6e  74 73 20 61 72 65 20 71  |efficients are q|
00003a30  75 69 63 6b 20 74 6f 0a  20 20 20 20 20 20 20 20  |uick to.        |
00003a40  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003a50  63 61 6c 63 75 6c 61 74  65 0a 0a 20 20 20 20 20  |calculate..     |
00003a60  20 20 20 20 20 20 20 20  20 20 20 73 69 65 72 72  |           sierr|
00003a70  61 32 3a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |a2:.            |
00003a80  20 20 20 20 20 20 20 20  20 20 20 20 76 65 72 79  |            very|
00003a90  20 73 69 6d 69 6c 61 72  20 74 6f 20 62 75 72 6b  | similar to burk|
00003aa0  65 73 2c 20 62 75 74 20  70 6f 6f 72 20 71 75 61  |es, but poor qua|
00003ab0  6c 69 74 79 0a 0a 20 20  20 20 20 20 20 20 20 20  |lity..          |
00003ac0  20 20 20 20 20 20 73 69  65 72 72 61 33 3a 0a 20  |      sierra3:. |
00003ad0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003ae0  20 20 20 20 20 20 20 61  20 33 2d 6c 69 6e 65 20  |       a 3-line |
00003af0  66 69 6c 74 65 72 0a 0a  20 20 20 20 20 20 20 20  |filter..        |
00003b00  20 20 20 20 20 20 20 20  73 74 75 63 6b 69 3a 0a  |        stucki:.|
00003b10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003b20  20 20 20 20 20 20 20 20  61 6e 6f 74 68 65 72 20  |        another |
00003b30  33 2d 6c 69 6e 65 20 66  69 6c 74 65 72 2c 20 62  |3-line filter, b|
00003b40  75 74 20 73 6c 6f 77 20  74 6f 0a 20 20 20 20 20  |ut slow to.     |
00003b50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003b60  20 20 20 63 61 6c 63 75  6c 61 74 65 0a 0a 20 20  |   calculate..  |
00003b70  20 20 20 20 20 20 20 20  20 20 20 20 20 20 6a 61  |              ja|
00003b80  72 76 69 73 5f 6a 75 64  69 63 65 5f 6e 69 6e 6b  |rvis_judice_nink|
00003b90  65 3a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |e:.             |
00003ba0  20 20 20 20 20 20 20 20  20 20 20 61 20 33 2d 6c  |           a 3-l|
00003bb0  69 6e 65 20 66 69 6c 74  65 72 20 77 68 69 63 68  |ine filter which|
00003bc0  20 69 73 20 76 65 72 79  20 73 6c 6f 77 20 28 32  | is very slow (2|
00003bd0  32 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |2.              |
00003be0  20 20 20 20 20 20 20 20  20 20 74 69 6d 65 73 20  |          times |
00003bf0  73 6c 6f 77 65 72 20 74  68 61 6e 20 64 69 74 68  |slower than dith|
00003c00  65 72 32 78 32 29 2e 20  20 49 74 20 69 73 0a 20  |er2x2).  It is. |
00003c10  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003c20  20 20 20 20 20 20 20 71  75 65 73 74 69 6f 6e 61  |       questiona|
00003c30  62 6c 65 20 77 68 65 74  68 65 72 20 69 74 20 70  |ble whether it p|
00003c40  72 6f 64 75 63 65 73 20  62 65 74 74 65 72 0a 20  |roduces better. |
00003c50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003c60  20 20 20 20 20 20 20 6f  75 74 70 75 74 0a 0a 0a  |       output...|
00003c70  0a 20 20 20 20 20 20 20  20 4e 6f 74 65 20 74 68  |.        Note th|
00003c80  61 74 20 79 6f 75 20 63  61 6e 20 2a 6e 6f 74 2a  |at you can *not*|
00003c90  20 75 73 65 20 73 68 6f  72 74 63 75 74 73 20 66  | use shortcuts f|
00003ca0  6f 72 20 74 68 65 20 73  77 69 74 63 68 65 73 20  |or the switches |
00003cb0  28 69 65 0a 20 20 20 20  20 20 20 20 2d 76 20 69  |(ie.        -v i|
00003cc0  73 20 6e 6f 74 20 61 63  63 65 70 74 61 62 6c 65  |s not acceptable|
00003cd0  2c 20 75 73 65 20 2d 76  65 72 62 6f 73 65 29 2e  |, use -verbose).|
00003ce0  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 20 20 20  |.............   |
00003cf0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00003d00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 50  |               P|
00003d10  61 67 65 20 20 20 37 0a  0c 0a 20 3d 3d 3d 3d 3d  |age   7... =====|
00003d20  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00003d50  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 20 67 69 66 32  |=========== gif2|
00003d60  72 70 63 20 3d 3d 3d 3d  0a 0a 0a 0a 20 5b 32 2e  |rpc ====.... [2.|
00003d70  34 5d 20 44 65 66 61 75  6c 74 20 6f 70 74 69 6f  |4] Default optio|
00003d80  6e 73 3a 20 67 69 66 32  72 70 63 24 6f 70 74 69  |ns: gif2rpc$opti|
00003d90  6f 6e 73 0a 0a 20 20 20  20 20 20 20 20 49 66 20  |ons..        If |
00003da0  74 68 65 20 73 79 73 74  65 6d 20 76 61 72 69 61  |the system varia|
00003db0  62 6c 65 20 94 67 69 66  32 72 70 63 24 4f 70 74  |ble .gif2rpc$Opt|
00003dc0  69 6f 6e 73 95 20 69 73  20 64 65 66 69 6e 65 64  |ions. is defined|
00003dd0  2c 20 74 68 65 6e 0a 20  20 20 20 20 20 20 20 69  |, then.        i|
00003de0  74 20 77 69 6c 6c 20 62  65 20 61 70 70 65 6e 64  |t will be append|
00003df0  65 64 20 74 6f 20 61 6e  79 20 70 61 72 61 6d 65  |ed to any parame|
00003e00  74 65 72 73 20 67 69 76  65 6e 20 6f 6e 20 74 68  |ters given on th|
00003e10  65 20 63 6f 6d 6d 61 6e  64 0a 20 20 20 20 20 20  |e command.      |
00003e20  20 20 6c 69 6e 65 2e 0a  0a 20 20 20 20 20 20 20  |  line...       |
00003e30  20 54 68 69 73 20 69 73  20 70 61 72 74 69 63 75  | This is particu|
00003e40  6c 61 72 6c 79 20 75 73  65 66 75 6c 20 77 68 65  |larly useful whe|
00003e50  6e 20 75 73 69 6e 67 20  74 68 65 20 6c 6f 67 67  |n using the logg|
00003e60  69 6e 67 0a 20 20 20 20  20 20 20 20 66 61 63 69  |ing.        faci|
00003e70  6c 69 74 69 65 73 20 6f  66 20 74 68 65 20 70 72  |lities of the pr|
00003e80  6f 67 72 61 6d 2e 20 20  46 6f 72 20 65 78 61 6d  |ogram.  For exam|
00003e90  70 6c 65 2c 20 75 73 69  6e 67 0a 0a 20 20 20 20  |ple, using..    |
00003ea0  20 20 20 20 20 20 20 20  20 20 20 20 2a 53 65 74  |            *Set|
00003eb0  20 67 69 66 32 72 70 63  24 4f 70 74 69 6f 6e 73  | gif2rpc$Options|
00003ec0  20 2d 73 74 61 74 73 20  2d 6c 6f 67 20 24 2e 6c  | -stats -log $.l|
00003ed0  6f 67 0a 0a 20 20 20 20  20 20 20 20 77 69 6c 6c  |og..        will|
00003ee0  20 63 61 75 73 65 20 61  6c 6c 20 63 61 6c 6c 73  | cause all calls|
00003ef0  20 74 6f 20 67 69 66 32  72 70 63 20 74 6f 20 61  | to gif2rpc to a|
00003f00  70 70 65 6e 64 20 73 74  61 74 69 73 74 69 63 73  |ppend statistics|
00003f10  0a 20 20 20 20 20 20 20  20 69 6e 66 6f 72 6d 61  |.        informa|
00003f20  74 69 6f 6e 20 74 6f 20  74 68 65 20 66 69 6c 65  |tion to the file|
00003f30  20 94 24 2e 6c 6f 67 95  2e 0a 0a 0a 0a 20 20 32  | .$.log......  2|
00003f40  2e 35 20 54 79 70 69 63  61 6c 20 75 73 61 67 65  |.5 Typical usage|
00003f50  0a 0a 0a 20 20 20 20 20  20 20 20 46 6f 72 20 6e  |...        For n|
00003f60  6f 2d 68 61 73 73 6c 65  20 75 73 61 67 65 20 75  |o-hassle usage u|
00003f70  73 65 3a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |se:..           |
00003f80  20 20 20 20 20 67 69 66  32 72 70 63 20 2d 71 75  |     gif2rpc -qu|
00003f90  69 65 74 20 67 69 66 20  73 70 72 69 74 65 0a 0a  |iet gif sprite..|
00003fa0  0a 20 20 20 20 20 20 20  20 46 6f 72 20 73 6f 6d  |.        For som|
00003fb0  65 20 72 65 61 73 6f 6e  61 62 6c 65 20 69 6e 66  |e reasonable inf|
00003fc0  6f 72 6d 61 74 69 6f 6e  20 74 68 65 6e 20 75 73  |ormation then us|
00003fd0  65 20 73 6f 6d 65 74 68  69 6e 67 20 6c 69 6b 65  |e something like|
00003fe0  3a 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |:..             |
00003ff0  20 20 20 67 69 66 32 72  70 63 20 2d 73 74 61 74  |   gif2rpc -stat|
00004000  73 20 2d 6c 6f 67 20 24  2e 6c 6f 67 20 67 69 66  |s -log $.log gif|
00004010  20 73 70 72 69 74 65 0a  0a 20 20 20 20 20 20 20  | sprite..       |
00004020  20 61 6e 64 20 74 68 65  20 6c 6f 67 20 66 69 6c  | and the log fil|
00004030  65 20 77 69 6c 6c 20 62  65 20 61 70 70 65 6e 64  |e will be append|
00004040  65 64 20 77 69 74 68 20  61 6e 79 20 65 72 72 6f  |ed with any erro|
00004050  72 73 2c 20 61 6e 64 20  61 0a 20 20 20 20 20 20  |rs, and a.      |
00004060  20 20 73 69 6e 67 6c 65  20 6c 69 6e 65 20 67 69  |  single line gi|
00004070  76 69 6e 67 20 73 6f 6d  65 20 73 74 61 74 69 73  |ving some statis|
00004080  74 69 63 73 20 6f 66 20  74 68 65 20 63 6f 6e 76  |tics of the conv|
00004090  65 72 73 69 6f 6e 0a 0a  0a 20 20 20 20 20 20 20  |ersion...       |
000040a0  20 46 6f 72 20 94 70 72  6f 62 6c 65 6d 95 20 67  | For .problem. g|
000040b0  69 66 27 73 20 75 73 65  3a 0a 0a 20 20 20 20 20  |if's use:..     |
000040c0  20 20 20 20 20 20 20 20  20 20 20 67 69 66 32 72  |           gif2r|
000040d0  70 63 20 2d 76 65 72 62  6f 73 65 20 32 20 2d 66  |pc -verbose 2 -f|
000040e0  75 73 73 79 20 67 69 66  20 73 70 72 69 74 65 0a  |ussy gif sprite.|
000040f0  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
00004100  0a 0a 0a 0a 0a 0a 0a 20  20 20 20 20 20 20 20 20  |.......         |
00004110  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004120  20 20 20 20 20 20 20 20  20 50 61 67 65 20 20 20  |         Page   |
00004130  38 0a 0c 0a 20 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |8... ===========|
00004140  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00004170  3d 3d 3d 3d 3d 20 67 69  66 32 72 70 63 20 3d 3d  |===== gif2rpc ==|
00004180  3d 3d 0a 20 20 20 20 20  20 20 20 0a 20 20 20 20  |==.        .    |
00004190  20 20 20 20 0a 20 20 20  20 20 20 20 20 0a 20 5b  |    .        . [|
000041a0  33 5d 20 4f 75 74 70 75  74 20 69 6d 61 67 65 20  |3] Output image |
000041b0  66 6f 72 6d 61 74 0a 0a  0a 20 20 20 20 20 20 20  |format...       |
000041c0  20 59 6f 75 20 6d 61 79  20 74 68 69 6e 6b 20 74  | You may think t|
000041d0  68 61 74 20 2d 62 70 70  20 30 20 69 73 20 74 68  |hat -bpp 0 is th|
000041e0  65 20 62 65 73 74 20 6f  70 74 69 6f 6e 2c 20 61  |e best option, a|
000041f0  73 20 74 68 69 73 20 77  69 6c 6c 0a 20 20 20 20  |s this will.    |
00004200  20 20 20 20 67 65 6e 65  72 61 74 65 20 61 20 73  |    generate a s|
00004210  70 72 69 74 65 20 74 68  61 74 20 63 6f 6e 74 61  |prite that conta|
00004220  69 6e 73 20 61 6c 6c 20  74 68 65 20 69 6e 66 6f  |ins all the info|
00004230  72 6d 61 74 69 6f 6e 20  69 6e 20 74 68 65 0a 20  |rmation in the. |
00004240  20 20 20 20 20 20 20 6f  72 69 67 69 6e 61 6c 20  |       original |
00004250  47 49 46 2e 0a 0a 20 20  20 20 20 20 20 20 42 75  |GIF...        Bu|
00004260  74 20 77 68 65 6e 20 79  6f 75 20 63 6f 6d 65 20  |t when you come |
00004270  74 6f 20 64 69 73 70 6c  61 79 20 74 68 61 74 20  |to display that |
00004280  47 49 46 2c 20 74 68 65  20 4f 53 20 68 61 73 20  |GIF, the OS has |
00004290  71 75 69 74 65 20 61 0a  20 20 20 20 20 20 20 20  |quite a.        |
000042a0  62 69 74 20 6f 66 20 77  6f 72 6b 20 74 6f 20 64  |bit of work to d|
000042b0  6f 20 62 65 66 6f 72 65  20 69 74 20 63 61 6e 20  |o before it can |
000042c0  70 6c 6f 6e 6b 20 74 68  65 20 64 61 74 61 20 6f  |plonk the data o|
000042d0  6e 20 74 68 65 0a 20 20  20 20 20 20 20 20 73 63  |n the.        sc|
000042e0  72 65 65 6e 2e 20 20 54  68 65 20 6d 69 72 69 61  |reen.  The miria|
000042f0  64 20 6f 66 20 6f 70 74  69 6f 6e 73 20 70 72 6f  |d of options pro|
00004300  76 69 64 65 64 20 62 79  20 67 69 66 32 72 70 63  |vided by gif2rpc|
00004310  20 61 72 65 0a 20 20 20  20 20 20 20 20 74 68 65  | are.        the|
00004320  72 65 20 74 6f 20 64 6f  20 61 20 6c 6f 74 20 6f  |re to do a lot o|
00004330  66 20 74 68 69 73 20 77  6f 72 6b 20 6f 6e 63 65  |f this work once|
00004340  2c 20 61 6e 64 20 6e 6f  74 20 65 76 65 72 79 20  |, and not every |
00004350  74 69 6d 65 0a 20 20 20  20 20 20 20 20 74 68 65  |time.        the|
00004360  20 47 49 46 20 69 73 20  64 69 73 70 6c 61 79 65  | GIF is displaye|
00004370  64 2e 0a 0a 20 20 20 20  20 20 20 20 54 68 65 20  |d...        The |
00004380  6d 61 69 6e 20 70 72 6f  63 65 73 73 69 6e 67 20  |main processing |
00004390  74 68 61 74 20 67 69 66  32 72 70 63 20 64 6f 65  |that gif2rpc doe|
000043a0  73 20 69 73 20 74 6f 20  72 65 6d 6f 76 65 20 61  |s is to remove a|
000043b0  6e 79 0a 20 20 20 20 20  20 20 20 65 78 70 6c 69  |ny.        expli|
000043c0  63 69 74 20 70 61 6c 65  74 74 65 20 69 6e 66 6f  |cit palette info|
000043d0  72 6d 61 74 69 6f 6e 2c  20 61 6e 64 20 61 6c 74  |rmation, and alt|
000043e0  65 72 20 74 68 65 20 69  6d 61 67 65 20 73 6f 20  |er the image so |
000043f0  74 68 61 74 0a 20 20 20  20 20 20 20 20 61 20 64  |that.        a d|
00004400  65 66 61 75 6c 74 20 28  52 49 53 43 20 4f 20 53  |efault (RISC O S|
00004410  29 20 70 61 6c 65 74 74  65 20 69 73 20 75 73 65  |) palette is use|
00004420  64 2e 20 20 54 68 69 73  20 75 73 75 61 6c 6c 79  |d.  This usually|
00004430  20 73 61 76 65 73 0a 20  20 20 20 20 20 20 20 32  | saves.        2|
00004440  4b 20 70 65 72 20 69 6d  61 67 65 3a 0a 0a 20 20  |K per image:..  |
00004450  20 20 20 20 20 20 20 20  20 20 20 20 20 20 53 69  |              Si|
00004460  7a 65 20 20 20 20 20 20  6e 6f 6e 65 20 20 20 20  |ze      none    |
00004470  20 20 20 20 20 33 32 4b  20 69 6d 61 67 65 20 20  |     32K image  |
00004480  20 20 31 36 4d 20 69 6d  61 67 65 0a 20 20 20 20  |  16M image.    |
00004490  20 20 20 20 20 20 20 20  20 20 20 20 38 78 38 20  |            8x8 |
000044a0  20 20 20 20 20 20 32 31  36 38 20 20 20 20 20 20  |      2168      |
000044b0  20 20 20 20 20 20 31 38  34 20 20 20 20 20 20 20  |      184       |
000044c0  20 20 20 33 31 32 0a 20  20 20 20 20 20 20 20 20  |   312.         |
000044d0  20 20 20 20 20 20 20 31  36 78 31 36 20 20 20 20  |       16x16    |
000044e0  20 32 33 36 30 20 20 20  20 20 20 20 20 20 20 20  | 2360           |
000044f0  20 35 36 38 20 20 20 20  20 20 20 20 20 31 30 38  | 568         108|
00004500  30 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |0.              |
00004510  20 20 33 32 78 33 32 20  20 20 20 20 33 31 32 38  |  32x32     3128|
00004520  20 20 20 20 20 20 20 20  20 20 20 32 31 30 34 20  |           2104 |
00004530  20 20 20 20 20 20 20 20  34 31 35 32 0a 20 20 20  |        4152.   |
00004540  20 20 20 20 20 20 20 20  20 20 20 20 20 36 34 78  |             64x|
00004550  36 34 20 20 20 20 20 36  32 30 30 20 20 20 20 20  |64     6200     |
00004560  20 20 20 20 20 20 38 32  34 38 20 20 20 20 20 20  |      8248      |
00004570  20 20 31 36 34 34 30 0a  20 20 20 20 20 20 20 20  |  16440.        |
00004580  20 20 20 20 20 20 20 20  31 30 32 34 78 34 20 20  |        1024x4  |
00004590  20 20 36 32 30 30 20 20  20 20 20 20 20 20 20 20  |  6200          |
000045a0  20 38 32 34 38 20 20 20  20 20 20 20 20 31 36 34  | 8248        164|
000045b0  34 30 0a 20 20 20 20 20  20 20 20 0a 20 20 20 20  |40.        .    |
000045c0  20 20 20 20 0a 20 20 20  20 20 20 20 20 41 6e 64  |    .        And|
000045d0  20 77 69 74 68 20 61 20  74 72 61 6e 73 70 61 72  | with a transpar|
000045e0  65 6e 63 79 20 6d 61 73  6b 0a 20 20 20 20 20 20  |ency mask.      |
000045f0  20 20 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |  .             |
00004600  20 20 20 53 69 7a 65 20  20 20 20 20 20 6e 6f 6e  |   Size      non|
00004610  65 20 20 20 20 20 20 20  20 33 32 4b 20 69 6d 61  |e        32K ima|
00004620  67 65 20 20 20 20 31 36  4d 20 69 6d 61 67 65 0a  |ge    16M image.|
00004630  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004640  38 78 38 20 20 20 20 20  20 20 32 32 33 32 20 20  |8x8       2232  |
00004650  20 20 20 20 20 20 20 20  20 20 32 31 36 20 20 20  |          216   |
00004660  20 20 20 20 20 20 20 33  34 34 0a 20 20 20 20 20  |       344.     |
00004670  20 20 20 20 20 20 20 20  20 20 20 31 36 78 31 36  |           16x16|
00004680  20 20 20 20 20 32 36 31  32 20 20 20 20 20 20 20  |     2612       |
00004690  20 20 20 20 20 36 33 32  20 20 20 20 20 20 20 20  |     632        |
000046a0  20 31 31 34 34 0a 20 20  20 20 20 20 20 20 20 20  | 1144.          |
000046b0  20 20 20 20 20 20 33 32  78 33 32 20 20 20 20 20  |      32x32     |
000046c0  34 31 35 32 20 20 20 20  20 20 20 20 20 20 20 32  |4152           2|
000046d0  32 33 32 20 20 20 20 20  20 20 20 20 34 32 38 30  |232         4280|
000046e0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000046f0  20 36 34 78 36 34 20 20  20 20 31 30 32 39 36 20  | 64x64    10296 |
00004700  20 20 20 20 20 20 20 20  20 20 38 37 36 30 20 20  |          8760  |
00004710  20 20 20 20 20 20 31 36  39 35 32 0a 20 20 20 20  |      16952.    |
00004720  20 20 20 20 20 20 20 20  20 20 20 20 31 30 32 34  |            1024|
00004730  78 34 20 20 20 31 30 32  39 36 20 20 20 20 20 20  |x4   10296      |
00004740  20 20 20 20 20 38 37 36  30 20 20 20 20 20 20 20  |     8760       |
00004750  20 31 36 39 35 32 0a 0a  0a 20 20 20 20 20 20 20  | 16952...       |
00004760  20 4e 6f 74 65 20 74 68  61 74 20 74 68 65 20 2d  | Note that the -|
00004770  73 74 61 74 20 66 69 6c  65 20 6d 61 79 20 62 65  |stat file may be|
00004780  20 75 73 65 64 20 74 6f  20 67 69 76 65 20 73 74  | used to give st|
00004790  61 74 69 73 74 69 63 73  0a 20 20 20 20 20 20 20  |atistics.       |
000047a0  20 61 62 6f 75 74 20 74  68 65 20 66 69 6c 65 20  | about the file |
000047b0  73 69 7a 65 20 28 61 6e  64 20 73 61 76 69 6e 67  |size (and saving|
000047c0  73 29 20 65 6e 63 6f 75  6e 74 65 72 65 64 2e 0a  |s) encountered..|
000047d0  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
000047e0  0a 0a 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |....            |
000047f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004800  20 20 20 20 20 20 50 61  67 65 20 20 20 39 0a 0c  |      Page   9..|
00004810  0a 20 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |. ==============|
00004820  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00004850  3d 3d 20 67 69 66 32 72  70 63 20 3d 3d 3d 3d 0a  |== gif2rpc ====.|
00004860  0a 0a 0a 20 5b 34 5d 20  57 68 79 20 75 73 65 20  |... [4] Why use |
00004870  67 69 66 32 72 70 63 0a  0a 0a 20 20 20 20 20 20  |gif2rpc...      |
00004880  20 20 54 68 65 72 65 20  61 72 65 20 74 77 6f 20  |  There are two |
00004890  6f 74 68 65 72 20 70 72  6f 67 72 61 6d 73 20 6f  |other programs o|
000048a0  75 74 20 74 68 65 72 65  20 74 68 61 74 20 70 65  |ut there that pe|
000048b0  72 66 6f 72 6d 20 6e 65  61 72 0a 20 20 20 20 20  |rform near.     |
000048c0  20 20 20 69 64 65 6e 74  69 63 61 6c 20 66 75 6e  |   identical fun|
000048d0  63 74 69 6f 6e 73 3a 0a  20 20 20 20 20 20 20 20  |ctions:.        |
000048e0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
000048f0  20 21 43 68 61 6e 67 65  46 53 49 0a 20 20 20 20  | !ChangeFSI.    |
00004900  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004910  20 20 20 20 54 68 69 73  20 70 72 6f 67 72 61 6d  |    This program|
00004920  2c 20 75 6e 66 6f 72 74  75 6e 61 74 65 6c 79 2c  |, unfortunately,|
00004930  20 64 6f 65 73 20 6e 6f  74 20 73 65 65 6d 0a 20  | does not seem. |
00004940  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004950  20 20 20 20 20 20 20 74  6f 20 63 6f 70 65 20 77  |       to cope w|
00004960  69 74 68 20 94 74 72 61  6e 73 70 61 72 65 6e 74  |ith .transparent|
00004970  95 20 47 49 46 73 2e 20  20 53 69 6e 63 65 0a 20  |. GIFs.  Since. |
00004980  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004990  20 20 20 20 20 20 20 74  68 65 73 65 20 61 72 65  |       these are|
000049a0  20 74 68 65 20 6e 6f 72  6d 2c 20 72 61 74 68 65  | the norm, rathe|
000049b0  72 20 74 68 61 6e 20 74  68 65 0a 20 20 20 20 20  |r than the.     |
000049c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000049d0  20 20 20 65 78 63 65 70  74 69 6f 6e 20 6f 6e 20  |   exception on |
000049e0  74 68 65 20 57 57 57 2c  20 69 74 20 69 73 20 62  |the WWW, it is b|
000049f0  61 64 20 6e 65 77 73 0a  20 20 20 20 20 20 20 20  |ad news.        |
00004a00  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |.               |
00004a10  20 67 69 66 32 73 70 72  0a 20 20 20 20 20 20 20  | gif2spr.       |
00004a20  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004a30  20 54 68 69 73 20 69 73  20 61 20 6e 69 63 65 20  | This is a nice |
00004a40  70 72 6f 67 72 61 6d 2c  20 62 75 74 20 68 61 73  |program, but has|
00004a50  20 6e 6f 20 73 75 70 70  6f 72 74 0a 20 20 20 20  | no support.    |
00004a60  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00004a70  20 20 20 20 66 6f 72 20  67 65 6e 65 72 61 74 69  |    for generati|
00004a80  6e 67 20 33 32 4b 20 63  6f 6c 6f 75 72 20 69 6d  |ng 32K colour im|
00004a90  61 67 65 73 0a 20 20 20  20 20 20 20 20 0a 20 20  |ages.        .  |
00004aa0  20 20 20 20 20 20 59 6f  75 91 64 20 75 73 65 20  |      You.d use |
00004ab0  67 69 66 32 72 70 63 20  69 66 20 79 6f 75 20 75  |gif2rpc if you u|
00004ac0  73 75 61 6c 6c 79 20 76  69 65 77 20 47 49 46 73  |sually view GIFs|
00004ad0  20 69 6e 20 33 32 4b 20  6d 6f 64 65 73 2c 0a 20  | in 32K modes,. |
00004ae0  20 20 20 20 20 20 20 6f  72 20 77 6f 75 6c 64 20  |       or would |
00004af0  6c 69 6b 65 20 74 6f 20  63 6f 6e 76 65 72 74 20  |like to convert |
00004b00  47 49 46 73 20 74 6f 20  31 36 4d 20 63 6f 6c 6f  |GIFs to 16M colo|
00004b10  75 72 20 73 70 72 69 74  65 73 2e 0a 0a 20 20 20  |ur sprites...   |
00004b20  20 20 20 20 20 49 74 91  73 20 6c 6f 67 67 69 6e  |     It.s loggin|
00004b30  67 20 66 61 63 69 6c 69  74 79 2c 20 61 6e 64 20  |g facility, and |
00004b40  66 75 6c 6c 65 72 20 64  69 61 67 6e 6f 73 74 69  |fuller diagnosti|
00004b50  63 73 20 6f 66 20 65 72  72 6f 72 73 0a 20 20 20  |cs of errors.   |
00004b60  20 20 20 20 20 6d 61 79  20 62 65 20 75 73 65 66  |     may be usef|
00004b70  75 6c 20 74 6f 20 79 6f  75 2e 0a 0a 20 20 20 20  |ul to you...    |
00004b80  20 20 20 20 41 6c 73 6f  2c 20 69 74 73 27 20 61  |    Also, its' a|
00004b90  62 69 6c 69 74 79 20 74  6f 20 75 73 65 20 6f 74  |bility to use ot|
00004ba0  68 65 72 20 66 69 6c 74  65 72 20 61 6c 67 6f 72  |her filter algor|
00004bb0  69 74 68 6d 73 20 28 66  61 73 74 65 72 0a 20 20  |ithms (faster.  |
00004bc0  20 20 20 20 20 20 6f 6e  65 73 20 6c 69 6b 65 20  |      ones like |
00004bd0  64 69 74 68 65 72 32 78  32 2c 20 6f 72 20 73 6c  |dither2x2, or sl|
00004be0  6f 77 65 72 20 6f 6e 65  73 29 20 63 61 6e 20 62  |ower ones) can b|
00004bf0  65 20 76 65 72 79 20 75  73 65 66 75 6c 2e 0a 0a  |e very useful...|
00004c00  0a 0a 20 5b 34 2e 31 5d  20 53 70 65 65 64 20 63  |.. [4.1] Speed c|
00004c10  6f 6d 70 61 72 69 73 6f  6e 73 0a 0a 20 20 20 20  |omparisons..    |
00004c20  20 20 20 20 41 73 20 61  20 74 65 73 74 20 62 65  |    As a test be|
00004c30  64 2c 20 61 20 31 32 38  20 63 6f 6c 6f 75 72 20  |d, a 128 colour |
00004c40  36 34 30 78 34 38 30 20  47 49 46 20 77 61 73 20  |640x480 GIF was |
00004c50  75 73 65 64 2e 20 20 49  74 20 77 61 73 0a 20 20  |used.  It was.  |
00004c60  20 20 20 20 20 20 63 6f  6e 76 65 72 74 65 64 20  |      converted |
00004c70  74 6f 20 61 20 73 70 72  69 74 65 20 31 30 20 74  |to a sprite 10 t|
00004c80  69 6d 65 73 2c 20 61 6e  64 20 61 20 73 63 72 69  |imes, and a scri|
00004c90  70 74 20 72 65 63 6f 72  64 65 64 20 74 68 65 0a  |pt recorded the.|
00004ca0  20 20 20 20 20 20 20 20  74 6f 74 61 6c 20 74 69  |        total ti|
00004cb0  6d 65 2c 20 61 63 63 75  72 61 74 65 20 74 6f 20  |me, accurate to |
00004cc0  2b 2f 2d 20 6f 6e 65 20  73 65 63 6f 6e 64 2e 20  |+/- one second. |
00004cd0  20 49 74 20 77 61 73 20  72 61 6e 20 69 6e 20 61  | It was ran in a|
00004ce0  0a 20 20 20 20 20 20 20  20 33 32 4b 20 73 63 72  |.        32K scr|
00004cf0  65 65 6e 20 6d 6f 64 65  20 28 31 30 32 34 78 37  |een mode (1024x7|
00004d00  36 38 29 2c 20 61 6e 64  20 61 20 33 32 4b 20 69  |68), and a 32K i|
00004d10  6d 61 67 65 20 77 61 73  20 67 65 6e 65 72 61 74  |mage was generat|
00004d20  65 64 3a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |ed:..           |
00004d30  20 20 20 43 68 61 6e 67  65 46 53 49 20 64 69 74  |   ChangeFSI dit|
00004d40  68 65 72 65 64 20 20 20  20 20 20 33 36 20 20 20  |hered      36   |
00004d50  20 20 28 53 31 36 2c 39  30 2c 39 30 29 0a 20 20  |  (S16,90,90).  |
00004d60  20 20 20 20 20 20 20 20  20 20 20 20 67 69 66 32  |            gif2|
00004d70  72 70 63 20 66 6c 6f 79  64 2d 73 74 65 69 6e 62  |rpc floyd-steinb|
00004d80  65 72 67 20 33 30 20 20  20 20 20 28 2d 71 75 69  |erg 30     (-qui|
00004d90  65 74 2c 20 2d 62 70 70  20 31 36 29 0a 20 20 20  |et, -bpp 16).   |
00004da0  20 20 20 20 20 20 20 20  20 20 20 43 68 61 6e 67  |           Chang|
00004db0  65 46 53 49 20 73 69 6d  70 6c 65 20 20 20 20 20  |eFSI simple     |
00004dc0  20 20 20 32 34 20 20 20  20 20 28 53 31 36 2c 39  |   24     (S16,9|
00004dd0  30 2c 39 30 2c 20 2d 6e  6f 64 69 74 68 65 72 29  |0,90, -nodither)|
00004de0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 67  |.              g|
00004df0  69 66 32 73 70 72 20 20  20 20 20 20 20 20 20 20  |if2spr          |
00004e00  20 20 20 20 20 20 20 31  31 20 20 20 20 20 28 2d  |       11     (-|
00004e10  71 29 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |q).             |
00004e20  20 67 69 66 32 72 70 63  20 32 78 32 20 64 69 74  | gif2rpc 2x2 dit|
00004e30  68 65 72 20 20 20 20 20  20 31 31 20 20 20 20 20  |her      11     |
00004e40  28 2d 71 75 69 65 74 2c  20 2d 62 70 70 20 31 36  |(-quiet, -bpp 16|
00004e50  29 0a 0a 20 20 20 20 20  20 20 20 46 6f 72 20 67  |)..        For g|
00004e60  65 6e 65 72 61 74 69 6e  67 20 61 20 32 35 36 20  |enerating a 256 |
00004e70  63 6f 6c 6f 75 72 20 69  6d 61 67 65 20 69 6e 20  |colour image in |
00004e80  61 20 32 35 36 20 63 6f  6c 6f 75 72 20 73 63 72  |a 256 colour scr|
00004e90  65 65 6e 0a 20 20 20 20  20 20 20 20 6d 6f 64 65  |een.        mode|
00004ea0  20 28 31 36 30 30 78 31  32 30 30 29 3a 0a 0a 20  | (1600x1200):.. |
00004eb0  20 20 20 20 20 20 20 20  20 20 20 20 20 43 68 61  |             Cha|
00004ec0  6e 67 65 46 53 49 20 64  69 74 68 65 72 20 73 6c  |ngeFSI dither sl|
00004ed0  6f 77 20 20 20 36 37 20  20 20 20 20 28 32 38 72  |ow   67     (28r|
00004ee0  29 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |).              |
00004ef0  43 68 61 6e 67 65 46 53  49 20 64 69 74 68 65 72  |ChangeFSI dither|
00004f00  20 66 61 73 74 20 20 20  35 39 20 20 20 20 20 28  | fast   59     (|
00004f10  32 38 29 0a 20 20 20 20  20 20 20 20 20 20 20 20  |28).            |
00004f20  20 20 43 68 61 6e 67 65  46 53 49 20 73 69 6d 70  |  ChangeFSI simp|
00004f30  6c 65 20 73 6c 6f 77 20  20 20 35 32 20 20 20 20  |le slow   52    |
00004f40  20 28 32 38 72 2c 20 2d  6e 6f 64 69 74 68 65 72  | (28r, -nodither|
00004f50  29 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |).              |
00004f60  43 68 61 6e 67 65 46 53  49 20 73 69 6d 70 6c 65  |ChangeFSI simple|
00004f70  20 66 61 73 74 20 20 20  34 36 20 20 20 20 20 28  | fast   46     (|
00004f80  32 38 2c 20 2d 6e 6f 64  69 74 68 65 72 29 0a 20  |28, -nodither). |
00004f90  20 20 20 20 20 20 20 20  20 20 20 20 20 67 69 66  |             gif|
00004fa0  32 73 70 72 20 20 20 20  20 20 20 20 20 20 20 20  |2spr            |
00004fb0  20 20 20 20 20 31 31 20  20 20 20 20 28 2d 71 29  |     11     (-q)|
00004fc0  0a 20 20 20 20 20 20 20  20 20 20 20 20 20 20 67  |.              g|
00004fd0  69 66 32 72 70 63 20 20  20 20 20 20 20 20 20 20  |if2rpc          |
00004fe0  20 20 20 20 20 20 20 20  38 20 20 20 20 20 28 2d  |        8     (-|
00004ff0  71 75 69 65 74 2c 20 2d  62 70 70 20 38 29 0a 0a  |quiet, -bpp 8)..|
00005000  0a 0a 0a 0a 0a 0a 0a 0a  20 20 20 20 20 20 20 20  |........        |
00005010  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005020  20 20 20 20 20 20 20 20  20 20 50 61 67 65 20 20  |          Page  |
00005030  31 30 0a 0c 0a 20 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |10... ==========|
00005040  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00005070  3d 3d 3d 3d 3d 3d 20 67  69 66 32 72 70 63 20 3d  |====== gif2rpc =|
00005080  3d 3d 3d 0a 0a 0a 0a 20  5b 35 5d 20 45 72 72 6f  |===.... [5] Erro|
00005090  72 20 63 6f 64 65 73 0a  0a 20 20 20 20 20 20 20  |r codes..       |
000050a0  20 54 68 65 73 65 20 61  72 65 20 74 68 65 20 65  | These are the e|
000050b0  72 72 6f 72 20 6e 75 6d  62 65 72 73 20 74 68 61  |rror numbers tha|
000050c0  74 20 77 69 6c 6c 20 62  65 20 72 65 70 6f 72 74  |t will be report|
000050d0  65 64 20 28 75 6e 6c 65  73 73 0a 20 20 20 20 20  |ed (unless.     |
000050e0  20 20 20 79 6f 75 20 75  73 65 20 74 68 65 20 2d  |   you use the -|
000050f0  71 75 69 65 74 20 6f 70  74 69 6f 6e 29 20 69 66  |quiet option) if|
00005100  20 74 68 65 20 47 49 46  20 69 73 20 66 6f 75 6e  | the GIF is foun|
00005110  64 20 74 6f 20 62 65 0a  20 20 20 20 20 20 20 20  |d to be.        |
00005120  63 6f 72 72 75 70 74 65  64 3a 0a 0a 0a 20 20 20  |corrupted:...   |
00005130  20 20 20 20 20 31 30 3a  20 20 20 20 20 74 68 65  |     10:     the|
00005140  20 73 74 61 72 74 20 6f  66 20 74 68 65 20 66 69  | start of the fi|
00005150  6c 65 20 77 61 73 20 6e  6f 74 20 61 20 76 61 6c  |le was not a val|
00005160  69 64 20 47 49 46 20 68  65 61 64 65 72 0a 0a 20  |id GIF header.. |
00005170  20 20 20 20 20 20 20 31  31 3a 20 20 20 20 20 69  |       11:     i|
00005180  6e 76 61 6c 69 64 20 6c  7a 77 20 74 61 62 6c 65  |nvalid lzw table|
00005190  20 73 69 7a 65 20 28 6e  6f 74 20 69 6e 20 72 61  | size (not in ra|
000051a0  6e 67 65 20 5b 32 2c 20  39 5d 29 0a 0a 20 20 20  |nge [2, 9])..   |
000051b0  20 20 20 20 20 31 32 3a  20 20 20 20 20 73 68 6f  |     12:     sho|
000051c0  72 74 20 66 69 6c 65 0a  0a 20 20 20 20 20 20 20  |rt file..       |
000051d0  20 31 33 3a 20 20 20 20  20 75 6e 65 78 70 65 63  | 13:     unexpec|
000051e0  74 65 64 20 72 65 63 6f  72 64 0a 0a 20 20 20 20  |ted record..    |
000051f0  20 20 20 20 31 34 3a 20  20 20 20 20 63 6f 72 72  |    14:     corr|
00005200  75 70 74 20 67 72 61 70  68 69 63 20 65 78 74 65  |upt graphic exte|
00005210  6e 73 69 6f 6e 20 72 65  63 6f 72 64 20 73 69 7a  |nsion record siz|
00005220  65 0a 0a 20 20 20 20 20  20 20 20 31 35 3a 20 20  |e..        15:  |
00005230  20 20 20 74 68 65 72 65  20 77 61 73 20 6e 6f 20  |   there was no |
00005240  69 6d 61 67 65 20 69 6e  20 74 68 65 20 66 69 6c  |image in the fil|
00005250  65 0a 0a 20 20 20 20 20  20 20 20 31 36 3a 20 20  |e..        16:  |
00005260  20 20 20 69 6d 61 67 65  20 73 69 7a 65 20 69 6e  |   image size in|
00005270  76 61 6c 69 64 20 28 70  69 78 65 6c 20 73 69 7a  |valid (pixel siz|
00005280  65 20 6c 65 73 73 20 74  68 61 6e 20 6f 6e 65 29  |e less than one)|
00005290  0a 0a 20 20 20 20 20 20  20 20 31 37 3a 20 20 20  |..        17:   |
000052a0  20 20 63 6f 72 72 75 70  74 20 67 72 61 70 68 69  |  corrupt graphi|
000052b0  63 20 65 78 74 65 6e 73  69 6f 6e 20 72 65 63 6f  |c extension reco|
000052c0  72 64 20 74 65 72 6d 69  6e 61 74 6f 72 0a 0a 20  |rd terminator.. |
000052d0  20 20 20 20 20 20 20 31  38 3a 20 20 20 20 20 28  |       18:     (|
000052e0  69 6e 74 65 72 6e 61 6c  20 65 72 72 6f 72 29 20  |internal error) |
000052f0  70 72 6f 63 65 73 73 69  6e 67 20 6d 61 73 6b 0a  |processing mask.|
00005300  0a 20 20 20 20 20 20 20  20 31 39 3a 20 20 20 20  |.        19:    |
00005310  20 28 69 6e 74 65 72 6e  61 6c 20 65 72 72 6f 72  | (internal error|
00005320  29 20 70 72 6f 63 65 73  73 69 6e 67 20 69 6d 61  |) processing ima|
00005330  67 65 0a 0a 20 20 20 20  20 20 20 20 32 30 3a 20  |ge..        20: |
00005340  20 20 20 20 6e 6f 20 70  61 6c 65 74 74 65 20 64  |    no palette d|
00005350  65 66 69 6e 65 64 20 69  6e 20 73 63 72 65 65 6e  |efined in screen|
00005360  20 6f 72 20 69 6d 61 67  65 0a 0a 20 20 20 20 20  | or image..     |
00005370  20 20 20 32 31 3a 20 20  20 20 20 6c 61 73 74 20  |   21:     last |
00005380  72 6f 77 20 77 61 73 20  69 6e 63 6f 6d 70 6c 65  |row was incomple|
00005390  74 65 0a 0a 20 20 20 20  20 20 20 20 32 32 3a 20  |te..        22: |
000053a0  20 20 20 20 65 78 74 72  61 20 62 79 74 65 28 73  |    extra byte(s|
000053b0  29 20 61 66 74 65 72 20  69 6d 61 67 65 20 66 6f  |) after image fo|
000053c0  75 6e 64 0a 0a 20 20 20  20 20 20 20 20 32 33 3a  |und..        23:|
000053d0  20 20 20 20 20 62 61 64  20 65 6e 64 20 6f 66 20  |     bad end of |
000053e0  69 6d 61 67 65 20 6d 61  72 6b 65 72 0a 0a 0a 0a  |image marker....|
000053f0  0a 0a 0a 0a 0a 0a 0a 0a  0a 0a 0a 0a 0a 0a 0a 0a  |................|
00005400  0a 0a 0a 0a 0a 20 20 20  20 20 20 20 20 20 20 20  |.....           |
00005410  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005420  20 20 20 20 20 20 20 50  61 67 65 20 20 31 31 0a  |       Page  11.|
00005430  0c 0a 20 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.. =============|
00005440  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
*
00005470  3d 3d 3d 20 67 69 66 32  72 70 63 20 3d 3d 3d 3d  |=== gif2rpc ====|
00005480  0a 0a 0a 0a 20 5b 36 5d  20 48 69 73 74 6f 72 79  |.... [6] History|
00005490  0a 0a 20 20 20 20 20 20  20 20 56 65 72 73 69 6f  |..        Versio|
000054a0  6e 20 31 2e 30 32 20 32  31 2d 4a 61 6e 2d 31 39  |n 1.02 21-Jan-19|
000054b0  39 36 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |96.             |
000054c0  20 20 20 42 65 74 74 65  72 20 63 6f 6c 6f 75 72  |   Better colour|
000054d0  20 6d 61 74 63 68 69 6e  67 20 66 6f 72 20 32 35  | matching for 25|
000054e0  36 20 63 6f 6c 6f 75 72  20 73 70 72 69 74 65 73  |6 colour sprites|
000054f0  0a 0a 20 20 20 20 20 20  20 20 56 65 72 73 69 6f  |..        Versio|
00005500  6e 20 31 2e 30 31 20 31  34 2d 4a 61 6e 2d 31 39  |n 1.01 14-Jan-19|
00005510  39 36 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |96.             |
00005520  20 20 20 41 64 64 65 64  20 2d 61 75 74 6f 6e 61  |   Added -autona|
00005530  6d 65 20 66 65 61 74 75  72 65 0a 20 20 20 20 20  |me feature.     |
00005540  20 20 20 20 20 20 20 20  20 20 20 54 69 64 69 65  |           Tidie|
00005550  64 20 75 70 20 74 68 69  73 20 64 6f 63 75 6d 65  |d up this docume|
00005560  6e 74 61 74 69 6f 6e 0a  20 20 20 20 20 20 20 20  |ntation.        |
00005570  20 20 20 20 20 20 20 20  57 72 6f 74 65 20 74 68  |        Wrote th|
00005580  65 20 67 69 66 32 72 70  63 46 45 20 6b 6c 75 64  |e gif2rpcFE klud|
00005590  67 65 20 70 72 6f 67 72  61 6d 0a 0a 0a 20 20 20  |ge program...   |
000055a0  20 20 20 20 20 56 65 72  73 69 6f 6e 20 31 2e 30  |     Version 1.0|
000055b0  30 20 32 31 2d 53 65 70  2d 31 39 39 35 0a 20 20  |0 21-Sep-1995.  |
000055c0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 54 68  |              Th|
000055d0  69 73 20 77 61 73 20 6e  65 76 65 72 20 72 65 6c  |is was never rel|
000055e0  65 61 73 65 64 2c 20 62  75 74 20 77 61 73 20 6c  |eased, but was l|
000055f0  65 66 74 0a 20 20 20 20  20 20 20 20 20 20 20 20  |eft.            |
00005600  20 20 20 20 6c 61 6e 67  75 69 73 68 69 6e 67 20  |    languishing |
00005610  6f 6e 20 74 68 65 20 68  61 72 64 20 64 69 73 63  |on the hard disc|
00005620  0a 0a 0a 0a 20 20 37 20  41 75 74 68 6f 72 0a 0a  |....  7 Author..|
00005630  20 20 20 20 20 20 20 50  72 6f 67 72 61 6d 20 61  |       Program a|
00005640  6e 64 20 64 6f 63 75 6d  65 6e 74 61 74 69 6f 6e  |nd documentation|
00005650  20 62 79 20 28 62 75 74  20 73 65 65 20 63 6f 70  | by (but see cop|
00005660  79 72 69 67 68 74 20 6e  6f 74 69 63 65 0a 20 20  |yright notice.  |
00005670  20 20 20 20 20 61 62 6f  76 65 29 3a 0a 0a 0a 20  |     above):... |
00005680  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000056a0  43 79 20 42 6f 6f 6b 65  72 0a 20 20 20 20 20 20  |Cy Booker.      |
000056b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000056c0  20 20 20 20 20 20 20 20  38 36 20 43 68 75 72 63  |        86 Churc|
000056d0  68 20 56 69 65 77 0a 20  20 20 20 20 20 20 20 20  |h View.         |
000056e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000056f0  20 20 20 20 20 20 20 20  4d 61 69 6e 20 52 6f 61  |        Main Roa|
00005700  64 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |d.              |
00005710  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005720  20 20 43 72 6f 63 6b 65  6e 68 69 6c 6c 0a 20 20  |  Crockenhill.  |
00005730  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
00005750  53 77 61 6e 6c 65 79 0a  20 20 20 20 20 20 20 20  |Swanley.        |
00005760  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
00005770  20 20 20 20 20 20 20 20  20 20 20 4b 65 6e 74 0a  |           Kent.|
00005780  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
*
000057a0  20 20 42 52 38 20 38 4a  57 0a 20 20 20 20 20 20  |  BR8 8JW.      |
000057b0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000057c0  20 20 20 20 20 20 20 20  20 20 20 20 20 55 2e 4b  |             U.K|
000057d0  2e 0a 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |..              |
000057e0  20 20 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |  .             |
000057f0  20 20 20 20 20 20 20 49  6e 74 65 72 6e 65 74 3a  |       Internet:|
00005800  20 63 79 40 63 68 65 65  70 6e 69 73 2e 64 65 6d  | cy@cheepnis.dem|
00005810  6f 6e 2e 63 6f 2e 75 6b  0a 20 20 20 20 20 20 20  |on.co.uk.       |
00005820  20 20 20 20 20 20 20 20  20 41 72 63 61 64 65 20  |         Arcade |
00005830  42 42 53 20 28 46 69 64  6f 6e 65 74 23 32 3a 32  |BBS (Fidonet#2:2|
00005840  35 34 2f 32 37 2e 30 29  3a 20 43 79 20 42 6f 6f  |54/27.0): Cy Boo|
00005850  6b 65 72 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ker.            |
00005860  20 20 20 20 0a 20 20 20  20 20 20 20 20 20 20 20  |    .           |
00005870  20 20 20 4d 75 73 69 63  61 6c 20 65 6e 74 65 72  |   Musical enter|
00005880  74 61 69 6e 6d 65 6e 74  20 70 72 6f 76 69 64 65  |tainment provide|
00005890  64 20 62 79 20 46 72 61  6e 6b 20 5a 61 70 70 61  |d by Frank Zappa|
000058a0  0a 0a                                             |..|
000058a2