Home » Personal collection » Acorn hard disk » apps » web » ReadMeDocs/smt_Terms

ReadMeDocs/smt_Terms

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 » Personal collection » Acorn hard disk » apps » web
Filename: ReadMeDocs/smt_Terms
Read OK:
File size: 122C bytes
Load address: 0000
Exec address: 0000
Duplicates

There is 1 duplicate copy of this file in the archive:

File contents
�Contents

gif2spr
Installation and Usage
Command line Usage
Notes
History
Contacting me

�gif2spr Version 1.06

A simple program to convert gif87a and gif89a graphic formats to Acorn
Sprite format. Transparency masks for the GIF files are created to
improve the appearance of the sprite. Interlaced images have been catered
for since the 2nd release. Version 1.06 will be the sixth release! Is it
just bad programming or bad testing that caused this?

I cannot be held responsible for any damage or loss of data as a result of
use or missuse of this program.

�Installation and Usage

There are currently several other programs that require gif2spr to work correctly
these normally include the latest version as of their release date. If you wish
to update one of those version please check the documentation of those programs
first but it should only require copying the new version of gif2spr to be copied
into the appropriate place.

Command line installation

Please ensure that gif2spr is in a directory pointed to by Run$Path, my copy is
saved in the library directory of my harddisc and my Run$Path looks like this.

Show Run$Path 
Run$Path(Macro) : ,%.,Boot:Library.,ADFS::HardDisc4.$.Library.

�Command line Usage

You can enter the pathname of a gif as the first file argument and
the pathname of the sprite file as the second file argument.

gif2spr [-q] [-v] RAM:$.in RAM:$.out

There are two options that can also be used.
 -q stops gif2spr generating error messages when things go wrong, useful when
       called by other programs
 -v generates verbose output.


�Notes

Only sprites with square pixel aspect ratios are generated.

This program appears to be at least twice as fast as ChangeFSI even
though ChangeFSI has hand coded LZW decompression. This made me very
happy when I tested it.

I've tested the program on 1,2,4,6,7,8 bits per pixel all the routines
have been tested since 3bpp uses the 4bpp routines and 5,6,7bpp uses 8bpp
I've only tested the transparency on 8bpp and 1bpp gifs, but the masking code is
almost identical to the pixel code so should not cause any problems. I
did check that part of the code for typos. The images I have were not
suitable for creating transparency masks as they were scanned in and
did not have large areas of single colour. This program has now been
in use for many months with very few reported errors, if you find any
please send me the report generated by gif2spr when run with the -v
option on the offending GIF file. The GIF file would also be of use.

The -q and -v options should be seperate and not of the form -qv but this
would not make much sense anyway. This may change in the future as more
options need to be added.

�History

1.03 The code to deal with interlaced gif's has been re-coded since version
2 and is more likely to work correctly. Previously some images had a few
lines in the wrong place making the image look quite odd.

1.04 has fixed a rare problem that occured when GIF's with multiple graphic
extensions caused the error message  'liblug: Unkown input file type'

1.05 Another Rare error this was created by me several versions ago. It only
happens when an empty transparent index graphic extension occurs in the data
stream and generates the message 'liblug: Unkown input file type'

1.06 It appears that there is a program out there on the Mac that generates GIFs
with an extra byte compressed on the end of the image data. The effect was to
overwrite the beginning of another malloc'd block and caused an error when trying
to free that memory. The extra byte only occures when a scan line is a multiple
of 4 pixels. I have 6 examples of this problem.

Another problem generated by a Mac program (possibly the same) caused the
same error message as above to occur but was because the gif had a strange
definition for it's colour map and caused an unallocated pointer to be freed
(This is partly bad programming but should not have occured if the gif hadh had
it's flags set correctly). As a result of all this gif2spr is now more tollerant
of strange GIF files.

My Thanks go to the following people (in no particular order)

 Peter Burwood
 Andrew Pullan
 Doug Winter
 Ben Schofield
 Philip Banks
 Stewart Brodie
 Mike Cook
 Steve Ellacott


�Contacting me

This is the Sixth distribution and was made on the 29th June 1995

Simon Truss 
mailto:simon@bigblue.demon.co.uk

I can be contacted on this address until about september 95 
mailto:u1smt@csc.liv.ac.uk

I can be contacted at the following address for a few years yet
(It has to be forwarded on, but it will reach me)

23 Charlton Gardens 
Coulsdon 
Surrey 
CR5 1AS 
Last Upated "Jun 29 1995"

00000000  0a 8f 43 6f 6e 74 65 6e  74 73 0a 0a 67 69 66 32  |..Contents..gif2|
00000010  73 70 72 0a 49 6e 73 74  61 6c 6c 61 74 69 6f 6e  |spr.Installation|
00000020  20 61 6e 64 20 55 73 61  67 65 0a 43 6f 6d 6d 61  | and Usage.Comma|
00000030  6e 64 20 6c 69 6e 65 20  55 73 61 67 65 0a 4e 6f  |nd line Usage.No|
00000040  74 65 73 0a 48 69 73 74  6f 72 79 0a 43 6f 6e 74  |tes.History.Cont|
00000050  61 63 74 69 6e 67 20 6d  65 0a 0a 8f 67 69 66 32  |acting me...gif2|
00000060  73 70 72 20 56 65 72 73  69 6f 6e 20 31 2e 30 36  |spr Version 1.06|
00000070  0a 0a 41 20 73 69 6d 70  6c 65 20 70 72 6f 67 72  |..A simple progr|
00000080  61 6d 20 74 6f 20 63 6f  6e 76 65 72 74 20 67 69  |am to convert gi|
00000090  66 38 37 61 20 61 6e 64  20 67 69 66 38 39 61 20  |f87a and gif89a |
000000a0  67 72 61 70 68 69 63 20  66 6f 72 6d 61 74 73 20  |graphic formats |
000000b0  74 6f 20 41 63 6f 72 6e  0a 53 70 72 69 74 65 20  |to Acorn.Sprite |
000000c0  66 6f 72 6d 61 74 2e 20  54 72 61 6e 73 70 61 72  |format. Transpar|
000000d0  65 6e 63 79 20 6d 61 73  6b 73 20 66 6f 72 20 74  |ency masks for t|
000000e0  68 65 20 47 49 46 20 66  69 6c 65 73 20 61 72 65  |he GIF files are|
000000f0  20 63 72 65 61 74 65 64  20 74 6f 0a 69 6d 70 72  | created to.impr|
00000100  6f 76 65 20 74 68 65 20  61 70 70 65 61 72 61 6e  |ove the appearan|
00000110  63 65 20 6f 66 20 74 68  65 20 73 70 72 69 74 65  |ce of the sprite|
00000120  2e 20 49 6e 74 65 72 6c  61 63 65 64 20 69 6d 61  |. Interlaced ima|
00000130  67 65 73 20 68 61 76 65  20 62 65 65 6e 20 63 61  |ges have been ca|
00000140  74 65 72 65 64 0a 66 6f  72 20 73 69 6e 63 65 20  |tered.for since |
00000150  74 68 65 20 32 6e 64 20  72 65 6c 65 61 73 65 2e  |the 2nd release.|
00000160  20 56 65 72 73 69 6f 6e  20 31 2e 30 36 20 77 69  | Version 1.06 wi|
00000170  6c 6c 20 62 65 20 74 68  65 20 73 69 78 74 68 20  |ll be the sixth |
00000180  72 65 6c 65 61 73 65 21  20 49 73 20 69 74 0a 6a  |release! Is it.j|
00000190  75 73 74 20 62 61 64 20  70 72 6f 67 72 61 6d 6d  |ust bad programm|
000001a0  69 6e 67 20 6f 72 20 62  61 64 20 74 65 73 74 69  |ing or bad testi|
000001b0  6e 67 20 74 68 61 74 20  63 61 75 73 65 64 20 74  |ng that caused t|
000001c0  68 69 73 3f 0a 0a 49 20  63 61 6e 6e 6f 74 20 62  |his?..I cannot b|
000001d0  65 20 68 65 6c 64 20 72  65 73 70 6f 6e 73 69 62  |e held responsib|
000001e0  6c 65 20 66 6f 72 20 61  6e 79 20 64 61 6d 61 67  |le for any damag|
000001f0  65 20 6f 72 20 6c 6f 73  73 20 6f 66 20 64 61 74  |e or loss of dat|
00000200  61 20 61 73 20 61 20 72  65 73 75 6c 74 20 6f 66  |a as a result of|
00000210  0a 75 73 65 20 6f 72 20  6d 69 73 73 75 73 65 20  |.use or missuse |
00000220  6f 66 20 74 68 69 73 20  70 72 6f 67 72 61 6d 2e  |of this program.|
00000230  0a 0a 8f 49 6e 73 74 61  6c 6c 61 74 69 6f 6e 20  |...Installation |
00000240  61 6e 64 20 55 73 61 67  65 0a 0a 54 68 65 72 65  |and Usage..There|
00000250  20 61 72 65 20 63 75 72  72 65 6e 74 6c 79 20 73  | are currently s|
00000260  65 76 65 72 61 6c 20 6f  74 68 65 72 20 70 72 6f  |everal other pro|
00000270  67 72 61 6d 73 20 74 68  61 74 20 72 65 71 75 69  |grams that requi|
00000280  72 65 20 67 69 66 32 73  70 72 20 74 6f 20 77 6f  |re gif2spr to wo|
00000290  72 6b 20 63 6f 72 72 65  63 74 6c 79 0a 74 68 65  |rk correctly.the|
000002a0  73 65 20 6e 6f 72 6d 61  6c 6c 79 20 69 6e 63 6c  |se normally incl|
000002b0  75 64 65 20 74 68 65 20  6c 61 74 65 73 74 20 76  |ude the latest v|
000002c0  65 72 73 69 6f 6e 20 61  73 20 6f 66 20 74 68 65  |ersion as of the|
000002d0  69 72 20 72 65 6c 65 61  73 65 20 64 61 74 65 2e  |ir release date.|
000002e0  20 49 66 20 79 6f 75 20  77 69 73 68 0a 74 6f 20  | If you wish.to |
000002f0  75 70 64 61 74 65 20 6f  6e 65 20 6f 66 20 74 68  |update one of th|
00000300  6f 73 65 20 76 65 72 73  69 6f 6e 20 70 6c 65 61  |ose version plea|
00000310  73 65 20 63 68 65 63 6b  20 74 68 65 20 64 6f 63  |se check the doc|
00000320  75 6d 65 6e 74 61 74 69  6f 6e 20 6f 66 20 74 68  |umentation of th|
00000330  6f 73 65 20 70 72 6f 67  72 61 6d 73 0a 66 69 72  |ose programs.fir|
00000340  73 74 20 62 75 74 20 69  74 20 73 68 6f 75 6c 64  |st but it should|
00000350  20 6f 6e 6c 79 20 72 65  71 75 69 72 65 20 63 6f  | only require co|
00000360  70 79 69 6e 67 20 74 68  65 20 6e 65 77 20 76 65  |pying the new ve|
00000370  72 73 69 6f 6e 20 6f 66  20 67 69 66 32 73 70 72  |rsion of gif2spr|
00000380  20 74 6f 20 62 65 20 63  6f 70 69 65 64 0a 69 6e  | to be copied.in|
00000390  74 6f 20 74 68 65 20 61  70 70 72 6f 70 72 69 61  |to the appropria|
000003a0  74 65 20 70 6c 61 63 65  2e 0a 0a 43 6f 6d 6d 61  |te place...Comma|
000003b0  6e 64 20 6c 69 6e 65 20  69 6e 73 74 61 6c 6c 61  |nd line installa|
000003c0  74 69 6f 6e 0a 0a 50 6c  65 61 73 65 20 65 6e 73  |tion..Please ens|
000003d0  75 72 65 20 74 68 61 74  20 67 69 66 32 73 70 72  |ure that gif2spr|
000003e0  20 69 73 20 69 6e 20 61  20 64 69 72 65 63 74 6f  | is in a directo|
000003f0  72 79 20 70 6f 69 6e 74  65 64 20 74 6f 20 62 79  |ry pointed to by|
00000400  20 52 75 6e 24 50 61 74  68 2c 20 6d 79 20 63 6f  | Run$Path, my co|
00000410  70 79 20 69 73 0a 73 61  76 65 64 20 69 6e 20 74  |py is.saved in t|
00000420  68 65 20 6c 69 62 72 61  72 79 20 64 69 72 65 63  |he library direc|
00000430  74 6f 72 79 20 6f 66 20  6d 79 20 68 61 72 64 64  |tory of my hardd|
00000440  69 73 63 20 61 6e 64 20  6d 79 20 52 75 6e 24 50  |isc and my Run$P|
00000450  61 74 68 20 6c 6f 6f 6b  73 20 6c 69 6b 65 20 74  |ath looks like t|
00000460  68 69 73 2e 0a 0a 53 68  6f 77 20 52 75 6e 24 50  |his...Show Run$P|
00000470  61 74 68 20 0a 52 75 6e  24 50 61 74 68 28 4d 61  |ath .Run$Path(Ma|
00000480  63 72 6f 29 20 3a 20 2c  25 2e 2c 42 6f 6f 74 3a  |cro) : ,%.,Boot:|
00000490  4c 69 62 72 61 72 79 2e  2c 41 44 46 53 3a 3a 48  |Library.,ADFS::H|
000004a0  61 72 64 44 69 73 63 34  2e 24 2e 4c 69 62 72 61  |ardDisc4.$.Libra|
000004b0  72 79 2e 0a 0a 8f 43 6f  6d 6d 61 6e 64 20 6c 69  |ry....Command li|
000004c0  6e 65 20 55 73 61 67 65  0a 0a 59 6f 75 20 63 61  |ne Usage..You ca|
000004d0  6e 20 65 6e 74 65 72 20  74 68 65 20 70 61 74 68  |n enter the path|
000004e0  6e 61 6d 65 20 6f 66 20  61 20 67 69 66 20 61 73  |name of a gif as|
000004f0  20 74 68 65 20 66 69 72  73 74 20 66 69 6c 65 20  | the first file |
00000500  61 72 67 75 6d 65 6e 74  20 61 6e 64 0a 74 68 65  |argument and.the|
00000510  20 70 61 74 68 6e 61 6d  65 20 6f 66 20 74 68 65  | pathname of the|
00000520  20 73 70 72 69 74 65 20  66 69 6c 65 20 61 73 20  | sprite file as |
00000530  74 68 65 20 73 65 63 6f  6e 64 20 66 69 6c 65 20  |the second file |
00000540  61 72 67 75 6d 65 6e 74  2e 0a 0a 67 69 66 32 73  |argument...gif2s|
00000550  70 72 20 5b 2d 71 5d 20  5b 2d 76 5d 20 52 41 4d  |pr [-q] [-v] RAM|
00000560  3a 24 2e 69 6e 20 52 41  4d 3a 24 2e 6f 75 74 0a  |:$.in RAM:$.out.|
00000570  0a 54 68 65 72 65 20 61  72 65 20 74 77 6f 20 6f  |.There are two o|
00000580  70 74 69 6f 6e 73 20 74  68 61 74 20 63 61 6e 20  |ptions that can |
00000590  61 6c 73 6f 20 62 65 20  75 73 65 64 2e 0a 20 2d  |also be used.. -|
000005a0  71 20 73 74 6f 70 73 20  67 69 66 32 73 70 72 20  |q stops gif2spr |
000005b0  67 65 6e 65 72 61 74 69  6e 67 20 65 72 72 6f 72  |generating error|
000005c0  20 6d 65 73 73 61 67 65  73 20 77 68 65 6e 20 74  | messages when t|
000005d0  68 69 6e 67 73 20 67 6f  20 77 72 6f 6e 67 2c 20  |hings go wrong, |
000005e0  75 73 65 66 75 6c 20 77  68 65 6e 0a 20 20 20 20  |useful when.    |
000005f0  20 20 20 63 61 6c 6c 65  64 20 62 79 20 6f 74 68  |   called by oth|
00000600  65 72 20 70 72 6f 67 72  61 6d 73 0a 20 2d 76 20  |er programs. -v |
00000610  67 65 6e 65 72 61 74 65  73 20 76 65 72 62 6f 73  |generates verbos|
00000620  65 20 6f 75 74 70 75 74  2e 0a 0a 0a 8f 4e 6f 74  |e output.....Not|
00000630  65 73 0a 0a 4f 6e 6c 79  20 73 70 72 69 74 65 73  |es..Only sprites|
00000640  20 77 69 74 68 20 73 71  75 61 72 65 20 70 69 78  | with square pix|
00000650  65 6c 20 61 73 70 65 63  74 20 72 61 74 69 6f 73  |el aspect ratios|
00000660  20 61 72 65 20 67 65 6e  65 72 61 74 65 64 2e 0a  | are generated..|
00000670  0a 54 68 69 73 20 70 72  6f 67 72 61 6d 20 61 70  |.This program ap|
00000680  70 65 61 72 73 20 74 6f  20 62 65 20 61 74 20 6c  |pears to be at l|
00000690  65 61 73 74 20 74 77 69  63 65 20 61 73 20 66 61  |east twice as fa|
000006a0  73 74 20 61 73 20 43 68  61 6e 67 65 46 53 49 20  |st as ChangeFSI |
000006b0  65 76 65 6e 0a 74 68 6f  75 67 68 20 43 68 61 6e  |even.though Chan|
000006c0  67 65 46 53 49 20 68 61  73 20 68 61 6e 64 20 63  |geFSI has hand c|
000006d0  6f 64 65 64 20 4c 5a 57  20 64 65 63 6f 6d 70 72  |oded LZW decompr|
000006e0  65 73 73 69 6f 6e 2e 20  54 68 69 73 20 6d 61 64  |ession. This mad|
000006f0  65 20 6d 65 20 76 65 72  79 0a 68 61 70 70 79 20  |e me very.happy |
00000700  77 68 65 6e 20 49 20 74  65 73 74 65 64 20 69 74  |when I tested it|
00000710  2e 0a 0a 49 27 76 65 20  74 65 73 74 65 64 20 74  |...I've tested t|
00000720  68 65 20 70 72 6f 67 72  61 6d 20 6f 6e 20 31 2c  |he program on 1,|
00000730  32 2c 34 2c 36 2c 37 2c  38 20 62 69 74 73 20 70  |2,4,6,7,8 bits p|
00000740  65 72 20 70 69 78 65 6c  20 61 6c 6c 20 74 68 65  |er pixel all the|
00000750  20 72 6f 75 74 69 6e 65  73 0a 68 61 76 65 20 62  | routines.have b|
00000760  65 65 6e 20 74 65 73 74  65 64 20 73 69 6e 63 65  |een tested since|
00000770  20 33 62 70 70 20 75 73  65 73 20 74 68 65 20 34  | 3bpp uses the 4|
00000780  62 70 70 20 72 6f 75 74  69 6e 65 73 20 61 6e 64  |bpp routines and|
00000790  20 35 2c 36 2c 37 62 70  70 20 75 73 65 73 20 38  | 5,6,7bpp uses 8|
000007a0  62 70 70 0a 49 27 76 65  20 6f 6e 6c 79 20 74 65  |bpp.I've only te|
000007b0  73 74 65 64 20 74 68 65  20 74 72 61 6e 73 70 61  |sted the transpa|
000007c0  72 65 6e 63 79 20 6f 6e  20 38 62 70 70 20 61 6e  |rency on 8bpp an|
000007d0  64 20 31 62 70 70 20 67  69 66 73 2c 20 62 75 74  |d 1bpp gifs, but|
000007e0  20 74 68 65 20 6d 61 73  6b 69 6e 67 20 63 6f 64  | the masking cod|
000007f0  65 20 69 73 0a 61 6c 6d  6f 73 74 20 69 64 65 6e  |e is.almost iden|
00000800  74 69 63 61 6c 20 74 6f  20 74 68 65 20 70 69 78  |tical to the pix|
00000810  65 6c 20 63 6f 64 65 20  73 6f 20 73 68 6f 75 6c  |el code so shoul|
00000820  64 20 6e 6f 74 20 63 61  75 73 65 20 61 6e 79 20  |d not cause any |
00000830  70 72 6f 62 6c 65 6d 73  2e 20 49 0a 64 69 64 20  |problems. I.did |
00000840  63 68 65 63 6b 20 74 68  61 74 20 70 61 72 74 20  |check that part |
00000850  6f 66 20 74 68 65 20 63  6f 64 65 20 66 6f 72 20  |of the code for |
00000860  74 79 70 6f 73 2e 20 54  68 65 20 69 6d 61 67 65  |typos. The image|
00000870  73 20 49 20 68 61 76 65  20 77 65 72 65 20 6e 6f  |s I have were no|
00000880  74 0a 73 75 69 74 61 62  6c 65 20 66 6f 72 20 63  |t.suitable for c|
00000890  72 65 61 74 69 6e 67 20  74 72 61 6e 73 70 61 72  |reating transpar|
000008a0  65 6e 63 79 20 6d 61 73  6b 73 20 61 73 20 74 68  |ency masks as th|
000008b0  65 79 20 77 65 72 65 20  73 63 61 6e 6e 65 64 20  |ey were scanned |
000008c0  69 6e 20 61 6e 64 0a 64  69 64 20 6e 6f 74 20 68  |in and.did not h|
000008d0  61 76 65 20 6c 61 72 67  65 20 61 72 65 61 73 20  |ave large areas |
000008e0  6f 66 20 73 69 6e 67 6c  65 20 63 6f 6c 6f 75 72  |of single colour|
000008f0  2e 20 54 68 69 73 20 70  72 6f 67 72 61 6d 20 68  |. This program h|
00000900  61 73 20 6e 6f 77 20 62  65 65 6e 0a 69 6e 20 75  |as now been.in u|
00000910  73 65 20 66 6f 72 20 6d  61 6e 79 20 6d 6f 6e 74  |se for many mont|
00000920  68 73 20 77 69 74 68 20  76 65 72 79 20 66 65 77  |hs with very few|
00000930  20 72 65 70 6f 72 74 65  64 20 65 72 72 6f 72 73  | reported errors|
00000940  2c 20 69 66 20 79 6f 75  20 66 69 6e 64 20 61 6e  |, if you find an|
00000950  79 0a 70 6c 65 61 73 65  20 73 65 6e 64 20 6d 65  |y.please send me|
00000960  20 74 68 65 20 72 65 70  6f 72 74 20 67 65 6e 65  | the report gene|
00000970  72 61 74 65 64 20 62 79  20 67 69 66 32 73 70 72  |rated by gif2spr|
00000980  20 77 68 65 6e 20 72 75  6e 20 77 69 74 68 20 74  | when run with t|
00000990  68 65 20 2d 76 0a 6f 70  74 69 6f 6e 20 6f 6e 20  |he -v.option on |
000009a0  74 68 65 20 6f 66 66 65  6e 64 69 6e 67 20 47 49  |the offending GI|
000009b0  46 20 66 69 6c 65 2e 20  54 68 65 20 47 49 46 20  |F file. The GIF |
000009c0  66 69 6c 65 20 77 6f 75  6c 64 20 61 6c 73 6f 20  |file would also |
000009d0  62 65 20 6f 66 20 75 73  65 2e 0a 0a 54 68 65 20  |be of use...The |
000009e0  2d 71 20 61 6e 64 20 2d  76 20 6f 70 74 69 6f 6e  |-q and -v option|
000009f0  73 20 73 68 6f 75 6c 64  20 62 65 20 73 65 70 65  |s should be sepe|
00000a00  72 61 74 65 20 61 6e 64  20 6e 6f 74 20 6f 66 20  |rate and not of |
00000a10  74 68 65 20 66 6f 72 6d  20 2d 71 76 20 62 75 74  |the form -qv but|
00000a20  20 74 68 69 73 0a 77 6f  75 6c 64 20 6e 6f 74 20  | this.would not |
00000a30  6d 61 6b 65 20 6d 75 63  68 20 73 65 6e 73 65 20  |make much sense |
00000a40  61 6e 79 77 61 79 2e 20  54 68 69 73 20 6d 61 79  |anyway. This may|
00000a50  20 63 68 61 6e 67 65 20  69 6e 20 74 68 65 20 66  | change in the f|
00000a60  75 74 75 72 65 20 61 73  20 6d 6f 72 65 0a 6f 70  |uture as more.op|
00000a70  74 69 6f 6e 73 20 6e 65  65 64 20 74 6f 20 62 65  |tions need to be|
00000a80  20 61 64 64 65 64 2e 0a  0a 8f 48 69 73 74 6f 72  | added....Histor|
00000a90  79 0a 0a 31 2e 30 33 20  54 68 65 20 63 6f 64 65  |y..1.03 The code|
00000aa0  20 74 6f 20 64 65 61 6c  20 77 69 74 68 20 69 6e  | to deal with in|
00000ab0  74 65 72 6c 61 63 65 64  20 67 69 66 27 73 20 68  |terlaced gif's h|
00000ac0  61 73 20 62 65 65 6e 20  72 65 2d 63 6f 64 65 64  |as been re-coded|
00000ad0  20 73 69 6e 63 65 20 76  65 72 73 69 6f 6e 0a 32  | since version.2|
00000ae0  20 61 6e 64 20 69 73 20  6d 6f 72 65 20 6c 69 6b  | and is more lik|
00000af0  65 6c 79 20 74 6f 20 77  6f 72 6b 20 63 6f 72 72  |ely to work corr|
00000b00  65 63 74 6c 79 2e 20 50  72 65 76 69 6f 75 73 6c  |ectly. Previousl|
00000b10  79 20 73 6f 6d 65 20 69  6d 61 67 65 73 20 68 61  |y some images ha|
00000b20  64 20 61 20 66 65 77 0a  6c 69 6e 65 73 20 69 6e  |d a few.lines in|
00000b30  20 74 68 65 20 77 72 6f  6e 67 20 70 6c 61 63 65  | the wrong place|
00000b40  20 6d 61 6b 69 6e 67 20  74 68 65 20 69 6d 61 67  | making the imag|
00000b50  65 20 6c 6f 6f 6b 20 71  75 69 74 65 20 6f 64 64  |e look quite odd|
00000b60  2e 0a 0a 31 2e 30 34 20  68 61 73 20 66 69 78 65  |...1.04 has fixe|
00000b70  64 20 61 20 72 61 72 65  20 70 72 6f 62 6c 65 6d  |d a rare problem|
00000b80  20 74 68 61 74 20 6f 63  63 75 72 65 64 20 77 68  | that occured wh|
00000b90  65 6e 20 47 49 46 27 73  20 77 69 74 68 20 6d 75  |en GIF's with mu|
00000ba0  6c 74 69 70 6c 65 20 67  72 61 70 68 69 63 0a 65  |ltiple graphic.e|
00000bb0  78 74 65 6e 73 69 6f 6e  73 20 63 61 75 73 65 64  |xtensions caused|
00000bc0  20 74 68 65 20 65 72 72  6f 72 20 6d 65 73 73 61  | the error messa|
00000bd0  67 65 20 20 27 6c 69 62  6c 75 67 3a 20 55 6e 6b  |ge  'liblug: Unk|
00000be0  6f 77 6e 20 69 6e 70 75  74 20 66 69 6c 65 20 74  |own input file t|
00000bf0  79 70 65 27 0a 0a 31 2e  30 35 20 41 6e 6f 74 68  |ype'..1.05 Anoth|
00000c00  65 72 20 52 61 72 65 20  65 72 72 6f 72 20 74 68  |er Rare error th|
00000c10  69 73 20 77 61 73 20 63  72 65 61 74 65 64 20 62  |is was created b|
00000c20  79 20 6d 65 20 73 65 76  65 72 61 6c 20 76 65 72  |y me several ver|
00000c30  73 69 6f 6e 73 20 61 67  6f 2e 20 49 74 20 6f 6e  |sions ago. It on|
00000c40  6c 79 0a 68 61 70 70 65  6e 73 20 77 68 65 6e 20  |ly.happens when |
00000c50  61 6e 20 65 6d 70 74 79  20 74 72 61 6e 73 70 61  |an empty transpa|
00000c60  72 65 6e 74 20 69 6e 64  65 78 20 67 72 61 70 68  |rent index graph|
00000c70  69 63 20 65 78 74 65 6e  73 69 6f 6e 20 6f 63 63  |ic extension occ|
00000c80  75 72 73 20 69 6e 20 74  68 65 20 64 61 74 61 0a  |urs in the data.|
00000c90  73 74 72 65 61 6d 20 61  6e 64 20 67 65 6e 65 72  |stream and gener|
00000ca0  61 74 65 73 20 74 68 65  20 6d 65 73 73 61 67 65  |ates the message|
00000cb0  20 27 6c 69 62 6c 75 67  3a 20 55 6e 6b 6f 77 6e  | 'liblug: Unkown|
00000cc0  20 69 6e 70 75 74 20 66  69 6c 65 20 74 79 70 65  | input file type|
00000cd0  27 0a 0a 31 2e 30 36 20  49 74 20 61 70 70 65 61  |'..1.06 It appea|
00000ce0  72 73 20 74 68 61 74 20  74 68 65 72 65 20 69 73  |rs that there is|
00000cf0  20 61 20 70 72 6f 67 72  61 6d 20 6f 75 74 20 74  | a program out t|
00000d00  68 65 72 65 20 6f 6e 20  74 68 65 20 4d 61 63 20  |here on the Mac |
00000d10  74 68 61 74 20 67 65 6e  65 72 61 74 65 73 20 47  |that generates G|
00000d20  49 46 73 0a 77 69 74 68  20 61 6e 20 65 78 74 72  |IFs.with an extr|
00000d30  61 20 62 79 74 65 20 63  6f 6d 70 72 65 73 73 65  |a byte compresse|
00000d40  64 20 6f 6e 20 74 68 65  20 65 6e 64 20 6f 66 20  |d on the end of |
00000d50  74 68 65 20 69 6d 61 67  65 20 64 61 74 61 2e 20  |the image data. |
00000d60  54 68 65 20 65 66 66 65  63 74 20 77 61 73 20 74  |The effect was t|
00000d70  6f 0a 6f 76 65 72 77 72  69 74 65 20 74 68 65 20  |o.overwrite the |
00000d80  62 65 67 69 6e 6e 69 6e  67 20 6f 66 20 61 6e 6f  |beginning of ano|
00000d90  74 68 65 72 20 6d 61 6c  6c 6f 63 27 64 20 62 6c  |ther malloc'd bl|
00000da0  6f 63 6b 20 61 6e 64 20  63 61 75 73 65 64 20 61  |ock and caused a|
00000db0  6e 20 65 72 72 6f 72 20  77 68 65 6e 20 74 72 79  |n error when try|
00000dc0  69 6e 67 0a 74 6f 20 66  72 65 65 20 74 68 61 74  |ing.to free that|
00000dd0  20 6d 65 6d 6f 72 79 2e  20 54 68 65 20 65 78 74  | memory. The ext|
00000de0  72 61 20 62 79 74 65 20  6f 6e 6c 79 20 6f 63 63  |ra byte only occ|
00000df0  75 72 65 73 20 77 68 65  6e 20 61 20 73 63 61 6e  |ures when a scan|
00000e00  20 6c 69 6e 65 20 69 73  20 61 20 6d 75 6c 74 69  | line is a multi|
00000e10  70 6c 65 0a 6f 66 20 34  20 70 69 78 65 6c 73 2e  |ple.of 4 pixels.|
00000e20  20 49 20 68 61 76 65 20  36 20 65 78 61 6d 70 6c  | I have 6 exampl|
00000e30  65 73 20 6f 66 20 74 68  69 73 20 70 72 6f 62 6c  |es of this probl|
00000e40  65 6d 2e 0a 0a 41 6e 6f  74 68 65 72 20 70 72 6f  |em...Another pro|
00000e50  62 6c 65 6d 20 67 65 6e  65 72 61 74 65 64 20 62  |blem generated b|
00000e60  79 20 61 20 4d 61 63 20  70 72 6f 67 72 61 6d 20  |y a Mac program |
00000e70  28 70 6f 73 73 69 62 6c  79 20 74 68 65 20 73 61  |(possibly the sa|
00000e80  6d 65 29 20 63 61 75 73  65 64 20 74 68 65 0a 73  |me) caused the.s|
00000e90  61 6d 65 20 65 72 72 6f  72 20 6d 65 73 73 61 67  |ame error messag|
00000ea0  65 20 61 73 20 61 62 6f  76 65 20 74 6f 20 6f 63  |e as above to oc|
00000eb0  63 75 72 20 62 75 74 20  77 61 73 20 62 65 63 61  |cur but was beca|
00000ec0  75 73 65 20 74 68 65 20  67 69 66 20 68 61 64 20  |use the gif had |
00000ed0  61 20 73 74 72 61 6e 67  65 0a 64 65 66 69 6e 69  |a strange.defini|
00000ee0  74 69 6f 6e 20 66 6f 72  20 69 74 27 73 20 63 6f  |tion for it's co|
00000ef0  6c 6f 75 72 20 6d 61 70  20 61 6e 64 20 63 61 75  |lour map and cau|
00000f00  73 65 64 20 61 6e 20 75  6e 61 6c 6c 6f 63 61 74  |sed an unallocat|
00000f10  65 64 20 70 6f 69 6e 74  65 72 20 74 6f 20 62 65  |ed pointer to be|
00000f20  20 66 72 65 65 64 0a 28  54 68 69 73 20 69 73 20  | freed.(This is |
00000f30  70 61 72 74 6c 79 20 62  61 64 20 70 72 6f 67 72  |partly bad progr|
00000f40  61 6d 6d 69 6e 67 20 62  75 74 20 73 68 6f 75 6c  |amming but shoul|
00000f50  64 20 6e 6f 74 20 68 61  76 65 20 6f 63 63 75 72  |d not have occur|
00000f60  65 64 20 69 66 20 74 68  65 20 67 69 66 20 68 61  |ed if the gif ha|
00000f70  64 68 20 68 61 64 0a 69  74 27 73 20 66 6c 61 67  |dh had.it's flag|
00000f80  73 20 73 65 74 20 63 6f  72 72 65 63 74 6c 79 29  |s set correctly)|
00000f90  2e 20 41 73 20 61 20 72  65 73 75 6c 74 20 6f 66  |. As a result of|
00000fa0  20 61 6c 6c 20 74 68 69  73 20 67 69 66 32 73 70  | all this gif2sp|
00000fb0  72 20 69 73 20 6e 6f 77  20 6d 6f 72 65 20 74 6f  |r is now more to|
00000fc0  6c 6c 65 72 61 6e 74 0a  6f 66 20 73 74 72 61 6e  |llerant.of stran|
00000fd0  67 65 20 47 49 46 20 66  69 6c 65 73 2e 0a 0a 4d  |ge GIF files...M|
00000fe0  79 20 54 68 61 6e 6b 73  20 67 6f 20 74 6f 20 74  |y Thanks go to t|
00000ff0  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 70 65 6f  |he following peo|
00001000  70 6c 65 20 28 69 6e 20  6e 6f 20 70 61 72 74 69  |ple (in no parti|
00001010  63 75 6c 61 72 20 6f 72  64 65 72 29 0a 0a 20 50  |cular order).. P|
00001020  65 74 65 72 20 42 75 72  77 6f 6f 64 0a 20 41 6e  |eter Burwood. An|
00001030  64 72 65 77 20 50 75 6c  6c 61 6e 0a 20 44 6f 75  |drew Pullan. Dou|
00001040  67 20 57 69 6e 74 65 72  0a 20 42 65 6e 20 53 63  |g Winter. Ben Sc|
00001050  68 6f 66 69 65 6c 64 0a  20 50 68 69 6c 69 70 20  |hofield. Philip |
00001060  42 61 6e 6b 73 0a 20 53  74 65 77 61 72 74 20 42  |Banks. Stewart B|
00001070  72 6f 64 69 65 0a 20 4d  69 6b 65 20 43 6f 6f 6b  |rodie. Mike Cook|
00001080  0a 20 53 74 65 76 65 20  45 6c 6c 61 63 6f 74 74  |. Steve Ellacott|
00001090  0a 0a 0a 8f 43 6f 6e 74  61 63 74 69 6e 67 20 6d  |....Contacting m|
000010a0  65 0a 0a 54 68 69 73 20  69 73 20 74 68 65 20 53  |e..This is the S|
000010b0  69 78 74 68 20 64 69 73  74 72 69 62 75 74 69 6f  |ixth distributio|
000010c0  6e 20 61 6e 64 20 77 61  73 20 6d 61 64 65 20 6f  |n and was made o|
000010d0  6e 20 74 68 65 20 32 39  74 68 20 4a 75 6e 65 20  |n the 29th June |
000010e0  31 39 39 35 0a 0a 53 69  6d 6f 6e 20 54 72 75 73  |1995..Simon Trus|
000010f0  73 20 0a 6d 61 69 6c 74  6f 3a 73 69 6d 6f 6e 40  |s .mailto:simon@|
00001100  62 69 67 62 6c 75 65 2e  64 65 6d 6f 6e 2e 63 6f  |bigblue.demon.co|
00001110  2e 75 6b 0a 0a 49 20 63  61 6e 20 62 65 20 63 6f  |.uk..I can be co|
00001120  6e 74 61 63 74 65 64 20  6f 6e 20 74 68 69 73 20  |ntacted on this |
00001130  61 64 64 72 65 73 73 20  75 6e 74 69 6c 20 61 62  |address until ab|
00001140  6f 75 74 20 73 65 70 74  65 6d 62 65 72 20 39 35  |out september 95|
00001150  20 0a 6d 61 69 6c 74 6f  3a 75 31 73 6d 74 40 63  | .mailto:u1smt@c|
00001160  73 63 2e 6c 69 76 2e 61  63 2e 75 6b 0a 0a 49 20  |sc.liv.ac.uk..I |
00001170  63 61 6e 20 62 65 20 63  6f 6e 74 61 63 74 65 64  |can be contacted|
00001180  20 61 74 20 74 68 65 20  66 6f 6c 6c 6f 77 69 6e  | at the followin|
00001190  67 20 61 64 64 72 65 73  73 20 66 6f 72 20 61 20  |g address for a |
000011a0  66 65 77 20 79 65 61 72  73 20 79 65 74 0a 28 49  |few years yet.(I|
000011b0  74 20 68 61 73 20 74 6f  20 62 65 20 66 6f 72 77  |t has to be forw|
000011c0  61 72 64 65 64 20 6f 6e  2c 20 62 75 74 20 69 74  |arded on, but it|
000011d0  20 77 69 6c 6c 20 72 65  61 63 68 20 6d 65 29 0a  | will reach me).|
000011e0  0a 32 33 20 43 68 61 72  6c 74 6f 6e 20 47 61 72  |.23 Charlton Gar|
000011f0  64 65 6e 73 20 0a 43 6f  75 6c 73 64 6f 6e 20 0a  |dens .Coulsdon .|
00001200  53 75 72 72 65 79 20 0a  43 52 35 20 31 41 53 20  |Surrey .CR5 1AS |
00001210  0a 4c 61 73 74 20 55 70  61 74 65 64 20 22 4a 75  |.Last Upated "Ju|
00001220  6e 20 32 39 20 31 39 39  35 22 0a 0a              |n 29 1995"..|
0000122c