Home » Personal collection » Acorn hard disk » apps » ImagePrcss » !ChangeFSI/FSIinfo » Compare

Compare !ChangeFSI/FSIinfo with !ChangeFSI/FSIinfo

File: Personal collection » Acorn hard disk » apps » ImagePrcss » !ChangeFSI/FSIinfo
Compared with: Archimedes archive » Apps » Acorn Applications Update (1994)(Acorn Computers).adf » !ChangeFSI/FSIinfo
Similarity: 99% of bytes duplicated

98.6% of the bytes in these files are duplicated between them. Duplicated Different Padding (ignored)

Bytes are marked as duplicated if they lie within a run of at least 16 bytes which also appears somewhere in the other file, in any position. Long runs of padding bytes (zeros, spaces, &FF and &E5) are ignored.

!ChangeFSI/FSIinfo
00000000  20 20 20 20 20 43 68 61  6e 67 65 46 53 49 3a 20  |     ChangeFSI: |
00000010  43 6f 6c 6f 75 72 20 49  6d 61 67 65 20 50 72 6f  |Colour Image Pro|
00000020  63 65 73 73 69 6e 67 20  55 73 69 6e 67 20 74 68  |cessing Using th|
00000030  65 20 32 35 36 20 63 6f  6c 6f 75 72 20 6d 6f 64  |e 256 colour mod|
00000040  65 73 0a 0a 41 72 63 68  69 6d 65 64 65 73 20 63  |es..Archimedes c|
00000050  6f 6d 70 75 74 65 72 73  20 68 61 76 65 20 66 75  |omputers have fu|
00000060  6c 6c 20 63 6f 6c 6f 75  72 20 64 69 73 70 6c 61  |ll colour displa|
00000070  79 20 63 61 70 61 62 69  6c 69 74 69 65 73 20 62  |y capabilities b|
00000080  75 69 6c 74 20 69 6e 74  6f 20 74 68 65 6d 20 61  |uilt into them a|
00000090  73 0a 73 74 61 6e 64 61  72 64 2e 20 48 6f 77 65  |s.standard. Howe|
000000a0  76 65 72 2c 20 63 6f 6d  70 61 72 65 64 20 77 69  |ver, compared wi|
000000b0  74 68 20 74 68 65 20 68  61 72 64 77 61 72 65 20  |th the hardware |
000000c0  66 6f 75 6e 64 20 69 6e  20 6c 61 72 67 65 72 20  |found in larger |
000000d0  77 6f 72 6b 73 74 61 74  69 6f 6e 73 2c 20 74 68  |workstations, th|
000000e0  65 0a 66 61 63 69 6c 69  74 69 65 73 20 70 72 6f  |e.facilities pro|
000000f0  76 69 64 65 64 20 68 61  76 65 20 62 65 65 6e 20  |vided have been |
00000100  63 61 72 65 66 75 6c 6c  79 20 72 65 64 75 63 65  |carefully reduce|
00000110  64 20 28 69 6e 20 6f 72  64 65 72 20 74 6f 20 6d  |d (in order to m|
00000120  61 6b 65 20 74 68 65 6d  20 63 68 65 61 70 0a 65  |ake them cheap.e|
00000130  6e 6f 75 67 68 20 74 6f  20 66 69 74 20 61 6c 6c  |nough to fit all|
00000140  20 74 68 65 20 74 69 6d  65 29 2e 20 53 6f 20 74  | the time). So t|
00000150  68 65 20 70 72 65 63 69  73 69 6f 6e 20 6f 66 20  |he precision of |
00000160  74 68 65 20 64 69 67 69  74 61 6c 20 74 6f 20 61  |the digital to a|
00000170  6e 61 6c 6f 67 75 65 0a  63 6f 6e 76 65 72 74 65  |nalogue.converte|
00000180  72 73 20 69 73 20 6f 6e  6c 79 20 34 20 62 69 74  |rs is only 4 bit|
00000190  73 20 28 69 6e 73 74 65  61 64 20 6f 66 20 38 29  |s (instead of 8)|
000001a0  20 61 6e 64 20 74 68 65  20 63 6f 6c 6f 75 72 20  | and the colour |
000001b0  70 61 6c 65 74 74 65 20  6f 6e 6c 79 20 68 61 73  |palette only has|
000001c0  20 31 36 0a 65 6e 74 72  69 65 73 20 28 69 6e 73  | 16.entries (ins|
000001d0  74 65 61 64 20 6f 66 20  32 35 36 29 2e 0a 0a 54  |tead of 256)...T|
000001e0  68 65 20 56 49 44 43 20  32 35 36 20 63 6f 6c 6f  |he VIDC 256 colo|
000001f0  75 72 20 6d 6f 64 65 0a  3d 3d 3d 3d 3d 3d 3d 3d  |ur mode.========|
00000200  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00000210  3d 0a 0a 48 61 73 20 34  20 64 69 72 65 63 74 20  |=..Has 4 direct |
00000220  62 69 74 73 20 28 74 6f  70 20 32 20 67 72 65 65  |bits (top 2 gree|
00000230  6e 2c 20 74 6f 70 20 72  65 64 20 61 6e 64 20 62  |n, top red and b|
00000240  6c 75 65 29 20 70 6c 75  73 20 34 20 70 61 6c 65  |lue) plus 4 pale|
00000250  74 74 65 20 6c 6f 6f 6b  20 75 70 20 62 69 74 73  |tte look up bits|
00000260  0a 77 68 69 63 68 20 61  66 66 65 63 74 20 74 68  |.which affect th|
00000270  65 20 72 65 6d 61 69 6e  69 6e 67 20 44 41 43 20  |e remaining DAC |
00000280  62 69 74 73 2e 20 54 68  69 73 20 74 68 65 72 65  |bits. This there|
00000290  66 6f 72 65 20 67 69 76  65 73 20 61 20 63 68 6f  |fore gives a cho|
000002a0  69 63 65 20 6f 66 20 32  35 36 0a 63 6f 6c 6f 75  |ice of 256.colou|
000002b0  72 73 20 66 72 6f 6d 20  34 30 39 36 2c 20 62 75  |rs from 4096, bu|
000002c0  74 20 74 68 65 20 63 68  6f 69 63 65 20 69 73 20  |t the choice is |
000002d0  6e 6f 74 20 61 20 66 72  65 65 20 6f 6e 65 20 69  |not a free one i|
000002e0  6e 20 74 68 61 74 20 74  68 65 20 34 20 64 69 72  |n that the 4 dir|
000002f0  65 63 74 20 62 69 74 73  0a 61 72 65 20 61 6c 77  |ect bits.are alw|
00000300  61 79 73 20 63 6f 6e 6e  65 63 74 65 64 3a 20 74  |ays connected: t|
00000310  68 69 73 20 6c 65 61 76  65 73 20 6f 6e 6c 79 20  |his leaves only |
00000320  32 35 36 20 73 65 6c 65  63 74 69 6f 6e 73 20 61  |256 selections a|
00000330  76 61 69 6c 61 62 6c 65  20 66 72 6f 6d 20 74 68  |vailable from th|
00000340  65 20 34 30 39 36 0a 63  6f 6c 6f 75 72 20 72 61  |e 4096.colour ra|
00000350  6e 67 65 2e 20 54 6f 20  72 65 70 65 61 74 3a 20  |nge. To repeat: |
00000360  74 68 65 72 65 20 61 72  65 20 32 35 36 20 73 69  |there are 256 si|
00000370  6d 75 6c 74 61 6e 65 6f  75 73 20 63 6f 6c 6f 75  |multaneous colou|
00000380  72 73 20 69 6e 20 61 20  73 65 6c 65 63 74 69 6f  |rs in a selectio|
00000390  6e 20 6f 75 74 0a 6f 66  20 34 30 39 36 20 63 6f  |n out.of 4096 co|
000003a0  6c 6f 75 72 73 2c 20 77  68 65 72 65 20 74 68 65  |lours, where the|
000003b0  72 65 20 61 72 65 20 6f  6e 6c 79 20 32 35 36 20  |re are only 256 |
000003c0  22 6c 65 67 61 6c 22 20  73 65 6c 65 63 74 69 6f  |"legal" selectio|
000003d0  6e 73 2e 20 54 68 65 20  6e 65 77 20 56 49 44 43  |ns. The new VIDC|
000003e0  32 30 0a 61 6c 6c 6f 77  73 20 61 6e 20 61 72 62  |20.allows an arb|
000003f0  69 74 72 61 72 79 20 73  65 6c 65 63 74 69 6f 6e  |itrary selection|
00000400  20 6f 66 20 63 6f 6c 6f  75 72 73 2c 20 62 75 74  | of colours, but|
00000410  20 74 68 65 20 64 65 66  61 75 6c 74 20 73 69 74  | the default sit|
00000420  75 61 74 69 6f 6e 20 69  73 0a 69 64 65 6e 74 69  |uation is.identi|
00000430  63 61 6c 2e 0a 0a 54 68  65 72 65 20 61 72 65 20  |cal...There are |
00000440  22 6f 70 74 69 6d 61 6c  22 20 73 65 6c 65 63 74  |"optimal" select|
00000450  69 6f 6e 73 2e 20 41 6e  20 6f 70 74 69 6d 61 6c  |ions. An optimal|
00000460  20 73 65 6c 65 63 74 69  6f 6e 20 69 73 20 6f 6e  | selection is on|
00000470  65 20 77 68 69 63 68 20  63 6f 76 65 72 73 20 74  |e which covers t|
00000480  68 65 0a 65 6e 74 69 72  65 20 52 2c 20 47 2c 20  |he.entire R, G, |
00000490  42 20 63 6f 6c 6f 75 72  20 63 75 62 65 20 28 69  |B colour cube (i|
000004a0  2e 65 2e 20 30 2d 66 75  6c 6c 73 63 61 6c 65 20  |.e. 0-fullscale |
000004b0  66 6f 72 20 65 61 63 68  20 6f 66 20 74 68 65 20  |for each of the |
000004c0  63 6f 6c 6f 75 72 73 29  20 61 6e 64 20 63 61 6e  |colours) and can|
000004d0  0a 74 68 75 73 20 62 65  20 64 69 74 68 65 72 65  |.thus be dithere|
000004e0  64 20 74 6f 20 66 72 6f  6d 20 61 6e 79 20 70 69  |d to from any pi|
000004f0  63 74 75 72 65 20 28 69  66 20 6f 6e 65 20 63 6f  |cture (if one co|
00000500  6e 73 69 64 65 72 73 20  70 69 63 74 75 72 65 27  |nsiders picture'|
00000510  73 20 63 6f 6c 6f 75 72  20 72 61 6e 67 65 0a 61  |s colour range.a|
00000520  73 20 61 6e 20 61 72 62  69 74 72 61 72 79 20 76  |s an arbitrary v|
00000530  6f 6c 75 6d 65 20 69 6e  20 74 68 65 20 63 6f 6c  |olume in the col|
00000540  6f 75 72 20 63 75 62 65  2c 20 74 68 65 6e 20 79  |our cube, then y|
00000550  6f 75 20 63 61 6e 20 64  69 74 68 65 72 2f 64 69  |ou can dither/di|
00000560  73 70 6c 61 79 20 61 0a  70 69 63 74 75 72 65 20  |splay a.picture |
00000570  61 63 63 75 72 61 74 65  6c 79 20 69 66 20 61 6e  |accurately if an|
00000580  64 20 6f 6e 6c 79 20 69  66 20 74 68 65 20 76 6f  |d only if the vo|
00000590  6c 75 6d 65 20 63 6f 76  65 72 65 64 20 62 79 20  |lume covered by |
000005a0  74 68 65 20 61 76 61 69  6c 61 62 6c 65 20 63 6f  |the available co|
000005b0  6c 6f 75 72 73 0a 65 6e  63 6c 6f 73 65 73 20 74  |lours.encloses t|
000005c0  68 65 20 70 69 63 74 75  72 65 27 73 29 2e 20 54  |he picture's). T|
000005d0  68 65 20 6f 70 74 69 6d  61 6c 20 73 65 6c 65 63  |he optimal selec|
000005e0  74 69 6f 6e 20 75 73 65  64 20 66 6f 72 20 74 68  |tion used for th|
000005f0  65 20 52 49 53 43 20 4f  53 20 32 35 36 20 63 6f  |e RISC OS 256 co|
00000600  6c 6f 75 72 0a 6d 6f 64  65 20 70 61 6c 65 74 74  |lour.mode palett|
00000610  65 20 63 6f 6e 74 61 69  6e 73 20 32 20 6d 6f 73  |e contains 2 mos|
00000620  74 20 73 69 67 6e 69 66  69 63 61 6e 74 20 62 69  |t significant bi|
00000630  74 73 20 6f 66 20 52 65  64 2c 20 32 20 6d 6f 73  |ts of Red, 2 mos|
00000640  74 20 73 69 67 6e 69 66  69 63 61 6e 74 20 62 69  |t significant bi|
00000650  74 73 0a 6f 66 20 47 72  65 65 6e 20 61 6e 64 20  |ts.of Green and |
00000660  32 20 6d 6f 73 74 20 73  69 67 6e 69 66 69 63 61  |2 most significa|
00000670  6e 74 20 62 69 74 73 20  6f 66 20 42 6c 75 65 2c  |nt bits of Blue,|
00000680  20 77 69 74 68 20 74 68  65 20 6c 61 73 74 20 32  | with the last 2|
00000690  20 62 69 74 73 20 63 6f  6e 74 72 6f 6c 6c 69 6e  | bits controllin|
000006a0  67 0a 74 68 65 20 32 20  6c 65 61 73 74 20 73 69  |g.the 2 least si|
000006b0  67 6e 69 66 69 63 61 6e  74 20 62 69 74 73 20 69  |gnificant bits i|
000006c0  6e 20 70 61 72 61 6c 6c  65 6c 20 28 22 61 64 64  |n parallel ("add|
000006d0  73 20 77 68 69 74 65 22  20 74 6f 20 61 20 63 6f  |s white" to a co|
000006e0  6c 6f 75 72 29 2e 20 54  68 75 73 20 70 65 61 6b  |lour). Thus peak|
000006f0  0a 52 2c 20 47 2c 20 42  20 69 73 20 6f 62 74 61  |.R, G, B is obta|
00000700  69 6e 65 64 20 28 77 69  74 68 6f 75 74 20 73 69  |ined (without si|
00000710  64 65 20 65 66 66 65 63  74 73 20 69 66 20 76 61  |de effects if va|
00000720  72 69 65 64 20 73 69 6d  75 6c 74 61 6e 65 6f 75  |ried simultaneou|
00000730  73 6c 79 2c 20 77 69 74  68 20 61 20 73 69 64 65  |sly, with a side|
00000740  0a 65 66 66 65 63 74 20  69 66 20 70 65 61 6b 20  |.effect if peak |
00000750  52 20 28 73 61 79 29 20  61 6c 6f 6e 65 20 69 73  |R (say) alone is|
00000760  20 72 65 71 75 69 72 65  64 29 2e 20 41 20 63 6f  | required). A co|
00000770  72 72 65 63 74 6c 79 20  64 65 73 69 67 6e 65 64  |rrectly designed|
00000780  20 65 72 72 6f 72 20 64  69 66 66 75 73 69 6f 6e  | error diffusion|
00000790  0a 64 69 74 68 65 72 20  61 6c 67 6f 72 69 74 68  |.dither algorith|
000007a0  6d 20 63 61 6e 20 64 69  73 70 6c 61 79 20 70 69  |m can display pi|
000007b0  63 74 75 72 65 73 20 77  69 74 68 20 76 65 72 79  |ctures with very|
000007c0  20 68 69 67 68 20 66 69  64 65 6c 69 74 79 2e 20  | high fidelity. |
000007d0  5b 6e 6f 74 65 20 74 68  61 74 0a 64 69 74 68 65  |[note that.dithe|
000007e0  72 69 6e 67 20 61 6c 6c  20 70 69 63 74 75 72 65  |ring all picture|
000007f0  73 20 77 69 74 68 20 61  20 73 69 6e 67 6c 65 20  |s with a single |
00000800  70 61 6c 65 74 74 65 20  70 65 72 6d 69 74 73 20  |palette permits |
00000810  74 68 65 69 72 20 64 69  73 70 6c 61 79 0a 73 69  |their display.si|
00000820  6d 75 6c 74 61 6e 65 6f  75 73 6c 79 20 6f 6e 20  |multaneously on |
00000830  74 68 65 20 73 63 72 65  65 6e 2c 20 61 6c 73 6f  |the screen, also|
00000840  20 6e 6f 74 65 20 74 68  61 74 20 64 69 74 68 65  | note that dithe|
00000850  72 69 6e 67 20 74 6f 20  61 20 66 69 78 65 64 20  |ring to a fixed |
00000860  70 61 6c 65 74 74 65 20  69 73 0a 6d 75 63 68 20  |palette is.much |
00000870  71 75 69 63 6b 65 72 20  74 68 61 6e 20 73 65 6c  |quicker than sel|
00000880  65 63 74 69 6e 67 20 61  20 70 61 6c 65 74 74 65  |ecting a palette|
00000890  20 66 69 72 73 74 21 5d  0a 0a 4f 6e 65 20 63 61  | first!]..One ca|
000008a0  6e 20 61 6c 73 6f 20 70  72 6f 67 72 61 6d 20 74  |n also program t|
000008b0  68 65 20 73 79 73 74 65  6d 20 66 6f 72 20 61 20  |he system for a |
000008c0  6c 61 72 67 65 20 6e 75  6d 62 65 72 20 6f 66 20  |large number of |
000008d0  6e 20 62 69 74 73 20 70  65 72 20 63 6f 6c 6f 75  |n bits per colou|
000008e0  72 20 6d 6f 64 65 73 2c  0a 77 69 74 68 20 74 68  |r modes,.with th|
000008f0  65 20 6e 20 62 69 74 73  20 73 74 61 72 74 69 6e  |e n bits startin|
00000900  67 20 61 74 20 74 68 65  20 6d 6f 73 74 20 73 69  |g at the most si|
00000910  67 6e 69 66 69 63 61 6e  74 20 65 6e 64 20 6f 66  |gnificant end of|
00000920  20 74 68 65 20 63 6f 6c  6f 75 72 20 72 61 6e 67  | the colour rang|
00000930  65 2e 20 46 6f 72 0a 65  78 61 6d 70 6c 65 20 34  |e. For.example 4|
00000940  20 62 69 74 73 20 6f 66  20 67 72 65 65 6e 2c 20  | bits of green, |
00000950  33 20 62 69 74 73 20 6f  66 20 72 65 64 20 61 6e  |3 bits of red an|
00000960  64 20 31 20 62 69 74 20  6f 66 20 62 6c 75 65 2e  |d 1 bit of blue.|
00000970  20 54 68 65 20 63 6f 6e  73 74 72 61 69 6e 74 73  | The constraints|
00000980  20 61 72 65 3a 0a 20 20  20 20 20 32 20 3c 3d 20  | are:.     2 <= |
00000990  6e 47 72 65 65 6e 20 3c  3d 20 34 0a 20 20 20 20  |nGreen <= 4.    |
000009a0  20 31 20 3c 3d 20 6e 52  65 64 20 20 20 3c 3d 20  | 1 <= nRed   <= |
000009b0  34 0a 20 20 20 20 20 31  20 3c 3d 20 6e 42 6c 75  |4.     1 <= nBlu|
000009c0  65 20 20 3c 3d 20 34 0a  20 20 20 20 20 28 61 6e  |e  <= 4.     (an|
000009d0  64 20 6e 52 65 64 2b 6e  42 6c 75 65 2b 6e 47 72  |d nRed+nBlue+nGr|
000009e0  65 65 6e 3d 38 29 0a 4d  6f 64 65 73 20 6c 69 6b  |een=8).Modes lik|
000009f0  65 20 74 68 65 73 65 20  61 72 65 20 6f 66 74 65  |e these are ofte|
00000a00  6e 20 75 73 65 66 75 6c  20 66 6f 72 20 72 65 61  |n useful for rea|
00000a10  6c 20 74 69 6d 65 20 73  6f 6c 69 64 20 6d 6f 64  |l time solid mod|
00000a20  65 6c 6c 69 6e 67 20 28  77 68 65 72 65 20 74 68  |elling (where th|
00000a30  65 0a 65 78 70 65 6e 73  65 20 6f 66 20 64 69 74  |e.expense of dit|
00000a40  68 65 72 69 6e 67 20 77  69 74 68 20 65 72 72 6f  |hering with erro|
00000a50  72 20 64 69 66 66 75 73  69 6f 6e 20 28 63 69 72  |r diffusion (cir|
00000a60  63 61 20 31 30 30 20 63  79 63 6c 65 73 20 70 65  |ca 100 cycles pe|
00000a70  72 20 70 69 78 65 6c 29  20 63 61 6e 6e 6f 74 0a  |r pixel) cannot.|
00000a80  62 65 20 61 66 66 6f 72  64 65 64 29 2e 20 54 68  |be afforded). Th|
00000a90  65 73 65 20 73 65 6c 65  63 74 69 6f 6e 73 20 61  |ese selections a|
00000aa0  72 65 20 6e 6f 6e 2d 6f  70 74 69 6d 61 6c 3a 20  |re non-optimal: |
00000ab0  74 68 65 20 63 6f 6c 6f  75 72 20 63 75 62 65 20  |the colour cube |
00000ac0  69 73 20 6e 6f 74 0a 63  6f 6d 70 6c 65 74 65 6c  |is not.completel|
00000ad0  79 20 73 70 61 6e 6e 65  64 2e 0a 0a 44 69 73 70  |y spanned...Disp|
00000ae0  6c 61 79 69 6e 67 20 41  20 50 69 63 74 75 72 65  |laying A Picture|
00000af0  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
00000b00  3d 3d 3d 3d 3d 0a 0a 53  69 6e 63 65 20 61 20 63  |=====..Since a c|
00000b10  6f 6c 6f 75 72 20 69 6e  20 74 68 65 20 32 35 36  |olour in the 256|
00000b20  20 63 6f 6c 6f 75 72 20  6d 6f 64 65 20 63 61 6e  | colour mode can|
00000b30  20 62 65 20 73 75 63 68  20 61 20 63 6f 6d 70 6c  | be such a compl|
00000b40  69 63 61 74 65 64 20 74  68 69 6e 67 2c 20 77 69  |icated thing, wi|
00000b50  74 68 0a 76 61 72 79 69  6e 67 20 63 61 70 61 62  |th.varying capab|
00000b60  69 6c 69 74 79 20 6f 66  20 73 70 61 6e 6e 69 6e  |ility of spannin|
00000b70  67 20 74 68 65 20 63 6f  6c 6f 75 72 20 63 75 62  |g the colour cub|
00000b80  65 20 61 6e 64 20 61 6e  20 75 6e 6b 6e 6f 77 6e  |e and an unknown|
00000b90  20 61 63 63 75 72 61 63  79 2c 20 74 68 65 72 65  | accuracy, there|
00000ba0  0a 69 73 20 61 20 52 49  53 43 20 4f 53 20 73 74  |.is a RISC OS st|
00000bb0  61 6e 64 61 72 64 20 77  61 79 20 6f 66 20 73 70  |andard way of sp|
00000bc0  65 63 69 66 79 69 6e 67  20 61 20 63 6f 6c 6f 75  |ecifying a colou|
00000bd0  72 20 79 6f 75 20 77 69  73 68 20 74 6f 20 64 72  |r you wish to dr|
00000be0  61 77 20 77 69 74 68 20  75 73 69 6e 67 20 38 0a  |aw with using 8.|
00000bf0  62 69 74 73 20 66 6f 72  20 52 2c 20 47 20 61 6e  |bits for R, G an|
00000c00  64 20 42 20 63 6f 6d 70  6f 6e 65 6e 74 73 2e 20  |d B components. |
00000c10  41 20 63 61 6c 6c 20 74  6f 20 74 68 65 20 6f 70  |A call to the op|
00000c20  65 72 61 74 69 6e 67 20  73 79 73 74 65 6d 20 63  |erating system c|
00000c30  6f 6e 76 65 72 74 73 20  74 68 69 73 20 74 6f 0a  |onverts this to.|
00000c40  74 68 65 20 6e 65 61 72  65 73 74 20 63 6f 6c 6f  |the nearest colo|
00000c50  75 72 20 61 6e 64 20 6e  65 77 20 6f 62 6a 65 63  |ur and new objec|
00000c60  74 73 20 63 61 6e 20 62  65 20 64 72 61 77 6e 2e  |ts can be drawn.|
00000c70  0a 0a 57 68 65 72 65 20  74 68 65 20 6f 62 6a 65  |..Where the obje|
00000c80  63 74 20 74 6f 20 62 65  20 64 72 61 77 6e 20 69  |ct to be drawn i|
00000c90  73 20 61 20 70 72 65 76  69 6f 75 73 6c 79 20 67  |s a previously g|
00000ca0  65 6e 65 72 61 74 65 64  20 70 69 63 74 75 72 65  |enerated picture|
00000cb0  2c 20 74 68 65 20 6d 6f  64 75 6c 65 73 0a 22 53  |, the modules."S|
00000cc0  70 72 69 74 65 45 78 74  65 6e 64 22 20 28 69 6e  |priteExtend" (in|
00000cd0  20 74 68 65 20 52 4f 4d  29 20 61 6e 64 20 22 43  | the ROM) and "C|
00000ce0  6f 6c 6f 75 72 54 72 61  6e 73 22 20 28 69 6e 20  |olourTrans" (in |
00000cf0  74 68 65 20 21 53 79 73  74 65 6d 20 64 69 72 65  |the !System dire|
00000d00  63 74 6f 72 79 29 20 69  6e 0a 52 49 53 43 20 4f  |ctory) in.RISC O|
00000d10  53 20 70 72 6f 76 69 64  65 20 73 6f 6d 65 20 63  |S provide some c|
00000d20  61 70 61 62 69 6c 69 74  65 73 20 66 6f 72 20 64  |apabilites for d|
00000d30  69 73 70 6c 61 79 69 6e  67 20 70 69 63 74 75 72  |isplaying pictur|
00000d40  65 73 20 69 6e 20 64 69  66 66 65 72 65 6e 74 20  |es in different |
00000d50  73 63 72 65 65 6e 0a 6d  6f 64 65 73 2e 20 43 6f  |screen.modes. Co|
00000d60  6c 6f 75 72 54 72 61 6e  73 20 63 61 6e 20 6c 6f  |lourTrans can lo|
00000d70  6f 6b 20 61 74 20 74 68  65 20 70 61 6c 65 74 74  |ok at the palett|
00000d80  65 20 77 68 69 63 68 20  61 20 73 70 72 69 74 65  |e which a sprite|
00000d90  20 75 73 65 73 20 61 6e  64 20 72 65 74 75 72 6e  | uses and return|
00000da0  20 61 0a 6c 69 73 74 20  6f 66 20 74 68 65 20 65  | a.list of the e|
00000db0  71 75 69 76 61 6c 65 6e  74 20 27 63 6c 6f 73 65  |quivalent 'close|
00000dc0  73 74 27 20 63 6f 6c 6f  75 72 73 20 69 6e 20 74  |st' colours in t|
00000dd0  68 65 20 63 75 72 72 65  6e 74 20 73 63 72 65 65  |he current scree|
00000de0  6e 20 6d 6f 64 65 2e 0a  53 70 72 69 74 65 45 78  |n mode..SpriteEx|
00000df0  74 65 6e 64 20 63 61 6e  20 70 61 69 6e 74 20 73  |tend can paint s|
00000e00  70 72 69 74 65 73 20 75  73 69 6e 67 20 74 68 65  |prites using the|
00000e10  20 6c 69 73 74 20 6f 66  20 65 71 75 69 76 61 6c  | list of equival|
00000e20  65 6e 74 20 63 6f 6c 6f  75 72 73 20 61 6e 64 20  |ent colours and |
00000e30  63 61 6e 0a 63 68 61 6e  67 65 20 74 68 65 20 73  |can.change the s|
00000e40  69 7a 65 20 6f 66 20 74  68 65 20 69 6d 61 67 65  |ize of the image|
00000e50  20 69 6e 74 6f 20 74 68  65 20 62 61 72 67 61 69  | into the bargai|
00000e60  6e 2e 20 54 68 69 73 20  69 73 20 61 6c 6c 20 76  |n. This is all v|
00000e70  65 72 79 20 77 65 6c 6c  20 66 6f 72 20 73 69 6d  |ery well for sim|
00000e80  70 6c 65 0a 70 69 63 74  75 72 65 73 20 6f 72 20  |ple.pictures or |
00000e90  70 69 63 74 75 72 65 73  20 63 72 65 61 74 65 64  |pictures created|
00000ea0  20 64 69 72 65 63 74 6c  79 20 66 6f 72 20 61 20  | directly for a |
00000eb0  70 61 72 74 69 63 75 6c  61 72 20 6d 6f 64 65 2c  |particular mode,|
00000ec0  20 62 75 74 20 77 68 61  74 20 68 61 70 70 65 6e  | but what happen|
00000ed0  73 0a 66 6f 72 20 6d 6f  72 65 20 64 65 74 61 69  |s.for more detai|
00000ee0  6c 65 64 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |led information |
00000ef0  6f 72 20 70 69 63 74 75  72 65 73 20 66 72 6f 6d  |or pictures from|
00000f00  20 6f 74 68 65 72 20 73  6f 75 72 63 65 73 20 77  | other sources w|
00000f10  69 74 68 20 72 65 73 6f  6c 75 74 69 6f 6e 0a 6e  |ith resolution.n|
00000f20  6f 74 20 6d 61 74 63 68  65 64 20 62 79 20 74 68  |ot matched by th|
00000f30  65 20 41 72 63 68 69 6d  65 64 65 73 20 68 61 72  |e Archimedes har|
00000f40  64 77 61 72 65 3f 0a 0a  41 6c 73 6f 20 74 68 65  |dware?..Also the|
00000f50  20 61 62 6f 76 65 20 66  61 63 69 6c 69 74 69 65  | above facilitie|
00000f60  73 20 61 72 65 20 72 61  74 68 65 72 20 62 61 73  |s are rather bas|
00000f70  69 63 3a 20 43 6f 6c 6f  75 72 54 72 61 6e 73 20  |ic: ColourTrans |
00000f80  6d 61 6b 65 73 20 6e 6f  20 65 66 66 6f 72 74 20  |makes no effort |
00000f90  74 6f 20 75 73 65 0a 64  69 74 68 65 72 69 6e 67  |to use.dithering|
00000fa0  20 28 74 68 65 20 70 72  61 63 74 69 73 65 20 6f  | (the practise o|
00000fb0  66 20 70 75 74 74 69 6e  67 20 70 61 74 74 65 72  |f putting patter|
00000fc0  6e 73 20 6f 66 20 64 69  66 66 65 72 65 6e 74 20  |ns of different |
00000fd0  63 6f 6c 6f 75 72 65 64  20 70 69 78 65 6c 73 0a  |coloured pixels.|
00000fe0  74 6f 67 65 74 68 65 72  20 74 6f 20 72 65 70 72  |together to repr|
00000ff0  65 73 65 6e 74 20 6f 74  68 65 72 20 63 6f 6c 6f  |esent other colo|
00001000  75 72 73 29 20 61 6e 64  20 53 70 72 69 74 65 45  |urs) and SpriteE|
00001010  78 74 65 6e 64 20 73 69  6d 70 6c 79 20 64 69 73  |xtend simply dis|
00001020  63 61 72 64 73 0a 61 64  64 69 74 69 6f 6e 61 6c  |cards.additional|
00001030  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 69 66 20  | information if |
00001040  72 65 64 75 63 69 6e 67  20 74 68 65 20 70 69 63  |reducing the pic|
00001050  74 75 72 65 20 69 6e 20  73 69 7a 65 20 28 61 6e  |ture in size (an|
00001060  64 20 74 6f 67 65 74 68  65 72 20 74 68 65 79 20  |d together they |
00001070  6d 61 6b 65 0a 6e 6f 20  61 74 74 65 6d 70 74 20  |make.no attempt |
00001080  74 6f 20 65 6e 68 61 6e  63 65 20 74 68 65 20 70  |to enhance the p|
00001090  69 63 74 75 72 65 20 77  68 65 6e 20 6d 61 6b 69  |icture when maki|
000010a0  6e 67 20 69 74 20 6c 61  72 67 65 72 29 2e 20 54  |ng it larger). T|
000010b0  68 65 20 72 65 61 73 6f  6e 20 66 6f 72 20 74 68  |he reason for th|
000010c0  65 73 65 0a 73 68 6f 72  74 63 6f 6d 69 6e 67 73  |ese.shortcomings|
000010d0  20 69 73 20 71 75 69 74  65 20 73 69 6d 70 6c 65  | is quite simple|
000010e0  3a 20 73 70 65 65 64 2e  20 54 68 65 20 61 6c 67  |: speed. The alg|
000010f0  6f 72 69 74 68 6d 20 75  73 65 64 20 69 6e 20 43  |orithm used in C|
00001100  68 61 6e 67 65 46 53 49  20 75 73 65 73 20 31 30  |hangeFSI uses 10|
00001110  35 0a 41 52 4d 20 69 6e  73 74 72 75 63 74 69 6f  |5.ARM instructio|
00001120  6e 73 20 70 65 72 20 70  69 78 65 6c 20 2d 20 61  |ns per pixel - a|
00001130  6e 64 20 74 68 61 74 27  73 20 61 70 61 72 74 20  |nd that's apart |
00001140  66 72 6f 6d 20 61 6e 79  20 69 6e 73 74 72 75 63  |from any instruc|
00001150  74 69 6f 6e 73 20 75 73  65 64 20 74 6f 0a 72 65  |tions used to.re|
00001160  61 64 20 74 68 65 20 69  6d 61 67 65 20 69 6e 2c  |ad the image in,|
00001170  20 63 68 61 6e 67 65 20  69 74 73 20 73 69 7a 65  | change its size|
00001180  20 61 6e 64 20 77 72 69  74 65 20 74 68 65 20 72  | and write the r|
00001190  65 73 75 6c 74 20 6f 75  74 2e 20 46 6f 72 20 63  |esult out. For c|
000011a0  6f 6d 70 61 72 69 73 6f  6e 2c 0a 74 68 65 20 6e  |omparison,.the n|
000011b0  6f 72 6d 61 6c 20 73 70  72 69 74 65 20 70 6c 6f  |ormal sprite plo|
000011c0  74 20 74 61 6b 65 73 20  6f 6e 6c 79 20 6f 6e 65  |t takes only one|
000011d0  20 69 6e 73 74 72 75 63  74 69 6f 6e 20 70 65 72  | instruction per|
000011e0  20 70 69 78 65 6c 20 28  34 20 69 6e 73 74 72 75  | pixel (4 instru|
000011f0  63 74 69 6f 6e 73 20 66  6f 72 0a 66 6f 75 72 20  |ctions for.four |
00001200  38 20 62 69 74 20 70 69  78 65 6c 73 29 2e 20 50  |8 bit pixels). P|
00001210  72 6f 63 65 73 73 69 6e  67 20 61 20 4d 4f 44 45  |rocessing a MODE|
00001220  20 31 35 20 70 69 63 74  75 72 65 20 74 68 75 73  | 15 picture thus|
00001230  20 75 73 65 73 20 75 70  20 74 6f 6f 20 6d 61 6e  | uses up too man|
00001240  79 20 73 65 63 6f 6e 64  73 0a 6f 66 20 41 52 4d  |y seconds.of ARM|
00001250  20 63 70 75 20 74 69 6d  65 20 74 6f 20 69 6d 61  | cpu time to ima|
00001260  67 69 6e 65 20 69 74 20  61 73 20 70 61 72 74 20  |gine it as part |
00001270  6f 66 20 74 68 65 20 69  6e 74 65 72 61 63 74 69  |of the interacti|
00001280  76 65 20 64 65 73 6b 74  6f 70 2e 0a 0a 53 6f 20  |ve desktop...So |
00001290  77 68 61 74 20 64 6f 65  73 20 43 68 61 6e 67 65  |what does Change|
000012a0  46 53 49 20 64 6f 20 74  6f 20 6d 61 6b 65 20 74  |FSI do to make t|
000012b0  68 65 20 73 69 74 75 61  74 69 6f 6e 20 62 65 74  |he situation bet|
000012c0  74 65 72 3f 20 41 6e 64  20 77 68 79 20 64 6f 65  |ter? And why doe|
000012d0  73 20 69 74 20 74 61 6b  65 20 73 6f 0a 6c 6f 6e  |s it take so.lon|
000012e0  67 3f 20 4f 6e 65 20 63  61 6e 20 69 6d 6d 65 64  |g? One can immed|
000012f0  69 61 74 65 6c 79 20 64  72 61 77 20 75 70 20 73  |iately draw up s|
00001300  6f 6d 65 20 64 65 73 69  72 61 62 6c 65 20 70 72  |ome desirable pr|
00001310  6f 70 65 72 74 69 65 73  20 66 6f 72 20 61 6e 79  |operties for any|
00001320  20 73 6f 6c 75 74 69 6f  6e 20 74 6f 0a 74 68 65  | solution to.the|
00001330  20 69 6d 61 67 65 20 63  68 61 6e 67 69 6e 67 20  | image changing |
00001340  70 72 6f 62 6c 65 6d 3a  0a 0a 28 31 29 20 4d 61  |problem:..(1) Ma|
00001350  78 69 6d 69 73 69 6e 67  20 74 68 65 20 76 6f 6c  |ximising the vol|
00001360  75 6d 65 20 6f 66 20 74  68 65 20 63 6f 6c 6f 75  |ume of the colou|
00001370  72 20 63 75 62 65 2e 20  43 6f 6c 6f 75 72 20 72  |r cube. Colour r|
00001380  65 70 72 65 73 65 6e 74  65 64 20 69 6e 20 74 68  |epresented in th|
00001390  65 20 52 65 64 2c 0a 47  72 65 65 6e 20 61 6e 64  |e Red,.Green and|
000013a0  20 42 6c 75 65 20 63 6f  6d 70 75 74 65 72 20 67  | Blue computer g|
000013b0  72 61 70 68 69 63 73 20  73 79 73 74 65 6d 20 63  |raphics system c|
000013c0  61 6e 20 62 65 20 74 68  6f 75 67 68 74 20 6f 66  |an be thought of|
000013d0  20 61 73 20 61 20 70 6f  69 6e 74 20 69 6e 20 61  | as a point in a|
000013e0  20 33 44 0a 63 75 62 65  20 77 68 6f 73 65 20 61  | 3D.cube whose a|
000013f0  78 65 73 20 61 72 65 20  74 68 65 20 72 65 64 2c  |xes are the red,|
00001400  20 67 72 65 65 6e 20 61  6e 64 20 62 6c 75 65 20  | green and blue |
00001410  76 61 6c 75 65 73 2e 20  57 68 61 74 65 76 65 72  |values. Whatever|
00001420  20 63 6c 65 76 65 72 0a  61 70 70 72 6f 78 69 6d  | clever.approxim|
00001430  61 74 69 6f 6e 73 2c 20  64 69 74 68 65 72 69 6e  |ations, ditherin|
00001440  67 20 6f 72 20 65 72 72  6f 72 20 64 69 66 66 75  |g or error diffu|
00001450  73 69 6f 6e 20 74 65 63  68 6e 69 71 75 65 73 20  |sion techniques |
00001460  61 72 65 20 75 73 65 64  2c 20 74 68 65 20 63 6f  |are used, the co|
00001470  6c 6f 75 72 0a 76 6f 6c  75 6d 65 20 73 70 61 6e  |lour.volume span|
00001480  6e 65 64 20 62 79 20 74  68 65 20 72 2c 20 67 20  |ned by the r, g |
00001490  61 6e 64 20 62 20 61 78  65 73 20 69 6e 20 74 68  |and b axes in th|
000014a0  65 20 74 61 72 67 65 74  20 73 68 6f 75 6c 64 20  |e target should |
000014b0  62 65 20 6c 61 72 67 65  20 65 6e 6f 75 67 68 20  |be large enough |
000014c0  74 6f 0a 63 6f 6e 74 61  69 6e 20 74 68 65 20 73  |to.contain the s|
000014d0  6f 75 72 63 65 20 76 6f  6c 75 6d 65 2e 20 49 66  |ource volume. If|
000014e0  20 6e 6f 74 2c 20 74 68  65 6e 20 74 68 65 20 70  | not, then the p|
000014f0  69 63 74 75 72 65 20 77  69 6c 6c 20 61 70 70 65  |icture will appe|
00001500  61 72 20 66 61 64 65 64  20 69 6e 20 73 6f 6d 65  |ar faded in some|
00001510  0a 77 61 79 20 63 6f 6d  70 61 72 65 64 20 74 6f  |.way compared to|
00001520  20 74 68 65 20 6f 72 69  67 69 6e 61 6c 20 28 22  | the original ("|
00001530  74 68 65 20 72 65 64 20  64 6f 65 73 6e 27 74 20  |the red doesn't |
00001540  73 65 65 6d 20 71 75 69  74 65 20 74 68 65 20 73  |seem quite the s|
00001550  61 6d 65 22 29 2e 20 46  6f 72 20 61 0a 73 69 6e  |ame"). For a.sin|
00001560  67 6c 65 20 70 69 63 74  75 72 65 20 61 20 63 6f  |gle picture a co|
00001570  6c 6f 75 72 20 76 6f 6c  75 6d 65 20 6f 6e 6c 79  |lour volume only|
00001580  20 61 73 20 6c 61 72 67  65 20 61 73 20 74 68 65  | as large as the|
00001590  20 69 6e 70 75 74 20 63  6f 75 6c 64 20 62 65 20  | input could be |
000015a0  63 68 6f 73 65 6e 3b 0a  61 6c 74 65 72 6e 61 74  |chosen;.alternat|
000015b0  69 76 65 6c 79 20 66 6f  72 20 61 6e 20 61 72 62  |ively for an arb|
000015c0  69 74 72 61 72 79 20 73  65 74 20 6f 66 20 69 6e  |itrary set of in|
000015d0  70 75 74 20 70 69 63 74  75 72 65 73 2c 20 74 68  |put pictures, th|
000015e0  65 20 63 6f 6c 6f 75 72  20 76 6f 6c 75 6d 65 20  |e colour volume |
000015f0  6f 6e 20 74 68 65 0a 6f  75 74 70 75 74 20 73 79  |on the.output sy|
00001600  73 74 65 6d 20 68 61 73  20 74 6f 20 62 65 20 6d  |stem has to be m|
00001610  61 64 65 20 61 73 20 6c  61 72 67 65 20 61 73 20  |ade as large as |
00001620  70 6f 73 73 69 62 6c 65  2e 20 57 68 65 72 65 20  |possible. Where |
00001630  61 6e 69 6d 61 74 69 6f  6e 20 69 73 20 72 65 71  |animation is req|
00001640  75 69 72 65 64 0a 74 68  65 20 63 6f 6c 6f 75 72  |uired.the colour|
00001650  20 76 6f 6c 75 6d 65 20  68 61 73 20 74 6f 20 62  | volume has to b|
00001660  65 20 63 6f 6e 73 69 73  74 65 6e 74 20 66 6f 72  |e consistent for|
00001670  20 61 6c 6c 20 74 68 65  20 70 69 63 74 75 72 65  | all the picture|
00001680  73 2e 20 57 68 65 6e 20  67 65 6e 65 72 61 74 69  |s. When generati|
00001690  6e 67 0a 74 68 65 20 6c  61 72 67 65 73 74 20 76  |ng.the largest v|
000016a0  6f 6c 75 6d 65 2c 20 69  74 20 69 73 20 69 6d 70  |olume, it is imp|
000016b0  6f 72 74 61 6e 74 20 74  6f 20 75 73 65 20 74 68  |ortant to use th|
000016c0  65 20 73 79 73 74 65 6d  20 68 61 72 64 77 61 72  |e system hardwar|
000016d0  65 20 74 6f 20 74 68 65  20 6c 69 6d 69 74 3a 0a  |e to the limit:.|
000016e0  66 6f 72 20 65 78 61 6d  70 6c 65 2c 20 69 66 20  |for example, if |
000016f0  6f 6e 65 20 68 61 73 20  74 77 6f 20 62 69 74 73  |one has two bits|
00001700  20 6f 66 20 63 6f 6e 74  72 6f 6c 20 6f 76 65 72  | of control over|
00001710  20 74 68 65 20 41 72 63  68 69 6d 65 64 65 73 20  | the Archimedes |
00001720  34 20 62 69 74 20 44 20  74 6f 20 41 0a 63 6f 6e  |4 bit D to A.con|
00001730  76 65 72 74 65 72 73 2c  20 74 68 65 20 6c 61 72  |verters, the lar|
00001740  67 65 73 74 20 72 61 6e  67 65 20 69 73 20 63 6f  |gest range is co|
00001750  76 65 72 65 64 20 62 79  20 76 61 6c 75 65 73 20  |vered by values |
00001760  30 2c 20 35 2c 20 31 30  20 61 6e 64 20 31 35 20  |0, 5, 10 and 15 |
00001770  28 72 61 74 68 65 72 20  74 68 61 6e 0a 30 2c 20  |(rather than.0, |
00001780  34 2c 20 38 20 61 6e 64  20 31 32 29 2e 0a 0a 28  |4, 8 and 12)...(|
00001790  32 29 20 47 69 76 69 6e  67 20 68 75 65 20 63 6f  |2) Giving hue co|
000017a0  6e 73 69 73 74 65 6e 63  79 20 61 74 20 64 69 66  |nsistency at dif|
000017b0  66 65 72 65 6e 74 20 73  61 74 75 72 61 74 69 6f  |ferent saturatio|
000017c0  6e 73 2e 20 46 6f 72 20  65 78 61 6d 70 6c 65 2c  |ns. For example,|
000017d0  20 77 69 74 68 20 61 0a  70 61 6c 65 74 74 65 20  | with a.palette |
000017e0  77 69 74 68 20 64 69 66  66 65 72 65 6e 74 20 6e  |with different n|
000017f0  75 6d 62 65 72 73 20 6f  66 20 62 69 74 73 20 6f  |umbers of bits o|
00001800  66 20 72 2c 20 67 20 61  6e 64 20 62 20 69 74 20  |f r, g and b it |
00001810  6d 61 79 20 62 65 20 69  6d 70 6f 73 73 69 62 6c  |may be impossibl|
00001820  65 20 74 6f 0a 68 61 76  65 20 61 20 63 6f 6e 73  |e to.have a cons|
00001830  69 73 74 65 6e 74 20 73  65 74 20 6f 66 20 63 6f  |istent set of co|
00001840  6c 6f 75 72 73 20 72 65  70 72 65 73 65 6e 74 69  |lours representi|
00001850  6e 67 20 64 65 72 69 76  65 64 20 63 6f 6c 6f 75  |ng derived colou|
00001860  72 73 20 61 74 20 64 69  66 66 65 72 65 6e 74 0a  |rs at different.|
00001870  6c 65 76 65 6c 73 20 6f  66 20 69 6e 74 65 6e 73  |levels of intens|
00001880  69 74 79 2e 20 53 68 61  64 65 73 20 6f 66 20 77  |ity. Shades of w|
00001890  68 69 74 65 20 61 6e 64  20 73 65 63 6f 6e 64 61  |hite and seconda|
000018a0  72 79 20 63 6f 6c 6f 75  72 73 20 28 63 79 61 6e  |ry colours (cyan|
000018b0  2c 20 6d 61 67 65 6e 74  61 20 61 6e 64 0a 79 65  |, magenta and.ye|
000018c0  6c 6c 6f 77 29 20 61 72  65 20 70 61 72 74 69 63  |llow) are partic|
000018d0  75 6c 61 72 6c 79 20 64  69 66 66 69 63 75 6c 74  |ularly difficult|
000018e0  2e 0a 0a 28 33 29 20 57  6f 72 6b 69 6e 67 20 77  |...(3) Working w|
000018f0  69 74 68 20 74 68 65 20  6d 75 6c 74 69 2d 74 61  |ith the multi-ta|
00001900  73 6b 69 6e 67 20 64 65  73 6b 74 6f 70 2e 20 41  |sking desktop. A|
00001910  63 6f 72 6e 20 61 72 65  20 61 73 6b 69 6e 67 20  |corn are asking |
00001920  66 6f 72 20 61 6c 6c 20  6e 65 77 0a 73 6f 66 74  |for all new.soft|
00001930  77 61 72 65 20 74 6f 20  62 65 20 62 75 69 6c 74  |ware to be built|
00001940  20 6f 6e 20 74 68 65 20  6d 75 6c 74 69 74 61 73  | on the multitas|
00001950  6b 69 6e 67 20 73 79 73  74 65 6d 2e 20 54 68 69  |king system. Thi|
00001960  73 20 69 6d 70 6c 69 65  73 20 74 68 61 74 20 74  |s implies that t|
00001970  68 65 20 70 61 6c 65 74  74 65 0a 73 68 6f 75 6c  |he palette.shoul|
00001980  64 20 6e 6f 74 20 62 65  20 63 68 61 6e 67 65 64  |d not be changed|
00001990  20 28 6f 72 20 74 68 61  74 20 74 68 65 20 61 67  | (or that the ag|
000019a0  72 65 65 6d 65 6e 74 20  6f 66 20 61 6c 6c 20 70  |reement of all p|
000019b0  72 6f 67 72 61 6d 73 20  63 75 72 72 65 6e 74 6c  |rograms currentl|
000019c0  79 20 72 75 6e 6e 69 6e  67 0a 69 73 20 6f 62 74  |y running.is obt|
000019d0  61 69 6e 65 64 20 66 69  72 73 74 29 2e 0a 0a 54  |ained first)...T|
000019e0  68 65 20 64 65 73 6b 74  6f 70 20 28 64 65 66 61  |he desktop (defa|
000019f0  75 6c 74 29 20 70 61 6c  65 74 74 65 20 69 6e 20  |ult) palette in |
00001a00  74 68 65 20 32 35 36 20  63 6f 6c 6f 75 72 20 6d  |the 256 colour m|
00001a10  6f 64 65 73 20 28 65 2e  67 2e 20 6d 6f 64 65 73  |odes (e.g. modes|
00001a20  20 31 33 2c 20 31 35 2c  20 32 31 2c 0a 32 34 20  | 13, 15, 21,.24 |
00001a30  61 6e 64 20 32 38 29 20  69 73 20 71 75 69 74 65  |and 28) is quite|
00001a40  20 77 65 6c 6c 20 64 65  73 69 67 6e 65 64 2e 20  | well designed. |
00001a50  49 74 20 64 6f 65 73 20  68 61 76 65 20 74 68 65  |It does have the|
00001a60  20 70 72 6f 70 65 72 74  69 65 73 20 6f 66 20 28  | properties of (|
00001a70  31 29 20 61 6e 64 20 28  32 29 0a 28 69 74 20 65  |1) and (2).(it e|
00001a80  76 65 6e 20 68 61 73 20  31 36 20 73 68 61 64 65  |ven has 16 shade|
00001a90  73 20 6f 66 20 67 72 65  79 29 20 61 6e 64 20 61  |s of grey) and a|
00001aa0  75 74 6f 6d 61 74 69 63  61 6c 6c 79 20 73 61 74  |utomatically sat|
00001ab0  69 73 66 69 65 73 20 28  33 29 2e 20 49 74 20 69  |isfies (3). It i|
00001ac0  73 20 75 73 65 64 20 62  79 0a 6d 61 6e 79 20 41  |s used by.many A|
00001ad0  63 6f 72 6e 20 70 72 6f  67 72 61 6d 73 20 28 44  |corn programs (D|
00001ae0  72 61 77 2c 20 50 61 69  6e 74 29 20 61 6e 64 20  |raw, Paint) and |
00001af0  62 79 20 65 78 74 65 72  6e 61 6c 20 70 72 6f 67  |by external prog|
00001b00  72 61 6d 73 20 28 45 75  63 6c 69 64 2c 20 50 72  |rams (Euclid, Pr|
00001b10  6f 41 72 74 69 73 61 6e  2c 0a 41 74 65 6c 69 65  |oArtisan,.Atelie|
00001b20  72 2c 20 2e 2e 29 20 74  6f 20 67 72 65 61 74 20  |r, ..) to great |
00001b30  65 66 66 65 63 74 20 61  6e 64 20 69 73 20 61 20  |effect and is a |
00001b40  73 61 66 65 20 63 68 6f  69 63 65 20 66 6f 72 20  |safe choice for |
00001b50  43 68 61 6e 67 65 46 53  49 2e 20 54 68 65 72 65  |ChangeFSI. There|
00001b60  20 61 72 65 20 74 77 6f  0a 77 61 79 73 20 43 68  | are two.ways Ch|
00001b70  61 6e 67 65 46 53 49 20  63 61 6e 20 63 68 6f 6f  |angeFSI can choo|
00001b80  73 65 20 61 20 63 6f 6c  6f 75 72 3a 0a 0a 28 61  |se a colour:..(a|
00001b90  29 20 61 20 6d 65 74 68  6f 64 20 77 68 69 63 68  |) a method which|
00001ba0  20 64 65 72 69 76 65 73  20 76 61 6c 75 65 73 20  | derives values |
00001bb0  66 6f 72 20 72 2c 20 67  2c 20 62 20 61 6e 64 20  |for r, g, b and |
00001bc0  74 69 6e 74 20 61 6c 67  6f 72 69 74 68 6d 69 63  |tint algorithmic|
00001bd0  61 6c 6c 79 20 28 6e 6f  0a 73 75 66 66 69 78 29  |ally (no.suffix)|
00001be0  20 28 73 75 69 74 61 62  6c 65 20 6f 6e 6c 79 20  | (suitable only |
00001bf0  66 6f 72 20 74 68 65 20  64 65 66 61 75 6c 74 20  |for the default |
00001c00  52 49 53 43 20 4f 53 20  32 35 36 20 63 6f 6c 6f  |RISC OS 256 colo|
00001c10  75 72 20 70 61 6c 65 74  74 65 29 0a 0a 28 62 29  |ur palette)..(b)|
00001c20  20 73 65 61 72 63 68 20  74 68 65 20 70 61 6c 65  | search the pale|
00001c30  74 74 65 20 66 6f 72 20  74 68 65 20 63 6c 6f 73  |tte for the clos|
00001c40  65 73 74 20 63 6f 6c 6f  75 72 20 28 72 20 73 75  |est colour (r su|
00001c50  66 66 69 78 29 2e 20 54  68 65 20 70 72 65 63 69  |ffix). The preci|
00001c60  73 65 20 6d 65 74 68 6f  64 20 62 79 0a 77 68 69  |se method by.whi|
00001c70  63 68 20 74 68 69 73 20  69 73 20 64 6f 6e 65 20  |ch this is done |
00001c80  69 73 20 74 68 65 20 73  75 62 6a 65 63 74 20 6f  |is the subject o|
00001c90  66 20 61 6e 6f 74 68 65  72 20 64 6f 63 75 6d 65  |f another docume|
00001ca0  6e 74 2e 0a 0a 41 53 49  44 45 3a 20 74 68 65 20  |nt...ASIDE: the |
00001cb0  63 6c 6f 73 65 73 74 20  63 6f 6c 6f 75 72 20 69  |closest colour i|
00001cc0  73 20 63 68 6f 73 65 6e  20 73 75 63 68 20 74 68  |s chosen such th|
00001cd0  61 74 20 74 68 65 20 64  69 73 74 61 6e 63 65 20  |at the distance |
00001ce0  62 65 74 77 65 65 6e 20  74 68 65 20 74 72 75 65  |between the true|
00001cf0  0a 63 6f 6c 6f 75 72 20  61 6e 64 20 74 68 65 20  |.colour and the |
00001d00  63 68 6f 69 63 65 20 69  73 20 6d 69 6e 69 6d 69  |choice is minimi|
00001d10  73 65 64 20 69 6e 20 74  68 65 20 63 6f 6c 6f 75  |sed in the colou|
00001d20  72 20 63 75 62 65 20 73  70 61 63 65 2e 20 53 69  |r cube space. Si|
00001d30  6e 63 65 20 74 68 65 20  68 75 6d 61 6e 0a 65 79  |nce the human.ey|
00001d40  65 20 69 73 20 6d 6f 72  65 20 73 65 6e 73 69 74  |e is more sensit|
00001d50  69 76 65 20 74 6f 20 67  72 65 65 6e 2c 20 74 68  |ive to green, th|
00001d60  65 6e 20 72 65 64 20 61  6e 64 20 6c 61 73 74 6c  |en red and lastl|
00001d70  79 20 62 6c 75 65 2c 20  74 68 65 20 64 69 73 74  |y blue, the dist|
00001d80  61 6e 63 65 20 66 75 6e  63 74 69 6f 6e 0a 69 73  |ance function.is|
00001d90  20 77 65 69 67 68 74 65  64 20 31 30 2c 20 33 20  | weighted 10, 3 |
00001da0  61 6e 64 20 31 20 69 6e  20 67 72 65 65 6e 27 73  |and 1 in green's|
00001db0  20 66 61 76 6f 75 72 2e  0a 0a 57 69 74 68 20 74  | favour...With t|
00001dc0  68 65 20 31 36 20 63 6f  6c 6f 75 72 20 6d 6f 64  |he 16 colour mod|
00001dd0  65 73 20 28 65 2e 67 2e  20 6d 6f 64 65 73 20 39  |es (e.g. modes 9|
00001de0  2c 20 31 32 2c 20 31 36  2c 20 32 30 20 61 6e 64  |, 12, 16, 20 and|
00001df0  20 32 37 29 20 74 68 65  20 64 65 66 61 75 6c 74  | 27) the default|
00001e00  20 70 61 6c 65 74 74 65  0a 64 6f 65 73 20 6e 6f  | palette.does no|
00001e10  74 20 73 61 74 69 73 66  79 20 28 31 29 20 61 6e  |t satisfy (1) an|
00001e20  64 20 28 32 29 20 75 6e  6c 65 73 73 20 74 68 65  |d (2) unless the|
00001e30  20 6f 75 74 70 75 74 20  69 73 20 70 75 72 65 6c  | output is purel|
00001e40  79 20 73 68 61 64 65 73  20 6f 66 20 67 72 65 79  |y shades of grey|
00001e50  20 2d 0a 43 68 61 6e 67  65 46 53 49 20 63 61 6e  | -.ChangeFSI can|
00001e60  20 75 73 65 20 65 69 74  68 65 72 20 38 20 67 72  | use either 8 gr|
00001e70  65 79 73 20 28 66 6f 72  20 74 68 65 20 64 65 73  |eys (for the des|
00001e80  6b 74 6f 70 29 20 6f 72  20 31 36 20 67 72 65 79  |ktop) or 16 grey|
00001e90  73 20 28 6f 75 74 20 6f  66 20 74 68 65 0a 64 65  |s (out of the.de|
00001ea0  73 6b 74 6f 70 20 6f 72  20 77 69 74 68 20 74 68  |sktop or with th|
00001eb0  65 20 64 65 73 6b 74 6f  70 20 70 61 6c 65 74 74  |e desktop palett|
00001ec0  65 20 61 6c 74 65 72 65  64 20 74 6f 20 70 72 6f  |e altered to pro|
00001ed0  76 69 64 65 20 31 36 20  67 72 65 79 73 29 2e 20  |vide 16 greys). |
00001ee0  46 6f 72 20 63 6f 6c 6f  75 72 0a 72 65 70 72 65  |For colour.repre|
00001ef0  73 65 6e 74 61 74 69 6f  6e 2c 20 43 68 61 6e 67  |sentation, Chang|
00001f00  65 46 53 49 20 63 61 6e  20 65 69 74 68 65 72 3a  |eFSI can either:|
00001f10  0a 0a 28 61 29 20 75 73  65 20 31 20 62 69 74 20  |..(a) use 1 bit |
00001f20  6f 66 20 72 65 64 2c 20  31 20 62 69 74 20 6f 66  |of red, 1 bit of|
00001f30  20 67 72 65 65 6e 20 61  6e 64 20 31 20 62 69 74  | green and 1 bit|
00001f40  20 6f 66 20 62 6c 75 65  20 28 69 2e 65 2e 20 74  | of blue (i.e. t|
00001f50  68 65 20 73 74 61 6e 64  61 72 64 20 38 0a 64 69  |he standard 8.di|
00001f60  67 69 74 61 6c 20 63 6f  6c 6f 75 72 73 20 42 6c  |gital colours Bl|
00001f70  61 63 6b 2c 20 52 65 64  2c 20 47 72 65 65 6e 2c  |ack, Red, Green,|
00001f80  20 42 6c 75 65 2c 20 59  65 6c 6c 6f 77 2c 20 4d  | Blue, Yellow, M|
00001f90  61 67 65 6e 74 61 2c 20  43 79 61 6e 20 61 6e 64  |agenta, Cyan and|
00001fa0  20 57 68 69 74 65 29 2e  20 54 68 69 73 0a 73 70  | White). This.sp|
00001fb0  61 6e 73 20 74 68 65 20  63 6f 6c 6f 75 72 20 63  |ans the colour c|
00001fc0  75 62 65 20 61 6e 64 20  69 73 20 68 75 65 20 63  |ube and is hue c|
00001fd0  6f 6e 73 69 73 74 65 6e  74 2c 20 62 75 74 20 64  |onsistent, but d|
00001fe0  6f 65 73 6e 27 74 20 75  73 65 20 74 68 65 20 66  |oesn't use the f|
00001ff0  75 6c 6c 20 72 61 6e 67  65 20 6f 66 0a 62 69 74  |ull range of.bit|
00002000  73 20 70 72 6f 76 69 64  65 64 20 69 6e 20 74 68  |s provided in th|
00002010  65 20 66 6f 72 6d 61 74  2e 20 43 6f 6c 6f 75 72  |e format. Colour|
00002020  54 72 61 6e 73 20 63 61  6e 20 6d 61 70 20 74 68  |Trans can map th|
00002030  69 73 20 74 6f 20 74 68  65 20 64 65 73 6b 74 6f  |is to the deskto|
00002040  70 20 77 69 74 68 20 74  68 65 0a 73 74 61 6e 64  |p with the.stand|
00002050  61 72 64 20 70 61 6c 65  74 74 65 20 77 69 74 68  |ard palette with|
00002060  20 66 61 69 72 20 73 75  63 63 65 73 73 2c 20 65  | fair success, e|
00002070  78 63 65 70 74 20 66 6f  72 20 74 68 65 20 6c 61  |xcept for the la|
00002080  63 6b 20 6f 66 20 6d 61  67 65 6e 74 61 20 28 66  |ck of magenta (f|
00002090  75 6c 6c 0a 72 65 64 2b  66 75 6c 6c 20 62 6c 75  |ull.red+full blu|
000020a0  65 29 20 69 6e 20 74 68  65 20 70 61 6c 65 74 74  |e) in the palett|
000020b0  65 2e 20 41 20 62 65 74  74 65 72 20 72 65 73 75  |e. A better resu|
000020c0  6c 74 20 63 61 6e 20 62  65 20 61 63 68 69 65 76  |lt can be achiev|
000020d0  65 64 20 62 79 20 73 65  74 74 69 6e 67 20 36 20  |ed by setting 6 |
000020e0  6f 66 0a 74 68 65 20 63  6f 6c 6f 75 72 73 20 69  |of.the colours i|
000020f0  6e 20 74 68 65 20 70 61  6c 65 74 74 65 20 74 6f  |n the palette to|
00002100  20 72 65 64 2c 20 67 72  65 65 6e 2c 20 79 65 6c  | red, green, yel|
00002110  6c 6f 77 2c 20 62 6c 75  65 2c 20 6d 61 67 65 6e  |low, blue, magen|
00002120  74 61 20 61 6e 64 20 63  79 61 6e 2e 20 53 69 6e  |ta and cyan. Sin|
00002130  63 65 0a 43 6f 6c 6f 75  72 54 72 61 6e 73 20 77  |ce.ColourTrans w|
00002140  69 6c 6c 20 6d 61 70 20  74 68 65 20 63 6f 6c 6f  |ill map the colo|
00002150  75 72 73 20 61 6e 79 77  61 79 2c 20 69 74 20 64  |urs anyway, it d|
00002160  6f 65 73 6e 27 74 20 6d  61 74 74 65 72 20 77 68  |oesn't matter wh|
00002170  69 63 68 20 36 2c 20 62  75 74 20 74 68 65 0a 6d  |ich 6, but the.m|
00002180  6f 73 74 20 63 6f 6e 73  69 73 74 65 6e 74 20 76  |ost consistent v|
00002190  61 6c 75 65 73 20 61 72  65 20 38 3d 62 6c 75 65  |alues are 8=blue|
000021a0  2c 20 39 3d 79 65 6c 6c  6f 77 2c 20 31 30 3d 67  |, 9=yellow, 10=g|
000021b0  72 65 65 6e 2c 20 31 31  3d 72 65 64 2c 20 31 33  |reen, 11=red, 13|
000021c0  3d 63 79 61 6e 2c 0a 31  34 3d 6d 61 67 65 6e 74  |=cyan,.14=magent|
000021d0  61 20 28 6c 65 61 76 69  6e 67 20 30 2d 37 2c 20  |a (leaving 0-7, |
000021e0  31 32 20 61 6e 64 20 31  35 20 75 6e 63 68 61 6e  |12 and 15 unchan|
000021f0  67 65 64 29 2e 20 54 68  69 73 20 6f 70 74 69 6f  |ged). This optio|
00002200  6e 20 69 73 20 73 65 6c  65 63 74 65 64 20 62 79  |n is selected by|
00002210  20 61 20 22 64 22 0a 28  64 69 67 69 74 61 6c 20  | a "d".(digital |
00002220  52 47 42 29 20 73 75 66  66 69 78 20 74 6f 20 74  |RGB) suffix to t|
00002230  68 65 20 70 72 6f 67 72  61 6d 27 73 20 6d 6f 64  |he program's mod|
00002240  65 20 61 72 67 75 6d 65  6e 74 2e 0a 0a 6f 72 20  |e argument...or |
00002250  28 62 29 20 73 65 61 72  63 68 20 74 68 65 20 70  |(b) search the p|
00002260  61 6c 65 74 74 65 20 66  6f 72 20 74 68 65 20 63  |alette for the c|
00002270  6c 6f 73 65 73 74 20 63  6f 6c 6f 75 72 20 28 72  |losest colour (r|
00002280  20 73 75 66 66 69 78 29  20 5b 43 68 61 6e 67 65  | suffix) [Change|
00002290  46 53 49 20 6e 65 65 64  73 20 74 6f 0a 62 65 20  |FSI needs to.be |
000022a0  69 6e 20 74 68 65 20 31  36 20 63 6f 6c 6f 75 72  |in the 16 colour|
000022b0  20 6d 6f 64 65 20 69 6e  20 6f 72 64 65 72 20 74  | mode in order t|
000022c0  6f 20 72 65 61 64 20 74  68 65 20 70 61 6c 65 74  |o read the palet|
000022d0  74 65 5d 0a 0a 57 69 74  68 20 74 68 65 20 34 20  |te]..With the 4 |
000022e0  63 6f 6c 6f 75 72 20 6d  6f 64 65 73 20 28 65 2e  |colour modes (e.|
000022f0  67 2e 20 6d 6f 64 65 73  20 38 2c 20 31 31 2c 20  |g. modes 8, 11, |
00002300  31 39 20 61 6e 64 20 32  36 29 20 43 68 61 6e 67  |19 and 26) Chang|
00002310  65 46 53 49 20 69 73 20  72 65 61 6c 6c 79 0a 70  |eFSI is really.p|
00002320  75 73 68 65 64 2e 20 53  68 61 64 65 73 20 6f 66  |ushed. Shades of|
00002330  20 67 72 65 79 20 6f 75  74 70 75 74 20 69 73 20  | grey output is |
00002340  64 6f 6e 65 20 77 69 74  68 20 74 68 65 20 30 2c  |done with the 0,|
00002350  20 35 2c 20 31 30 2c 20  31 35 20 6c 65 76 65 6c  | 5, 10, 15 level|
00002360  20 70 61 6c 65 74 74 65  2e 20 42 75 74 0a 68 6f  | palette. But.ho|
00002370  77 20 63 61 6e 20 63 6f  6c 6f 75 72 20 62 65 20  |w can colour be |
00002380  64 6f 6e 65 3f 20 46 6f  72 20 65 78 61 6d 70 6c  |done? For exampl|
00002390  65 2c 20 65 61 63 68 20  70 69 78 65 6c 20 63 61  |e, each pixel ca|
000023a0  6e 20 64 69 73 70 6c 61  79 20 6f 6e 6c 79 20 6f  |n display only o|
000023b0  6e 65 20 6f 66 20 28 73  61 79 29 0a 62 6c 61 63  |ne of (say).blac|
000023c0  6b 2c 20 72 65 64 2c 20  67 72 65 65 6e 20 6f 72  |k, red, green or|
000023d0  20 62 6c 75 65 2e 20 54  68 69 73 20 66 61 69 6c  | blue. This fail|
000023e0  73 20 74 6f 20 73 70 61  6e 20 74 68 65 20 63 6f  |s to span the co|
000023f0  6c 6f 75 72 20 63 75 62  65 20 28 69 74 20 64 6f  |lour cube (it do|
00002400  65 73 20 6f 6e 6c 79 0a  68 61 6c 66 20 6f 66 20  |es only.half of |
00002410  69 74 29 2c 20 68 6f 77  65 76 65 72 2c 20 73 6f  |it), however, so|
00002420  20 62 6c 61 63 6b 2c 20  63 79 61 6e 2c 20 6d 61  | black, cyan, ma|
00002430  67 65 6e 74 61 20 61 6e  64 20 79 65 6c 6c 6f 77  |genta and yellow|
00002440  20 61 72 65 20 75 73 65  64 20 69 6e 73 74 65 61  | are used instea|
00002450  64 2e 20 54 68 65 0a 72  65 73 74 20 68 61 73 20  |d. The.rest has |
00002460  74 6f 20 62 65 20 6c 65  66 74 20 74 6f 20 6c 75  |to be left to lu|
00002470  63 6b 3a 20 74 68 65 72  65 20 69 73 20 6e 6f 20  |ck: there is no |
00002480  77 61 79 20 69 74 20 63  61 6e 20 61 70 70 72 6f  |way it can appro|
00002490  78 69 6d 61 74 65 20 74  6f 20 70 75 72 65 20 73  |ximate to pure s|
000024a0  68 61 64 65 73 0a 6f 66  20 72 65 64 2c 20 67 72  |hades.of red, gr|
000024b0  65 65 6e 20 6f 72 20 62  6c 75 65 2e 20 34 20 62  |een or blue. 4 b|
000024c0  69 74 20 63 6f 6c 6f 75  72 20 70 69 63 74 75 72  |it colour pictur|
000024d0  65 73 20 63 61 6e 20 62  65 20 73 65 65 6e 20 6f  |es can be seen o|
000024e0  6e 20 74 68 65 20 64 65  73 6b 74 6f 70 20 69 6e  |n the desktop in|
000024f0  20 31 36 0a 63 6f 6c 6f  75 72 20 6d 6f 64 65 73  | 16.colour modes|
00002500  20 77 69 74 68 20 74 68  65 20 61 62 6f 76 65 20  | with the above |
00002510  70 61 6c 65 74 74 65 20  6f 72 20 69 6e 20 32 35  |palette or in 25|
00002520  36 20 63 6f 6c 6f 75 72  20 6d 6f 64 65 73 2e 20  |6 colour modes. |
00002530  54 68 69 73 20 6f 70 74  69 6f 6e 20 69 73 20 62  |This option is b|
00002540  79 20 61 0a 22 63 22 20  73 75 66 66 69 78 2e 20  |y a."c" suffix. |
00002550  49 66 20 79 6f 75 20 63  61 6e 20 70 72 6f 76 69  |If you can provi|
00002560  64 65 20 61 20 62 65 74  74 65 72 20 70 61 6c 65  |de a better pale|
00002570  74 74 65 2c 20 74 68 65  6e 20 43 68 61 6e 67 65  |tte, then Change|
00002580  46 53 49 20 63 61 6e 20  75 73 65 20 69 74 20 77  |FSI can use it w|
00002590  69 74 68 0a 74 68 65 20  22 72 22 20 73 75 66 66  |ith.the "r" suff|
000025a0  69 78 20 73 65 61 72 63  68 20 6d 65 74 68 6f 64  |ix search method|
000025b0  2e 0a 0a 57 69 74 68 20  32 20 63 6f 6c 6f 75 72  |...With 2 colour|
000025c0  20 6d 6f 64 65 73 20 28  65 2e 67 2e 20 6d 6f 64  | modes (e.g. mod|
000025d0  65 73 20 30 2c 20 31 38  2c 20 32 33 20 61 6e 64  |es 0, 18, 23 and|
000025e0  20 32 35 29 20 70 69 78  65 6c 73 20 61 72 65 20  | 25) pixels are |
000025f0  65 69 74 68 65 72 20 4f  4e 20 6f 72 20 4f 46 46  |either ON or OFF|
00002600  2c 0a 43 68 61 6e 67 65  46 53 49 20 77 69 6c 6c  |,.ChangeFSI will|
00002610  20 6f 6e 6c 79 20 64 6f  20 73 68 61 64 65 73 20  | only do shades |
00002620  6f 66 20 67 72 65 79 20  6f 75 74 70 75 74 2e 2e  |of grey output..|
00002630  2e 2e 20 48 6f 77 65 76  65 72 2c 20 74 68 65 20  |.. However, the |
00002640  6d 65 74 68 6f 64 20 75  73 65 64 20 63 61 6e 0a  |method used can.|
00002650  62 65 20 76 61 72 69 65  64 20 28 73 65 65 20 6c  |be varied (see l|
00002660  61 74 65 72 29 2e 0a 0a  53 6f 20 74 68 61 74 27  |ater)...So that'|
00002670  73 20 74 68 65 20 63 61  6e 76 61 73 20 43 68 61  |s the canvas Cha|
00002680  6e 67 65 46 53 49 20 68  61 73 20 74 6f 20 77 6f  |ngeFSI has to wo|
00002690  72 6b 20 6f 6e 2e 20 48  6f 77 20 64 6f 65 73 20  |rk on. How does |
000026a0  69 74 20 64 69 73 70 6c  61 79 20 74 68 65 20 69  |it display the i|
000026b0  6e 70 75 74 0a 72 61 6e  67 65 20 6f 66 20 63 6f  |nput.range of co|
000026c0  6c 6f 75 72 73 20 6f 6e  20 74 68 65 73 65 20 6f  |lours on these o|
000026d0  75 74 70 75 74 73 3f 20  54 68 65 20 61 6e 73 77  |utputs? The answ|
000026e0  65 72 20 69 73 2c 20 61  73 20 73 74 61 74 65 64  |er is, as stated|
000026f0  20 61 62 6f 76 65 2c 20  64 69 74 68 65 72 69 6e  | above, ditherin|
00002700  67 3a 0a 74 68 65 20 70  72 6f 63 65 73 73 20 6f  |g:.the process o|
00002710  66 20 61 70 70 72 6f 78  69 6d 61 74 69 6e 67 20  |f approximating |
00002720  69 6e 74 65 6e 73 69 74  79 20 76 61 72 69 61 74  |intensity variat|
00002730  69 6f 6e 73 20 77 69 74  68 20 70 61 74 74 65 72  |ions with patter|
00002740  6e 65 64 20 61 72 65 61  73 2e 20 54 68 65 72 65  |ned areas. There|
00002750  0a 61 72 65 20 74 77 6f  20 62 61 73 69 63 20 74  |.are two basic t|
00002760  79 70 65 73 20 6f 66 20  64 69 74 68 65 72 69 6e  |ypes of ditherin|
00002770  67 20 74 65 63 68 6e 69  71 75 65 3a 20 74 68 61  |g technique: tha|
00002780  74 20 75 73 65 64 20 74  6f 20 70 72 69 6e 74 20  |t used to print |
00002790  63 6f 6c 6f 75 72 20 6d  61 67 61 7a 69 6e 65 73  |colour magazines|
000027a0  0a 61 6e 64 20 6e 65 77  73 70 61 70 65 72 20 70  |.and newspaper p|
000027b0  68 6f 74 6f 67 72 61 70  68 73 20 22 63 6c 75 73  |hotographs "clus|
000027c0  74 65 72 65 64 20 64 6f  74 20 64 69 74 68 65 72  |tered dot dither|
000027d0  22 20 2d 20 74 68 65 20  73 69 7a 65 20 6f 66 20  |" - the size of |
000027e0  74 68 65 20 64 6f 74 20  6f 66 20 69 6e 6b 0a 67  |the dot of ink.g|
000027f0  69 76 65 73 20 74 68 65  20 69 6e 74 65 6e 73 69  |ives the intensi|
00002800  74 79 3b 20 61 6e 64 20  74 68 61 74 20 75 73 65  |ty; and that use|
00002810  64 20 6f 6e 20 64 6f 74  20 6d 61 74 72 69 78 20  |d on dot matrix |
00002820  64 69 73 70 6c 61 79 73  2c 20 66 6f 72 20 65 78  |displays, for ex|
00002830  61 6d 70 6c 65 20 74 68  65 20 67 72 65 79 0a 6c  |ample the grey.l|
00002840  65 76 65 6c 20 70 61 74  74 65 72 6e 73 20 75 73  |evel patterns us|
00002850  65 64 20 62 79 20 31 20  62 69 74 20 70 65 72 20  |ed by 1 bit per |
00002860  70 69 78 65 6c 20 6d 6f  64 65 20 6f 6e 20 74 68  |pixel mode on th|
00002870  65 20 64 65 73 6b 74 6f  70 20 22 64 69 73 70 65  |e desktop "dispe|
00002880  72 73 65 64 20 64 6f 74  0a 64 69 74 68 65 72 22  |rsed dot.dither"|
00002890  20 77 68 65 72 65 20 74  68 65 20 61 76 65 72 61  | where the avera|
000028a0  67 65 20 6e 75 6d 62 65  72 20 6f 66 20 64 6f 74  |ge number of dot|
000028b0  73 20 69 6e 20 74 68 65  20 61 72 65 61 20 67 69  |s in the area gi|
000028c0  76 65 73 20 74 68 65 20  69 6e 74 65 6e 73 69 74  |ves the intensit|
000028d0  79 2e 0a 0a 57 68 79 20  64 6f 65 73 20 74 68 65  |y...Why does the|
000028e0  20 77 6f 72 6c 64 20 6e  65 65 64 20 74 77 6f 20  | world need two |
000028f0  64 69 66 66 65 72 65 6e  74 20 74 65 63 68 6e 69  |different techni|
00002900  71 75 65 73 3f 20 57 65  6c 6c 2c 20 64 69 66 66  |ques? Well, diff|
00002910  65 72 65 6e 74 20 64 65  76 69 63 65 73 0a 72 65  |erent devices.re|
00002920  70 72 6f 64 75 63 65 20  70 69 78 65 6c 73 20 64  |produce pixels d|
00002930  69 66 66 65 72 65 6e 74  6c 79 2e 20 54 68 65 20  |ifferently. The |
00002940  22 69 64 65 61 6c 20 73  71 75 61 72 65 22 20 70  |"ideal square" p|
00002950  69 78 65 6c 73 20 70 72  6f 64 75 63 65 64 20 62  |ixels produced b|
00002960  79 20 61 6e 20 4c 43 44  20 61 72 65 0a 70 65 72  |y an LCD are.per|
00002970  66 65 63 74 20 66 6f 72  20 64 69 73 70 65 72 73  |fect for dispers|
00002980  65 64 20 64 6f 74 20 64  69 74 68 65 72 3b 20 61  |ed dot dither; a|
00002990  20 43 52 54 20 70 72 6f  64 75 63 65 73 20 61 20  | CRT produces a |
000029a0  67 61 75 73 73 69 61 6e  20 73 70 6f 74 20 28 61  |gaussian spot (a|
000029b0  20 63 69 72 63 6c 65 20  6f 72 0a 65 6c 6c 69 70  | circle or.ellip|
000029c0  73 65 20 77 68 69 63 68  20 64 65 63 61 79 73 20  |se which decays |
000029d0  69 6e 20 69 6e 74 65 6e  73 69 74 79 20 74 6f 77  |in intensity tow|
000029e0  61 72 64 73 20 74 68 65  20 65 64 67 65 73 29 20  |ards the edges) |
000029f0  69 6e 73 74 65 61 64 20  6f 66 20 61 20 73 71 75  |instead of a squ|
00002a00  61 72 65 20 2d 0a 64 69  73 70 65 72 73 65 64 20  |are -.dispersed |
00002a10  64 6f 74 20 64 69 74 68  65 72 20 77 6f 72 6b 73  |dot dither works|
00002a20  20 77 65 6c 6c 3b 20 61  20 64 6f 74 20 6d 61 74  | well; a dot mat|
00002a30  72 69 78 20 69 6d 70 61  63 74 20 70 72 69 6e 74  |rix impact print|
00002a40  65 72 20 6f 72 20 61 20  22 77 72 69 74 65 20 62  |er or a "write b|
00002a50  6c 61 63 6b 22 0a 6c 61  73 65 72 20 70 72 69 6e  |lack".laser prin|
00002a60  74 65 72 20 70 72 6f 64  75 63 65 20 6c 61 72 67  |ter produce larg|
00002a70  65 20 64 6f 74 73 20 28  64 69 61 6d 65 74 65 72  |e dots (diameter|
00002a80  20 61 74 20 6c 65 61 73  74 20 53 51 52 28 32 29  | at least SQR(2)|
00002a90  20 6f 76 65 72 20 75 6e  69 74 20 70 69 78 65 6c  | over unit pixel|
00002aa0  0a 73 71 75 61 72 65 29  20 61 6e 64 20 74 68 75  |.square) and thu|
00002ab0  73 20 6d 61 6b 65 20 70  69 63 74 75 72 65 73 20  |s make pictures |
00002ac0  74 6f 6f 20 64 61 72 6b  20 69 66 20 64 69 73 70  |too dark if disp|
00002ad0  65 72 73 65 64 20 64 6f  74 20 64 69 74 68 65 72  |ersed dot dither|
00002ae0  20 69 73 20 75 73 65 64  3b 20 61 0a 22 77 72 69  | is used; a."wri|
00002af0  74 65 20 77 68 69 74 65  22 20 6c 61 73 65 72 20  |te white" laser |
00002b00  70 72 69 6e 74 65 72 20  70 72 69 6e 74 73 20 6e  |printer prints n|
00002b10  65 67 61 74 69 76 65 20  22 77 68 69 74 65 20 64  |egative "white d|
00002b20  6f 74 73 22 20 6f 6e 20  61 20 62 6c 61 63 6b 20  |ots" on a black |
00002b30  66 69 65 6c 64 20 61 6e  64 0a 74 68 75 73 20 22  |field and.thus "|
00002b40  63 61 76 65 73 20 69 6e  22 20 74 68 65 20 73 69  |caves in" the si|
00002b50  64 65 73 20 6f 66 20 70  69 78 65 6c 73 20 6d 61  |des of pixels ma|
00002b60  6b 69 6e 67 20 70 69 63  74 75 72 65 73 20 74 6f  |king pictures to|
00002b70  6f 20 77 68 69 74 65 20  77 69 74 68 20 64 69 73  |o white with dis|
00002b80  70 65 72 73 65 64 0a 64  6f 74 20 64 69 74 68 65  |persed.dot dithe|
00002b90  72 2e 20 43 6c 75 73 74  65 72 65 64 20 64 6f 74  |r. Clustered dot|
00002ba0  20 64 69 74 68 65 72 20  72 65 64 75 63 65 73 20  | dither reduces |
00002bb0  74 68 65 20 65 66 66 65  63 74 73 20 6f 66 20 6d  |the effects of m|
00002bc0  69 73 2d 73 69 7a 65 64  20 70 69 78 65 6c 73 20  |is-sized pixels |
00002bd0  62 79 0a 65 6e 73 75 72  69 6e 67 20 74 68 65 79  |by.ensuring they|
00002be0  20 61 72 65 20 61 64 6a  61 63 65 6e 74 20 28 61  | are adjacent (a|
00002bf0  6e 64 20 74 68 75 73 20  74 68 65 20 65 72 72 6f  |nd thus the erro|
00002c00  72 20 69 73 20 63 6f 6e  66 69 6e 65 64 20 74 6f  |r is confined to|
00002c10  20 74 68 65 20 70 65 72  69 70 68 65 72 79 20 6f  | the periphery o|
00002c20  66 0a 74 68 65 20 73 68  61 70 65 29 20 62 75 74  |f.the shape) but|
00002c30  20 74 68 69 73 20 64 6f  65 73 20 68 61 76 65 20  | this does have |
00002c40  61 20 63 6f 73 74 20 69  6e 20 70 6f 6f 72 65 72  |a cost in poorer|
00002c50  20 72 65 73 6f 6c 75 74  69 6f 6e 2e 0a 0a 53 69  | resolution...Si|
00002c60  6e 63 65 20 43 68 61 6e  67 65 46 53 49 27 73 20  |nce ChangeFSI's |
00002c70  63 6f 6c 6f 75 72 20 6f  72 20 67 72 65 79 73 63  |colour or greysc|
00002c80  61 6c 65 20 6f 75 74 70  75 74 20 69 73 20 74 6f  |ale output is to|
00002c90  20 43 52 54 73 20 28 6f  72 20 4c 43 44 73 20 69  | CRTs (or LCDs i|
00002ca0  6e 20 73 6f 6d 65 0a 64  69 73 74 61 6e 74 20 66  |n some.distant f|
00002cb0  75 74 75 72 65 29 20 69  74 20 61 75 74 6f 6d 61  |uture) it automa|
00002cc0  74 69 63 61 6c 6c 79 20  75 73 65 73 20 61 20 64  |tically uses a d|
00002cd0  69 73 70 65 72 73 65 64  20 64 6f 74 20 64 69 74  |ispersed dot dit|
00002ce0  68 65 72 2e 20 4d 6f 6e  6f 63 68 72 6f 6d 65 20  |her. Monochrome |
00002cf0  6f 75 74 70 75 74 0a 63  6f 75 6c 64 20 62 65 20  |output.could be |
00002d00  66 6f 72 20 74 68 65 20  73 63 72 65 65 6e 20 6f  |for the screen o|
00002d10  72 20 66 6f 72 20 61 20  70 72 69 6e 74 65 72 3a  |r for a printer:|
00002d20  20 74 68 65 20 75 73 65  72 20 63 61 6e 20 73 65  | the user can se|
00002d30  6c 65 63 74 20 62 65 74  77 65 65 6e 20 64 69 73  |lect between dis|
00002d40  70 65 72 73 65 64 0a 61  6e 64 20 63 6c 75 73 74  |persed.and clust|
00002d50  65 72 65 64 20 6d 65 74  68 6f 64 73 20 62 79 20  |ered methods by |
00002d60  61 64 64 69 6e 67 20 61  20 76 61 72 69 6f 75 73  |adding a various|
00002d70  20 73 75 66 66 69 63 65  73 20 28 22 63 22 2c 20  | suffices ("c", |
00002d80  22 64 22 20 6f 72 20 22  74 22 29 20 74 6f 20 74  |"d" or "t") to t|
00002d90  68 65 0a 6d 6f 64 65 20  6e 75 6d 62 65 72 20 66  |he.mode number f|
00002da0  6f 72 20 63 6c 75 73 74  65 72 65 64 20 6f 75 74  |or clustered out|
00002db0  70 75 74 2e 20 46 6f 72  20 22 63 22 20 74 68 65  |put. For "c" the|
00002dc0  20 61 6c 67 6f 72 69 74  68 6d 20 28 64 75 65 20  | algorithm (due |
00002dd0  74 6f 20 52 6f 62 65 72  74 20 4c 20 47 61 72 64  |to Robert L Gard|
00002de0  2c 0a 31 39 37 36 29 20  61 70 70 72 6f 78 69 6d  |,.1976) approxim|
00002df0  61 74 65 73 20 74 6f 6e  65 73 20 69 6e 20 74 68  |ates tones in th|
00002e00  65 20 72 61 6e 67 65 20  30 2e 2e 31 36 20 28 31  |e range 0..16 (1|
00002e10  37 20 6c 65 76 65 6c 73  29 20 62 79 20 75 73 69  |7 levels) by usi|
00002e20  6e 67 20 30 2e 2e 31 36  20 22 6f 6e 22 0a 70 69  |ng 0..16 "on".pi|
00002e30  78 65 6c 73 20 69 6e 20  61 20 34 20 62 79 20 34  |xels in a 4 by 4|
00002e40  20 63 65 6c 6c 2e 20 46  6f 72 20 22 64 22 20 74  | cell. For "d" t|
00002e50  68 65 20 61 6c 67 6f 72  69 74 68 6d 20 28 64 65  |he algorithm (de|
00002e60  76 65 6c 6f 70 65 64 20  62 79 20 6d 65 2c 20 62  |veloped by me, b|
00002e70  75 74 20 73 69 6d 69 6c  61 72 20 74 6f 0a 47 61  |ut similar to.Ga|
00002e80  72 64 27 73 29 20 61 70  70 72 6f 78 69 6d 61 74  |rd's) approximat|
00002e90  65 73 20 74 6f 6e 65 73  20 69 6e 20 74 68 65 20  |es tones in the |
00002ea0  72 61 6e 67 65 20 30 2e  2e 34 20 28 35 20 6c 65  |range 0..4 (5 le|
00002eb0  76 65 6c 73 29 20 62 79  20 75 73 69 6e 67 20 30  |vels) by using 0|
00002ec0  2e 2e 34 20 22 6f 6e 22  0a 70 69 78 65 6c 73 20  |..4 "on".pixels |
00002ed0  69 6e 20 61 20 32 20 62  79 20 32 20 63 65 6c 6c  |in a 2 by 2 cell|
00002ee0  2e 20 46 6f 72 20 22 74  22 20 74 68 65 20 61 6c  |. For "t" the al|
00002ef0  67 6f 72 69 74 68 6d 20  28 64 69 74 74 6f 20 61  |gorithm (ditto a|
00002f00  73 20 22 64 22 29 20 61  70 70 72 6f 78 69 6d 61  |s "d") approxima|
00002f10  74 65 73 0a 74 6f 6e 65  73 20 69 6e 20 74 68 65  |tes.tones in the|
00002f20  20 72 61 6e 67 65 20 30  2e 2e 39 20 28 31 30 20  | range 0..9 (10 |
00002f30  6c 65 76 65 6c 73 29 20  62 79 20 75 73 69 6e 67  |levels) by using|
00002f40  20 30 2e 2e 39 20 22 6f  6e 22 20 70 69 78 65 6c  | 0..9 "on" pixel|
00002f50  73 20 69 6e 20 61 20 33  20 62 79 20 33 20 63 65  |s in a 3 by 3 ce|
00002f60  6c 6c 2e 0a 54 68 65 20  22 6f 6e 22 20 70 69 78  |ll..The "on" pix|
00002f70  65 6c 73 20 61 72 65 20  63 61 72 65 66 75 6c 6c  |els are carefull|
00002f80  79 20 63 68 6f 73 65 6e  20 74 6f 20 70 72 6f 76  |y chosen to prov|
00002f90  69 64 65 3a 20 28 61 29  20 73 79 6d 6d 65 74 72  |ide: (a) symmetr|
00002fa0  79 20 6f 66 20 77 68 69  74 65 2f 62 6c 61 63 6b  |y of white/black|
00002fb0  0a 61 6e 64 20 62 6c 61  63 6b 2f 77 68 69 74 65  |.and black/white|
00002fc0  20 70 61 74 74 65 72 6e  73 20 28 62 29 20 64 69  | patterns (b) di|
00002fd0  61 67 6f 6e 61 6c 6c 79  20 6f 72 69 65 6e 74 65  |agonally oriente|
00002fe0  64 20 64 6f 74 20 67 72  69 64 2e 20 54 68 65 20  |d dot grid. The |
00002ff0  64 69 61 67 6f 6e 61 6c  20 61 6e 67 6c 65 0a 72  |diagonal angle.r|
00003000  65 64 75 63 65 73 20 74  68 65 20 65 79 65 27 73  |educes the eye's|
00003010  20 61 62 69 6c 69 74 79  20 74 6f 20 73 65 65 20  | ability to see |
00003020  74 68 65 20 72 65 63 74  61 6e 67 75 6c 61 72 20  |the rectangular |
00003030  70 61 74 74 65 72 6e 73  20 70 72 6f 64 75 63 65  |patterns produce|
00003040  64 2e 20 54 68 65 20 76  61 72 69 6f 75 73 0a 73  |d. The various.s|
00003050  69 7a 65 73 20 6f 66 20  74 68 65 20 68 61 6c 66  |izes of the half|
00003060  74 6f 6e 65 20 63 65 6c  6c 20 61 6c 6c 6f 77 20  |tone cell allow |
00003070  73 6f 6d 65 20 74 72 61  64 65 20 6f 66 66 20 62  |some trade off b|
00003080  65 74 77 65 65 6e 20 72  65 70 72 65 73 65 6e 74  |etween represent|
00003090  69 6e 67 20 74 68 65 20  74 6f 6e 61 6c 0a 76 61  |ing the tonal.va|
000030a0  6c 75 65 73 20 63 6f 72  72 65 63 74 6c 79 20 61  |lues correctly a|
000030b0  6e 64 20 6c 6f 73 73 20  6f 66 20 72 65 73 6f 6c  |nd loss of resol|
000030c0  75 74 69 6f 6e 2e 20 53  74 61 72 74 20 77 69 74  |ution. Start wit|
000030d0  68 20 22 63 22 20 61 6e  64 20 70 72 6f 67 72 65  |h "c" and progre|
000030e0  73 73 20 74 6f 20 22 74  22 20 61 6e 64 0a 74 68  |ss to "t" and.th|
000030f0  65 6e 20 22 64 22 20 69  66 20 74 68 65 20 72 65  |en "d" if the re|
00003100  73 6f 6c 75 74 69 6f 6e  20 69 73 20 6e 6f 74 20  |solution is not |
00003110  61 63 63 65 70 74 61 62  6c 65 2e 0a 0a 43 68 61  |acceptable...Cha|
00003120  6e 67 65 46 53 49 20 63  61 6e 20 67 65 6e 65 72  |ngeFSI can gener|
00003130  61 74 65 20 72 65 61 73  6f 6e 61 62 6c 65 20 70  |ate reasonable p|
00003140  69 63 74 75 72 65 73 20  6f 6e 20 22 77 72 69 74  |ictures on "writ|
00003150  65 20 62 6c 61 63 6b 22  20 70 72 69 6e 74 65 72  |e black" printer|
00003160  73 20 77 69 74 68 20 61  0a 64 69 73 70 65 72 73  |s with a.dispers|
00003170  65 64 20 64 6f 74 20 64  69 74 68 65 72 20 62 79  |ed dot dither by|
00003180  20 75 73 69 6e 67 20 74  68 65 20 22 2d 62 6c 61  | using the "-bla|
00003190  63 6b 22 20 70 61 72 61  6d 65 74 65 72 3b 20 68  |ck" parameter; h|
000031a0  6f 77 65 76 65 72 20 69  6d 61 67 65 73 20 70 72  |owever images pr|
000031b0  6f 64 75 63 65 64 0a 6c  69 6b 65 20 74 68 69 73  |oduced.like this|
000031c0  20 64 6f 20 6e 6f 74 20  70 68 6f 74 6f 63 6f 70  | do not photocop|
000031d0  79 20 61 74 20 61 6c 6c  20 77 65 6c 6c 20 28 74  |y at all well (t|
000031e0  68 65 20 70 68 6f 74 6f  63 6f 70 69 65 72 20 6d  |he photocopier m|
000031f0  61 6b 65 73 20 74 68 65  20 64 6f 74 73 20 62 6c  |akes the dots bl|
00003200  61 63 6b 65 72 0a 61 67  61 69 6e 21 29 2e 20 54  |acker.again!). T|
00003210  68 65 20 70 61 72 61 6d  65 74 65 72 20 74 6f 20  |he parameter to |
00003220  2d 62 6c 61 63 6b 20 28  64 65 66 61 75 6c 74 20  |-black (default |
00003230  76 61 6c 75 65 20 33 32  2c 20 72 61 6e 67 65 20  |value 32, range |
00003240  30 2e 2e 31 32 38 29 20  74 65 6c 6c 73 0a 43 68  |0..128) tells.Ch|
00003250  61 6e 67 65 46 53 49 20  68 6f 77 20 6d 75 63 68  |angeFSI how much|
00003260  20 6c 61 72 67 65 72 20  74 68 61 6e 20 74 68 65  | larger than the|
00003270  20 69 64 65 61 6c 20 73  71 75 61 72 65 20 70 69  | ideal square pi|
00003280  78 65 6c 20 74 68 65 20  64 6f 74 73 20 70 72 6f  |xel the dots pro|
00003290  64 75 63 65 64 20 62 79  20 74 68 65 0a 70 72 69  |duced by the.pri|
000032a0  6e 74 65 72 20 61 72 65  20 2d 20 31 32 38 20 63  |nter are - 128 c|
000032b0  6f 72 72 65 73 70 6f 6e  64 73 20 74 6f 20 61 6e  |orresponds to an|
000032c0  20 69 6e 6b 65 64 20 64  6f 74 20 63 6f 76 65 72  | inked dot cover|
000032d0  69 6e 67 20 66 6f 75 72  20 74 69 6d 65 73 20 74  |ing four times t|
000032e0  68 65 20 61 72 65 61 20  6f 66 0a 74 68 65 20 69  |he area of.the i|
000032f0  64 65 61 6c 20 62 6c 61  63 6b 20 73 71 75 61 72  |deal black squar|
00003300  65 20 70 69 78 65 6c 20  28 61 6e 64 20 74 68 69  |e pixel (and thi|
00003310  73 20 77 69 6c 6c 20 67  65 6e 65 72 61 6c 6c 79  |s will generally|
00003320  20 6d 65 61 6e 20 43 68  61 6e 67 65 46 53 49 20  | mean ChangeFSI |
00003330  70 72 6f 64 75 63 65 73  0a 61 6e 20 65 6e 74 69  |produces.an enti|
00003340  72 65 6c 79 20 77 68 69  74 65 20 6f 75 74 70 75  |rely white outpu|
00003350  74 21 29 2e 20 56 61 6c  75 65 73 20 61 62 6f 76  |t!). Values abov|
00003360  65 20 36 34 20 67 69 76  65 20 72 61 74 68 65 72  |e 64 give rather|
00003370  20 70 6f 6f 72 20 72 65  73 75 6c 74 73 20 6f 6e  | poor results on|
00003380  20 73 6f 6d 65 0a 70 69  63 74 75 72 65 73 20 62  | some.pictures b|
00003390  75 74 20 6d 61 79 20 62  65 20 77 6f 72 74 68 20  |ut may be worth |
000033a0  65 78 70 65 72 69 6d 65  6e 74 69 6e 67 20 77 69  |experimenting wi|
000033b0  74 68 2e 20 54 68 65 20  64 65 66 61 75 6c 74 20  |th. The default |
000033c0  69 73 20 33 32 2c 20 61  20 64 6f 74 20 63 6f 76  |is 32, a dot cov|
000033d0  65 72 69 6e 67 0a 35 30  25 20 6d 6f 72 65 20 61  |ering.50% more a|
000033e0  72 65 61 20 74 68 61 6e  20 74 68 65 20 73 71 75  |rea than the squ|
000033f0  61 72 65 20 70 69 78 65  6c 20 28 74 68 65 20 6d  |are pixel (the m|
00003400  69 6e 69 6d 75 6d 20 63  69 72 63 6c 65 20 65 6e  |inimum circle en|
00003410  63 6c 6f 73 69 6e 67 20  74 68 65 20 70 69 78 65  |closing the pixe|
00003420  6c 0a 73 71 75 61 72 65  29 2e 20 53 6f 6d 65 20  |l.square). Some |
00003430  70 72 69 6e 74 65 72 73  20 70 72 6f 64 75 63 65  |printers produce|
00003440  20 64 6f 74 73 20 6f 66  20 28 70 73 65 75 64 6f  | dots of (pseudo|
00003450  2d 72 61 6e 64 6f 6d 6c  79 29 20 76 61 72 79 69  |-randomly) varyi|
00003460  6e 67 20 73 69 7a 65 73  20 61 6e 64 0a 62 6c 61  |ng sizes and.bla|
00003470  63 6b 20 63 6f 72 72 65  63 74 69 6f 6e 20 6d 61  |ck correction ma|
00003480  79 20 6e 6f 74 20 68 65  6c 70 20 77 69 74 68 20  |y not help with |
00003490  74 68 65 73 65 20 28 74  68 65 20 70 69 63 74 75  |these (the pictu|
000034a0  72 65 20 6c 6f 6f 6b 73  20 22 6e 6f 69 73 79 22  |re looks "noisy"|
000034b0  29 20 69 6e 20 77 68 69  63 68 0a 63 61 73 65 20  |) in which.case |
000034c0  75 73 65 20 6f 6e 65 20  6f 66 20 74 68 65 20 63  |use one of the c|
000034d0  6c 75 73 74 65 72 65 64  20 6f 75 74 70 75 74 20  |lustered output |
000034e0  6d 65 74 68 6f 64 73 2e  20 2d 62 6c 61 63 6b 20  |methods. -black |
000034f0  63 6f 72 72 65 63 74 69  6f 6e 20 6d 61 6b 65 73  |correction makes|
00003500  20 70 69 63 74 75 72 65  73 0a 6f 6e 20 74 68 65  | pictures.on the|
00003510  20 73 63 72 65 65 6e 20  6c 6f 6f 6b 20 76 65 72  | screen look ver|
00003520  79 20 70 61 6c 65 2c 20  73 69 6e 63 65 2c 20 69  |y pale, since, i|
00003530  66 20 61 6e 79 74 68 69  6e 67 2c 20 62 6c 61 63  |f anything, blac|
00003540  6b 20 70 69 78 65 6c 73  20 6f 6e 20 73 63 72 65  |k pixels on scre|
00003550  65 6e 20 61 72 65 0a 73  6d 61 6c 6c 65 72 20 74  |en are.smaller t|
00003560  68 61 6e 20 74 68 65 20  69 64 65 61 6c 20 73 71  |han the ideal sq|
00003570  75 61 72 65 2e 0a 0a 5b  61 73 69 64 65 3a 20 74  |uare...[aside: t|
00003580  6f 20 70 72 69 6e 74 20  74 68 65 73 65 20 70 69  |o print these pi|
00003590  63 74 75 72 65 73 2c 20  79 6f 75 20 6e 65 65 64  |ctures, you need|
000035a0  20 61 20 6d 65 74 68 6f  64 20 77 68 69 63 68 20  | a method which |
000035b0  63 6f 70 69 65 73 20 74  68 65 20 70 69 78 65 6c  |copies the pixel|
000035c0  73 0a 43 68 61 6e 67 65  46 53 49 20 68 61 73 20  |s.ChangeFSI has |
000035d0  6d 61 64 65 20 65 78 61  63 74 6c 79 20 74 6f 20  |made exactly to |
000035e0  74 68 6f 73 65 20 6f 66  20 74 68 65 20 6f 75 74  |those of the out|
000035f0  70 75 74 20 64 65 76 69  63 65 2e 20 55 73 69 6e  |put device. Usin|
00003600  67 20 21 50 61 69 6e 74  2c 20 73 63 61 6c 65 20  |g !Paint, scale |
00003610  58 0a 61 6e 64 20 59 20  62 79 20 39 30 3a 33 30  |X.and Y by 90:30|
00003620  30 20 66 6f 72 20 61 20  33 30 30 64 70 69 20 70  |0 for a 300dpi p|
00003630  72 69 6e 74 65 72 2e 5d  0a 0a 49 6e 20 61 6c 6c  |rinter.]..In all|
00003640  20 63 61 73 65 73 2c 20  61 6e 20 61 70 70 72 6f  | cases, an appro|
00003650  78 69 6d 61 74 69 6f 6e  20 74 6f 20 61 20 63 6f  |ximation to a co|
00003660  6c 6f 75 72 20 77 69 6c  6c 20 70 72 6f 64 75 63  |lour will produc|
00003670  65 20 61 6e 20 65 72 72  6f 72 20 28 77 68 69 63  |e an error (whic|
00003680  68 20 6d 69 67 68 74 0a  70 6f 73 73 69 62 6c 79  |h might.possibly|
00003690  20 62 65 20 7a 65 72 6f  20 69 66 20 43 68 61 6e  | be zero if Chan|
000036a0  67 65 46 53 49 20 69 73  20 76 65 72 79 20 6c 75  |geFSI is very lu|
000036b0  63 6b 79 29 2e 20 43 68  61 6e 67 65 46 53 49 20  |cky). ChangeFSI |
000036c0  74 72 61 63 6b 73 20 74  68 65 73 65 20 65 72 72  |tracks these err|
000036d0  6f 72 73 20 61 6e 64 0a  65 6e 73 75 72 65 73 20  |ors and.ensures |
000036e0  74 68 61 74 20 6f 76 65  72 20 77 69 64 65 20 61  |that over wide a|
000036f0  72 65 61 73 20 74 68 65  72 65 20 69 73 20 6e 6f  |reas there is no|
00003700  20 6f 76 65 72 61 6c 6c  20 65 72 72 6f 72 20 75  | overall error u|
00003710  73 69 6e 67 20 61 20 74  65 63 68 6e 69 71 75 65  |sing a technique|
00003720  20 63 61 6c 6c 65 64 0a  22 65 72 72 6f 72 20 64  | called."error d|
00003730  69 66 66 75 73 69 6f 6e  22 2c 20 66 69 72 73 74  |iffusion", first|
00003740  20 64 65 76 69 73 65 64  20 62 79 20 52 20 57 20  | devised by R W |
00003750  46 6c 6f 79 64 20 61 6e  64 20 4c 20 53 74 65 69  |Floyd and L Stei|
00003760  6e 62 65 72 67 20 69 6e  20 31 39 37 35 2e 20 49  |nberg in 1975. I|
00003770  6e 20 74 68 69 73 0a 74  65 63 68 6e 69 71 75 65  |n this.technique|
00003780  20 74 68 65 20 61 70 70  72 6f 78 69 6d 61 74 69  | the approximati|
00003790  6f 6e 20 69 73 20 6d 61  64 65 20 61 6e 64 20 74  |on is made and t|
000037a0  68 65 20 65 72 72 6f 72  20 64 69 73 74 72 69 62  |he error distrib|
000037b0  75 74 65 64 20 74 6f 20  6e 65 61 72 62 79 20 70  |uted to nearby p|
000037c0  69 78 65 6c 73 0a 69 6e  20 74 68 65 20 66 6f 6c  |ixels.in the fol|
000037d0  6c 6f 77 69 6e 67 20 72  61 74 69 6f 73 3a 0a 0a  |lowing ratios:..|
000037e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000037f0  63 75 72 72 65 6e 74 20  70 69 78 65 6c 20 20 20  |current pixel   |
00003800  37 2f 31 36 20 6f 66 20  65 72 72 6f 72 0a 33 2f  |7/16 of error.3/|
00003810  31 36 20 6f 66 20 65 72  72 6f 72 20 20 20 35 2f  |16 of error   5/|
00003820  31 36 20 6f 66 20 65 72  72 6f 72 20 20 20 31 2f  |16 of error   1/|
00003830  31 36 20 6f 66 20 65 72  72 6f 72 0a 0a 43 68 61  |16 of error..Cha|
00003840  6e 67 65 46 53 49 20 67  65 74 73 20 73 6f 6d 65  |ngeFSI gets some|
00003850  20 6f 66 20 69 74 73 20  6e 61 6d 65 20 66 72 6f  | of its name fro|
00003860  6d 20 46 6c 6f 79 64 20  61 6e 64 20 53 74 65 69  |m Floyd and Stei|
00003870  6e 62 65 72 67 2e 20 41  64 64 69 74 69 6f 6e 61  |nberg. Additiona|
00003880  6c 6c 79 2c 0a 43 68 61  6e 67 65 46 53 49 20 73  |lly,.ChangeFSI s|
00003890  63 61 6e 73 20 74 68 72  6f 75 67 68 20 74 68 65  |cans through the|
000038a0  20 70 69 63 74 75 72 65  20 69 6e 20 61 20 73 65  | picture in a se|
000038b0  72 70 65 6e 74 69 6e 65  20 66 61 73 68 69 6f 6e  |rpentine fashion|
000038c0  2c 20 64 6f 69 6e 67 20  61 20 72 6f 77 20 6f 66  |, doing a row of|
000038d0  0a 70 69 78 65 6c 73 20  6c 65 66 74 20 74 6f 20  |.pixels left to |
000038e0  72 69 67 68 74 20 66 6f  6c 6c 6f 77 65 64 20 62  |right followed b|
000038f0  79 20 74 68 65 20 6e 65  78 74 20 72 6f 77 20 72  |y the next row r|
00003900  69 67 68 74 20 74 6f 20  6c 65 66 74 2e 20 54 68  |ight to left. Th|
00003910  69 73 20 72 65 64 75 63  65 73 20 74 68 65 0a 70  |is reduces the.p|
00003920  72 6f 62 61 62 69 6c 69  74 79 20 6f 66 20 72 65  |robability of re|
00003930  67 75 6c 61 72 20 70 61  74 74 65 72 6e 73 20 77  |gular patterns w|
00003940  68 69 63 68 20 74 68 65  20 65 79 65 20 69 73 20  |hich the eye is |
00003950  73 65 6e 73 69 74 69 76  65 20 74 6f 2e 20 54 68  |sensitive to. Th|
00003960  65 20 66 69 6e 61 6c 20  49 20 6f 66 0a 74 68 65  |e final I of.the|
00003970  20 6e 61 6d 65 20 69 73  20 66 6f 72 20 49 6e 74  | name is for Int|
00003980  65 67 65 72 3a 20 43 68  61 6e 67 65 46 53 49 20  |eger: ChangeFSI |
00003990  64 6f 65 73 20 61 6c 6c  20 69 74 73 20 77 6f 72  |does all its wor|
000039a0  6b 20 69 6e 20 33 32 20  62 69 74 20 66 69 78 65  |k in 32 bit fixe|
000039b0  64 20 70 6f 69 6e 74 0a  69 6e 74 65 67 65 72 20  |d point.integer |
000039c0  61 72 69 74 68 6d 65 74  69 63 20 28 77 69 74 68  |arithmetic (with|
000039d0  20 74 68 65 20 70 6f 69  6e 74 20 61 74 20 62 69  | the point at bi|
000039e0  74 20 32 38 29 20 69 6e  73 74 65 61 64 20 6f 66  |t 28) instead of|
000039f0  20 66 6c 6f 61 74 69 6e  67 20 70 6f 69 6e 74 2e  | floating point.|
00003a00  0a 44 69 74 68 65 72 69  6e 67 20 63 61 6e 20 62  |.Dithering can b|
00003a10  65 20 74 75 72 6e 65 64  20 6f 66 66 20 75 73 69  |e turned off usi|
00003a20  6e 67 20 75 73 69 6e 67  20 22 44 69 73 61 62 6c  |ng using "Disabl|
00003a30  65 20 44 69 74 68 65 72  69 6e 67 22 20 6f 6e 20  |e Dithering" on |
00003a40  74 68 65 20 50 72 6f 63  65 73 73 69 6e 67 0a 64  |the Processing.d|
00003a50  69 61 6c 6f 67 75 65 20  28 22 2d 6e 6f 64 69 74  |ialogue ("-nodit|
00003a60  68 65 72 22 20 6f 6e 20  74 68 65 20 63 6f 6d 6d  |her" on the comm|
00003a70  61 6e 64 20 6c 69 6e 65  29 20 77 68 69 63 68 20  |and line) which |
00003a80  61 74 20 6c 65 61 73 74  20 61 6c 6c 6f 77 73 20  |at least allows |
00003a90  79 6f 75 20 74 6f 20 73  65 65 20 68 6f 77 0a 77  |you to see how.w|
00003aa0  65 6c 6c 20 69 74 20 64  6f 65 73 21 0a 0a 54 68  |ell it does!..Th|
00003ab0  65 20 63 6f 6e 76 65 72  73 69 6f 6e 20 66 72 6f  |e conversion fro|
00003ac0  6d 20 6f 6e 65 20 63 6f  6c 6f 75 72 20 72 61 6e  |m one colour ran|
00003ad0  67 65 20 74 6f 20 61 6e  6f 74 68 65 72 20 69 73  |ge to another is|
00003ae0  20 6d 61 64 65 20 61 74  20 74 68 65 20 73 61 6d  | made at the sam|
00003af0  65 20 74 69 6d 65 20 61  73 20 61 0a 63 68 61 6e  |e time as a.chan|
00003b00  67 65 20 69 6e 20 73 69  7a 65 20 6f 66 20 74 68  |ge in size of th|
00003b10  65 20 69 6d 61 67 65 2e  20 53 69 7a 65 20 69 73  |e image. Size is|
00003b20  20 63 68 61 6e 67 65 64  20 62 79 20 72 61 74 69  | changed by rati|
00003b30  6f 73 20 6f 66 20 61 72  65 61 73 20 62 65 74 77  |os of areas betw|
00003b40  65 65 6e 20 74 68 65 0a  69 6e 70 75 74 20 61 6e  |een the.input an|
00003b50  64 20 6f 75 74 70 75 74  3a 20 74 68 65 20 74 6f  |d output: the to|
00003b60  74 61 6c 20 77 65 69 67  68 74 20 6f 66 20 72 2c  |tal weight of r,|
00003b70  20 67 2c 20 61 6e 64 20  62 20 69 6e 20 74 68 65  | g, and b in the|
00003b80  20 73 6f 75 72 63 65 20  61 72 65 61 20 69 73 0a  | source area is.|
00003b90  63 61 6c 63 75 6c 61 74  65 64 20 75 73 69 6e 67  |calculated using|
00003ba0  20 74 68 65 20 66 69 78  65 64 20 70 6f 69 6e 74  | the fixed point|
00003bb0  20 61 72 69 74 68 6d 65  74 69 63 20 61 6e 64 20  | arithmetic and |
00003bc0  74 68 69 73 20 72 65 73  75 6c 74 20 69 73 20 74  |this result is t|
00003bd0  68 65 6e 0a 61 70 70 72  6f 78 69 6d 61 74 65 64  |hen.approximated|
00003be0  20 74 6f 20 74 68 65 20  6f 75 74 70 75 74 20 75  | to the output u|
00003bf0  73 69 6e 67 20 74 68 65  20 65 72 72 6f 72 20 64  |sing the error d|
00003c00  69 66 66 75 73 69 6f 6e  20 74 6f 20 70 72 65 73  |iffusion to pres|
00003c10  65 72 76 65 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  |erve information|
00003c20  0a 28 66 6f 72 20 65 78  61 6d 70 6c 65 2c 20 63  |.(for example, c|
00003c30  6f 6e 73 69 64 65 72 20  68 61 6c 76 69 6e 67 20  |onsider halving |
00003c40  69 6e 20 73 69 7a 65 20  61 6e 20 69 6d 61 67 65  |in size an image|
00003c50  20 77 69 74 68 20 61 64  6a 61 63 65 6e 74 20 70  | with adjacent p|
00003c60  69 78 65 6c 73 20 6f 66  0a 69 6e 74 65 6e 73 69  |ixels of.intensi|
00003c70  74 69 65 73 20 31 20 61  6e 64 20 32 3b 20 74 68  |ties 1 and 2; th|
00003c80  65 20 6f 75 74 70 75 74  20 70 69 78 65 6c 20 6e  |e output pixel n|
00003c90  65 65 64 73 20 74 6f 20  62 65 20 76 61 6c 75 65  |eeds to be value|
00003ca0  20 31 2e 35 2c 20 73 6f  20 74 68 65 20 30 2e 35  | 1.5, so the 0.5|
00003cb0  20 65 72 72 6f 72 0a 69  73 20 73 65 6e 74 20 74  | error.is sent t|
00003cc0  6f 20 61 64 6a 61 63 65  6e 74 20 70 69 78 65 6c  |o adjacent pixel|
00003cd0  73 20 74 6f 20 6b 65 65  70 20 74 68 65 20 6f 76  |s to keep the ov|
00003ce0  65 72 61 6c 6c 20 63 6f  6c 6f 75 72 20 74 68 65  |erall colour the|
00003cf0  20 73 61 6d 65 29 2e 20  54 68 65 20 73 69 7a 65  | same). The size|
00003d00  0a 63 68 61 6e 67 65 20  69 73 20 65 78 70 72 65  |.change is expre|
00003d10  73 73 65 64 20 61 73 20  61 20 72 61 74 69 6f 20  |ssed as a ratio |
00003d20  6f 66 20 6f 75 74 70 75  74 20 74 6f 20 69 6e 70  |of output to inp|
00003d30  75 74 20 28 65 2e 67 2e  20 34 30 3a 32 30 29 20  |ut (e.g. 40:20) |
00003d40  77 68 69 63 68 20 43 68  61 6e 67 65 46 53 49 0a  |which ChangeFSI.|
00003d50  72 65 64 75 63 65 73 20  74 6f 20 74 68 65 20 73  |reduces to the s|
00003d60  6d 61 6c 6c 65 73 74 20  70 6f 73 73 69 62 6c 65  |mallest possible|
00003d70  20 74 65 72 6d 73 20 28  32 3a 31 20 69 6e 20 74  | terms (2:1 in t|
00003d80  68 69 73 20 63 61 73 65  29 20 73 6f 20 74 68 61  |his case) so tha|
00003d90  74 20 79 6f 75 20 61 72  65 20 66 72 65 65 0a 74  |t you are free.t|
00003da0  6f 20 67 69 76 65 20 76  61 6c 75 65 73 20 6c 69  |o give values li|
00003db0  6b 65 20 32 35 36 3a 35  31 32 20 69 66 20 74 68  |ke 256:512 if th|
00003dc0  61 74 27 73 20 77 68 61  74 20 79 6f 75 20 6d 65  |at's what you me|
00003dd0  61 6e 21 20 53 69 7a 65  20 63 68 61 6e 67 65 20  |an! Size change |
00003de0  69 73 20 65 69 74 68 65  72 20 62 6f 74 68 0a 78  |is either both.x|
00003df0  20 61 6e 64 20 79 20 28  69 66 20 6f 6e 65 20 72  | and y (if one r|
00003e00  61 74 69 6f 20 69 73 20  67 69 76 65 6e 29 20 6f  |atio is given) o|
00003e10  72 20 73 65 70 61 72 61  74 65 20 78 20 61 6e 64  |r separate x and|
00003e20  20 79 20 28 69 66 20 74  77 6f 20 72 61 74 69 6f  | y (if two ratio|
00003e30  73 20 61 72 65 20 67 69  76 65 6e 29 2e 0a 4e 6f  |s are given)..No|
00003e40  74 65 20 74 68 61 74 20  74 68 65 20 73 69 7a 65  |te that the size|
00003e50  20 6f 66 20 61 20 52 49  53 43 20 4f 53 20 70 69  | of a RISC OS pi|
00003e60  78 65 6c 20 69 73 20 6b  6e 6f 77 6e 2c 20 73 6f  |xel is known, so|
00003e70  20 63 68 61 6e 67 69 6e  67 20 66 72 6f 6d 20 28  | changing from (|
00003e80  73 61 79 29 20 6d 6f 64  65 20 32 31 0a 74 6f 20  |say) mode 21.to |
00003e90  28 73 61 79 29 20 6d 6f  64 65 20 31 33 20 64 6f  |(say) mode 13 do|
00003ea0  65 73 20 6e 6f 74 20 6e  65 65 64 20 61 6e 79 20  |es not need any |
00003eb0  61 64 64 69 74 69 6f 6e  61 6c 20 73 70 65 63 69  |additional speci|
00003ec0  66 69 65 64 20 73 63 61  6c 69 6e 67 2e 20 54 68  |fied scaling. Th|
00003ed0  65 20 66 75 6c 6c 20 73  69 7a 65 0a 6f 75 74 70  |e full size.outp|
00003ee0  75 74 20 66 6f 72 20 6d  6f 64 65 20 32 31 20 69  |ut for mode 21 i|
00003ef0  73 20 74 68 65 20 72 65  66 65 72 65 6e 63 65 2c  |s the reference,|
00003f00  20 73 6f 20 73 63 61 6c  65 20 74 6f 20 36 34 30  | so scale to 640|
00003f10  20 62 79 20 35 31 32 2e  20 41 20 63 6f 6d 6d 6f  | by 512. A commo|
00003f20  6e 20 73 63 61 6c 69 6e  67 0a 69 73 20 74 6f 20  |n scaling.is to |
00003f30  66 69 6c 6c 20 74 68 65  20 6f 75 74 70 75 74 20  |fill the output |
00003f40  73 70 72 69 74 65 20 77  69 74 68 20 74 68 65 20  |sprite with the |
00003f50  69 6e 70 75 74 20 61 6e  64 20 61 6e 20 22 3d 22  |input and an "="|
00003f60  20 70 61 72 61 6d 65 74  65 72 20 74 6f 20 78 20  | parameter to x |
00003f70  61 6e 64 2f 6f 72 20 79  0a 72 61 74 69 6f 73 20  |and/or y.ratios |
00003f80  77 69 6c 6c 20 64 6f 20  74 68 69 73 20 77 69 74  |will do this wit|
00003f90  68 6f 75 74 20 65 76 65  72 20 68 61 76 69 6e 67  |hout ever having|
00003fa0  20 74 6f 20 6b 6e 6f 77  20 74 68 65 20 73 69 7a  | to know the siz|
00003fb0  65 20 6f 66 20 74 68 65  20 69 6e 70 75 74 2e 20  |e of the input. |
00003fc0  53 69 6d 70 6c 79 0a 6f  6d 69 74 74 69 6e 67 20  |Simply.omitting |
00003fd0  74 68 65 20 66 72 61 63  74 69 6f 6e 61 6c 20 70  |the fractional p|
00003fe0  61 72 74 20 63 61 75 73  65 73 20 43 68 61 6e 67  |art causes Chang|
00003ff0  65 46 53 49 20 74 6f 20  70 75 74 20 69 6e 20 74  |eFSI to put in t|
00004000  68 65 20 73 6f 75 72 63  65 20 73 69 7a 65 2c 20  |he source size, |
00004010  74 68 75 73 0a 67 69 76  69 6e 67 20 6f 75 74 70  |thus.giving outp|
00004020  75 74 20 77 68 69 63 68  20 69 73 20 74 68 65 20  |ut which is the |
00004030  73 70 65 63 69 66 69 65  64 20 6e 75 6d 62 65 72  |specified number|
00004040  20 6f 66 20 70 69 78 65  6c 73 20 69 6e 20 73 69  | of pixels in si|
00004050  7a 65 2e 0a 0a 43 6f 6e  76 65 72 73 69 6f 6e 20  |ze...Conversion |
00004060  66 72 6f 6d 20 63 6f 6c  6f 75 72 20 74 6f 20 6d  |from colour to m|
00004070  6f 6e 6f 63 68 72 6f 6d  65 20 73 68 61 64 65 73  |onochrome shades|
00004080  20 6f 66 20 67 72 65 79  20 69 73 20 64 6f 6e 65  | of grey is done|
00004090  20 77 69 74 68 20 74 68  65 20 43 49 45 0a 6c 75  | with the CIE.lu|
000040a0  6d 69 6e 61 6e 63 65 20  77 65 69 67 68 74 73 20  |minance weights |
000040b0  66 6f 72 20 72 2c 20 67  20 61 6e 64 20 62 20 28  |for r, g and b (|
000040c0  30 2e 32 39 39 2c 20 30  2e 35 38 37 2c 20 30 2e  |0.299, 0.587, 0.|
000040d0  31 31 34 29 20 77 68 69  63 68 20 69 73 20 74 68  |114) which is th|
000040e0  65 20 73 74 61 6e 64 61  72 64 0a 63 6f 6e 76 65  |e standard.conve|
000040f0  72 73 69 6f 6e 20 66 6f  72 20 62 72 6f 61 64 63  |rsion for broadc|
00004100  61 73 74 20 74 65 6c 65  76 69 73 69 6f 6e 2e 20  |ast television. |
00004110  54 68 65 73 65 20 76 61  6c 75 65 73 20 63 61 6e  |These values can|
00004120  20 62 65 20 61 6c 74 65  72 65 64 20 75 73 69 6e  | be altered usin|
00004130  67 20 74 68 65 0a 2d 72  65 64 2c 20 2d 67 72 65  |g the.-red, -gre|
00004140  65 6e 20 61 6e 64 20 2d  62 6c 75 65 20 63 6f 6d  |en and -blue com|
00004150  6d 61 6e 64 73 20 61 6e  64 20 61 6c 6c 6f 77 20  |mands and allow |
00004160  64 69 66 66 65 72 65 6e  74 20 77 65 69 67 68 74  |different weight|
00004170  69 6e 67 73 20 66 6f 72  20 63 6f 6e 76 65 72 73  |ings for convers|
00004180  69 6f 6e 0a 74 6f 20 6d  6f 6e 6f 63 68 72 6f 6d  |ion.to monochrom|
00004190  65 20 74 6f 20 62 65 20  74 72 69 65 64 2c 20 74  |e to be tried, t|
000041a0  68 69 73 20 61 6c 73 6f  20 61 6c 6c 6f 77 73 20  |his also allows |
000041b0  73 65 6c 65 63 74 69 6f  6e 20 6f 66 20 61 6e 20  |selection of an |
000041c0  69 6d 61 67 65 20 63 6f  6d 70 6f 73 65 64 20 6f  |image composed o|
000041d0  66 0a 6f 6e 6c 79 20 73  6f 6d 65 20 6f 66 20 74  |f.only some of t|
000041e0  68 65 20 63 6f 6c 6f 75  72 73 20 28 65 2e 67 2e  |he colours (e.g.|
000041f0  20 2d 72 65 64 31 20 2d  67 72 65 65 6e 30 20 2d  | -red1 -green0 -|
00004200  62 6c 75 65 30 29 20 69  6e 20 6d 61 6b 69 6e 67  |blue0) in making|
00004210  20 61 20 62 6c 61 63 6b  20 61 6e 64 0a 77 68 69  | a black and.whi|
00004220  74 65 20 69 6d 61 67 65  2e 0a 0a 43 68 61 6e 67  |te image...Chang|
00004230  65 46 53 49 20 63 61 6e  20 74 61 6b 65 20 61 6e  |eFSI can take an|
00004240  79 20 52 49 53 43 20 4f  53 20 73 70 72 69 74 65  |y RISC OS sprite|
00004250  73 20 28 32 2c 20 34 2c  20 31 36 20 6f 72 20 32  |s (2, 4, 16 or 2|
00004260  35 36 20 63 6f 6c 6f 75  72 73 29 2e 20 49 66 20  |56 colours). If |
00004270  74 68 65 72 65 20 69 73  20 61 0a 70 61 6c 65 74  |there is a.palet|
00004280  74 65 20 69 74 20 77 69  6c 6c 20 62 65 20 75 73  |te it will be us|
00004290  65 64 2c 20 6f 74 68 65  72 77 69 73 65 20 74 68  |ed, otherwise th|
000042a0  65 20 73 74 61 6e 64 61  72 64 20 32 2c 20 34 2c  |e standard 2, 4,|
000042b0  20 31 36 20 61 6e 64 20  32 35 36 20 63 6f 6c 6f  | 16 and 256 colo|
000042c0  75 72 20 64 65 73 6b 74  6f 70 0a 70 61 6c 65 74  |ur desktop.palet|
000042d0  74 65 73 20 61 72 65 20  75 73 65 64 2e 20 43 68  |tes are used. Ch|
000042e0  61 6e 67 65 46 53 49 20  63 61 6e 20 61 6c 73 6f  |angeFSI can also|
000042f0  20 72 65 61 64 20 74 68  65 20 31 36 62 70 70 20  | read the 16bpp |
00004300  61 6e 64 20 32 34 62 70  70 20 73 70 72 69 74 65  |and 24bpp sprite|
00004310  73 20 77 68 69 63 68 0a  68 61 76 65 20 6e 6f 20  |s which.have no |
00004320  70 61 6c 65 74 74 65 73  2e 0a 0a 43 68 61 6e 67  |palettes...Chang|
00004330  65 46 53 49 20 69 73 20  62 6f 74 68 20 61 20 63  |eFSI is both a c|
00004340  6f 6d 6d 61 6e 64 20 6c  69 6e 65 20 64 72 69 76  |ommand line driv|
00004350  65 6e 20 70 72 6f 67 72  61 6d 20 61 6e 64 20 61  |en program and a|
00004360  20 64 65 73 6b 74 6f 70  20 61 70 70 6c 69 63 61  | desktop applica|
00004370  74 69 6f 6e 2e 20 54 68  65 0a 66 69 6c 65 20 21  |tion. The.file !|
00004380  48 65 6c 70 20 64 65 73  63 72 69 62 65 73 20 68  |Help describes h|
00004390  6f 77 20 74 6f 20 75 73  65 20 74 68 65 20 61 70  |ow to use the ap|
000043a0  70 6c 69 63 61 74 69 6f  6e 20 66 72 6f 6d 20 74  |plication from t|
000043b0  68 65 20 64 65 73 6b 74  6f 70 2c 20 69 66 20 79  |he desktop, if y|
000043c0  6f 75 20 6e 65 65 64 0a  74 6f 20 75 73 65 20 74  |ou need.to use t|
000043d0  68 65 20 70 72 6f 67 72  61 6d 20 61 73 20 61 20  |he program as a |
000043e0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 64 72 69  |command line dri|
000043f0  76 65 6e 20 70 72 6f 67  72 61 6d 20 79 6f 75 20  |ven program you |
00004400  77 69 6c 6c 20 6e 65 65  64 20 74 6f 20 68 61 76  |will need to hav|
00004410  65 20 69 74 20 69 6e 0a  74 68 65 20 6c 69 62 72  |e it in.the libr|
00004420  61 72 79 20 28 6f 72 20  6f 6e 20 72 75 6e 24 70  |ary (or on run$p|
00004430  61 74 68 29 20 61 6e 64  20 70 72 65 73 73 20 66  |ath) and press f|
00004440  31 32 20 74 6f 20 67 65  74 20 6f 75 74 20 6f 66  |12 to get out of|
00004450  20 74 68 65 20 64 65 73  6b 74 6f 70 2e 20 54 68  | the desktop. Th|
00004460  65 20 66 69 6c 65 0a 22  46 53 49 75 73 65 22 20  |e file."FSIuse" |
00004470  64 65 73 63 72 69 62 65  73 20 74 68 65 20 70 61  |describes the pa|
00004480  72 61 6d 65 74 65 72 73  20 63 6f 6e 63 69 73 65  |rameters concise|
00004490  6c 79 2e 20 54 68 65 20  70 72 6f 67 72 61 6d 20  |ly. The program |
000044a0  73 65 6c 65 63 74 73 20  6d 6f 64 65 20 30 20 77  |selects mode 0 w|
000044b0  68 65 6e 0a 72 75 6e 20  66 72 6f 6d 20 74 68 65  |hen.run from the|
000044c0  20 63 6f 6d 6d 61 6e 64  20 6c 69 6e 65 20 77 68  | command line wh|
000044d0  65 6e 20 64 6f 69 6e 67  20 61 6e 79 20 77 6f 72  |en doing any wor|
000044e0  6b 20 69 6e 20 6f 72 64  65 72 20 74 6f 20 73 70  |k in order to sp|
000044f0  65 65 64 20 75 70 20 70  72 6f 63 65 73 73 69 6e  |eed up processin|
00004500  67 0a 28 74 68 69 73 20  63 61 6e 20 62 65 20 64  |g.(this can be d|
00004510  69 73 61 62 6c 65 64 20  77 69 74 68 20 2d 6e 6f  |isabled with -no|
00004520  6d 6f 64 65 29 2e 20 49  74 20 6d 61 79 20 61 6c  |mode). It may al|
00004530  73 6f 20 62 65 20 61 20  67 6f 6f 64 20 69 64 65  |so be a good ide|
00004540  61 20 74 6f 20 52 4d 46  61 73 74 65 72 0a 42 41  |a to RMFaster.BA|
00004550  53 49 43 2e 20 41 6e 20  68 6f 75 72 67 6c 61 73  |SIC. An hourglas|
00004560  73 20 25 61 67 65 20 70  72 6f 63 65 73 73 65 64  |s %age processed|
00004570  20 66 69 67 75 72 65 20  69 73 20 64 69 73 70 6c  | figure is displ|
00004580  61 79 65 64 20 28 74 68  69 73 20 6d 61 79 20 72  |ayed (this may r|
00004590  75 6e 20 74 68 72 6f 75  67 68 0a 74 77 69 63 65  |un through.twice|
000045a0  20 66 6f 72 20 73 6f 6d  65 20 6f 66 20 74 68 65  | for some of the|
000045b0  20 6d 6f 72 65 20 65 78  70 65 6e 73 69 76 65 20  | more expensive |
000045c0  6f 70 74 69 6f 6e 73 29  2e 20 54 68 65 20 70 72  |options). The pr|
000045d0  6f 67 72 61 6d 20 72 65  61 64 73 20 74 68 65 20  |ogram reads the |
000045e0  73 6f 75 72 63 65 0a 69  6d 61 67 65 20 66 72 6f  |source.image fro|
000045f0  6d 20 64 69 73 63 20 61  6e 64 20 62 75 69 6c 64  |m disc and build|
00004600  73 20 74 68 65 20 6f 75  74 70 75 74 20 69 6e 20  |s the output in |
00004610  6d 65 6d 6f 72 79 2c 20  68 61 76 69 6e 67 20 63  |memory, having c|
00004620  6c 61 69 6d 65 64 20 73  6f 6d 65 20 66 72 6f 6d  |laimed some from|
00004630  20 74 68 65 0a 73 79 73  74 65 6d 2e 0a 0a 49 6e  | the.system...In|
00004640  20 61 64 64 69 74 69 6f  6e 20 74 6f 20 73 74 72  | addition to str|
00004650  69 63 74 6c 79 20 63 6f  6e 76 65 72 74 69 6e 67  |ictly converting|
00004660  20 74 68 65 20 73 6f 75  72 63 65 20 69 6d 61 67  | the source imag|
00004670  65 2c 20 43 68 61 6e 67  65 46 53 49 20 63 61 6e  |e, ChangeFSI can|
00004680  20 61 6c 73 6f 20 70 72  6f 63 65 73 73 0a 69 74  | also process.it|
00004690  2e 20 41 20 74 72 69 76  69 61 6c 20 6f 70 74 69  |. A trivial opti|
000046a0  6f 6e 20 69 73 20 22 2d  69 6e 66 6f 22 3a 20 43  |on is "-info": C|
000046b0  68 61 6e 67 65 46 53 49  20 77 69 6c 6c 20 74 65  |hangeFSI will te|
000046c0  6c 6c 20 79 6f 75 20 77  68 61 74 20 69 74 20 69  |ll you what it i|
000046d0  73 20 64 6f 69 6e 67 20  28 61 0a 67 6f 6f 64 20  |s doing (a.good |
000046e0  77 61 79 20 6f 66 20 66  69 6e 64 69 6e 67 20 6f  |way of finding o|
000046f0  75 74 20 77 68 61 74 20  74 68 65 20 73 6f 75 72  |ut what the sour|
00004700  63 65 20 69 6d 61 67 65  20 61 63 74 75 61 6c 6c  |ce image actuall|
00004710  79 20 69 73 2c 20 61 6e  64 20 68 6f 77 20 74 68  |y is, and how th|
00004720  65 20 73 63 61 6c 69 6e  67 0a 74 75 72 6e 73 20  |e scaling.turns |
00004730  6f 75 74 21 29 2e 20 53  69 6d 69 6c 61 72 6c 79  |out!). Similarly|
00004740  20 74 72 69 76 69 61 6c  20 61 72 65 20 2d 76 66  | trivial are -vf|
00004750  6c 69 70 20 61 6e 64 20  2d 68 66 6c 69 70 20 2d  |lip and -hflip -|
00004760  20 74 68 65 20 70 69 63  74 75 72 65 20 63 61 6e  | the picture can|
00004770  20 62 65 0a 70 72 6f 64  75 63 65 20 75 70 73 69  | be.produce upsi|
00004780  64 65 20 64 6f 77 6e 20  61 6e 64 20 6c 65 66 74  |de down and left|
00004790  2f 72 69 67 68 74 20 72  65 76 65 72 73 65 64 2e  |/right reversed.|
000047a0  20 4e 6f 74 20 73 6f 20  74 72 69 76 69 61 6c 20  | Not so trivial |
000047b0  69 73 20 2d 72 6f 74 61  74 65 2c 20 77 68 69 63  |is -rotate, whic|
000047c0  68 0a 77 69 6c 6c 20 72  6f 74 61 74 65 20 74 68  |h.will rotate th|
000047d0  65 20 69 6d 61 67 65 20  62 79 20 39 30 20 64 65  |e image by 90 de|
000047e0  67 72 65 65 73 20 28 74  68 61 74 20 69 73 2c 20  |grees (that is, |
000047f0  61 6e 20 61 6e 74 69 2d  20 63 6c 6f 63 6b 77 69  |an anti- clockwi|
00004800  73 65 20 71 75 61 72 74  65 72 20 74 75 72 6e 29  |se quarter turn)|
00004810  2e 0a 2d 72 6f 74 61 74  65 2d 20 72 6f 74 61 74  |..-rotate- rotat|
00004820  65 73 20 62 79 20 2d 39  30 20 64 65 67 72 65 65  |es by -90 degree|
00004830  73 20 28 63 6c 6f 63 6b  77 69 73 65 20 71 75 61  |s (clockwise qua|
00004840  72 74 65 72 20 74 75 72  6e 29 2e 0a 0a 53 6f 6d  |rter turn)...Som|
00004850  65 74 69 6d 65 73 20 75  73 65 66 75 6c 20 69 73  |etimes useful is|
00004860  20 22 2d 6e 6f 73 69 7a  65 22 3a 20 43 68 61 6e  | "-nosize": Chan|
00004870  67 65 46 53 49 20 63 61  6e 20 72 65 61 64 20 70  |geFSI can read p|
00004880  69 78 65 6c 20 73 69 7a  65 20 69 6e 66 6f 72 6d  |ixel size inform|
00004890  61 74 69 6f 6e 20 66 72  6f 6d 0a 74 68 65 20 73  |ation from.the s|
000048a0  6f 75 72 63 65 20 69 6d  61 67 65 20 28 69 66 20  |ource image (if |
000048b0  70 72 65 73 65 6e 74 29  20 6f 72 20 67 75 65 73  |present) or gues|
000048c0  73 20 69 74 20 28 65 2e  67 2e 20 69 66 20 74 68  |s it (e.g. if th|
000048d0  65 72 65 20 61 72 65 20  6c 65 73 73 20 74 68 61  |ere are less tha|
000048e0  6e 20 33 32 30 20 62 79  0a 32 35 36 20 70 69 78  |n 320 by.256 pix|
000048f0  65 6c 73 20 69 6e 20 61  20 73 6f 75 72 63 65 20  |els in a source |
00004900  69 6d 61 67 65 2c 20 43  68 61 6e 67 65 46 53 49  |image, ChangeFSI|
00004910  20 61 73 73 75 6d 65 73  20 74 68 65 20 70 69 78  | assumes the pix|
00004920  65 6c 73 20 61 72 65 20  74 68 65 20 73 61 6d 65  |els are the same|
00004930  20 73 69 7a 65 20 61 73  0a 4d 4f 44 45 20 31 33  | size as.MODE 13|
00004940  27 73 20 5b 34 35 20 70  65 72 20 69 6e 63 68 5d  |'s [45 per inch]|
00004950  29 20 6f 72 20 64 65 72  69 76 65 20 69 74 20 66  |) or derive it f|
00004960  72 6f 6d 20 6f 74 68 65  72 20 69 6e 66 6f 72 6d  |rom other inform|
00004970  61 74 69 6f 6e 20 61 6e  64 20 73 63 61 6c 65 20  |ation and scale |
00004980  74 68 65 0a 6f 75 74 70  75 74 20 69 6d 61 67 65  |the.output image|
00004990  20 28 63 6f 6d 70 6f 73  65 64 20 6f 66 20 52 49  | (composed of RI|
000049a0  53 43 20 4f 53 20 73 71  75 61 72 65 20 6f 72 20  |SC OS square or |
000049b0  31 3a 32 20 73 69 7a 65  64 20 70 69 78 65 6c 73  |1:2 sized pixels|
000049c0  29 20 61 70 70 72 6f 70  72 69 61 74 65 6c 79 2e  |) appropriately.|
000049d0  0a 2d 6e 6f 73 69 7a 65  20 73 74 6f 70 73 20 74  |.-nosize stops t|
000049e0  68 69 73 20 66 72 6f 6d  20 68 61 70 70 65 6e 69  |his from happeni|
000049f0  6e 67 2e 20 5b 74 68 69  73 20 73 65 65 6d 73 20  |ng. [this seems |
00004a00  70 61 72 74 69 63 75 6c  61 72 6c 79 20 72 65 6c  |particularly rel|
00004a10  65 76 61 6e 74 20 6f 6e  20 66 6f 72 6d 61 74 73  |evant on formats|
00004a20  0a 6c 69 6b 65 20 54 49  46 46 20 6f 72 20 49 46  |.like TIFF or IF|
00004a30  46 20 77 68 65 72 65 20  74 68 65 20 70 69 78 65  |F where the pixe|
00004a40  6c 20 73 69 7a 65 20 69  73 20 73 70 65 63 69 66  |l size is specif|
00004a50  69 65 64 20 2a 62 75 74  20 6d 61 79 20 62 65 20  |ied *but may be |
00004a60  77 72 6f 6e 67 2a 5d 20  55 73 69 6e 67 0a 2d 69  |wrong*] Using.-i|
00004a70  6e 66 6f 20 77 69 6c 6c  20 64 69 73 70 6c 61 79  |nfo will display|
00004a80  20 74 68 65 20 70 69 78  65 6c 20 72 61 74 69 6f  | the pixel ratio|
00004a90  73 20 77 68 69 63 68 20  43 68 61 6e 67 65 46 53  |s which ChangeFS|
00004aa0  49 20 69 73 20 75 73 69  6e 67 20 2d 20 61 20 63  |I is using - a c|
00004ab0  6f 6d 62 69 6e 61 74 69  6f 6e 20 6f 66 0a 74 68  |ombination of.th|
00004ac0  65 20 73 69 7a 65 20 67  75 65 73 73 2c 20 74 68  |e size guess, th|
00004ad0  65 20 6f 75 74 70 75 74  20 70 69 78 65 6c 20 73  |e output pixel s|
00004ae0  69 7a 65 20 61 6e 64 20  61 6e 79 20 64 65 6c 69  |ize and any deli|
00004af0  62 65 72 61 74 65 20 73  63 61 6c 69 6e 67 2e 20  |berate scaling. |
00004b00  22 2d 6e 6f 73 63 61 6c  65 22 0a 74 75 72 6e 73  |"-noscale".turns|
00004b10  20 6f 66 66 20 74 68 65  20 6f 75 74 70 75 74 20  | off the output |
00004b20  73 63 61 6c 69 6e 67 20  61 73 20 77 65 6c 6c 2e  |scaling as well.|
00004b30  0a 0a 54 68 65 20 73 69  6d 70 6c 65 73 74 20 69  |..The simplest i|
00004b40  6d 61 67 65 20 70 72 6f  63 65 73 73 69 6e 67 20  |mage processing |
00004b50  6f 70 74 69 6f 6e 20 69  73 20 22 2d 72 61 6e 67  |option is "-rang|
00004b60  65 22 20 77 68 69 63 68  20 77 69 6c 6c 20 65 78  |e" which will ex|
00004b70  70 61 6e 64 20 74 68 65  20 64 79 6e 61 6d 69 63  |pand the dynamic|
00004b80  0a 72 61 6e 67 65 20 6f  66 20 74 68 65 20 69 6e  |.range of the in|
00004b90  70 75 74 20 70 69 63 74  75 72 65 20 73 6f 20 74  |put picture so t|
00004ba0  68 61 74 20 69 74 20 66  69 6c 6c 73 20 74 68 65  |hat it fills the|
00004bb0  20 61 76 61 69 6c 61 62  6c 65 20 61 72 65 61 20  | available area |
00004bc0  28 6e 6f 74 20 61 20 67  6f 6f 64 0a 6f 70 74 69  |(not a good.opti|
00004bd0  6f 6e 20 66 6f 72 20 61  6e 69 6d 61 74 65 64 20  |on for animated |
00004be0  73 65 71 75 65 6e 63 65  73 20 75 6e 6c 65 73 73  |sequences unless|
00004bf0  20 61 6c 6c 20 73 6f 75  72 63 65 20 69 6d 61 67  | all source imag|
00004c00  65 73 20 70 6f 73 73 65  73 73 20 74 68 65 20 73  |es possess the s|
00004c10  61 6d 65 20 72 61 6e 67  65 29 2e 0a 53 69 6e 63  |ame range)..Sinc|
00004c20  65 20 72 2c 20 67 2c 20  62 20 61 72 65 20 70 72  |e r, g, b are pr|
00004c30  6f 63 65 73 73 65 64 20  62 79 20 74 68 65 20 73  |ocessed by the s|
00004c40  61 6d 65 20 61 6d 6f 75  6e 74 2c 20 2d 72 61 6e  |ame amount, -ran|
00004c50  67 65 20 70 72 65 73 65  72 76 65 73 20 74 68 65  |ge preserves the|
00004c60  20 63 6f 6c 6f 75 72 20  6f 66 0a 70 69 78 65 6c  | colour of.pixel|
00004c70  73 20 69 6e 20 63 6f 6c  6f 75 72 65 64 20 70 69  |s in coloured pi|
00004c80  63 74 75 72 65 73 2e 0a  0a 41 20 75 73 65 66 75  |ctures...A usefu|
00004c90  6c 20 6f 70 74 69 6f 6e  20 66 6f 72 20 6f 75 74  |l option for out|
00004ca0  70 75 74 20 69 6e 74 65  6e 64 65 64 20 66 6f 72  |put intended for|
00004cb0  20 74 68 65 20 73 63 72  65 65 6e 20 6f 6e 6c 79  | the screen only|
00004cc0  20 69 73 20 47 61 6d 6d  61 20 63 6f 72 72 65 63  | is Gamma correc|
00004cd0  74 69 6f 6e 2e 0a 43 52  54 20 64 69 73 70 6c 61  |tion..CRT displa|
00004ce0  79 73 20 64 6f 20 6e 6f  74 20 68 61 76 65 20 61  |ys do not have a|
00004cf0  20 73 69 6d 70 6c 65 20  6c 69 6e 65 61 72 20 72  | simple linear r|
00004d00  65 6c 61 74 69 6f 6e 73  68 69 70 20 62 65 74 77  |elationship betw|
00004d10  65 65 6e 20 62 72 69 67  68 74 6e 65 73 73 20 6f  |een brightness o|
00004d20  66 20 74 68 65 0a 73 70  6f 74 20 61 6e 64 20 69  |f the.spot and i|
00004d30  6e 70 75 74 20 76 6f 6c  74 61 67 65 3a 20 69 6e  |nput voltage: in|
00004d40  73 74 65 61 64 20 6f 66  20 62 72 69 67 68 74 6e  |stead of brightn|
00004d50  65 73 73 20 3d 20 63 6f  6e 73 74 20 2a 20 76 6f  |ess = const * vo|
00004d60  6c 74 61 67 65 2c 20 74  68 65 20 72 65 73 70 6f  |ltage, the respo|
00004d70  6e 73 65 0a 69 73 20 62  72 69 67 68 74 6e 65 73  |nse.is brightnes|
00004d80  73 20 3d 20 63 6f 6e 73  74 20 2a 20 76 6f 6c 74  |s = const * volt|
00004d90  61 67 65 20 5e 20 28 31  2f 67 61 6d 6d 61 29 2e  |age ^ (1/gamma).|
00004da0  20 49 6e 20 74 68 65 20  54 56 20 69 6e 64 75 73  | In the TV indus|
00004db0  74 72 79 2c 20 67 61 6d  6d 61 20 68 61 73 20 62  |try, gamma has b|
00004dc0  65 65 6e 0a 73 74 61 6e  64 61 72 64 69 73 65 64  |een.standardised|
00004dd0  20 61 73 20 32 2e 32 2c  20 62 75 74 20 74 68 65  | as 2.2, but the|
00004de0  72 65 20 69 73 20 77 69  64 65 20 76 61 72 69 61  |re is wide varia|
00004df0  74 69 6f 6e 20 69 6e 20  74 68 65 20 63 6f 6d 70  |tion in the comp|
00004e00  75 74 65 72 20 69 6e 64  75 73 74 72 79 3a 20 74  |uter industry: t|
00004e10  68 65 0a 6d 6f 6e 69 74  6f 72 27 73 20 72 65 73  |he.monitor's res|
00004e20  70 6f 6e 73 65 20 77 69  6c 6c 20 76 61 72 79 20  |ponse will vary |
00004e30  64 65 70 65 6e 64 69 6e  67 20 6f 6e 20 77 68 61  |depending on wha|
00004e40  74 20 6d 61 6b 65 20 69  74 20 69 73 20 61 6e 64  |t make it is and|
00004e50  20 68 6f 77 20 69 74 20  69 73 0a 61 64 6a 75 73  | how it is.adjus|
00004e60  74 65 64 2e 20 4c 6f 77  20 76 61 6c 75 65 73 20  |ted. Low values |
00004e70  6f 66 20 67 61 6d 6d 61  20 28 30 20 74 6f 20 31  |of gamma (0 to 1|
00004e80  29 20 6d 61 6b 65 20 63  6f 6c 6f 75 72 73 20 64  |) make colours d|
00004e90  61 72 6b 65 72 20 61 6e  64 20 68 69 67 68 20 76  |arker and high v|
00004ea0  61 6c 75 65 73 0a 28 61  62 6f 76 65 20 31 29 20  |alues.(above 1) |
00004eb0  6d 61 6b 65 20 63 6f 6c  6f 75 72 73 20 6c 69 67  |make colours lig|
00004ec0  68 74 65 72 20 77 69 74  68 20 74 68 65 20 65 66  |hter with the ef|
00004ed0  66 65 63 74 73 20 62 65  69 6e 67 20 70 61 72 74  |fects being part|
00004ee0  69 63 75 6c 61 72 6c 79  20 6e 6f 74 69 63 65 61  |icularly noticea|
00004ef0  62 6c 65 0a 6f 6e 20 64  69 6d 20 63 6f 6c 6f 75  |ble.on dim colou|
00004f00  72 73 2e 20 22 2d 67 61  6d 6d 61 22 20 75 73 65  |rs. "-gamma" use|
00004f10  73 20 74 68 65 20 64 65  66 61 75 6c 74 20 6f 66  |s the default of|
00004f20  20 32 2e 32 2c 20 61 6e  64 20 69 74 20 63 61 6e  | 2.2, and it can|
00004f30  20 62 65 20 73 65 74 20  62 79 0a 22 2d 67 61 6d  | be set by."-gam|
00004f40  6d 61 31 2e 35 22 20 73  61 79 2e 20 47 61 6d 6d  |ma1.5" say. Gamm|
00004f50  61 20 63 6f 72 72 65 63  74 69 6f 6e 20 69 73 20  |a correction is |
00004f60  6d 6f 73 74 20 72 65 6c  65 76 61 6e 74 20 77 68  |most relevant wh|
00004f70  65 6e 20 69 74 73 20 6b  6e 6f 77 6e 20 74 68 61  |en its known tha|
00004f80  74 20 74 68 65 0a 69 6e  70 75 74 20 68 61 73 20  |t the.input has |
00004f90  61 20 6c 69 6e 65 61 72  20 69 6e 74 65 6e 73 69  |a linear intensi|
00004fa0  74 79 20 28 69 6e 70 75  74 20 66 72 6f 6d 20 61  |ty (input from a|
00004fb0  20 73 63 61 6e 6e 65 72  20 6f 72 20 66 72 6f 6d  | scanner or from|
00004fc0  20 61 6e 6f 74 68 65 72  20 63 6f 6d 70 75 74 65  | another compute|
00004fd0  72 0a 77 69 74 68 20 6d  6f 72 65 20 62 69 74 73  |r.with more bits|
00004fe0  20 70 65 72 20 63 6f 6c  6f 75 72 20 63 6f 6d 70  | per colour comp|
00004ff0  6f 6e 65 6e 74 20 74 68  61 6e 20 74 68 65 20 41  |onent than the A|
00005000  72 63 68 69 6d 65 64 65  73 29 2e 0a 0a 41 20 6d  |rchimedes)...A m|
00005010  6f 72 65 20 63 6f 6d 70  6c 65 78 20 70 72 69 6d  |ore complex prim|
00005020  69 74 69 76 65 20 69 73  20 22 2d 65 71 75 61 6c  |itive is "-equal|
00005030  22 20 77 68 69 63 68 20  70 65 72 66 6f 72 6d 73  |" which performs|
00005040  20 22 68 69 73 74 6f 67  72 61 6d 20 65 71 75 61  | "histogram equa|
00005050  6c 69 73 61 74 69 6f 6e  22 20 6f 6e 0a 74 68 65  |lisation" on.the|
00005060  20 69 6d 61 67 65 2e 20  54 68 69 73 20 6d 61 6b  | image. This mak|
00005070  65 73 20 74 68 65 20 68  69 73 74 6f 67 72 61 6d  |es the histogram|
00005080  20 6f 66 20 6c 65 76 65  6c 20 76 65 72 73 75 73  | of level versus|
00005090  20 6e 75 6d 62 65 72 20  6f 66 20 70 6f 69 6e 74  | number of point|
000050a0  73 20 61 74 20 74 68 61  74 0a 6c 65 76 65 6c 20  |s at that.level |
000050b0  61 73 20 66 6c 61 74 20  61 73 20 70 6f 73 73 69  |as flat as possi|
000050c0  62 6c 65 20 67 69 76 69  6e 67 20 66 75 6c 6c 20  |ble giving full |
000050d0  75 73 65 20 6f 66 20 74  68 65 20 6e 75 6d 62 65  |use of the numbe|
000050e0  72 20 6f 66 20 63 6f 6c  6f 75 72 73 20 61 76 61  |r of colours ava|
000050f0  69 6c 61 62 6c 65 2e 0a  2d 65 71 75 61 6c 20 69  |ilable..-equal i|
00005100  73 20 61 20 76 65 72 79  20 68 61 72 73 68 20 70  |s a very harsh p|
00005110  72 69 6d 69 74 69 76 65  2c 20 65 76 65 6e 20 6f  |rimitive, even o|
00005120  6e 20 6d 6f 6e 6f 63 68  72 6f 6d 65 20 69 6e 70  |n monochrome inp|
00005130  75 74 73 20 69 74 20 63  61 6e 20 70 72 6f 64 75  |uts it can produ|
00005140  63 65 20 61 6e 0a 69 6e  66 65 72 69 6f 72 20 70  |ce an.inferior p|
00005150  69 63 74 75 72 65 3b 20  77 68 69 6c 65 20 6f 6e  |icture; while on|
00005160  20 63 6f 6c 6f 75 72 20  70 69 63 74 75 72 65 73  | colour pictures|
00005170  20 69 74 20 63 61 6e 20  64 69 73 74 6f 72 74 20  | it can distort |
00005180  74 68 65 20 63 6f 6c 6f  75 72 20 6f 66 20 65 61  |the colour of ea|
00005190  63 68 0a 70 6f 69 6e 74  20 28 73 69 6e 63 65 20  |ch.point (since |
000051a0  72 2c 20 67 2c 20 62 20  61 72 65 20 63 6f 6d 70  |r, g, b are comp|
000051b0  75 74 65 64 20 73 65 70  61 72 61 74 65 6c 79 29  |uted separately)|
000051c0  2e 20 42 75 74 20 2d 65  71 75 61 6c 20 63 61 6e  |. But -equal can|
000051d0  20 6f 66 74 65 6e 20 72  65 63 6f 76 65 72 20 61  | often recover a|
000051e0  0a 70 69 63 74 75 72 65  20 74 68 61 74 20 69 73  |.picture that is|
000051f0  20 6f 74 68 65 72 77 69  73 65 20 63 6f 6d 70 6c  | otherwise compl|
00005200  65 74 65 6c 79 20 75 73  65 6c 65 73 73 20 6f 72  |etely useless or|
00005210  20 65 78 70 6f 73 65 20  69 6e 66 6f 72 6d 61 74  | expose informat|
00005220  69 6f 6e 20 6c 6f 63 6b  65 64 20 69 6e 20 61 0a  |ion locked in a.|
00005230  73 6d 61 6c 6c 20 70 61  72 74 20 6f 66 20 74 68  |small part of th|
00005240  65 20 69 6e 70 75 74 20  73 63 61 6c 65 2e 0a 0a  |e input scale...|
00005250  49 6d 61 67 65 20 63 6f  6c 6f 75 72 73 20 6d 61  |Image colours ma|
00005260  79 20 62 65 20 69 6e 76  65 72 74 65 64 20 77 69  |y be inverted wi|
00005270  74 68 20 74 68 65 20 2d  69 6e 76 65 72 74 20 6f  |th the -invert o|
00005280  70 74 69 6f 6e 2e 20 57  68 69 63 68 20 6d 61 79  |ption. Which may|
00005290  20 62 65 20 66 75 6e 20  69 6e 0a 63 6f 6c 6f 75  | be fun in.colou|
000052a0  72 20 62 75 74 20 69 73  20 72 61 72 65 6c 79 20  |r but is rarely |
000052b0  75 73 65 66 75 6c 21 20  48 6f 77 65 76 65 72 2c  |useful! However,|
000052c0  20 6d 6f 6e 6f 63 68 72  6f 6d 65 20 69 6d 61 67  | monochrome imag|
000052d0  65 73 20 66 72 65 71 75  65 6e 74 6c 79 20 6e 65  |es frequently ne|
000052e0  65 64 0a 69 6e 76 65 72  74 69 6e 67 2c 20 65 73  |ed.inverting, es|
000052f0  70 65 63 69 61 6c 6c 79  20 6f 6e 65 20 62 69 74  |pecially one bit|
00005300  20 70 65 72 20 70 69 78  65 6c 20 73 6f 75 72 63  | per pixel sourc|
00005310  65 73 2e 0a 0a 41 20 6d  6f 72 65 20 70 6f 77 65  |es...A more powe|
00005320  72 66 75 6c 20 6f 70 74  69 6f 6e 20 69 73 20 22  |rful option is "|
00005330  2d 73 68 61 72 70 65 6e  22 20 77 68 69 63 68 20  |-sharpen" which |
00005340  65 6e 68 61 6e 63 65 73  20 74 68 65 20 65 64 67  |enhances the edg|
00005350  65 73 20 6f 66 20 6f 62  6a 65 63 74 73 20 69 6e  |es of objects in|
00005360  20 74 68 65 0a 70 69 63  74 75 72 65 3a 20 74 68  | the.picture: th|
00005370  69 73 20 69 73 20 76 65  72 79 20 75 73 65 66 75  |is is very usefu|
00005380  6c 20 73 69 6e 63 65 20  74 68 65 20 64 69 74 68  |l since the dith|
00005390  65 72 69 6e 67 20 70 72  6f 63 65 73 73 20 69 6e  |ering process in|
000053a0  65 76 69 74 61 62 6c 79  20 73 6d 65 61 72 73 0a  |evitably smears.|
000053b0  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 6f 76 65 72  |information over|
000053c0  20 74 68 65 20 64 69 73  70 6c 61 79 2e 20 50 72  | the display. Pr|
000053d0  65 2d 73 68 61 72 70 65  6e 69 6e 67 20 74 68 65  |e-sharpening the|
000053e0  20 69 6d 61 67 65 20 63  61 6e 20 72 65 73 75 6c  | image can resul|
000053f0  74 20 69 6e 20 61 20 6d  6f 72 65 0a 61 63 63 65  |t in a more.acce|
00005400  70 74 61 62 6c 65 20 6f  75 74 70 75 74 2e 20 44  |ptable output. D|
00005410  65 66 61 75 6c 74 20 76  61 6c 75 65 73 20 6f 66  |efault values of|
00005420  20 73 68 61 72 70 65 6e  69 6e 67 20 63 61 6e 20  | sharpening can |
00005430  62 65 20 6f 76 65 72 72  69 64 64 65 6e 20 66 6f  |be overridden fo|
00005440  72 20 73 70 65 63 69 61  6c 0a 65 66 66 65 63 74  |r special.effect|
00005450  73 3a 20 2d 73 68 61 72  70 65 6e 38 20 64 6f 65  |s: -sharpen8 doe|
00005460  73 20 65 64 67 65 20 64  65 74 65 63 74 69 6f 6e  |s edge detection|
00005470  2e 20 4c 6f 77 65 72 20  61 6d 6f 75 6e 74 73 20  |. Lower amounts |
00005480  6f 66 20 73 68 61 72 70  65 6e 69 6e 67 20 61 72  |of sharpening ar|
00005490  65 0a 6f 62 74 61 69 6e  65 64 20 77 69 74 68 20  |e.obtained with |
000054a0  6c 61 72 67 65 72 20 2d  73 68 61 72 70 65 6e 20  |larger -sharpen |
000054b0  6e 75 6d 62 65 72 73 2e  20 49 6e 20 67 65 6e 65  |numbers. In gene|
000054c0  72 61 6c 20 74 68 65 20  6d 6f 72 65 20 69 6e 70  |ral the more inp|
000054d0  75 74 20 61 6e 64 20 6f  75 74 70 75 74 0a 70 69  |ut and output.pi|
000054e0  78 65 6c 73 20 61 6e 64  20 74 68 65 20 67 72 65  |xels and the gre|
000054f0  61 74 65 72 20 74 68 65  20 6f 75 74 70 75 74 20  |ater the output |
00005500  72 61 6e 67 65 20 69 6e  20 61 20 70 69 78 65 6c  |range in a pixel|
00005510  20 69 6e 20 74 68 65 20  69 6d 61 67 65 73 2c 20  | in the images, |
00005520  74 68 65 20 6c 65 73 73  0a 73 68 61 72 70 65 6e  |the less.sharpen|
00005530  69 6e 67 20 69 73 20 72  65 71 75 69 72 65 64 2e  |ing is required.|
00005540  20 53 68 61 72 70 65 6e  69 6e 67 20 61 20 70 69  | Sharpening a pi|
00005550  63 74 75 72 65 20 77 68  69 63 68 20 69 73 20 61  |cture which is a|
00005560  6c 72 65 61 64 79 20 64  69 74 68 65 72 65 64 20  |lready dithered |
00005570  63 61 6e 20 67 69 76 65  0a 61 20 76 65 72 79 20  |can give.a very |
00005580  62 61 64 20 72 65 73 75  6c 74 2e 2e 2e 2e 0a 0a  |bad result......|
00005590  54 68 65 20 73 68 61 72  70 65 6e 69 6e 67 20 69  |The sharpening i|
000055a0  73 20 61 63 68 69 65 76  65 64 20 77 69 74 68 20  |s achieved with |
000055b0  74 68 65 20 66 6f 6c 6c  6f 77 69 6e 67 20 6d 61  |the following ma|
000055c0  74 72 69 78 3a 0a 0a 20  20 20 2d 31 20 20 20 20  |trix:..   -1    |
000055d0  2d 31 20 20 20 20 2d 31  0a 20 20 20 2d 31 20 73  |-1    -1.   -1 s|
000055e0  68 61 72 70 65 6e 20 20  2d 31 0a 20 20 20 2d 31  |harpen  -1.   -1|
000055f0  20 20 20 20 2d 31 20 20  20 20 2d 31 0a 0a 43 68  |    -1    -1..Ch|
00005600  61 6e 67 65 46 53 49 20  63 6f 6d 70 75 74 65 73  |angeFSI computes|
00005610  20 74 68 65 20 73 75 6d  20 6f 66 20 6e 69 6e 65  | the sum of nine|
00005620  20 70 69 78 65 6c 73 20  77 69 74 68 20 74 68 65  | pixels with the|
00005630  20 61 62 6f 76 65 20 77  65 69 67 68 74 73 20 66  | above weights f|
00005640  6f 72 20 65 61 63 68 20  69 6e 70 75 74 0a 70 69  |or each input.pi|
00005650  78 65 6c 20 61 6e 64 20  72 65 6e 6f 72 6d 61 6c  |xel and renormal|
00005660  69 73 65 73 20 74 68 65  20 72 65 73 75 6c 74 20  |ises the result |
00005670  28 64 69 76 69 64 65 73  20 62 79 20 73 68 61 72  |(divides by shar|
00005680  70 65 6e 2d 38 29 2e 0a  0a 53 69 6d 69 6c 61 72  |pen-8)...Similar|
00005690  20 69 73 20 22 2d 73 6d  6f 6f 74 68 22 20 77 68  | is "-smooth" wh|
000056a0  69 63 68 20 61 76 65 72  61 67 65 73 20 74 68 65  |ich averages the|
000056b0  20 70 69 78 65 6c 73 20  74 6f 20 65 6c 69 6d 69  | pixels to elimi|
000056c0  6e 61 74 65 20 6e 6f 69  73 65 2e 20 49 74 20 75  |nate noise. It u|
000056d0  73 65 73 20 74 68 65 0a  66 6f 6c 6c 6f 77 69 6e  |ses the.followin|
000056e0  67 20 6d 61 74 72 69 78  3a 0a 0a 20 20 20 20 31  |g matrix:..    1|
000056f0  20 20 20 20 20 31 20 20  20 20 20 31 0a 20 20 20  |     1     1.   |
00005700  20 31 20 20 73 6d 6f 6f  74 68 20 20 20 31 0a 20  | 1  smooth   1. |
00005710  20 20 20 31 20 20 20 20  20 31 20 20 20 20 20 31  |   1     1     1|
00005720  0a 0a 43 68 61 6e 67 65  46 53 49 20 63 6f 6d 70  |..ChangeFSI comp|
00005730  75 74 65 73 20 74 68 65  20 73 75 6d 20 6f 66 20  |utes the sum of |
00005740  6e 69 6e 65 20 70 69 78  65 6c 73 20 77 69 74 68  |nine pixels with|
00005750  20 74 68 65 20 61 62 6f  76 65 20 77 65 69 67 68  | the above weigh|
00005760  74 73 20 66 6f 72 20 65  61 63 68 20 69 6e 70 75  |ts for each inpu|
00005770  74 0a 70 69 78 65 6c 20  61 6e 64 20 72 65 6e 6f  |t.pixel and reno|
00005780  72 6d 61 6c 69 73 65 73  20 74 68 65 20 72 65 73  |rmalises the res|
00005790  75 6c 74 20 28 64 69 76  69 64 65 73 20 62 79 20  |ult (divides by |
000057a0  73 6d 6f 6f 74 68 2b 38  29 2e 20 4f 6e 6c 79 20  |smooth+8). Only |
000057b0  6f 6e 65 20 6f 66 20 73  6d 6f 6f 74 68 69 6e 67  |one of smoothing|
000057c0  0a 6f 72 20 73 68 61 72  70 65 6e 69 6e 67 20 6d  |.or sharpening m|
000057d0  61 79 20 62 65 20 70 65  72 66 6f 72 6d 65 64 20  |ay be performed |
000057e0  28 77 68 69 63 68 65 76  65 72 20 69 73 20 6c 61  |(whichever is la|
000057f0  73 74 20 6f 6e 20 74 68  65 20 63 6f 6d 6d 61 6e  |st on the comman|
00005800  64 20 6c 69 6e 65 29 2e  0a 0a 41 6e 20 6f 70 74  |d line)...An opt|
00005810  69 6f 6e 20 66 6f 72 20  74 65 73 74 69 6e 67 20  |ion for testing |
00005820  69 73 20 22 2d 6e 6f 64  69 74 68 65 72 22 20 77  |is "-nodither" w|
00005830  68 69 63 68 20 64 69 73  61 62 6c 65 73 20 74 68  |hich disables th|
00005840  65 20 46 6c 6f 79 64 20  53 74 65 69 6e 62 65 72  |e Floyd Steinber|
00005850  67 20 65 72 72 6f 72 0a  64 69 66 66 75 73 69 6f  |g error.diffusio|
00005860  6e 20 73 74 65 70 20 63  6f 6d 70 6c 65 74 65 6c  |n step completel|
00005870  79 2e 20 56 65 72 73 69  6f 6e 73 20 61 66 74 65  |y. Versions afte|
00005880  72 20 36 74 68 20 4a 75  6e 65 20 31 39 39 30 20  |r 6th June 1990 |
00005890  61 72 65 20 6d 6f 72 65  20 61 63 63 75 72 61 74  |are more accurat|
000058a0  65 20 61 74 0a 64 6f 69  6e 67 20 74 68 69 73 2e  |e at.doing this.|
000058b0  0a 0a 54 68 65 20 76 61  72 69 6f 75 73 20 70 72  |..The various pr|
000058c0  6f 63 65 73 73 65 73 20  64 65 73 63 72 69 62 65  |ocesses describe|
000058d0  64 20 61 62 6f 76 65 20  61 72 65 20 61 70 70 6c  |d above are appl|
000058e0  69 65 64 20 69 6e 20 74  68 65 20 66 6f 6c 6c 6f  |ied in the follo|
000058f0  77 69 6e 67 20 6f 72 64  65 72 20 66 6f 72 0a 70  |wing order for.p|
00005900  69 63 74 75 72 65 73 20  77 69 74 68 20 6d 6f 72  |ictures with mor|
00005910  65 20 6f 75 74 70 75 74  20 70 69 78 65 6c 73 20  |e output pixels |
00005920  74 68 61 6e 20 69 6e 70  75 74 3a 0a 20 20 20 28  |than input:.   (|
00005930  61 29 20 72 61 6e 67 65  20 6f 72 20 68 69 73 74  |a) range or hist|
00005940  6f 67 72 61 6d 20 65 71  75 61 6c 69 73 61 74 69  |ogram equalisati|
00005950  6f 6e 2c 0a 20 20 20 28  62 29 20 73 68 61 72 70  |on,.   (b) sharp|
00005960  65 6e 20 6f 72 20 73 6d  6f 6f 74 68 2c 0a 20 20  |en or smooth,.  |
00005970  20 28 63 29 20 73 63 61  6c 65 2c 0a 20 20 20 28  | (c) scale,.   (|
00005980  64 29 20 65 72 72 6f 72  20 64 69 66 66 75 73 69  |d) error diffusi|
00005990  6f 6e 2e 0a 54 68 69 73  20 6f 72 64 65 72 20 69  |on..This order i|
000059a0  73 20 63 68 6f 73 65 6e  20 73 6f 20 74 68 61 74  |s chosen so that|
000059b0  3a 0a 20 20 20 28 31 29  20 73 69 6e 63 65 20 74  |:.   (1) since t|
000059c0  68 65 20 69 6e 70 75 74  20 70 69 78 65 6c 73 20  |he input pixels |
000059d0  28 72 61 74 68 65 72 20  74 68 61 6e 20 74 68 65  |(rather than the|
000059e0  20 6f 75 74 70 75 74 20  70 69 78 65 6c 73 29 20  | output pixels) |
000059f0  61 72 65 20 73 68 61 72  70 65 6e 65 64 2c 0a 20  |are sharpened,. |
00005a00  20 20 20 20 20 20 74 68  65 72 65 20 69 73 20 6e  |      there is n|
00005a10  6f 20 66 61 6c 73 65 20  65 64 67 65 20 69 6e 74  |o false edge int|
00005a20  72 6f 64 75 63 65 64 20  77 68 65 6e 20 70 69 78  |roduced when pix|
00005a30  65 6c 73 20 61 72 65 20  72 65 70 6c 69 63 61 74  |els are replicat|
00005a40  65 64 2e 0a 0a 54 68 65  20 76 61 72 69 6f 75 73  |ed...The various|
00005a50  20 70 72 6f 63 65 73 73  65 73 20 64 65 73 63 72  | processes descr|
00005a60  69 62 65 64 20 61 62 6f  76 65 20 61 72 65 20 61  |ibed above are a|
00005a70  70 70 6c 69 65 64 20 69  6e 20 74 68 65 20 66 6f  |pplied in the fo|
00005a80  6c 6c 6f 77 69 6e 67 20  6f 72 64 65 72 20 66 6f  |llowing order fo|
00005a90  72 0a 70 69 63 74 75 72  65 73 20 77 69 74 68 20  |r.pictures with |
00005aa0  66 65 77 65 72 20 6f 75  74 70 75 74 20 70 69 78  |fewer output pix|
00005ab0  65 6c 73 20 74 68 61 6e  20 69 6e 70 75 74 3a 0a  |els than input:.|
00005ac0  20 20 20 28 61 29 20 73  63 61 6c 65 2c 0a 20 20  |   (a) scale,.  |
00005ad0  20 28 62 29 20 72 61 6e  67 65 20 6f 72 20 68 69  | (b) range or hi|
00005ae0  73 74 6f 67 72 61 6d 20  65 71 75 61 6c 69 73 61  |stogram equalisa|
00005af0  74 69 6f 6e 2c 0a 20 20  20 28 63 29 20 73 68 61  |tion,.   (c) sha|
00005b00  72 70 65 6e 20 6f 72 20  73 6d 6f 6f 74 68 2c 0a  |rpen or smooth,.|
00005b10  20 20 20 28 64 29 20 65  72 72 6f 72 20 64 69 66  |   (d) error dif|
00005b20  66 75 73 69 6f 6e 2e 0a  54 68 69 73 20 6f 72 64  |fusion..This ord|
00005b30  65 72 20 69 73 20 63 68  6f 73 65 6e 20 73 6f 20  |er is chosen so |
00005b40  74 68 61 74 3a 0a 20 20  20 28 31 29 20 72 61 6e  |that:.   (1) ran|
00005b50  67 69 6e 67 20 63 61 6e  20 65 6e 68 61 6e 63 65  |ging can enhance|
00005b60  20 64 6f 77 6e 2d 73 69  7a 65 64 20 69 6d 61 67  | down-sized imag|
00005b70  65 73 2e 20 53 61 79 20  61 20 62 6c 61 63 6b 2f  |es. Say a black/|
00005b80  77 68 69 74 65 20 64 69  74 68 65 72 65 64 20 69  |white dithered i|
00005b90  6d 61 67 65 0a 20 20 20  20 20 20 20 69 73 20 72  |mage.       is r|
00005ba0  65 64 75 63 65 64 20 69  6e 20 73 69 7a 65 2c 20  |educed in size, |
00005bb0  73 6f 20 74 68 61 74 20  74 68 65 20 6f 75 74 70  |so that the outp|
00005bc0  75 74 20 66 72 6f 6d 20  74 68 65 20 73 63 61 6c  |ut from the scal|
00005bd0  69 6e 67 20 70 72 6f 63  65 73 73 20 69 73 20 28  |ing process is (|
00005be0  73 6f 6d 65 0a 20 20 20  20 20 20 20 61 70 70 72  |some.       appr|
00005bf0  6f 78 69 6d 61 74 69 6f  6e 20 74 6f 29 20 74 68  |oximation to) th|
00005c00  65 20 6f 72 69 67 69 6e  61 6c 20 67 72 65 79 20  |e original grey |
00005c10  6c 65 76 65 6c 73 3b 20  74 68 65 6e 20 72 61 6e  |levels; then ran|
00005c20  67 69 6e 67 20 63 61 6e  20 65 78 70 61 6e 64 20  |ging can expand |
00005c30  74 68 69 73 0a 20 20 20  20 20 20 20 69 66 20 70  |this.       if p|
00005c40  6f 73 73 69 62 6c 65 2e  0a 20 20 20 28 32 29 20  |ossible..   (2) |
00005c50  73 68 61 72 70 65 6e 69  6e 67 20 63 61 6e 20 62  |sharpening can b|
00005c60  65 20 75 73 65 64 20 74  6f 20 6f 66 66 73 65 74  |e used to offset|
00005c70  20 74 68 65 20 62 6c 75  72 72 69 6e 67 20 65 66  | the blurring ef|
00005c80  66 65 63 74 73 20 6f 66  20 73 63 61 6c 69 6e 67  |fects of scaling|
00005c90  2e 0a 20 20 20 28 33 29  20 73 69 6e 63 65 20 74  |..   (3) since t|
00005ca0  68 65 20 6f 75 74 70 75  74 20 70 69 78 65 6c 73  |he output pixels|
00005cb0  20 28 72 61 74 68 65 72  20 74 68 61 6e 20 74 68  | (rather than th|
00005cc0  65 20 69 6e 70 75 74 20  70 69 78 65 6c 73 29 20  |e input pixels) |
00005cd0  61 72 65 20 73 68 61 72  70 65 6e 65 64 2c 0a 20  |are sharpened,. |
00005ce0  20 20 20 20 20 20 74 68  65 20 65 66 66 65 63 74  |      the effect|
00005cf0  20 6f 66 20 2d 73 68 61  72 70 65 6e 4e 20 69 73  | of -sharpenN is|
00005d00  20 63 6f 6e 73 69 73 74  65 6e 74 20 6f 76 65 72  | consistent over|
00005d10  20 64 69 66 66 65 72 65  6e 74 6c 79 20 73 63 61  | differently sca|
00005d20  6c 65 64 20 69 6d 61 67  65 73 2e 0a 0a 54 68 65  |led images...The|
00005d30  72 65 20 6d 61 79 20 62  65 20 74 69 6d 65 73 20  |re may be times |
00005d40  77 68 65 6e 20 74 68 69  73 20 61 75 74 6f 6d 61  |when this automa|
00005d50  74 69 63 20 73 65 6c 65  63 74 69 6f 6e 20 6f 66  |tic selection of|
00005d60  20 6f 72 64 65 72 20 67  65 74 73 20 69 74 20 77  | order gets it w|
00005d70  72 6f 6e 67 2c 0a 70 61  72 74 69 63 75 6c 61 72  |rong,.particular|
00005d80  6c 79 20 77 68 65 6e 20  63 68 61 6e 67 69 6e 67  |ly when changing|
00005d90  20 74 68 65 20 61 73 70  65 63 74 20 72 61 74 69  | the aspect rati|
00005da0  6f 2c 20 69 74 20 69 73  20 70 6f 73 73 69 62 6c  |o, it is possibl|
00005db0  65 20 74 6f 20 74 72 69  67 67 65 72 20 73 6f 6d  |e to trigger som|
00005dc0  65 0a 75 6e 64 65 73 69  72 61 62 6c 65 20 73 68  |e.undesirable sh|
00005dd0  61 72 70 65 6e 69 6e 67  20 61 72 74 69 66 61 63  |arpening artifac|
00005de0  74 73 2e 20 55 73 65 20  74 68 65 20 70 72 6f 67  |ts. Use the prog|
00005df0  72 61 6d 20 74 77 69 63  65 20 77 69 74 68 20 73  |ram twice with s|
00005e00  68 61 72 70 65 6e 69 6e  67 20 28 73 61 79 29 0a  |harpening (say).|
00005e10  64 69 73 61 62 6c 65 64  20 61 6e 64 20 65 6e 61  |disabled and ena|
00005e20  62 6c 65 64 20 69 6e 20  74 68 65 20 6f 72 64 65  |bled in the orde|
00005e30  72 20 72 65 71 75 69 72  65 64 2e 0a 0a 45 78 61  |r required...Exa|
00005e40  6d 70 6c 65 73 20 6f 66  20 75 73 65 3a 0a 0a 4d  |mples of use:..M|
00005e50  61 6b 65 20 22 73 74 61  6e 64 61 72 64 20 70 61  |ake "standard pa|
00005e60  6c 65 74 74 65 22 20 76  65 72 73 69 6f 6e 73 20  |lette" versions |
00005e70  6f 66 20 65 78 69 73 74  69 6e 67 20 32 35 36 20  |of existing 256 |
00005e80  63 6f 6c 6f 75 72 20 69  6d 61 67 65 73 20 28 66  |colour images (f|
00005e90  6f 72 20 65 78 61 6d 70  6c 65 0a 74 68 65 20 57  |or example.the W|
00005ea0  61 74 66 6f 72 64 20 64  69 67 69 74 69 73 65 72  |atford digitiser|
00005eb0  20 70 6c 75 73 20 63 6f  6c 6f 75 72 20 62 6f 61  | plus colour boa|
00005ec0  72 64 20 64 6f 65 73 6e  27 74 20 75 73 65 20 74  |rd doesn't use t|
00005ed0  68 65 20 73 74 61 6e 64  61 72 64 20 70 61 6c 65  |he standard pale|
00005ee0  74 74 65 29 2e 0a 20 20  28 65 2e 67 2e 20 22 63  |tte)..  (e.g. "c|
00005ef0  68 61 6e 67 65 66 73 69  20 69 6e 20 6f 75 74 20  |hangefsi in out |
00005f00  31 33 70 22 20 66 6f 72  20 61 20 63 6f 6c 6f 75  |13p" for a colou|
00005f10  72 65 64 20 57 61 74 66  6f 72 64 20 70 69 63 74  |red Watford pict|
00005f20  75 72 65 29 0a 0a 4f 72  20 63 6f 6e 76 65 72 74  |ure)..Or convert|
00005f30  20 61 20 63 6f 6c 6f 75  72 20 70 69 63 74 75 72  | a colour pictur|
00005f40  65 20 74 6f 20 73 6f 6d  65 74 68 69 6e 67 20 79  |e to something y|
00005f50  6f 75 20 63 61 6e 20 73  65 65 20 6f 6e 20 79 6f  |ou can see on yo|
00005f60  75 72 20 68 69 67 68 20  72 65 73 20 6d 6f 6e 6f  |ur high res mono|
00005f70  0a 6d 6f 6e 69 74 6f 72  2e 0a 20 20 28 65 2e 67  |.monitor..  (e.g|
00005f80  2e 20 22 63 68 61 6e 67  65 66 73 69 20 69 6e 20  |. "changefsi in |
00005f90  6f 75 74 20 31 38 20 2d  73 68 61 72 70 65 6e 20  |out 18 -sharpen |
00005fa0  2d 69 6e 66 6f 22 29 0a  0a 4f 72 20 63 6f 6e 76  |-info")..Or conv|
00005fb0  65 72 74 20 61 20 6c 61  72 67 65 20 6d 6f 6e 6f  |ert a large mono|
00005fc0  63 68 72 6f 6d 65 20 70  69 63 74 75 72 65 20 28  |chrome picture (|
00005fd0  66 72 6f 6d 20 61 20 73  63 61 6e 6e 65 72 2c 20  |from a scanner, |
00005fe0  73 61 79 29 20 74 6f 20  73 6f 6d 65 74 68 69 6e  |say) to somethin|
00005ff0  67 0a 77 68 69 63 68 20  63 61 6e 20 62 65 20 73  |g.which can be s|
00006000  65 65 6e 2e 0a 20 20 28  65 2e 67 2e 20 22 63 68  |een..  (e.g. "ch|
00006010  61 6e 67 65 66 73 69 20  69 6e 20 6f 75 74 20 32  |angefsi in out 2|
00006020  30 74 20 31 3a 34 20 2d  67 61 6d 6d 61 22 29 0a  |0t 1:4 -gamma").|
00006030  0a 4f 72 20 63 6f 6e 76  65 72 74 20 61 20 63 6f  |.Or convert a co|
00006040  6c 6f 75 72 20 70 69 63  74 75 72 65 20 74 6f 20  |lour picture to |
00006050  67 72 65 79 20 73 63 61  6c 65 20 66 6f 72 20 74  |grey scale for t|
00006060  68 65 20 64 65 73 6b 74  6f 70 2e 0a 20 20 28 65  |he desktop..  (e|
00006070  2e 67 2e 20 22 63 68 61  6e 67 65 66 73 69 20 69  |.g. "changefsi i|
00006080  6e 20 6f 75 74 20 32 30  22 29 0a 0a 4f 72 20 63  |n out 20")..Or c|
00006090  68 61 6e 67 65 20 61 20  35 31 32 20 62 79 20 34  |hange a 512 by 4|
000060a0  38 30 20 69 6d 61 67 65  20 74 6f 20 73 74 61 6e  |80 image to stan|
000060b0  64 61 72 64 20 66 6f 72  6d 61 74 20 61 6e 64 20  |dard format and |
000060c0  61 73 70 65 63 74 20 72  61 74 69 6f 0a 20 20 28  |aspect ratio.  (|
000060d0  65 2e 67 2e 20 22 63 68  61 6e 67 65 66 73 69 20  |e.g. "changefsi |
000060e0  69 6e 20 6f 75 74 20 31  35 20 36 34 30 3a 35 31  |in out 15 640:51|
000060f0  32 20 35 31 32 3a 34 38  30 22 29 0a 20 20 28 6f  |2 512:480").  (o|
00006100  72 20 22 63 68 61 6e 67  65 66 73 69 20 69 6e 20  |r "changefsi in |
00006110  6f 75 74 20 3d 20 2d 72  61 6e 67 65 22 29 0a 0a  |out = -range")..|
00006120  4f 72 20 63 68 61 6e 67  65 20 74 6f 20 64 69 67  |Or change to dig|
00006130  69 74 61 6c 20 72 2c 20  67 2c 20 62 0a 20 20 28  |ital r, g, b.  (|
00006140  65 2e 67 2e 20 22 63 68  61 6e 67 65 66 73 69 20  |e.g. "changefsi |
00006150  69 6e 20 6f 75 74 20 32  30 64 20 2d 73 68 61 72  |in out 20d -shar|
00006160  70 65 6e 31 36 22 29 0a  0a 4f 72 20 63 6f 6e 76  |pen16")..Or conv|
00006170  65 72 74 20 61 20 70 69  63 74 75 72 65 20 66 6f  |ert a picture fo|
00006180  72 20 70 72 69 6e 74 69  6e 67 20 6f 6e 20 61 20  |r printing on a |
00006190  33 30 30 64 70 69 20 6c  61 73 65 72 2e 0a 20 20  |300dpi laser..  |
000061a0  28 65 2e 67 2e 20 22 63  68 61 6e 67 65 66 73 69  |(e.g. "changefsi|
000061b0  20 69 6e 20 6f 75 74 20  31 38 63 20 33 30 30 3a  | in out 18c 300:|
000061c0  39 30 20 2d 73 68 61 72  70 65 6e 22 29 0a 0a 41  |90 -sharpen")..A|
000061d0  6e 64 20 6d 61 6e 79 20  6d 6f 72 65 20 75 73 65  |nd many more use|
000061e0  73 20 73 75 63 68 20 61  73 20 6d 61 6b 69 6e 67  |s such as making|
000061f0  20 6d 69 6e 69 61 74 75  72 65 73 20 6f 66 20 70  | miniatures of p|
00006200  69 63 74 75 72 65 73 2c  20 61 6e 69 6d 61 74 65  |ictures, animate|
00006210  64 20 73 65 71 75 65 6e  63 65 73 20 6f 66 0a 70  |d sequences of.p|
00006220  69 63 74 75 72 65 73 20  63 68 61 6e 67 69 6e 67  |ictures changing|
00006230  20 73 69 7a 65 20 28 6f  72 20 73 68 61 72 70 6e  | size (or sharpn|
00006240  65 73 73 21 29 2c 20 63  6f 6e 76 65 72 74 69 6e  |ess!), convertin|
00006250  67 20 41 72 74 69 73 61  6e 20 70 69 63 74 75 72  |g Artisan pictur|
00006260  65 73 20 74 6f 20 74 68  65 0a 64 65 73 6b 74 6f  |es to the.deskto|
00006270  70 20 28 74 72 79 20 6c  6f 6f 6b 69 6e 67 20 61  |p (try looking a|
00006280  74 20 74 68 65 20 41 72  74 69 73 61 6e 20 47 61  |t the Artisan Ga|
00006290  72 64 65 6e 20 77 69 74  68 20 74 68 65 20 64 65  |rden with the de|
000062a0  73 6b 74 6f 70 20 69 6e  20 32 35 36 20 63 6f 6c  |sktop in 256 col|
000062b0  6f 75 72 73 20 61 6e 64  0a 43 68 61 6e 67 65 46  |ours and.ChangeF|
000062c0  53 49 27 73 20 76 65 72  73 69 6f 6e 20 2d 20 74  |SI's version - t|
000062d0  68 65 20 73 74 72 69 70  65 73 20 6f 6e 20 74 68  |he stripes on th|
000062e0  65 20 6c 61 77 6e 20 76  61 6e 69 73 68 20 77 69  |e lawn vanish wi|
000062f0  74 68 20 74 68 65 20 73  74 61 6e 64 61 72 64 0a  |th the standard.|
00006300  76 65 72 73 69 6f 6e 29  2e 20 4f 62 76 69 6f 75  |version). Obviou|
00006310  73 6c 79 20 79 6f 75 20  77 69 6c 6c 20 6e 65 65  |sly you will nee|
00006320  64 20 74 6f 20 68 61 76  65 20 63 61 70 74 75 72  |d to have captur|
00006330  65 64 20 69 6e 70 75 74  20 61 73 20 61 20 73 70  |ed input as a sp|
00006340  72 69 74 65 20 66 69 72  73 74 21 0a 55 73 69 6e  |rite first!.Usin|
00006350  67 20 6d 6f 72 65 20 70  69 78 65 6c 73 20 70 65  |g more pixels pe|
00006360  72 20 69 6e 63 68 20 63  61 6e 20 69 6d 70 72 6f  |r inch can impro|
00006370  76 65 20 74 68 65 20 71  75 61 6c 69 74 79 20 6f  |ve the quality o|
00006380  66 20 74 68 65 20 72 65  73 75 6c 74 2c 20 70 61  |f the result, pa|
00006390  72 74 69 63 75 6c 61 72  6c 79 0a 63 6f 6e 76 65  |rticularly.conve|
000063a0  72 74 69 6e 67 20 74 6f  20 6d 75 6c 74 69 73 79  |rting to multisy|
000063b0  6e 63 20 6d 6f 64 65 73  2e 0a 0a 4e 6f 74 65 20  |nc modes...Note |
000063c0  74 68 61 74 2c 20 66 6f  72 20 61 6c 6c 20 77 6f  |that, for all wo|
000063d0  72 6b 20 77 69 74 68 20  43 68 61 6e 67 65 46 53  |rk with ChangeFS|
000063e0  49 2c 20 69 74 20 69 73  20 61 20 67 6f 6f 64 20  |I, it is a good |
000063f0  69 64 65 61 20 74 6f 20  73 74 61 72 74 20 66 72  |idea to start fr|
00006400  6f 6d 20 74 68 65 0a 75  6e 70 72 6f 63 65 73 73  |om the.unprocess|
00006410  65 64 20 69 6e 70 75 74  20 65 61 63 68 20 74 69  |ed input each ti|
00006420  6d 65 20 61 6e 64 20 64  6f 20 65 76 65 72 79 74  |me and do everyt|
00006430  68 69 6e 67 20 69 6e 20  6f 6e 65 20 70 61 73 73  |hing in one pass|
00006440  20 28 72 61 74 68 65 72  20 74 68 61 6e 20 75 73  | (rather than us|
00006450  69 6e 67 0a 74 68 65 20  70 72 6f 67 72 61 6d 20  |ing.the program |
00006460  73 65 76 65 72 61 6c 20  74 69 6d 65 73 20 77 69  |several times wi|
00006470  74 68 20 73 69 6d 70 6c  65 20 61 72 67 75 6d 65  |th simple argume|
00006480  6e 74 73 29 2e 20 49 74  20 69 73 20 6e 6f 74 20  |nts). It is not |
00006490  61 20 67 6f 6f 64 20 69  64 65 61 20 74 6f 0a 73  |a good idea to.s|
000064a0  68 61 72 70 65 6e 20 61  20 64 69 74 68 65 72 65  |harpen a dithere|
000064b0  64 20 69 6d 61 67 65 20  28 75 6e 6c 65 73 73 20  |d image (unless |
000064c0  69 74 20 68 61 73 20 62  65 65 6e 20 73 68 72 75  |it has been shru|
000064d0  6e 6b 29 2e 20 49 74 20  63 61 6e 20 62 65 20 76  |nk). It can be v|
000064e0  65 72 79 20 75 73 65 66  75 6c 0a 74 6f 20 75 73  |ery useful.to us|
000064f0  65 20 61 20 73 6d 61 6c  6c 20 61 6d 6f 75 6e 74  |e a small amount|
00006500  20 6f 66 20 73 6d 6f 6f  74 68 69 6e 67 20 6f 6e  | of smoothing on|
00006510  20 61 20 64 69 74 68 65  72 65 64 20 69 6d 61 67  | a dithered imag|
00006520  65 20 28 65 2e 67 2e 20  2d 73 6d 6f 6f 74 68 31  |e (e.g. -smooth1|
00006530  36 29 2e 0a 0a 2a 2a 2a  20 49 74 20 69 73 20 61  |6)...*** It is a|
00006540  20 76 65 72 79 20 67 6f  6f 64 20 69 64 65 61 20  | very good idea |
00006550  74 6f 20 6b 65 65 70 20  74 68 65 20 68 69 67 68  |to keep the high|
00006560  65 73 74 20 72 65 73 6f  6c 75 74 69 6f 6e 20 6d  |est resolution m|
00006570  61 73 74 65 72 20 74 68  61 74 20 79 6f 75 20 63  |aster that you c|
00006580  61 6e 0a 61 66 66 6f 72  64 20 74 68 65 20 64 69  |an.afford the di|
00006590  73 63 20 73 70 61 63 65  20 66 6f 72 2e 2e 2e 2e  |sc space for....|
000065a0  0a 0a 54 68 65 20 43 68  61 6e 67 65 46 53 49 20  |..The ChangeFSI |
000065b0  70 72 6f 67 72 61 6d 20  63 61 6e 20 61 6c 73 6f  |program can also|
000065c0  20 63 6f 6e 76 65 72 74  20 66 72 6f 6d 20 6e 6f  | convert from no|
000065d0  6e 20 52 49 53 43 20 4f  53 20 73 70 72 69 74 65  |n RISC OS sprite|
000065e0  20 66 6f 72 6d 61 74 73  20 77 68 69 6c 65 0a 64  | formats while.d|
000065f0  6f 69 6e 67 20 61 6c 6c  20 6f 66 20 74 68 65 20  |oing all of the |
00006600  61 62 6f 76 65 20 70 72  6f 63 65 73 73 69 6e 67  |above processing|
00006610  2e 20 43 68 61 6e 67 65  46 53 49 20 77 69 6c 6c  |. ChangeFSI will|
00006620  20 77 6f 72 6b 20 6f 75  74 20 77 68 61 74 20 74  | work out what t|
00006630  68 65 20 66 6f 72 6d 61  74 20 69 73 0a 61 75 74  |he format is.aut|
00006640  6f 6d 61 74 69 63 61 6c  6c 79 2e 20 46 6f 72 20  |omatically. For |
00006650  6e 61 74 69 76 65 20 52  49 53 43 20 4f 53 20 66  |native RISC OS f|
00006660  6f 72 6d 61 74 73 2c 20  69 74 20 75 73 65 73 20  |ormats, it uses |
00006670  74 68 65 20 66 69 6c 65  74 79 70 65 20 61 6e 64  |the filetype and|
00006680  20 74 68 65 72 65 20 63  61 6e 0a 62 65 20 6e 6f  | there can.be no|
00006690  20 63 6f 6e 66 75 73 69  6f 6e 2e 20 46 6f 72 20  | confusion. For |
000066a0  61 6c 69 65 6e 20 66 6f  72 6d 61 74 73 2c 20 69  |alien formats, i|
000066b0  74 20 66 69 72 73 74 20  74 72 69 65 73 20 6c 6f  |t first tries lo|
000066c0  6f 6b 69 6e 67 20 66 6f  72 20 70 61 72 74 69 63  |oking for partic|
000066d0  75 6c 61 72 0a 69 64 65  6e 74 69 66 79 69 6e 67  |ular.identifying|
000066e0  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 69 6e 73  | information ins|
000066f0  69 64 65 20 74 68 65 20  66 69 6c 65 20 61 6e 64  |ide the file and|
00006700  20 74 68 65 6e 20 28 69  66 20 74 68 69 73 20 66  | then (if this f|
00006710  61 69 6c 73 20 74 6f 20  68 61 76 65 0a 69 64 65  |ails to have.ide|
00006720  6e 74 69 66 69 65 64 20  61 20 66 6f 72 6d 61 74  |ntified a format|
00006730  29 20 74 72 69 65 73 20  75 73 69 6e 67 20 74 68  |) tries using th|
00006740  65 20 66 69 6c 65 20 6e  61 6d 65 20 69 74 73 65  |e file name itse|
00006750  6c 66 2e 20 53 65 65 20  74 68 65 20 64 65 74 61  |lf. See the deta|
00006760  69 6c 73 20 62 65 6c 6f  77 3a 0a 0a 54 68 65 20  |ils below:..The |
00006770  52 49 53 43 20 4f 53 20  73 70 72 69 74 65 20 66  |RISC OS sprite f|
00006780  6f 72 6d 61 74 0a 20 43  6f 6e 74 61 69 6e 73 20  |ormat. Contains |
00006790  31 2c 20 32 2c 20 34 20  6f 72 20 38 20 62 69 74  |1, 2, 4 or 8 bit|
000067a0  73 20 70 65 72 20 70 69  78 65 6c 20 77 69 74 68  |s per pixel with|
000067b0  20 61 20 6d 6f 64 69 66  69 63 61 74 69 6f 6e 20  | a modification |
000067c0  70 61 6c 65 74 74 65 20  6f 66 20 75 70 20 74 6f  |palette of up to|
000067d0  0a 20 31 36 20 65 6e 74  72 69 65 73 3b 20 61 6e  |. 16 entries; an|
000067e0  79 20 6e 75 6d 62 65 72  20 6f 66 20 70 69 78 65  |y number of pixe|
000067f0  6c 73 20 77 69 64 65 20  61 6e 64 20 68 69 67 68  |ls wide and high|
00006800  20 75 6e 63 6f 6d 70 72  65 73 73 65 64 2e 20 44  | uncompressed. D|
00006810  65 74 61 69 6c 73 20 61  72 65 20 69 6e 0a 20 41  |etails are in. A|
00006820  63 6f 72 6e 27 73 20 50  72 6f 67 72 61 6d 6d 65  |corn's Programme|
00006830  72 27 73 20 52 65 66 65  72 65 6e 63 65 20 4d 61  |r's Reference Ma|
00006840  6e 75 61 6c 2e 0a 20 2b  20 52 65 63 6f 67 6e 69  |nual.. + Recogni|
00006850  73 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |sed by file type|
00006860  20 46 46 39 20 28 61 20  70 61 69 6e 74 20 62 72  | FF9 (a paint br|
00006870  75 73 68 20 61 6e 64 20  68 6f 75 73 65 20 69 63  |ush and house ic|
00006880  6f 6e 29 0a 20 2d 20 44  65 74 61 69 6c 73 20 6f  |on). - Details o|
00006890  66 20 68 6f 77 20 6d 61  6e 79 20 62 69 74 73 20  |f how many bits |
000068a0  70 65 72 20 70 69 78 65  6c 20 61 6e 64 20 74 68  |per pixel and th|
000068b0  65 20 70 69 78 65 6c 20  73 69 7a 65 20 61 72 65  |e pixel size are|
000068c0  20 6f 62 74 61 69 6e 65  64 20 66 72 6f 6d 0a 20  | obtained from. |
000068d0  20 20 74 68 65 20 6f 70  65 72 61 74 69 6e 67 20  |  the operating |
000068e0  73 79 73 74 65 6d 20 28  72 61 74 68 65 72 20 74  |system (rather t|
000068f0  68 61 6e 20 62 65 69 6e  67 20 69 6e 20 74 68 65  |han being in the|
00006900  20 66 69 6c 65 29 20 66  72 6f 6d 20 74 68 65 20  | file) from the |
00006910  22 4d 4f 44 45 22 0a 20  20 20 6e 75 6d 62 65 72  |"MODE".   number|
00006920  2e 20 4d 6f 64 65 20 65  78 74 65 6e 73 69 6f 6e  |. Mode extension|
00006930  73 20 63 61 6e 20 72 65  73 75 6c 74 20 69 6e 20  |s can result in |
00006940  61 20 73 6f 75 72 63 65  20 69 6d 61 67 65 20 63  |a source image c|
00006950  6f 6e 74 61 69 6e 69 6e  67 20 61 20 4d 4f 44 45  |ontaining a MODE|
00006960  0a 20 20 20 6e 75 6d 62  65 72 20 77 68 69 63 68  |.   number which|
00006970  20 79 6f 75 72 20 63 6f  6d 70 75 74 65 72 20 64  | your computer d|
00006980  6f 65 73 20 6e 6f 74 20  75 6e 64 65 72 73 74 61  |oes not understa|
00006990  6e 64 2e 0a 20 2d 20 4d  61 73 6b 20 69 6e 66 6f  |nd.. - Mask info|
000069a0  72 6d 61 74 69 6f 6e 20  69 67 6e 6f 72 65 64 0a  |rmation ignored.|
000069b0  20 2d 20 4c 65 66 74 68  61 6e 64 20 77 61 73 74  | - Lefthand wast|
000069c0  61 67 65 20 69 67 6e 6f  72 65 64 0a 0a 54 68 65  |age ignored..The|
000069d0  20 6e 65 77 20 52 49 53  43 20 4f 53 20 73 70 72  | new RISC OS spr|
000069e0  69 74 65 20 66 6f 72 6d  61 74 0a 20 43 6f 6e 74  |ite format. Cont|
000069f0  61 69 6e 73 20 31 2c 20  32 2c 20 34 2c 20 38 2c  |ains 1, 2, 4, 8,|
00006a00  20 31 36 20 6f 72 20 33  32 20 62 69 74 73 20 70  | 16 or 32 bits p|
00006a10  65 72 20 70 69 78 65 6c  2e 0a 20 2b 20 52 65 63  |er pixel.. + Rec|
00006a20  6f 67 6e 69 73 65 64 20  62 79 20 66 69 6c 65 20  |ognised by file |
00006a30  74 79 70 65 20 46 46 39  0a 20 2b 20 6e 6f 20 70  |type FF9. + no p|
00006a40  72 6f 62 6c 65 6d 20 77  69 74 68 20 6d 6f 64 65  |roblem with mode|
00006a50  20 65 78 74 65 6e 73 69  6f 6e 73 3a 20 69 6e 66  | extensions: inf|
00006a60  6f 72 6d 61 74 69 6f 6e  20 69 73 20 63 6f 64 65  |ormation is code|
00006a70  64 20 69 6e 74 6f 20 74  68 65 20 66 6f 72 6d 61  |d into the forma|
00006a80  74 0a 20 2d 20 4d 61 73  6b 20 69 6e 66 6f 72 6d  |t. - Mask inform|
00006a90  61 74 69 6f 6e 20 69 67  6e 6f 72 65 64 0a 0a 4b  |ation ignored..K|
00006aa0  6f 64 61 6b 20 50 68 6f  74 6f 43 44 0a 20 32 34  |odak PhotoCD. 24|
00006ab0  20 62 69 74 20 70 65 72  20 70 69 78 65 6c 20 69  | bit per pixel i|
00006ac0  6d 61 67 65 73 20 61 74  20 76 61 72 69 6f 75 73  |mages at various|
00006ad0  20 72 65 73 6f 6c 75 74  69 6f 6e 73 0a 20 2b 20  | resolutions. + |
00006ae0  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 66 69  |Recognised by fi|
00006af0  6c 65 20 74 79 70 65 20  42 45 38 0a 20 2d 20 53  |le type BE8. - S|
00006b00  65 74 20 43 68 61 6e 67  65 46 53 49 24 50 43 44  |et ChangeFSI$PCD|
00006b10  49 6e 64 65 78 20 74 6f  20 72 65 61 64 20 72 65  |Index to read re|
00006b20  73 6f 6c 75 74 69 6f 6e  73 20 6f 74 68 65 72 20  |solutions other |
00006b30  74 68 61 6e 20 62 61 73  65 20 28 3d 33 29 0a 0a  |than base (=3)..|
00006b40  54 68 65 20 41 72 56 69  73 20 66 6f 72 6d 61 74  |The ArVis format|
00006b50  20 5b 6f 66 20 41 72 56  69 73 20 4d 75 6c 74 69  | [of ArVis Multi|
00006b60  6d 65 64 69 61 5d 0a 20  43 6f 6e 74 61 69 6e 73  |media]. Contains|
00006b70  20 35 20 62 69 74 73 20  6f 66 20 72 65 64 2c 20  | 5 bits of red, |
00006b80  67 72 65 65 6e 20 61 6e  64 20 62 6c 75 65 20 69  |green and blue i|
00006b90  6e 66 6f 72 6d 61 74 69  6f 6e 20 65 6e 63 6f 64  |nformation encod|
00006ba0  65 64 20 69 6e 74 6f 20  74 77 6f 20 52 49 53 43  |ed into two RISC|
00006bb0  20 4f 53 0a 20 73 70 72  69 74 65 73 20 22 48 49  | OS. sprites "HI|
00006bc0  50 2e 3c 66 69 6c 65 6e  61 6d 65 3e 22 20 61 6e  |P.<filename>" an|
00006bd0  64 20 22 4c 4f 50 2e 3c  66 69 6c 65 6e 61 6d 65  |d "LOP.<filename|
00006be0  3e 22 20 63 6f 6d 70 72  69 73 69 6e 67 20 61 20  |>" comprising a |
00006bf0  36 34 30 20 70 69 78 65  6c 20 77 69 64 65 0a 20  |640 pixel wide. |
00006c00  61 6e 64 20 32 35 36 20  6c 69 6e 65 20 74 61 6c  |and 256 line tal|
00006c10  6c 20 69 6d 61 67 65 20  77 69 74 68 20 70 69 78  |l image with pix|
00006c20  65 6c 73 20 73 69 7a 65  64 20 31 3a 32 2e 20 44  |els sized 1:2. D|
00006c30  65 74 61 69 6c 73 20 66  72 6f 6d 20 41 72 56 69  |etails from ArVi|
00006c40  73 20 4d 75 6c 74 69 6d  65 64 69 61 0a 20 2d 20  |s Multimedia. - |
00006c50  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 70 72  |Recognised by pr|
00006c60  6f 76 69 64 69 6e 67 20  74 68 65 20 48 49 50 2e  |oviding the HIP.|
00006c70  3c 66 69 6c 65 6e 61 6d  65 3e 20 28 77 68 69 63  |<filename> (whic|
00006c80  68 20 6d 75 73 74 20 62  65 20 6f 66 20 66 69 6c  |h must be of fil|
00006c90  65 20 74 79 70 65 20 46  46 39 29 0a 20 2d 20 55  |e type FF9). - U|
00006ca0  6e 63 6f 6d 70 72 65 73  73 65 64 20 28 69 6e 64  |ncompressed (ind|
00006cb0  65 65 64 20 72 65 70 72  65 73 65 6e 74 73 20 31  |eed represents 1|
00006cc0  36 20 62 69 74 73 20 69  6e 73 74 65 61 64 20 6f  |6 bits instead o|
00006cd0  66 20 31 35 29 2e 0a 0a  54 68 65 20 50 69 6e 65  |f 15)...The Pine|
00006ce0  61 70 70 6c 65 20 63 6f  6c 6f 75 72 20 64 69 67  |apple colour dig|
00006cf0  69 74 69 73 65 72 20 66  6f 72 6d 61 74 20 28 6f  |itiser format (o|
00006d00  66 20 50 69 6e 65 61 70  70 6c 65 20 53 6f 66 74  |f Pineapple Soft|
00006d10  77 61 72 65 29 0a 20 43  6f 6e 74 61 69 6e 73 20  |ware). Contains |
00006d20  36 20 62 69 74 73 20 6f  66 20 67 72 65 65 6e 2c  |6 bits of green,|
00006d30  20 35 20 62 69 74 73 20  6f 66 20 72 65 64 20 61  | 5 bits of red a|
00006d40  6e 64 20 62 6c 75 65 20  69 6e 66 6f 72 6d 61 74  |nd blue informat|
00006d50  69 6f 6e 20 66 69 6c 65  64 20 61 73 20 61 0a 20  |ion filed as a. |
00006d60  73 69 6e 67 6c 65 20 64  61 74 61 20 66 69 6c 65  |single data file|
00006d70  20 73 74 61 72 74 69 6e  67 20 22 46 53 49 66 69  | starting "FSIfi|
00006d80  6c 65 22 20 63 6f 6d 70  72 69 73 69 6e 67 20 61  |le" comprising a|
00006d90  20 35 31 32 20 70 69 78  65 6c 20 77 69 64 65 20  | 512 pixel wide |
00006da0  61 6e 64 20 32 35 36 0a  20 6c 69 6e 65 20 74 61  |and 256. line ta|
00006db0  6c 6c 20 69 6d 61 67 65  20 77 69 74 68 20 70 69  |ll image with pi|
00006dc0  78 65 6c 73 20 73 69 7a  65 64 20 31 3a 32 2e 0a  |xels sized 1:2..|
00006dd0  20 2d 20 52 65 63 6f 67  6e 69 73 65 64 20 62 79  | - Recognised by|
00006de0  20 22 46 53 49 66 69 6c  65 22 20 69 6e 20 74 68  | "FSIfile" in th|
00006df0  65 20 66 69 6c 65 20 28  77 68 69 63 68 20 63 61  |e file (which ca|
00006e00  6e 20 62 65 20 61 6e 79  20 74 79 70 65 29 0a 20  |n be any type). |
00006e10  2d 20 55 6e 63 6f 6d 70  72 65 73 73 65 64 0a 0a  |- Uncompressed..|
00006e20  54 68 65 20 57 61 74 66  6f 72 64 20 56 69 64 65  |The Watford Vide|
00006e30  6f 20 44 69 67 69 74 69  73 65 72 20 22 70 69 63  |o Digitiser "pic|
00006e40  74 75 72 65 22 20 66 6f  72 6d 61 74 0a 20 43 6f  |ture" format. Co|
00006e50  6e 74 61 69 6e 73 20 61  20 72 75 6e 20 6c 65 6e  |ntains a run len|
00006e60  67 74 68 20 65 6e 63 6f  64 65 64 20 36 34 20 67  |gth encoded 64 g|
00006e70  72 65 79 20 6c 65 76 65  6c 20 35 31 32 20 70 69  |rey level 512 pi|
00006e80  78 65 6c 20 77 69 64 65  2c 20 32 35 36 20 6c 69  |xel wide, 256 li|
00006e90  6e 65 20 69 6d 61 67 65  2c 0a 20 77 69 74 68 20  |ne image,. with |
00006ea0  70 69 78 65 6c 73 20 73  69 7a 65 64 20 31 3a 32  |pixels sized 1:2|
00006eb0  2e 20 44 65 74 61 69 6c  73 20 66 72 6f 6d 20 57  |. Details from W|
00006ec0  61 74 66 6f 72 64 20 45  6c 65 63 74 72 6f 6e 69  |atford Electroni|
00006ed0  63 73 20 4c 74 64 2e 0a  20 2b 20 52 65 63 6f 67  |cs Ltd.. + Recog|
00006ee0  6e 69 73 65 64 20 62 79  20 66 69 6c 65 20 74 79  |nised by file ty|
00006ef0  70 65 20 44 46 41 20 28  61 20 73 6d 61 6c 6c 20  |pe DFA (a small |
00006f00  67 72 65 79 20 70 69 63  74 75 72 65 20 6f 66 20  |grey picture of |
00006f10  53 74 65 76 69 65 20 4e  69 63 6b 73 29 0a 20 2d  |Stevie Nicks). -|
00006f20  20 57 61 72 6e 69 6e 67  3a 20 64 6f 6e 27 74 20  | Warning: don't |
00006f30  66 6f 72 67 65 74 20 74  6f 20 73 61 76 65 20 74  |forget to save t|
00006f40  68 65 20 70 69 63 74 75  72 65 73 20 69 6e 20 2a  |he pictures in *|
00006f50  75 6e 2d 64 69 74 68 65  72 65 64 2a 20 73 74 61  |un-dithered* sta|
00006f60  74 65 21 0a 20 57 68 65  6e 20 75 73 65 64 20 77  |te!. When used w|
00006f70  69 74 68 20 61 20 63 6f  6c 6f 75 72 20 63 6f 6e  |ith a colour con|
00006f80  76 65 72 74 65 72 2c 20  43 68 61 6e 67 65 46 53  |verter, ChangeFS|
00006f90  49 20 63 61 6e 20 72 65  61 64 20 74 68 72 65 65  |I can read three|
00006fa0  20 63 6f 6c 6f 75 72 0a  20 73 65 70 61 72 61 74  | colour. separat|
00006fb0  69 6f 6e 73 20 73 74 6f  72 65 64 20 69 6e 20 61  |ions stored in a|
00006fc0  20 64 69 72 65 63 74 6f  72 79 20 6f 66 20 73 65  | directory of se|
00006fd0  70 61 72 61 74 65 20 22  72 65 64 22 2c 20 22 67  |parate "red", "g|
00006fe0  72 65 65 6e 22 20 61 6e  64 20 22 62 6c 75 65 22  |reen" and "blue"|
00006ff0  0a 20 66 69 6c 65 73 2e  20 42 65 77 61 72 65 20  |. files. Beware |
00007000  6f 66 20 61 75 74 6f 2d  67 61 69 6e 2f 63 6f 6e  |of auto-gain/con|
00007010  74 72 61 73 74 20 77 68  65 6e 20 75 73 69 6e 67  |trast when using|
00007020  20 73 75 63 68 20 69 6e  66 6f 72 6d 61 74 69 6f  | such informatio|
00007030  6e 21 0a 0a 54 68 65 20  50 72 6f 41 72 74 69 73  |n!..The ProArtis|
00007040  61 6e 20 63 6f 6d 70 72  65 73 73 65 64 20 70 69  |an compressed pi|
00007050  63 74 75 72 65 20 66 69  6c 65 20 66 6f 72 6d 61  |cture file forma|
00007060  74 0a 20 43 6f 6e 74 61  69 6e 73 20 61 20 28 6d  |t. Contains a (m|
00007070  69 6c 64 6c 79 29 20 63  6f 6d 70 72 65 73 73 65  |ildly) compresse|
00007080  64 20 4d 4f 44 45 20 31  35 20 28 36 34 30 20 62  |d MODE 15 (640 b|
00007090  79 20 32 35 36 20 62 79  20 32 35 36 20 63 6f 6c  |y 256 by 256 col|
000070a0  6f 75 72 73 29 20 70 69  63 74 75 72 65 2e 0a 20  |ours) picture.. |
000070b0  44 65 74 61 69 6c 73 20  66 72 6f 6d 20 43 6c 61  |Details from Cla|
000070c0  72 65 73 2e 0a 20 2b 20  52 65 63 6f 67 6e 69 73  |res.. + Recognis|
000070d0  65 64 20 62 79 20 66 69  6c 65 20 74 79 70 65 20  |ed by file type |
000070e0  44 45 32 20 28 61 20 62  65 69 67 65 20 6d 6f 6e  |DE2 (a beige mon|
000070f0  69 74 6f 72 20 69 6e 20  61 20 67 72 65 79 20 73  |itor in a grey s|
00007100  75 72 72 6f 75 6e 64 29  0a 0a 54 68 65 20 54 69  |urround)..The Ti|
00007110  6d 65 53 74 65 70 20 73  61 74 65 6c 6c 69 74 65  |meStep satellite|
00007120  20 69 6d 61 67 65 20 66  6f 72 6d 61 74 0a 20 54  | image format. T|
00007130  68 69 73 20 67 69 76 65  73 20 61 6e 20 75 6e 63  |his gives an unc|
00007140  6f 6d 70 72 65 73 73 65  64 20 38 30 30 20 62 79  |ompressed 800 by|
00007150  20 38 30 30 20 77 69 74  68 20 32 35 36 20 67 72  | 800 with 256 gr|
00007160  65 79 20 6c 65 76 65 6c  73 2e 0a 20 2b 20 52 65  |ey levels.. + Re|
00007170  63 6f 67 6e 69 73 65 64  20 62 79 20 66 69 6c 65  |cognised by file|
00007180  20 74 79 70 65 20 37 41  30 20 28 69 63 6f 6e 20  | type 7A0 (icon |
00007190  6e 65 76 65 72 20 73 65  65 6e 29 0a 20 2d 20 4e  |never seen). - N|
000071a0  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
000071b0  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
000071c0  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
000071d0  0a 20 2d 20 44 6f 63 75  6d 65 6e 74 61 74 69 6f  |. - Documentatio|
000071e0  6e 20 6e 65 76 65 72 20  73 65 65 6e 2e 20 41 6e  |n never seen. An|
000071f0  20 65 78 74 72 61 20 68  65 61 64 65 72 20 66 69  | extra header fi|
00007200  6c 65 20 3c 6e 61 6d 65  3e 21 20 69 73 20 6e 6f  |le <name>! is no|
00007210  74 20 75 6e 64 65 72 73  74 6f 6f 64 0a 20 20 20  |t understood.   |
00007220  61 74 20 61 6c 6c 2e 2e  2e 2e 2e 0a 0a 43 43 49  |at all.......CCI|
00007230  52 36 30 31 20 34 3a 32  3a 32 20 69 6d 61 67 65  |R601 4:2:2 image|
00007240  73 0a 20 43 6f 6e 74 61  69 6e 20 37 32 30 20 70  |s. Contain 720 p|
00007250  69 78 65 6c 73 20 62 79  20 32 38 38 20 72 6f 77  |ixels by 288 row|
00007260  73 20 28 50 41 4c 29 20  5b 32 34 33 20 72 6f 77  |s (PAL) [243 row|
00007270  73 20 4e 54 53 43 5d 20  59 55 56 20 63 6f 64 65  |s NTSC] YUV code|
00007280  64 20 77 69 74 68 0a 20  70 69 78 65 6c 73 20 73  |d with. pixels s|
00007290  69 7a 65 64 20 31 3a 32  2e 0a 20 2b 20 52 65 63  |ized 1:2.. + Rec|
000072a0  6f 67 6e 69 73 65 64 20  62 79 20 66 69 6c 65 20  |ognised by file |
000072b0  74 79 70 65 20 36 30 31  0a 20 2d 20 6f 6e 65 20  |type 601. - one |
000072c0  66 69 65 6c 64 20 6f 6e  6c 79 0a 0a 41 6e 6f 74  |field only..Anot|
000072d0  68 65 72 20 54 69 6d 65  53 74 65 70 20 73 61 74  |her TimeStep sat|
000072e0  65 6c 6c 69 74 65 20 69  6d 61 67 65 20 66 6f 72  |ellite image for|
000072f0  6d 61 74 0a 20 47 69 76  69 6e 67 20 61 6e 20 75  |mat. Giving an u|
00007300  6e 63 6f 6d 70 72 65 73  73 65 64 20 31 32 38 20  |ncompressed 128 |
00007310  70 69 78 65 6c 73 20 77  69 64 65 20 62 79 20 32  |pixels wide by 2|
00007320  35 36 20 6c 69 6e 65 73  20 77 69 74 68 20 32 35  |56 lines with 25|
00007330  36 20 67 72 65 79 20 6c  65 76 65 6c 73 2c 0a 20  |6 grey levels,. |
00007340  70 69 78 65 6c 73 20 73  69 7a 65 64 20 32 3a 31  |pixels sized 2:1|
00007350  2e 20 55 73 65 64 20 62  79 20 54 69 6d 65 53 74  |. Used by TimeSt|
00007360  65 70 27 73 20 21 49 6d  50 72 6f 63 65 73 73 20  |ep's !ImProcess |
00007370  61 70 70 6c 69 63 61 74  69 6f 6e 2e 0a 20 2b 20  |application.. + |
00007380  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 66 69  |Recognised by fi|
00007390  6c 65 20 74 79 70 65 20  33 30 30 20 28 22 69 22  |le type 300 ("i"|
000073a0  20 69 6e 20 61 20 64 6f  63 75 6d 65 6e 74 20 66  | in a document f|
000073b0  72 61 6d 65 29 0a 20 2d  20 44 6f 63 75 6d 65 6e  |rame). - Documen|
000073c0  74 61 74 69 6f 6e 20 6e  65 76 65 72 20 73 65 65  |tation never see|
000073d0  6e 2e 0a 20 2d 20 41 20  62 69 74 20 63 6f 61 72  |n.. - A bit coar|
000073e0  73 65 0a 20 54 68 65 20  67 72 65 79 20 6c 65 76  |se. The grey lev|
000073f0  65 6c 73 20 72 65 70 72  65 73 65 6e 74 20 69 6e  |els represent in|
00007400  74 65 6e 73 69 74 79 20  69 6e 20 76 61 72 69 6f  |tensity in vario|
00007410  75 73 20 64 69 66 66 65  72 65 6e 74 20 77 61 76  |us different wav|
00007420  65 20 62 61 6e 64 73 2e  20 42 79 0a 20 6e 61 6d  |e bands. By. nam|
00007430  69 6e 67 20 66 69 6c 65  73 20 22 72 65 64 22 2c  |ing files "red",|
00007440  20 22 67 72 65 65 6e 22  20 61 6e 64 20 22 62 6c  | "green" and "bl|
00007450  75 65 22 20 61 6e 64 20  68 61 6e 64 69 6e 67 20  |ue" and handing |
00007460  43 68 61 6e 67 65 46 53  49 20 74 68 65 20 64 69  |ChangeFSI the di|
00007470  72 65 63 74 6f 72 79 2c  0a 20 79 6f 75 20 63 61  |rectory,. you ca|
00007480  6e 20 70 72 6f 64 75 63  65 20 61 20 66 61 6c 73  |n produce a fals|
00007490  65 20 63 6f 6c 6f 75 72  20 69 6d 61 67 65 2e 20  |e colour image. |
000074a0  48 6f 75 72 73 20 6f 66  20 65 78 70 65 72 69 6d  |Hours of experim|
000074b0  65 6e 74 61 74 69 6f 6e  20 63 61 6e 20 70 72 6f  |entation can pro|
000074c0  64 75 63 65 0a 20 61 6e  20 61 6c 6d 6f 73 74 20  |duce. an almost |
000074d0  72 65 61 73 6f 6e 61 62  6c 65 20 70 69 63 74 75  |reasonable pictu|
000074e0  72 65 2e 2e 2e 0a 0a 54  68 65 20 41 49 4d 20 61  |re.....The AIM a|
000074f0  6e 64 20 57 69 6c 64 20  56 69 73 69 6f 6e 20 56  |nd Wild Vision V|
00007500  31 30 20 66 6f 72 6d 61  74 0a 20 54 68 69 73 20  |10 format. This |
00007510  70 72 6f 76 69 64 65 73  20 61 6e 20 75 6e 63 6f  |provides an unco|
00007520  6d 70 72 65 73 73 65 64  20 32 35 36 20 62 79 20  |mpressed 256 by |
00007530  32 35 36 20 69 6d 61 67  65 20 77 69 74 68 20 32  |256 image with 2|
00007540  35 36 20 67 72 65 79 20  6c 65 76 65 6c 73 2e 20  |56 grey levels. |
00007550  44 65 74 61 69 6c 73 0a  20 66 72 6f 6d 20 44 65  |Details. from De|
00007560  6c 66 74 20 55 6e 69 76  65 72 73 69 74 79 20 6f  |lft University o|
00007570  66 20 54 65 63 68 6e 6f  6c 6f 67 79 20 61 6e 64  |f Technology and|
00007580  20 45 43 44 20 43 6f 6d  70 75 74 65 72 73 20 44  | ECD Computers D|
00007590  65 6c 66 74 20 42 2e 56  2e 0a 20 2b 20 52 65 63  |elft B.V.. + Rec|
000075a0  6f 67 6e 69 73 65 64 20  62 79 20 66 69 6c 65 20  |ognised by file |
000075b0  74 79 70 65 20 30 30 34  20 28 61 20 70 69 63 74  |type 004 (a pict|
000075c0  75 72 65 20 6f 66 20 27  54 72 75 69 27 20 77 69  |ure of 'Trui' wi|
000075d0  74 68 20 22 54 55 22 20  69 6e 20 62 6c 75 65 29  |th "TU" in blue)|
000075e0  0a 20 2b 20 43 68 61 6e  67 65 46 53 49 20 63 61  |. + ChangeFSI ca|
000075f0  6e 20 77 72 69 74 65 20  74 6f 20 74 68 69 73 20  |n write to this |
00007600  66 6f 72 6d 61 74 20 28  73 70 65 63 69 66 79 20  |format (specify |
00007610  22 61 69 6d 22 20 69 6e  20 74 68 65 20 6d 6f 64  |"aim" in the mod|
00007620  65 20 70 6f 73 69 74 69  6f 6e 29 0a 20 20 20 61  |e position).   a|
00007630  6e 64 20 73 70 65 63 69  66 79 20 3d 20 69 6e 20  |nd specify = in |
00007640  74 68 65 20 73 69 7a 69  6e 67 20 74 6f 20 67 65  |the sizing to ge|
00007650  74 20 61 20 32 35 36 20  62 79 20 32 35 36 20 6f  |t a 256 by 256 o|
00007660  75 74 70 75 74 20 28 6f  74 68 65 72 77 69 73 65  |utput (otherwise|
00007670  20 69 74 20 77 69 6c 6c  0a 20 20 20 62 65 20 74  | it will.   be t|
00007680  68 65 20 73 61 6d 65 20  73 69 7a 65 20 61 73 20  |he same size as |
00007690  74 68 65 20 73 6f 75 72  63 65 20 69 6d 61 67 65  |the source image|
000076a0  29 0a 20 2d 20 4e 6f 20  72 65 73 6f 6c 75 74 69  |). - No resoluti|
000076b0  6f 6e 20 73 70 65 63 69  66 69 65 64 2c 20 65 71  |on specified, eq|
000076c0  75 61 6c 20 74 6f 20 6d  6f 64 65 20 32 37 20 61  |ual to mode 27 a|
000076d0  73 73 75 6d 65 64 0a 20  2d 20 54 68 65 20 61 73  |ssumed. - The as|
000076e0  73 6f 63 69 61 74 65 64  20 66 69 6c 65 20 3c 6e  |sociated file <n|
000076f0  61 6d 65 3e 2b 20 28 66  69 6c 65 20 74 79 70 65  |ame>+ (file type|
00007700  20 30 31 30 29 20 77 68  69 63 68 20 63 6f 6e 74  | 010) which cont|
00007710  61 69 6e 73 20 61 64 64  69 74 69 6f 6e 61 6c 0a  |ains additional.|
00007720  20 20 20 69 6e 66 6f 72  6d 61 74 69 6f 6e 20 69  |   information i|
00007730  73 20 69 67 6e 6f 72 65  64 20 62 79 20 43 68 61  |s ignored by Cha|
00007740  6e 67 65 46 53 49 2e 0a  20 54 68 65 20 67 72 65  |ngeFSI.. The gre|
00007750  79 20 6c 65 76 65 6c 73  20 6d 61 79 20 72 65 70  |y levels may rep|
00007760  72 65 73 65 6e 74 20 69  6e 74 65 6e 73 69 74 79  |resent intensity|
00007770  20 69 6e 20 76 61 72 69  6f 75 73 20 64 69 66 66  | in various diff|
00007780  65 72 65 6e 74 20 77 61  76 65 20 62 61 6e 64 73  |erent wave bands|
00007790  2e 20 42 79 0a 20 6e 61  6d 69 6e 67 20 66 69 6c  |. By. naming fil|
000077a0  65 73 20 22 72 65 64 22  2c 20 22 67 72 65 65 6e  |es "red", "green|
000077b0  22 20 61 6e 64 20 22 62  6c 75 65 22 20 61 6e 64  |" and "blue" and|
000077c0  20 68 61 6e 64 69 6e 67  20 43 68 61 6e 67 65 46  | handing ChangeF|
000077d0  53 49 20 74 68 65 20 64  69 72 65 63 74 6f 72 79  |SI the directory|
000077e0  2c 0a 20 79 6f 75 20 63  61 6e 20 70 72 6f 64 75  |,. you can produ|
000077f0  63 65 20 61 20 66 61 6c  73 65 20 63 6f 6c 6f 75  |ce a false colou|
00007800  72 20 69 6d 61 67 65 2e  20 48 6f 75 72 73 20 6f  |r image. Hours o|
00007810  66 20 65 78 70 65 72 69  6d 65 6e 74 61 74 69 6f  |f experimentatio|
00007820  6e 20 63 61 6e 20 70 72  6f 64 75 63 65 0a 20 61  |n can produce. a|
00007830  6e 20 61 6c 6d 6f 73 74  20 72 65 61 73 6f 6e 61  |n almost reasona|
00007840  62 6c 65 20 70 69 63 74  75 72 65 2e 2e 2e 0a 0a  |ble picture.....|
00007850  54 68 65 20 57 69 6c 64  20 56 69 73 69 6f 6e 20  |The Wild Vision |
00007860  56 31 32 20 66 6f 72 6d  61 74 0a 20 54 68 69 73  |V12 format. This|
00007870  20 70 72 6f 76 69 64 65  73 20 61 6e 20 75 6e 63  | provides an unc|
00007880  6f 6d 70 72 65 73 73 65  64 20 35 31 32 20 62 79  |ompressed 512 by|
00007890  20 35 31 32 20 69 6d 61  67 65 20 77 69 74 68 20  | 512 image with |
000078a0  32 35 36 20 67 72 65 79  20 6c 65 76 65 6c 73 2e  |256 grey levels.|
000078b0  0a 20 2b 20 52 65 63 6f  67 6e 69 73 65 64 20 62  |. + Recognised b|
000078c0  79 20 66 69 6c 65 20 74  79 70 65 20 30 30 36 0a  |y file type 006.|
000078d0  20 2d 20 4e 6f 20 72 65  73 6f 6c 75 74 69 6f 6e  | - No resolution|
000078e0  20 73 70 65 63 69 66 69  65 64 2c 20 65 71 75 61  | specified, equa|
000078f0  6c 20 74 6f 20 6d 6f 64  65 20 32 37 20 61 73 73  |l to mode 27 ass|
00007900  75 6d 65 64 0a 0a 54 68  65 20 57 69 6c 64 20 56  |umed..The Wild V|
00007910  69 73 69 6f 6e 20 56 39  20 61 6e 64 20 53 6e 61  |ision V9 and Sna|
00007920  70 53 68 6f 74 20 66 6f  72 6d 61 74 73 0a 20 54  |pShot formats. T|
00007930  68 69 73 20 70 72 6f 76  69 64 65 73 20 61 6e 20  |his provides an |
00007940  75 6e 63 6f 6d 70 72 65  73 73 65 64 20 35 31 32  |uncompressed 512|
00007950  20 62 79 20 32 35 36 20  69 6d 61 67 65 20 77 69  | by 256 image wi|
00007960  74 68 20 34 20 62 69 74  73 20 6f 66 20 72 65 64  |th 4 bits of red|
00007970  2c 20 67 72 65 65 6e 0a  20 61 6e 64 20 62 6c 75  |, green. and blu|
00007980  65 2c 20 70 69 78 65 6c  73 20 73 69 7a 65 64 20  |e, pixels sized |
00007990  31 3a 32 2e 0a 20 2b 20  52 65 63 6f 67 6e 69 73  |1:2.. + Recognis|
000079a0  65 64 20 62 79 20 22 4d  65 72 63 53 6f 66 74 22  |ed by "MercSoft"|
000079b0  20 6f 72 20 22 53 6e 61  70 53 68 6f 74 22 20 68  | or "SnapShot" h|
000079c0  65 61 64 65 72 0a 20 2b  20 4e 6f 20 66 69 6c 65  |eader. + No file|
000079d0  20 74 79 70 65 20 6e 65  65 64 65 64 0a 0a 54 68  | type needed..Th|
000079e0  65 20 21 54 72 61 6e 73  6c 61 74 6f 72 20 43 6c  |e !Translator Cl|
000079f0  65 61 72 20 66 6f 72 6d  61 74 0a 20 54 68 69 73  |ear format. This|
00007a00  20 70 72 6f 76 69 64 65  73 20 31 2c 20 32 2c 20  | provides 1, 2, |
00007a10  34 2c 20 38 20 61 6e 64  20 32 34 20 62 69 74 73  |4, 8 and 24 bits|
00007a20  20 70 65 72 20 70 69 78  65 6c 2e 0a 20 2b 20 52  | per pixel.. + R|
00007a30  65 63 6f 67 6e 69 73 65  64 20 62 79 20 66 69 6c  |ecognised by fil|
00007a40  65 20 74 79 70 65 20 36  39 30 0a 20 2d 20 75 6e  |e type 690. - un|
00007a50  63 6f 6d 70 72 65 73 73  65 64 2c 20 65 73 70 65  |compressed, espe|
00007a60  63 69 61 6c 6c 79 20 66  6f 72 20 3c 38 20 62 69  |cially for <8 bi|
00007a70  74 73 20 70 65 72 20 70  69 78 65 6c 20 77 68 69  |ts per pixel whi|
00007a80  63 68 20 69 73 20 72 65  63 6f 72 64 65 64 20 61  |ch is recorded a|
00007a90  74 20 6f 6e 65 0a 20 20  20 62 79 74 65 20 70 65  |t one.   byte pe|
00007aa0  72 20 70 69 78 65 6c 2e  0a 20 2d 20 4e 6f 20 72  |r pixel.. - No r|
00007ab0  65 73 6f 6c 75 74 69 6f  6e 20 73 70 65 63 69 66  |esolution specif|
00007ac0  69 65 64 2c 20 65 71 75  61 6c 20 74 6f 20 6d 6f  |ied, equal to mo|
00007ad0  64 65 20 32 37 20 61 73  73 75 6d 65 64 0a 0a 54  |de 27 assumed..T|
00007ae0  68 65 20 41 74 61 72 69  20 53 54 20 22 44 65 67  |he Atari ST "Deg|
00007af0  61 73 22 20 66 6f 72 6d  61 74 0a 20 31 2c 20 32  |as" format. 1, 2|
00007b00  20 6f 72 20 34 20 62 69  74 73 20 70 65 72 20 70  | or 4 bits per p|
00007b10  69 78 65 6c 2c 20 63 6c  65 61 72 20 6f 72 20 72  |ixel, clear or r|
00007b20  75 6e 20 6c 65 6e 67 74  68 20 65 6e 63 6f 64 65  |un length encode|
00007b30  64 2e 20 52 49 53 43 20  4f 53 20 66 69 6c 65 20  |d. RISC OS file |
00007b40  74 79 70 65 20 62 79 0a  20 4a 6f 68 6e 20 4b 6f  |type by. John Ko|
00007b50  72 74 69 6e 6b 20 6f 66  20 21 54 72 61 6e 73 6c  |rtink of !Transl|
00007b60  61 74 6f 72 2e 0a 20 2b  20 52 65 63 6f 67 6e 69  |ator.. + Recogni|
00007b70  73 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |sed by file type|
00007b80  20 36 39 31 0a 20 2d 20  4e 6f 20 64 6f 63 75 6d  | 691. - No docum|
00007b90  65 6e 74 61 74 69 6f 6e  20 61 6e 64 20 6f 6e 6c  |entation and onl|
00007ba0  79 20 35 20 69 6d 61 67  65 73 20 72 65 61 64 0a  |y 5 images read.|
00007bb0  20 2d 20 4e 6f 20 72 65  73 6f 6c 75 74 69 6f 6e  | - No resolution|
00007bc0  20 73 70 65 63 69 66 69  65 64 2c 20 65 71 75 61  | specified, equa|
00007bd0  6c 20 74 6f 20 6d 6f 64  65 20 32 37 20 61 73 73  |l to mode 27 ass|
00007be0  75 6d 65 64 0a 0a 3e 3e  20 41 6c 6c 20 74 68 65  |umed..>> All the|
00007bf0  20 66 69 6c 65 20 66 6f  72 6d 61 74 73 20 73 6f  | file formats so|
00007c00  20 66 61 72 20 68 61 76  65 20 62 65 65 6e 20 64  | far have been d|
00007c10  65 73 69 67 6e 65 64 20  6f 6e 20 52 49 53 43 20  |esigned on RISC |
00007c20  4f 53 20 28 6f 72 20 41  72 74 68 75 72 29 20 61  |OS (or Arthur) a|
00007c30  6e 64 0a 72 65 63 6f 67  6e 69 74 69 6f 6e 20 6f  |nd.recognition o|
00007c40  66 20 74 68 65 20 66 6f  72 6d 61 74 20 69 73 20  |f the format is |
00007c50  64 65 66 69 6e 65 64 20  62 79 20 66 69 6c 65 20  |defined by file |
00007c60  74 79 70 65 2c 20 74 68  65 20 66 69 6c 65 73 20  |type, the files |
00007c70  61 72 72 69 76 65 20 6f  6e 20 52 49 53 43 0a 4f  |arrive on RISC.O|
00007c80  53 20 66 6c 6f 70 70 79  20 64 69 73 63 73 2c 20  |S floppy discs, |
00007c90  61 6e 64 20 74 68 65 20  6f 72 69 67 69 6e 61 74  |and the originat|
00007ca0  6f 72 73 20 6c 69 76 65  20 69 6e 20 74 68 65 20  |ors live in the |
00007cb0  73 61 6d 65 20 74 69 6d  65 20 7a 6f 6e 65 2e 20  |same time zone. |
00007cc0  46 6f 72 20 74 68 65 0a  66 6f 6c 6c 6f 77 69 6e  |For the.followin|
00007cd0  67 20 66 6f 72 6d 61 74  73 20 6d 61 6e 79 20 6f  |g formats many o|
00007ce0  66 20 74 68 65 73 65 20  74 68 69 6e 67 73 20 61  |f these things a|
00007cf0  72 65 20 6e 6f 74 20 74  72 75 65 2e 2e 2e 20 57  |re not true... W|
00007d00  68 69 63 68 20 6d 61 6b  65 73 20 69 74 20 6d 6f  |hich makes it mo|
00007d10  72 65 0a 64 69 66 66 69  63 75 6c 74 20 74 6f 20  |re.difficult to |
00007d20  67 75 61 72 61 6e 74 65  65 20 74 68 61 74 20 43  |guarantee that C|
00007d30  68 61 6e 67 65 46 53 49  20 77 69 6c 6c 20 62 65  |hangeFSI will be|
00007d40  20 61 62 6c 65 20 74 6f  20 72 65 61 64 20 74 68  | able to read th|
00007d50  65 20 66 69 6c 65 2e 0a  0a 54 68 65 20 4d 69 6c  |e file...The Mil|
00007d60  6c 69 70 65 64 65 20 50  72 69 73 6d 61 20 66 6f  |lipede Prisma fo|
00007d70  72 6d 61 74 20 28 75 73  65 64 20 62 79 20 43 61  |rmat (used by Ca|
00007d80  64 53 6f 66 74 20 61 6c  73 6f 29 0a 20 54 68 65  |dSoft also). The|
00007d90  20 4d 69 6c 6c 69 70 65  64 65 20 50 72 69 73 6d  | Millipede Prism|
00007da0  61 20 33 20 69 73 20 61  20 37 36 38 20 70 69 78  |a 3 is a 768 pix|
00007db0  65 6c 73 20 77 69 64 65  20 62 79 20 35 37 34 20  |els wide by 574 |
00007dc0  6c 69 6e 65 20 69 6e 74  65 72 6c 61 63 65 64 20  |line interlaced |
00007dd0  64 69 73 70 6c 61 79 0a  20 62 6f 61 72 64 20 66  |display. board f|
00007de0  6f 72 20 74 68 65 20 41  72 63 68 69 6d 65 64 65  |or the Archimede|
00007df0  73 20 61 6e 64 20 42 42  43 20 4d 69 63 72 6f 63  |s and BBC Microc|
00007e00  6f 6d 70 75 74 65 72 2e  20 49 74 20 61 6c 6c 6f  |omputer. It allo|
00007e10  77 73 20 75 73 65 20 6f  66 20 32 35 36 0a 20 63  |ws use of 256. c|
00007e20  6f 6c 6f 75 72 73 20 66  72 6f 6d 20 32 5e 32 34  |olours from 2^24|
00007e30  2e 20 46 69 6c 65 73 20  6d 61 79 20 62 65 20 73  |. Files may be s|
00007e40  74 6f 72 65 64 20 75 6e  63 6f 6d 70 72 65 73 73  |tored uncompress|
00007e50  65 64 20 28 34 33 32 4b  42 79 74 65 73 21 29 20  |ed (432KBytes!) |
00007e60  6f 72 20 72 75 6e 0a 20  6c 65 6e 67 74 68 20 65  |or run. length e|
00007e70  6e 63 6f 64 65 64 2e 20  4d 6f 72 65 20 64 65 74  |ncoded. More det|
00007e80  61 69 6c 73 20 66 72 6f  6d 20 43 61 64 53 6f 66  |ails from CadSof|
00007e90  74 20 6f 72 20 4d 69 6c  6c 69 70 65 64 65 20 45  |t or Millipede E|
00007ea0  6c 65 63 74 72 6f 6e 69  63 20 47 72 61 70 68 69  |lectronic Graphi|
00007eb0  63 73 2e 0a 20 2b 20 52  65 63 6f 67 6e 69 73 65  |cs.. + Recognise|
00007ec0  64 20 62 79 20 22 4d 49  4c 4c 49 50 45 44 45 22  |d by "MILLIPEDE"|
00007ed0  20 61 74 20 6f 66 66 73  65 74 20 31 36 20 69 6e  | at offset 16 in|
00007ee0  20 74 68 65 20 66 69 6c  65 0a 20 2d 20 4e 6f 20  | the file. - No |
00007ef0  72 65 73 6f 6c 75 74 69  6f 6e 20 73 70 65 63 69  |resolution speci|
00007f00  66 69 65 64 2c 20 65 71  75 61 6c 20 74 6f 20 6d  |fied, equal to m|
00007f10  6f 64 65 20 32 37 20 61  73 73 75 6d 65 64 0a 20  |ode 27 assumed. |
00007f20  2d 20 73 6c 6f 77 69 73  68 20 74 6f 20 72 65 61  |- slowish to rea|
00007f30  64 20 74 68 65 20 63 6f  6d 70 72 65 73 73 65 64  |d the compressed|
00007f40  20 66 6f 72 6d 61 74 73  0a 20 2d 20 73 63 61 6c  | formats. - scal|
00007f50  69 6e 67 20 74 68 65 20  70 69 63 74 75 72 65 20  |ing the picture |
00007f60  75 73 69 6e 67 20 3d 20  63 61 6e 20 62 65 20 70  |using = can be p|
00007f70  6f 6f 72 20 73 69 6e 63  65 20 35 37 34 20 6c 69  |oor since 574 li|
00007f80  6e 65 73 20 64 6f 6e 27  74 20 72 65 6c 61 74 65  |nes don't relate|
00007f90  20 76 65 72 79 0a 20 20  20 77 65 6c 6c 20 74 6f  | very.   well to|
00007fa0  20 35 31 32 20 6f 72 20  32 35 36 2e 20 55 73 65  | 512 or 256. Use|
00007fb0  20 2d 69 6e 66 6f 20 74  6f 20 64 69 73 70 6c 61  | -info to displa|
00007fc0  79 20 74 68 65 20 73 63  61 6c 65 20 72 61 74 69  |y the scale rati|
00007fd0  6f 73 2e 0a 0a 54 68 65  20 41 6c 64 75 73 2f 4d  |os...The Aldus/M|
00007fe0  69 63 72 6f 53 6f 66 74  20 54 49 46 46 20 66 6f  |icroSoft TIFF fo|
00007ff0  72 6d 61 74 20 28 61 6c  73 6f 20 66 69 6c 65 74  |rmat (also filet|
00008000  79 70 65 20 46 46 30 20  69 73 20 61 73 73 69 67  |ype FF0 is assig|
00008010  6e 65 64 20 74 6f 20 54  49 46 46 29 0a 20 46 72  |ned to TIFF). Fr|
00008020  65 71 75 65 6e 74 6c 79  20 75 73 65 64 20 62 79  |equently used by|
00008030  20 73 63 61 6e 6e 65 72  73 2c 20 54 49 46 46 20  | scanners, TIFF |
00008040  69 73 20 61 20 63 6f 6d  6d 6f 6e 20 69 6e 74 65  |is a common inte|
00008050  72 63 68 61 6e 67 65 20  66 6f 72 6d 61 74 20 66  |rchange format f|
00008060  6f 72 0a 20 67 72 61 70  68 69 63 73 20 69 6d 61  |or. graphics ima|
00008070  67 65 73 20 6f 6e 20 74  68 65 20 4d 61 63 20 61  |ges on the Mac a|
00008080  6e 64 20 50 43 20 28 70  61 72 74 69 63 75 6c 61  |nd PC (particula|
00008090  72 6c 79 20 44 54 50 20  61 6e 64 20 57 69 6e 64  |rly DTP and Wind|
000080a0  6f 77 73 29 2e 20 49 74  0a 20 70 72 6f 76 69 64  |ows). It. provid|
000080b0  65 73 20 61 6e 20 61 72  62 69 74 72 61 72 79 20  |es an arbitrary |
000080c0  6e 75 6d 62 65 72 20 6f  66 20 62 69 74 73 20 70  |number of bits p|
000080d0  65 72 20 70 69 78 65 6c  2c 20 73 69 7a 65 20 65  |er pixel, size e|
000080e0  74 63 20 75 73 69 6e 67  20 61 20 6e 75 6d 65 72  |tc using a numer|
000080f0  69 63 20 74 61 67 0a 20  73 63 68 65 6d 65 20 61  |ic tag. scheme a|
00008100  6c 6c 6f 77 69 6e 67 20  6e 65 77 20 69 6e 66 6f  |llowing new info|
00008110  72 6d 61 74 69 6f 6e 20  74 6f 20 62 65 20 69 6e  |rmation to be in|
00008120  74 72 6f 64 75 63 65 64  20 77 69 74 68 6f 75 74  |troduced without|
00008130  20 75 70 73 65 74 74 69  6e 67 20 65 78 69 73 74  | upsetting exist|
00008140  69 6e 67 0a 20 70 72 6f  67 72 61 6d 73 2e 20 54  |ing. programs. T|
00008150  68 65 20 66 6f 72 6d 61  74 20 6d 61 79 20 62 65  |he format may be|
00008160  20 63 6f 6d 70 72 65 73  73 65 64 20 28 69 6e 20  | compressed (in |
00008170  35 20 64 69 66 66 65 72  65 6e 74 20 77 61 79 73  |5 different ways|
00008180  20 61 74 20 70 72 65 73  65 6e 74 29 2e 0a 20 44  | at present).. D|
00008190  65 74 61 69 6c 73 20 66  72 6f 6d 20 41 6c 64 75  |etails from Aldu|
000081a0  73 20 55 4b 2c 20 4d 69  63 72 6f 53 6f 66 74 2c  |s UK, MicroSoft,|
000081b0  20 48 65 77 6c 65 74 74  20 50 61 63 6b 61 72 64  | Hewlett Packard|
000081c0  2e 2e 2e 0a 20 2b 20 52  65 63 6f 67 6e 69 73 65  |.... + Recognise|
000081d0  64 20 62 79 20 66 69 6c  65 20 74 79 70 65 20 46  |d by file type F|
000081e0  46 30 0a 20 2b 20 52 65  63 6f 67 6e 69 73 65 64  |F0. + Recognised|
000081f0  20 62 79 20 22 49 49 22  20 70 6c 75 73 20 74 68  | by "II" plus th|
00008200  65 20 31 36 20 62 69 74  20 6e 75 6d 62 65 72 20  |e 16 bit number |
00008210  34 32 20 61 74 20 74 68  65 20 73 74 61 72 74 20  |42 at the start |
00008220  6f 66 20 74 68 65 20 66  69 6c 65 20 66 6f 72 0a  |of the file for.|
00008230  20 20 20 6c 69 74 74 6c  65 20 65 6e 64 69 61 6e  |   little endian|
00008240  20 6d 61 63 68 69 6e 65  73 20 28 69 78 38 36 2c  | machines (ix86,|
00008250  20 41 52 4d 2c 20 56 41  58 2e 2e 2e 29 0a 20 2b  | ARM, VAX...). +|
00008260  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 22  | Recognised by "|
00008270  4d 4d 22 20 70 6c 75 73  20 74 68 65 20 31 36 20  |MM" plus the 16 |
00008280  62 69 74 20 6e 75 6d 62  65 72 20 34 32 20 61 74  |bit number 42 at|
00008290  20 74 68 65 20 73 74 61  72 74 20 6f 66 20 74 68  | the start of th|
000082a0  65 20 66 69 6c 65 20 66  6f 72 0a 20 20 20 62 69  |e file for.   bi|
000082b0  67 20 65 6e 64 69 61 6e  20 6d 61 63 68 69 6e 65  |g endian machine|
000082c0  73 20 28 4d 36 38 30 78  30 2e 2e 2e 29 0a 20 2b  |s (M680x0...). +|
000082d0  20 43 61 6e 20 72 65 61  64 20 50 61 63 6b 42 69  | Can read PackBi|
000082e0  74 73 20 69 6d 61 67 65  73 20 61 6e 64 20 4c 5a  |ts images and LZ|
000082f0  57 20 63 6f 6d 70 72 65  73 73 65 64 20 66 6f 72  |W compressed for|
00008300  6d 73 20 28 61 74 20 6c  65 61 73 74 20 74 68 65  |ms (at least the|
00008310  20 33 20 69 74 73 0a 20  20 20 73 65 65 6e 20 73  | 3 its.   seen s|
00008320  6f 20 66 61 72 2e 2e 2e  29 0a 20 2d 20 43 61 6e  |o far...). - Can|
00008330  6e 6f 74 20 72 65 61 64  20 70 72 65 64 69 63 74  |not read predict|
00008340  6f 72 20 63 6f 6d 70 72  65 73 73 65 64 20 4c 5a  |or compressed LZ|
00008350  57 20 69 6d 61 67 65 73  2e 0a 20 2d 20 53 6f 20  |W images.. - So |
00008360  66 61 72 20 43 68 61 6e  67 65 46 53 49 20 68 61  |far ChangeFSI ha|
00008370  73 20 6f 6e 6c 79 20 64  6f 6e 65 20 31 2c 20 34  |s only done 1, 4|
00008380  2c 20 38 20 61 6e 64 20  32 34 20 62 69 74 20 69  |, 8 and 24 bit i|
00008390  6d 61 67 65 73 2e 0a 20  20 20 49 74 20 63 61 6e  |mages..   It can|
000083a0  27 74 20 72 65 61 64 20  22 70 6c 61 6e 61 72 22  |'t read "planar"|
000083b0  20 69 6d 61 67 65 73 20  6f 72 20 43 43 49 54 54  | images or CCITT|
000083c0  20 63 6f 6d 70 72 65 73  73 65 64 20 66 6f 72 6d  | compressed form|
000083d0  73 2e 0a 20 2d 20 53 6f  6d 65 20 54 49 46 46 20  |s.. - Some TIFF |
000083e0  69 6d 61 67 65 73 20 68  61 76 65 20 69 6e 63 6f  |images have inco|
000083f0  72 72 65 63 74 20 70 69  78 65 6c 20 73 69 7a 65  |rrect pixel size|
00008400  73 3a 20 75 73 65 20 2d  6e 6f 73 69 7a 65 20 69  |s: use -nosize i|
00008410  66 20 74 68 69 73 20 69  73 0a 20 20 20 74 72 75  |f this is.   tru|
00008420  65 2e 20 49 66 20 6e 6f  20 70 69 78 65 6c 20 73  |e. If no pixel s|
00008430  69 7a 65 20 69 73 20 73  70 65 63 69 66 69 65 64  |ize is specified|
00008440  2c 20 43 68 61 6e 67 65  46 53 49 20 61 73 73 75  |, ChangeFSI assu|
00008450  6d 65 73 20 6d 6f 64 65  20 32 37 20 73 69 7a 65  |mes mode 27 size|
00008460  2e 0a 20 2b 20 54 49 46  46 20 69 73 20 61 20 74  |.. + TIFF is a t|
00008470  72 61 64 65 6d 61 72 6b  20 6f 66 20 41 6c 64 75  |rademark of Aldu|
00008480  73 20 43 6f 72 70 6f 72  61 74 69 6f 6e 0a 0a 54  |s Corporation..T|
00008490  68 65 20 43 6f 6d 70 75  53 65 72 76 65 20 47 49  |he CompuServe GI|
000084a0  46 20 66 6f 72 6d 61 74  0a 20 55 73 65 64 20 66  |F format. Used f|
000084b0  6f 72 20 77 69 64 65 20  61 72 65 61 20 6e 65 74  |or wide area net|
000084c0  77 6f 72 6b 20 74 72 61  6e 73 66 65 72 20 6f 66  |work transfer of|
000084d0  20 69 6d 61 67 65 73 2e  20 49 74 20 70 72 6f 76  | images. It prov|
000084e0  69 64 65 73 20 61 6e 20  4c 5a 57 0a 20 63 6f 6d  |ides an LZW. com|
000084f0  70 72 65 73 73 65 64 20  75 70 20 74 6f 20 32 35  |pressed up to 25|
00008500  36 20 63 6f 6c 6f 75 72  73 20 66 72 6f 6d 20 32  |6 colours from 2|
00008510  5e 32 34 20 61 72 62 69  74 72 61 72 79 20 73 69  |^24 arbitrary si|
00008520  7a 65 64 20 69 6d 61 67  65 2e 20 44 65 74 61 69  |zed image. Detai|
00008530  6c 73 20 66 72 6f 6d 0a  20 43 6f 6d 70 75 53 65  |ls from. CompuSe|
00008540  72 76 65 20 28 55 53 41  29 20 5b 6f 72 20 75 73  |rve (USA) [or us|
00008550  65 6e 65 74 5d 0a 20 2b  20 52 65 63 6f 67 6e 69  |enet]. + Recogni|
00008560  73 65 64 20 62 79 20 22  47 49 46 38 22 20 61 74  |sed by "GIF8" at|
00008570  20 74 68 65 20 73 74 61  72 74 20 6f 66 20 74 68  | the start of th|
00008580  65 20 66 69 6c 65 0a 20  2b 20 4c 5a 57 20 63 6f  |e file. + LZW co|
00008590  6d 70 72 65 73 73 69 6f  6e 20 69 73 20 65 66 66  |mpression is eff|
000085a0  69 63 69 65 6e 74 20 65  76 65 6e 20 66 6f 72 20  |icient even for |
000085b0  64 69 74 68 65 72 65 64  20 69 6d 61 67 65 73 0a  |dithered images.|
000085c0  20 2b 20 43 68 61 6e 67  65 46 53 49 20 63 61 6e  | + ChangeFSI can|
000085d0  20 64 65 63 6f 6d 70 72  65 73 73 20 4c 5a 57 20  | decompress LZW |
000085e0  71 75 69 63 6b 6c 79 0a  20 2d 20 4e 6f 20 72 65  |quickly. - No re|
000085f0  73 6f 6c 75 74 69 6f 6e  20 73 70 65 63 69 66 69  |solution specifi|
00008600  65 64 2c 20 65 71 75 61  6c 20 74 6f 20 6d 6f 64  |ed, equal to mod|
00008610  65 20 32 37 20 61 73 73  75 6d 65 64 0a 20 2d 20  |e 27 assumed. - |
00008620  6d 61 6e 79 20 6c 6f 77  20 71 75 61 6c 69 74 79  |many low quality|
00008630  20 69 6d 61 67 65 73 20  61 72 6f 75 6e 64 20 66  | images around f|
00008640  72 6f 6d 20 50 43 73 0a  20 2d 20 6e 6f 20 70 72  |rom PCs. - no pr|
00008650  6f 63 65 73 73 69 6e 67  20 6f 66 20 47 49 46 38  |ocessing of GIF8|
00008660  39 61 20 6d 61 73 6b 73  0a 0a 54 68 65 20 45 6c  |9a masks..The El|
00008670  65 63 74 72 6f 6e 69 63  20 41 72 74 73 20 49 46  |ectronic Arts IF|
00008680  46 20 49 4c 42 4d 20 66  6f 72 6d 61 74 0a 20 50  |F ILBM format. P|
00008690  72 6f 76 69 64 65 73 20  61 6e 20 61 72 62 69 74  |rovides an arbit|
000086a0  72 61 72 79 20 73 69 7a  65 64 20 69 6d 61 67 65  |rary sized image|
000086b0  20 77 69 74 68 20 75 70  20 74 6f 20 34 30 39 36  | with up to 4096|
000086c0  20 63 6f 6c 6f 75 72 73  20 73 6f 6d 65 74 69 6d  | colours sometim|
000086d0  65 73 20 72 75 6e 0a 20  6c 65 6e 67 74 68 20 65  |es run. length e|
000086e0  6e 63 6f 64 65 64 2e 20  43 68 61 6e 67 65 46 53  |ncoded. ChangeFS|
000086f0  49 20 75 6e 64 65 72 73  74 61 6e 64 73 20 74 68  |I understands th|
00008700  65 20 67 65 6e 65 72 69  63 20 66 6f 72 6d 61 74  |e generic format|
00008710  20 61 6e 64 20 61 6c 73  6f 20 74 68 65 0a 20 73  | and also the. s|
00008720  70 65 63 69 61 6c 20 41  6d 69 67 61 20 66 6f 72  |pecial Amiga for|
00008730  6d 61 74 20 66 6f 72 20  22 48 41 4d 22 20 61 6e  |mat for "HAM" an|
00008740  64 20 22 48 61 6c 66 2d  62 72 69 67 68 74 22 20  |d "Half-bright" |
00008750  69 6d 61 67 65 73 2e 0a  20 2b 20 52 65 63 6f 67  |images.. + Recog|
00008760  6e 69 73 65 64 20 62 79  20 22 46 4f 52 4d 22 20  |nised by "FORM" |
00008770  61 73 20 74 68 65 20 66  69 72 73 74 20 66 6f 75  |as the first fou|
00008780  72 20 63 68 61 72 61 63  74 65 72 73 20 61 6e 64  |r characters and|
00008790  20 22 49 4c 42 4d 22 20  61 73 0a 20 20 20 63 68  | "ILBM" as.   ch|
000087a0  61 72 61 63 74 65 72 73  20 38 20 74 6f 20 31 31  |aracters 8 to 11|
000087b0  0a 20 2d 20 4f 6e 6c 79  20 70 69 78 65 6c 20 61  |. - Only pixel a|
000087c0  73 70 65 63 74 20 72 61  74 69 6f 20 73 70 65 63  |spect ratio spec|
000087d0  69 66 69 65 64 2c 20 6e  6f 74 20 69 74 73 20 73  |ified, not its s|
000087e0  69 7a 65 20 28 61 6e 64  20 74 68 65 6e 20 73 6f  |ize (and then so|
000087f0  6d 65 74 69 6d 65 73 0a  20 20 20 69 6e 63 6f 72  |metimes.   incor|
00008800  72 65 63 74 6c 79 29 3a  20 75 73 65 20 2d 6e 6f  |rectly): use -no|
00008810  73 69 7a 65 20 2a 61 6e  64 2a 20 61 20 73 69 7a  |size *and* a siz|
00008820  65 20 63 68 61 6e 67 65  20 28 61 3a 62 29 20 69  |e change (a:b) i|
00008830  66 20 69 74 73 20 77 72  6f 6e 67 0a 20 2d 20 69  |f its wrong. - i|
00008840  6d 61 67 65 73 20 6f 66  74 65 6e 20 73 6d 61 6c  |mages often smal|
00008850  6c 0a 20 2d 20 64 6f 65  73 6e 27 74 20 75 6e 64  |l. - doesn't und|
00008860  65 72 73 74 61 6e 64 20  41 6d 69 67 61 20 22 68  |erstand Amiga "h|
00008870  69 72 65 73 22 0a 20 2d  20 63 61 6e 27 74 20 63  |ires". - can't c|
00008880  6f 6e 76 65 72 74 20 48  41 4d 20 70 69 63 74 75  |onvert HAM pictu|
00008890  72 65 73 20 64 69 72 65  63 74 6c 79 20 74 6f 20  |res directly to |
000088a0  6d 6f 6e 6f 63 68 72 6f  6d 65 0a 0a 54 68 65 20  |monochrome..The |
000088b0  4d 69 63 72 6f 53 6f 66  74 20 57 69 6e 64 6f 77  |MicroSoft Window|
000088c0  73 20 33 20 2e 42 4d 50  20 66 6f 72 6d 61 74 0a  |s 3 .BMP format.|
000088d0  20 55 73 65 64 20 62 79  20 4d 69 63 72 6f 53 6f  | Used by MicroSo|
000088e0  66 74 20 69 6e 20 57 69  6e 64 6f 77 73 20 33 20  |ft in Windows 3 |
000088f0  61 6e 64 20 50 61 69 6e  74 42 72 75 73 68 20 66  |and PaintBrush f|
00008900  6f 72 20 57 69 6e 64 6f  77 73 20 33 2e 20 50 72  |or Windows 3. Pr|
00008910  6f 76 69 64 65 73 20 61  6e 0a 20 61 72 62 69 74  |ovides an. arbit|
00008920  72 61 72 79 20 73 69 7a  65 64 20 69 6d 61 67 65  |rary sized image|
00008930  20 61 6e 64 20 31 2c 20  34 20 6f 72 20 38 20 62  | and 1, 4 or 8 b|
00008940  69 74 73 20 70 65 72 20  70 69 78 65 6c 2e 20 55  |its per pixel. U|
00008950  6e 63 6f 6d 70 72 65 73  73 65 64 2e 0a 20 2b 20  |ncompressed.. + |
00008960  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 22 42  |Recognised by "B|
00008970  4d 22 20 61 73 20 74 68  65 20 66 69 72 73 74 20  |M" as the first |
00008980  74 77 6f 20 63 68 61 72  61 63 74 65 72 73 0a 20  |two characters. |
00008990  2d 20 4e 6f 20 72 65 73  6f 6c 75 74 69 6f 6e 20  |- No resolution |
000089a0  73 70 65 63 69 66 69 65  64 2c 20 65 71 75 61 6c  |specified, equal|
000089b0  20 74 6f 20 6d 6f 64 65  20 32 37 20 61 73 73 75  | to mode 27 assu|
000089c0  6d 65 64 0a 20 2d 20 64  6f 63 75 6d 65 6e 74 61  |med. - documenta|
000089d0  74 69 6f 6e 20 6e 65 76  65 72 20 73 65 65 6e 20  |tion never seen |
000089e0  2d 20 37 20 66 69 6c 65  73 20 65 78 61 6d 69 6e  |- 7 files examin|
000089f0  65 64 20 61 6e 64 20 69  6e 74 65 6c 6c 69 67 65  |ed and intellige|
00008a00  6e 74 20 67 75 65 73 73  65 73 20 6d 61 64 65 21  |nt guesses made!|
00008a10  0a 0a 54 68 65 20 44 69  67 69 74 61 6c 20 52 65  |..The Digital Re|
00008a20  73 65 61 72 63 68 20 47  45 4d 20 2e 49 4d 47 20  |search GEM .IMG |
00008a30  66 6f 72 6d 61 74 0a 20  55 73 65 64 20 62 79 20  |format. Used by |
00008a40  47 45 4d 20 28 61 6e 64  20 47 45 4d 20 50 61 69  |GEM (and GEM Pai|
00008a50  6e 74 29 20 6f 6e 20 62  6f 74 68 20 50 43 20 61  |nt) on both PC a|
00008a60  6e 64 20 41 74 61 72 69  20 53 54 2e 20 50 72 6f  |nd Atari ST. Pro|
00008a70  76 69 64 65 73 20 61 6e  20 61 72 62 69 74 72 61  |vides an arbitra|
00008a80  72 79 0a 20 73 69 7a 65  64 20 69 6d 61 67 65 20  |ry. sized image |
00008a90  61 6e 64 20 6e 75 6d 62  65 72 20 6f 66 20 62 69  |and number of bi|
00008aa0  74 73 20 70 65 72 20 70  69 78 65 6c 20 28 74 68  |ts per pixel (th|
00008ab0  6f 75 67 68 20 69 74 73  20 6f 6e 6c 79 20 75 73  |ough its only us|
00008ac0  75 61 6c 6c 79 20 75 73  65 64 20 77 69 74 68 0a  |ually used with.|
00008ad0  20 75 70 20 74 6f 20 35  20 62 69 74 73 20 70 65  | up to 5 bits pe|
00008ae0  72 20 70 69 78 65 6c 29  20 61 6e 64 20 70 69 78  |r pixel) and pix|
00008af0  65 6c 20 73 69 7a 65 2e  20 43 6f 6d 70 72 65 73  |el size. Compres|
00008b00  73 65 64 20 62 79 20 72  75 6e 20 6c 65 6e 67 74  |sed by run lengt|
00008b10  68 20 65 6e 63 6f 64 69  6e 67 0a 20 61 6e 64 20  |h encoding. and |
00008b20  6c 69 6e 65 20 72 65 70  65 61 74 73 2e 0a 20 2d  |line repeats.. -|
00008b30  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 30  | Recognised by 0|
00008b40  30 20 30 31 20 30 30 20  30 38 20 61 73 20 74 68  |0 01 00 08 as th|
00008b50  65 20 66 69 72 73 74 20  66 6f 75 72 20 62 79 74  |e first four byt|
00008b60  65 73 20 28 22 76 65 72  73 69 6f 6e 20 31 2c 20  |es ("version 1, |
00008b70  68 65 61 64 65 72 0a 20  20 20 6c 65 6e 67 74 68  |header.   length|
00008b80  20 38 22 29 20 6f 72 20  62 79 20 22 49 4d 47 22  | 8") or by "IMG"|
00008b90  20 61 73 20 74 68 65 20  6e 61 6d 65 20 6f 66 20  | as the name of |
00008ba0  74 68 65 20 64 69 72 65  63 74 6f 72 79 20 74 68  |the directory th|
00008bb0  65 20 66 69 6c 65 20 69  73 20 69 6e 2e 0a 20 2d  |e file is in.. -|
00008bc0  20 50 6c 61 6e 61 72 20  66 69 6c 65 20 66 6f 72  | Planar file for|
00008bd0  6d 61 74 20 73 6c 6f 77  20 74 6f 20 72 65 61 64  |mat slow to read|
00008be0  0a 20 2d 20 50 61 6c 65  74 74 65 20 6e 6f 74 20  |. - Palette not |
00008bf0  73 70 65 63 69 66 69 65  64 3a 20 43 68 61 6e 67  |specified: Chang|
00008c00  65 46 53 49 20 61 73 73  75 6d 65 73 20 6c 69 6e  |eFSI assumes lin|
00008c10  65 61 72 20 73 68 61 64  65 73 20 6f 66 20 67 72  |ear shades of gr|
00008c20  65 79 2e 20 59 6f 75 20  6d 69 67 68 74 0a 20 20  |ey. You might.  |
00008c30  20 6e 65 65 64 20 74 6f  20 75 73 65 20 2d 69 6e  | need to use -in|
00008c40  76 65 72 74 20 69 66 20  74 68 65 20 69 6d 61 67  |vert if the imag|
00008c50  65 20 69 73 20 61 20 6e  65 67 61 74 69 76 65 0a  |e is a negative.|
00008c60  20 2d 20 54 68 65 20 73  69 7a 65 20 6f 66 20 61  | - The size of a|
00008c70  20 70 69 78 65 6c 20 69  73 20 73 70 65 63 69 66  | pixel is specif|
00008c80  69 65 64 20 69 6e 20 6d  69 63 72 6f 6e 73 2e 20  |ied in microns. |
00008c90  54 68 65 20 73 74 61 6e  64 61 72 64 20 52 49 53  |The standard RIS|
00008ca0  43 20 4f 53 20 39 30 0a  20 20 20 70 69 78 65 6c  |C OS 90.   pixel|
00008cb0  73 20 70 65 72 20 69 6e  63 68 20 74 72 61 6e 73  |s per inch trans|
00008cc0  6c 61 74 65 73 20 74 6f  20 28 31 2f 39 30 2a 32  |lates to (1/90*2|
00008cd0  2e 35 34 2a 31 30 2c 30  30 30 29 20 6d 69 63 72  |.54*10,000) micr|
00008ce0  6f 6e 73 20 2d 20 32 38  32 2e 20 28 75 73 65 0a  |ons - 282. (use.|
00008cf0  20 20 20 2d 69 6e 66 6f  20 74 6f 20 67 65 74 20  |   -info to get |
00008d00  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 61 62 6f 75  |information abou|
00008d10  74 20 74 68 65 20 73 63  61 6c 69 6e 67 2c 20 2d  |t the scaling, -|
00008d20  6e 6f 73 69 7a 65 20 74  6f 20 73 74 6f 70 20 69  |nosize to stop i|
00008d30  74 29 0a 20 2d 20 44 6f  63 75 6d 65 6e 74 61 74  |t). - Documentat|
00008d40  69 6f 6e 20 66 72 6f 6d  20 74 68 65 20 22 53 54  |ion from the "ST|
00008d50  20 57 6f 72 6c 64 22 20  6d 61 67 61 7a 69 6e 65  | World" magazine|
00008d60  27 73 20 63 6c 69 6e 69  63 2e 0a 0a 41 6e 20 75  |'s clinic...An u|
00008d70  6e 6b 6e 6f 77 6e 20 50  43 20 2e 50 49 43 20 66  |nknown PC .PIC f|
00008d80  6f 72 6d 61 74 0a 20 55  73 65 64 20 66 6f 72 20  |ormat. Used for |
00008d90  73 6f 6d 65 20 56 47 41  20 64 65 6d 6f 73 2c 20  |some VGA demos, |
00008da0  74 68 65 20 66 6f 72 6d  61 74 20 70 72 6f 76 69  |the format provi|
00008db0  64 65 73 20 61 6e 20 75  6e 63 6f 6d 70 72 65 73  |des an uncompres|
00008dc0  73 65 64 20 33 32 30 20  62 79 20 32 30 30 20 62  |sed 320 by 200 b|
00008dd0  79 0a 20 32 35 36 20 63  6f 6c 6f 75 72 20 28 66  |y. 256 colour (f|
00008de0  72 6f 6d 20 32 5e 32 34  29 20 56 47 41 20 73 63  |rom 2^24) VGA sc|
00008df0  72 65 65 6e 20 64 75 6d  70 2e 0a 20 2b 20 52 65  |reen dump.. + Re|
00008e00  63 6f 67 6e 69 73 65 64  20 62 79 20 22 41 56 5f  |cognised by "AV_|
00008e10  56 4f 22 20 61 73 20 74  68 65 20 66 69 72 73 74  |VO" as the first|
00008e20  20 66 69 76 65 20 62 79  74 65 73 20 69 6e 20 74  | five bytes in t|
00008e30  68 65 20 66 69 6c 65 0a  20 2d 20 44 6f 63 75 6d  |he file. - Docum|
00008e40  65 6e 74 61 74 69 6f 6e  20 6e 65 76 65 72 20 73  |entation never s|
00008e50  65 65 6e 0a 20 2d 20 50  69 78 65 6c 20 73 69 7a  |een. - Pixel siz|
00008e60  65 20 61 73 73 75 6d 65  64 20 74 68 65 20 73 61  |e assumed the sa|
00008e70  6d 65 20 61 73 20 4d 4f  44 45 20 31 33 20 28 34  |me as MODE 13 (4|
00008e80  35 20 70 69 78 65 6c 73  20 70 65 72 20 69 6e 63  |5 pixels per inc|
00008e90  68 29 2e 0a 0a 54 68 65  20 4d 61 63 50 61 69 6e  |h)...The MacPain|
00008ea0  74 20 66 6f 72 6d 61 74  0a 20 50 72 6f 76 69 64  |t format. Provid|
00008eb0  65 73 20 61 20 35 37 36  20 62 79 20 37 32 30 20  |es a 576 by 720 |
00008ec0  62 69 74 6d 61 70 2c 20  72 75 6e 20 6c 65 6e 67  |bitmap, run leng|
00008ed0  74 68 20 63 6f 64 65 64  20 62 79 20 74 68 65 20  |th coded by the |
00008ee0  4d 61 63 27 73 20 22 50  61 63 6b 42 69 74 73 22  |Mac's "PackBits"|
00008ef0  0a 20 61 6c 67 6f 72 69  74 68 6d 20 28 72 65 70  |. algorithm (rep|
00008f00  65 61 74 65 64 20 62 79  74 65 73 29 2e 0a 20 2d  |eated bytes).. -|
00008f10  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 22  | Recognised by "|
00008f20  50 4e 54 47 22 20 61 74  20 70 6f 73 69 74 69 6f  |PNTG" at positio|
00008f30  6e 20 36 35 20 69 6e 20  74 68 65 20 66 69 6c 65  |n 65 in the file|
00008f40  2e 20 54 68 69 73 20 6d  61 79 20 6f 6e 6c 79 20  |. This may only |
00008f50  72 65 6c 61 74 65 20 74  6f 0a 20 20 20 66 69 6c  |relate to.   fil|
00008f60  65 73 20 77 68 69 63 68  20 68 61 76 65 20 62 65  |es which have be|
00008f70  65 6e 20 74 68 72 6f 75  67 68 20 61 20 70 72 6f  |en through a pro|
00008f80  67 72 61 6d 20 63 61 6c  6c 65 64 20 22 4d 61 63  |gram called "Mac|
00008f90  46 69 78 22 2e 20 44 61  74 61 20 61 73 73 75 6d  |Fix". Data assum|
00008fa0  65 64 20 74 6f 0a 20 20  20 73 74 61 72 74 20 61  |ed to.   start a|
00008fb0  74 20 70 6f 73 69 74 69  6f 6e 20 31 32 38 20 69  |t position 128 i|
00008fc0  6e 20 74 68 65 20 66 69  6c 65 2e 20 48 65 61 64  |n the file. Head|
00008fd0  65 72 20 69 67 6e 6f 72  65 64 2e 0a 20 2d 20 4e  |er ignored.. - N|
00008fe0  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
00008ff0  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
00009000  20 6d 6f 64 65 20 32 35  20 61 73 73 75 6d 65 64  | mode 25 assumed|
00009010  0a 0a 54 68 65 20 4d 61  63 20 50 49 43 54 32 20  |..The Mac PICT2 |
00009020  66 6f 72 6d 61 74 20 28  50 49 43 54 20 65 78 74  |format (PICT ext|
00009030  65 6e 64 65 64 20 76 65  72 73 69 6f 6e 20 32 29  |ended version 2)|
00009040  0a 20 50 72 6f 76 69 64  65 73 20 61 6e 20 61 72  |. Provides an ar|
00009050  62 69 74 61 72 79 20 73  69 7a 65 20 70 61 63 6b  |bitary size pack|
00009060  65 64 20 70 69 63 74 75  72 65 2c 20 72 75 6e 20  |ed picture, run |
00009070  6c 65 6e 67 74 68 20 63  6f 64 65 64 20 62 79 20  |length coded by |
00009080  74 68 65 20 4d 61 63 27  73 0a 20 22 50 61 63 6b  |the Mac's. "Pack|
00009090  42 69 74 73 22 20 61 6c  67 6f 72 69 74 68 6d 20  |Bits" algorithm |
000090a0  28 72 65 70 65 61 74 65  64 20 62 79 74 65 73 29  |(repeated bytes)|
000090b0  2e 0a 20 2b 20 52 65 63  6f 67 6e 69 73 65 64 20  |.. + Recognised |
000090c0  62 79 20 6c 6f 6f 6b 69  6e 67 20 66 6f 72 20 74  |by looking for t|
000090d0  68 65 20 50 49 43 54 20  68 65 61 64 65 72 20 61  |he PICT header a|
000090e0  74 20 70 6f 73 69 74 69  6f 6e 20 35 31 34 20 69  |t position 514 i|
000090f0  6e 20 74 68 65 20 66 69  6c 65 2e 0a 20 20 20 54  |n the file..   T|
00009100  68 65 20 68 65 61 64 65  72 20 69 73 20 30 30 20  |he header is 00 |
00009110  31 31 20 30 32 20 46 46  20 30 43 20 30 30 20 46  |11 02 FF 0C 00 F|
00009120  46 20 46 45 2e 0a 20 2d  20 44 6f 63 75 6d 65 6e  |F FE.. - Documen|
00009130  74 61 74 69 6f 6e 20 61  76 61 69 6c 61 62 6c 65  |tation available|
00009140  20 62 75 74 20 6d 6f 73  74 6c 79 20 75 73 65 6c  | but mostly usel|
00009150  65 73 73 20 28 69 74 20  61 73 73 75 6d 65 73 20  |ess (it assumes |
00009160  79 6f 75 20 61 72 65 20  61 62 6f 75 74 20 74 6f  |you are about to|
00009170  0a 20 20 20 63 61 6c 6c  20 51 75 69 63 6b 44 72  |.   call QuickDr|
00009180  61 77 20 72 6f 75 74 69  6e 65 73 20 2d 20 22 4e  |aw routines - "N|
00009190  6f 74 65 3a 20 66 6f 72  20 6d 61 78 69 6d 75 6d  |ote: for maximum|
000091a0  20 73 61 66 65 74 79 20  61 6e 64 20 63 6f 6e 76  | safety and conv|
000091b0  65 6e 69 65 6e 63 65 2c  20 6c 65 74 0a 20 20 20  |enience, let.   |
000091c0  51 75 69 63 6b 44 72 61  77 20 67 65 6e 65 72 61  |QuickDraw genera|
000091d0  74 65 20 61 6e 64 20 69  6e 74 65 72 70 72 65 74  |te and interpret|
000091e0  20 79 6f 75 72 20 70 69  63 74 75 72 65 73 2e 22  | your pictures."|
000091f0  20 41 70 70 6c 65 20 66  61 69 6c 20 74 6f 20 64  | Apple fail to d|
00009200  65 73 63 72 69 62 65 0a  20 20 20 74 68 65 20 50  |escribe.   the P|
00009210  61 63 6b 42 69 74 73 20  61 6c 67 6f 72 69 74 68  |ackBits algorith|
00009220  6d 20 69 6e 20 49 6e 73  69 64 65 20 4d 61 63 2e  |m in Inside Mac.|
00009230  2e 2e 29 0a 20 2d 20 50  49 43 54 20 69 73 20 74  |..). - PICT is t|
00009240  68 65 20 6c 6f 6f 73 65  20 65 71 75 69 76 61 6c  |he loose equival|
00009250  65 6e 74 20 6f 66 20 52  49 53 43 20 4f 53 20 44  |ent of RISC OS D|
00009260  72 61 77 20 66 69 6c 65  20 66 6f 72 6d 61 74 2c  |raw file format,|
00009270  20 62 75 74 20 77 69 74  68 6f 75 74 0a 20 20 20  | but without.   |
00009280  74 68 65 20 65 78 70 6c  69 63 69 74 20 73 69 7a  |the explicit siz|
00009290  69 6e 67 20 6f 66 20 6f  62 6a 65 63 74 73 20 2d  |ing of objects -|
000092a0  20 66 6f 72 20 50 49 43  54 2c 20 69 66 20 74 68  | for PICT, if th|
000092b0  65 72 65 20 69 73 20 61  6e 20 6f 62 6a 65 63 74  |ere is an object|
000092c0  20 74 68 61 74 0a 20 20  20 79 6f 75 20 64 6f 6e  | that.   you don|
000092d0  27 74 20 75 6e 64 65 72  73 74 61 6e 64 2c 20 74  |'t understand, t|
000092e0  68 65 72 65 27 73 20 6e  6f 20 77 61 79 20 6f 66  |here's no way of|
000092f0  20 73 6b 69 70 70 69 6e  67 20 69 74 20 28 77 68  | skipping it (wh|
00009300  65 72 65 61 73 20 66 6f  72 20 44 72 61 77 2c 0a  |ereas for Draw,.|
00009310  20 20 20 74 68 65 20 73  69 7a 65 20 6f 66 20 74  |   the size of t|
00009320  68 65 20 6f 62 6a 65 63  74 20 69 73 20 73 70 65  |he object is spe|
00009330  63 69 66 69 65 64 20 69  6e 20 61 6e 20 6f 62 6a  |cified in an obj|
00009340  65 63 74 20 69 6e 64 65  70 2e 20 77 61 79 29 2e  |ect indep. way).|
00009350  20 41 70 70 6c 65 0a 20  20 20 70 72 65 73 65 6e  | Apple.   presen|
00009360  74 20 61 20 6c 61 72 67  65 20 74 61 62 6c 65 20  |t a large table |
00009370  6f 66 20 74 68 65 20 73  69 7a 65 73 20 6f 66 20  |of the sizes of |
00009380  74 68 65 20 6f 62 6a 65  63 74 73 20 28 30 30 30  |the objects (000|
00009390  30 20 2d 20 46 46 46 46  29 20 77 68 69 63 68 20  |0 - FFFF) which |
000093a0  69 73 0a 20 20 20 6e 6f  74 20 69 6e 20 43 68 61  |is.   not in Cha|
000093b0  6e 67 65 46 53 49 2e 20  43 6f 6e 73 65 71 75 65  |ngeFSI. Conseque|
000093c0  6e 74 6c 79 2c 20 69 66  20 43 68 61 6e 67 65 46  |ntly, if ChangeF|
000093d0  53 49 20 66 69 6e 64 73  20 61 6e 20 6f 62 6a 65  |SI finds an obje|
000093e0  63 74 20 69 74 20 64 6f  65 73 6e 27 74 0a 20 20  |ct it doesn't.  |
000093f0  20 6b 6e 6f 77 20 61 62  6f 75 74 20 62 65 66 6f  | know about befo|
00009400  72 65 20 74 68 65 20 70  69 63 74 75 72 65 2c 20  |re the picture, |
00009410  69 74 20 73 74 6f 70 73  2e 2e 2e 0a 20 2d 20 4f  |it stops.... - O|
00009420  6e 6c 79 20 50 61 63 6b  42 69 74 73 52 65 63 74  |nly PackBitsRect|
00009430  20 28 30 30 39 38 29 20  28 38 62 70 70 29 20 61  | (0098) (8bpp) a|
00009440  6e 64 20 44 69 72 65 63  74 42 69 74 73 52 65 63  |nd DirectBitsRec|
00009450  74 20 28 30 30 39 41 29  20 28 32 34 2f 33 32 20  |t (009A) (24/32 |
00009460  62 70 70 29 20 61 72 65  0a 20 20 20 61 6c 6c 6f  |bpp) are.   allo|
00009470  77 65 64 2e 0a 20 2b 20  43 68 61 6e 67 65 46 53  |wed.. + ChangeFS|
00009480  49 20 74 72 69 65 73 20  74 6f 20 73 6b 69 70 20  |I tries to skip |
00009490  61 20 43 6c 69 70 20 28  30 30 30 31 29 20 72 65  |a Clip (0001) re|
000094a0  67 69 6f 6e 20 69 66 20  69 74 20 65 6e 63 6f 75  |gion if it encou|
000094b0  6e 74 65 72 73 20 69 74  2c 20 73 69 6e 63 65 20  |nters it, since |
000094c0  69 74 0a 20 20 20 69 73  20 68 61 72 64 20 74 6f  |it.   is hard to|
000094d0  20 67 65 74 20 74 68 65  20 4d 61 63 20 4f 53 20  | get the Mac OS |
000094e0  74 6f 20 6d 61 6b 65 20  50 49 43 54 20 66 69 6c  |to make PICT fil|
000094f0  65 73 20 77 69 74 68 6f  75 74 20 61 20 63 6c 69  |es without a cli|
00009500  70 20 6f 70 63 6f 64 65  20 69 6e 20 74 68 65 6d  |p opcode in them|
00009510  2e 0a 20 2b 20 73 69 7a  65 20 6f 66 20 70 69 78  |.. + size of pix|
00009520  65 6c 20 73 70 65 63 69  66 69 65 64 2e 0a 20 2d  |el specified.. -|
00009530  20 4f 6e 6c 79 20 33 20  70 69 63 74 75 72 65 73  | Only 3 pictures|
00009540  20 72 65 61 64 20 2d 20  73 69 6e 63 65 20 74 68  | read - since th|
00009550  65 20 66 6f 72 6d 61 74  20 69 73 20 76 65 72 79  |e format is very|
00009560  20 63 6f 6d 70 6c 69 63  61 74 65 64 20 28 65 2e  | complicated (e.|
00009570  67 2e 20 74 68 65 20 73  69 7a 65 0a 20 20 20 6f  |g. the size.   o|
00009580  66 20 74 68 69 6e 67 73  20 63 68 61 6e 67 65 20  |f things change |
00009590  69 66 20 3e 32 35 30 20  72 6f 77 73 20 69 6e 20  |if >250 rows in |
000095a0  74 68 65 20 70 69 63 74  75 72 65 21 29 20 74 68  |the picture!) th|
000095b0  69 73 20 69 73 20 6e 6f  20 67 75 61 72 65 6e 74  |is is no guarent|
000095c0  65 65 20 74 68 61 74 0a  20 20 20 61 6e 79 74 68  |ee that.   anyth|
000095d0  69 6e 67 20 65 6c 73 65  20 77 69 6c 6c 20 62 65  |ing else will be|
000095e0  20 72 69 67 68 74 2e 0a  0a 54 68 65 20 5a 53 6f  | right...The ZSo|
000095f0  66 74 20 2e 50 43 58 20  66 6f 72 6d 61 74 0a 20  |ft .PCX format. |
00009600  55 73 65 64 20 62 79 20  50 43 20 50 61 69 6e 74  |Used by PC Paint|
00009610  62 72 75 73 68 2e 20 55  73 75 61 6c 6c 79 20 61  |brush. Usually a|
00009620  20 34 20 62 69 74 20 70  65 72 20 70 69 78 65 6c  | 4 bit per pixel|
00009630  20 69 6d 61 67 65 20 28  43 47 41 2c 20 45 47 41  | image (CGA, EGA|
00009640  2c 20 56 47 41 29 20 62  75 74 0a 20 63 61 6e 20  |, VGA) but. can |
00009650  62 65 20 31 2d 38 20 62  69 74 73 20 70 65 72 20  |be 1-8 bits per |
00009660  70 69 78 65 6c 2e 0a 20  2d 20 52 65 63 6f 67 6e  |pixel.. - Recogn|
00009670  69 73 65 64 20 62 79 20  31 30 2c 5b 30 2c 32 2c  |ised by 10,[0,2,|
00009680  33 2c 34 2c 35 5d 2c 31  20 61 74 20 73 74 61 72  |3,4,5],1 at star|
00009690  74 20 6f 66 20 66 69 6c  65 2e 20 4f 72 20 62 79  |t of file. Or by|
000096a0  20 6e 61 6d 65 20 50 43  58 2e 3c 66 6f 6f 3e 2e  | name PCX.<foo>.|
000096b0  20 4f 72 0a 20 20 20 62  79 20 74 79 70 65 20 26  | Or.   by type &|
000096c0  36 39 37 2e 0a 20 2b 20  49 6e 74 65 6c 6c 69 67  |697.. + Intellig|
000096d0  65 6e 74 20 63 68 65 63  6b 20 66 6f 72 20 72 65  |ent check for re|
000096e0  73 6f 6c 75 74 69 6f 6e  20 6f 66 20 74 68 65 20  |solution of the |
000096f0  44 41 43 73 20 6f 6e 20  74 68 65 20 50 43 20 63  |DACs on the PC c|
00009700  61 72 64 2e 20 55 73 65  20 2d 69 6e 66 6f 20 74  |ard. Use -info t|
00009710  6f 0a 20 20 20 66 69 6e  64 20 6f 75 74 20 77 68  |o.   find out wh|
00009720  61 74 20 43 68 61 6e 67  65 46 53 49 20 74 68 69  |at ChangeFSI thi|
00009730  6e 6b 73 20 69 74 20 69  73 2e 0a 20 2b 20 50 69  |nks it is.. + Pi|
00009740  78 65 6c 20 73 69 7a 65  20 69 6e 66 6f 72 6d 61  |xel size informa|
00009750  74 69 6f 6e 20 72 65 61  64 2e 20 59 6f 75 20 6d  |tion read. You m|
00009760  61 79 20 6e 65 65 64 20  74 6f 20 73 74 6f 70 20  |ay need to stop |
00009770  74 68 65 20 73 63 61 6c  69 6e 67 20 77 69 74 68  |the scaling with|
00009780  0a 20 20 20 2d 6e 6f 73  69 7a 65 2c 20 73 69 6e  |.   -nosize, sin|
00009790  63 65 20 69 74 73 20 6f  66 74 65 6e 20 77 72 6f  |ce its often wro|
000097a0  6e 67 2e 0a 0a 54 68 65  20 52 49 58 20 53 6f 66  |ng...The RIX Sof|
000097b0  74 77 6f 72 6b 73 20 43  6f 6c 6f 52 49 58 20 66  |tworks ColoRIX f|
000097c0  6f 72 6d 61 74 0a 20 55  73 65 64 20 62 79 20 56  |ormat. Used by V|
000097d0  47 41 20 50 61 69 6e 74  2c 20 69 6d 61 67 65 20  |GA Paint, image |
000097e0  65 78 74 65 6e 73 69 6f  6e 20 2e 53 43 45 20 2e  |extension .SCE .|
000097f0  2e 20 2e 53 43 58 2e 20  34 20 6f 72 20 38 20 62  |. .SCX. 4 or 8 b|
00009800  69 74 73 20 70 65 72 20  70 69 78 65 6c 2e 0a 20  |its per pixel.. |
00009810  2d 20 52 65 63 6f 67 6e  69 73 65 64 20 62 79 20  |- Recognised by |
00009820  22 52 49 58 33 22 20 61  74 20 73 74 61 72 74 20  |"RIX3" at start |
00009830  6f 66 20 66 69 6c 65 0a  20 2d 20 44 6f 63 75 6d  |of file. - Docum|
00009840  65 6e 74 61 74 69 6f 6e  20 6e 65 76 65 72 20 73  |entation never s|
00009850  65 65 6e 0a 20 2d 20 4f  6e 6c 79 20 35 20 66 69  |een. - Only 5 fi|
00009860  6c 65 73 20 72 65 61 64  3a 20 43 68 61 6e 67 65  |les read: Change|
00009870  46 53 49 20 63 68 65 63  6b 73 20 74 6f 20 73 65  |FSI checks to se|
00009880  65 20 69 66 20 74 68 65  20 68 65 61 64 65 72 20  |e if the header |
00009890  69 73 20 74 68 65 20 73  61 6d 65 0a 20 20 20 61  |is the same.   a|
000098a0  73 20 74 68 65 73 65 20  66 69 6c 65 73 20 61 6e  |s these files an|
000098b0  64 20 63 6f 6d 70 6c 61  69 6e 73 20 6f 74 68 65  |d complains othe|
000098c0  72 77 69 73 65 2e 0a 20  2d 20 4e 6f 20 72 65 73  |rwise.. - No res|
000098d0  6f 6c 75 74 69 6f 6e 20  73 70 65 63 69 66 69 65  |olution specifie|
000098e0  64 2c 20 65 71 75 61 6c  20 74 6f 20 6d 6f 64 65  |d, equal to mode|
000098f0  20 32 37 20 61 73 73 75  6d 65 64 0a 0a 54 68 65  | 27 assumed..The|
00009900  20 53 75 6e 20 22 70 69  78 72 65 63 74 22 20 66  | Sun "pixrect" f|
00009910  6f 72 6d 61 74 0a 20 55  73 65 64 20 75 6e 64 65  |ormat. Used unde|
00009920  72 20 53 75 6e 4f 53 20  61 6e 64 20 61 6c 73 6f  |r SunOS and also|
00009930  20 75 6e 64 65 72 20 58  31 31 2e 20 43 6f 6d 6d  | under X11. Comm|
00009940  6f 6e 6c 79 20 31 20 6f  72 20 38 20 62 69 74 73  |only 1 or 8 bits|
00009950  20 70 65 72 20 70 69 78  65 6c 2c 20 62 75 74 20  | per pixel, but |
00009960  75 70 0a 20 74 6f 20 32  34 20 62 69 74 73 20 70  |up. to 24 bits p|
00009970  65 72 20 70 69 78 65 6c  20 63 61 6e 20 62 65 20  |er pixel can be |
00009980  66 6f 75 6e 64 20 28 73  65 65 20 74 68 65 20 53  |found (see the S|
00009990  75 6e 20 4e 65 57 53 20  72 65 6c 65 61 73 65 20  |un NeWS release |
000099a0  74 61 70 65 21 29 2e 0a  20 2b 20 52 65 63 6f 67  |tape!).. + Recog|
000099b0  6e 69 73 65 64 20 62 79  20 26 35 39 41 35 35 41  |nised by &59A55A|
000099c0  39 35 20 61 74 20 74 68  65 20 73 74 61 72 74 20  |95 at the start |
000099d0  6f 66 20 74 68 65 20 66  69 6c 65 2e 0a 20 2d 20  |of the file.. - |
000099e0  4e 6f 20 72 65 73 6f 6c  75 74 69 6f 6e 20 73 70  |No resolution sp|
000099f0  65 63 69 66 69 65 64 2c  20 65 71 75 61 6c 20 74  |ecified, equal t|
00009a00  6f 20 6d 6f 64 65 20 32  37 20 61 73 73 75 6d 65  |o mode 27 assume|
00009a10  64 0a 20 2d 20 53 75 6e  20 64 69 64 6e 27 74 20  |d. - Sun didn't |
00009a20  73 70 65 63 69 66 79 20  74 68 65 20 70 69 78 65  |specify the pixe|
00009a30  6c 20 6f 72 64 65 72 69  6e 67 20 6f 66 20 32 34  |l ordering of 24|
00009a40  20 62 69 74 20 70 65 72  20 70 69 78 65 6c 20 69  | bit per pixel i|
00009a50  6d 61 67 65 73 3a 20 6d  61 6e 79 0a 20 20 20 61  |mages: many.   a|
00009a60  73 73 75 6d 65 20 52 47  42 20 77 68 65 6e 20 69  |ssume RGB when i|
00009a70  74 20 77 61 73 20 61 63  74 75 61 6c 6c 79 20 42  |t was actually B|
00009a80  47 52 2e 20 43 68 61 6e  67 65 20 62 79 74 65 20  |GR. Change byte |
00009a90  26 31 37 20 69 6e 20 74  68 65 20 53 75 6e 0a 20  |&17 in the Sun. |
00009aa0  20 20 72 61 73 74 65 72  66 69 6c 65 20 62 65 74  |  rasterfile bet|
00009ab0  77 65 65 6e 20 31 20 61  6e 64 20 33 20 69 66 20  |ween 1 and 3 if |
00009ac0  79 6f 75 20 68 61 76 65  20 61 20 70 72 6f 62 6c  |you have a probl|
00009ad0  65 6d 2e 0a 0a 54 68 65  20 22 70 62 6d 22 20 27  |em...The "pbm" '|
00009ae0  70 6f 72 74 61 62 6c 65  20 62 69 74 6d 61 70 27  |portable bitmap'|
00009af0  20 66 69 6c 65 20 66 6f  72 6d 61 74 0a 20 55 73  | file format. Us|
00009b00  65 64 20 62 79 20 74 68  65 20 22 50 42 4d 2d 50  |ed by the "PBM-P|
00009b10  4c 55 53 22 20 74 6f 6f  6c 6b 69 74 20 28 6d 61  |LUS" toolkit (ma|
00009b20  69 6e 6c 79 20 55 6e 69  78 29 20 62 79 20 4a 65  |inly Unix) by Je|
00009b30  66 20 50 6f 73 6b 61 6e  7a 65 72 2e 20 31 2d 32  |f Poskanzer. 1-2|
00009b40  34 20 62 69 74 73 0a 20  70 65 72 20 70 69 78 65  |4 bits. per pixe|
00009b50  6c 20 28 6d 6f 72 65 20  63 61 6e 20 62 65 20 73  |l (more can be s|
00009b60  70 65 63 69 66 69 65 64  20 69 6e 20 74 68 65 20  |pecified in the |
00009b70  66 6f 72 6d 61 74 20 62  75 74 20 43 68 61 6e 67  |format but Chang|
00009b80  65 46 53 49 20 63 61 6e  6e 6f 74 20 72 65 61 64  |eFSI cannot read|
00009b90  0a 20 74 68 65 6d 29 2e  20 43 68 61 6e 67 65 46  |. them). ChangeF|
00009ba0  53 49 20 63 61 6e 20 6f  6e 6c 79 20 72 65 61 64  |SI can only read|
00009bb0  20 74 68 65 20 22 52 41  57 42 49 54 53 22 20 66  | the "RAWBITS" f|
00009bc0  6f 72 6d 61 74 73 20 28  69 74 20 63 61 6e 20 77  |ormats (it can w|
00009bd0  72 69 74 65 20 61 6c 6c  20 6f 66 0a 20 74 68 65  |rite all of. the|
00009be0  20 70 62 6d 20 66 6f 72  6d 61 74 73 29 2e 0a 20  | pbm formats).. |
00009bf0  2b 20 52 65 63 6f 67 6e  69 73 65 64 20 62 79 20  |+ Recognised by |
00009c00  50 34 2f 50 35 2f 50 36  20 61 74 20 73 74 61 72  |P4/P5/P6 at star|
00009c10  74 20 6f 66 20 66 69 6c  65 2e 0a 20 2b 20 57 72  |t of file.. + Wr|
00009c20  69 74 61 62 6c 65 20 62  79 20 43 68 61 6e 67 65  |itable by Change|
00009c30  46 53 49 0a 20 2d 20 4e  6f 20 72 65 73 6f 6c 75  |FSI. - No resolu|
00009c40  74 69 6f 6e 20 73 70 65  63 69 66 69 65 64 2c 20  |tion specified, |
00009c50  65 71 75 61 6c 20 74 6f  20 6d 6f 64 65 20 32 37  |equal to mode 27|
00009c60  20 61 73 73 75 6d 65 64  0a 0a 54 68 65 20 55 4e  | assumed..The UN|
00009c70  49 58 20 22 72 6c 65 22  20 66 6f 72 6d 61 74 0a  |IX "rle" format.|
00009c80  20 55 73 65 64 20 62 79  20 61 20 70 72 6f 67 72  | Used by a progr|
00009c90  61 6d 20 63 61 6c 6c 65  64 20 22 73 76 66 62 22  |am called "svfb"|
00009ca0  20 74 6f 20 73 61 76 65  20 74 68 65 20 63 6f 6e  | to save the con|
00009cb0  74 65 6e 74 73 20 6f 66  20 6c 61 72 67 65 20 66  |tents of large f|
00009cc0  72 61 6d 65 0a 20 62 75  66 66 65 72 73 2c 20 63  |rame. buffers, c|
00009cd0  68 65 63 6b 65 64 20 77  69 74 68 20 66 6f 75 72  |hecked with four|
00009ce0  20 69 6d 61 67 65 73 20  61 74 20 32 34 20 62 69  | images at 24 bi|
00009cf0  74 73 20 70 65 72 20 70  69 78 65 6c 2e 0a 20 2b  |ts per pixel.. +|
00009d00  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 26  | Recognised by &|
00009d10  43 43 35 32 20 61 74 20  74 68 65 20 73 74 61 72  |CC52 at the star|
00009d20  74 20 6f 66 20 74 68 65  20 66 69 6c 65 2e 0a 20  |t of the file.. |
00009d30  2d 20 4e 6f 20 72 65 73  6f 6c 75 74 69 6f 6e 20  |- No resolution |
00009d40  73 70 65 63 69 66 69 65  64 2c 20 65 71 75 61 6c  |specified, equal|
00009d50  20 74 6f 20 6d 6f 64 65  20 32 37 20 61 73 73 75  | to mode 27 assu|
00009d60  6d 65 64 0a 0a 54 68 65  20 54 72 75 65 56 69 73  |med..The TrueVis|
00009d70  69 6f 6e 20 54 61 72 67  61 20 66 6f 72 6d 61 74  |ion Targa format|
00009d80  0a 20 55 73 65 64 20 62  79 20 54 72 75 65 56 69  |. Used by TrueVi|
00009d90  73 69 6f 6e 20 66 6f 72  20 56 69 73 74 61 20 62  |sion for Vista b|
00009da0  6f 61 72 64 73 2e 20 55  70 20 74 6f 20 33 32 20  |oards. Up to 32 |
00009db0  62 69 74 73 20 70 65 72  20 70 69 78 65 6c 2e 0a  |bits per pixel..|
00009dc0  20 2d 20 52 65 63 6f 67  6e 69 73 65 64 20 62 79  | - Recognised by|
00009dd0  20 73 75 66 66 69 78 20  5f 54 47 41 20 6f 72 20  | suffix _TGA or |
00009de0  5f 56 44 41 20 6f 6e 20  74 68 65 20 6e 61 6d 65  |_VDA on the name|
00009df0  2e 20 4f 72 20 62 79 20  74 79 70 65 20 26 36 39  |. Or by type &69|
00009e00  64 2e 0a 20 2d 20 4f 6e  6c 79 20 75 6e 63 6f 6d  |d.. - Only uncom|
00009e10  70 72 65 73 73 65 64 20  66 6f 72 6d 61 74 73 20  |pressed formats |
00009e20  72 65 61 64 61 62 6c 65  2e 0a 20 2d 20 4f 6e 6c  |readable.. - Onl|
00009e30  79 20 38 20 61 6e 64 20  31 36 20 62 69 74 20 70  |y 8 and 16 bit p|
00009e40  65 72 20 70 69 78 65 6c  20 66 6f 72 6d 61 74 73  |er pixel formats|
00009e50  20 74 65 73 74 65 64 2e  0a 0a 54 68 65 20 22 46  | tested...The "F|
00009e60  6c 65 78 69 62 6c 65 20  49 6d 61 67 65 20 54 72  |lexible Image Tr|
00009e70  61 6e 73 70 6f 72 74 20  53 79 73 74 65 6d 22 20  |ansport System" |
00009e80  28 46 49 54 53 29 20 66  6f 72 6d 61 74 0a 20 55  |(FITS) format. U|
00009e90  73 65 64 20 66 6f 72 20  61 73 74 72 6f 6e 6f 6d  |sed for astronom|
00009ea0  69 63 61 6c 20 64 61 74  61 2e 20 55 70 20 74 6f  |ical data. Up to|
00009eb0  20 31 36 20 62 69 74 73  20 70 65 72 20 70 69 78  | 16 bits per pix|
00009ec0  65 6c 20 63 6f 6d 70 6f  6e 65 6e 74 2e 0a 20 2b  |el component.. +|
00009ed0  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 22  | Recognised by "|
00009ee0  53 49 4d 50 4c 45 22 20  61 74 20 74 68 65 20 73  |SIMPLE" at the s|
00009ef0  74 61 72 74 20 6f 66 20  74 68 65 20 66 69 6c 65  |tart of the file|
00009f00  2e 0a 20 2d 20 4f 6e 6c  79 20 38 20 61 6e 64 20  |.. - Only 8 and |
00009f10  31 36 20 62 69 74 20 70  65 72 20 70 69 78 65 6c  |16 bit per pixel|
00009f20  20 63 6f 6d 70 6f 6e 65  6e 74 20 66 6f 72 6d 61  | component forma|
00009f30  74 73 20 74 65 73 74 65  64 2e 0a 20 2d 20 4f 6e  |ts tested.. - On|
00009f40  6c 79 20 74 77 6f 20 66  69 6c 65 73 20 65 76 65  |ly two files eve|
00009f50  72 20 73 65 65 6e 21 0a  20 2d 20 4e 6f 20 72 65  |r seen!. - No re|
00009f60  73 6f 6c 75 74 69 6f 6e  20 73 70 65 63 69 66 69  |solution specifi|
00009f70  65 64 2c 20 65 71 75 61  6c 20 74 6f 20 6d 6f 64  |ed, equal to mod|
00009f80  65 20 32 37 20 61 73 73  75 6d 65 64 0a 0a 54 68  |e 27 assumed..Th|
00009f90  65 20 49 72 6c 61 6d 20  69 6e 73 74 72 75 6d 65  |e Irlam instrume|
00009fa0  6e 74 73 20 63 6f 6c 6f  75 72 20 73 63 61 6e 6e  |nts colour scann|
00009fb0  65 72 20 66 6f 72 6d 61  74 0a 20 32 34 20 62 69  |er format. 24 bi|
00009fc0  74 20 70 65 72 20 70 69  78 65 6c 20 66 72 6f 6d  |t per pixel from|
00009fd0  20 63 6f 6c 6f 75 72 20  73 63 61 6e 6e 65 72 2e  | colour scanner.|
00009fe0  0a 20 2b 20 52 65 63 6f  67 6e 69 73 65 64 20 62  |. + Recognised b|
00009ff0  79 20 49 72 6c 61 6d 20  32 34 20 61 74 20 74 68  |y Irlam 24 at th|
0000a000  65 20 73 74 61 72 74 20  6f 66 20 74 68 65 20 66  |e start of the f|
0000a010  69 6c 65 2e 0a 20 2b 20  57 72 69 74 61 62 6c 65  |ile.. + Writable|
0000a020  20 62 79 20 43 68 61 6e  67 65 46 53 49 0a 20 2d  | by ChangeFSI. -|
0000a030  20 4e 6f 20 72 65 73 6f  6c 75 74 69 6f 6e 20 73  | No resolution s|
0000a040  70 65 63 69 66 69 65 64  2c 20 65 71 75 61 6c 20  |pecified, equal |
0000a050  74 6f 20 6d 6f 64 65 20  32 37 20 61 73 73 75 6d  |to mode 27 assum|
0000a060  65 64 0a 20 2d 20 6d 61  79 20 6e 65 65 64 20 67  |ed. - may need g|
0000a070  61 6d 6d 61 20 63 6f 72  72 65 63 74 69 6f 6e 0a  |amma correction.|
0000a080  0a 54 68 65 20 49 72 6c  61 6d 20 69 6e 73 74 72  |.The Irlam instr|
0000a090  75 6d 65 6e 74 73 20 59  55 56 20 34 31 31 20 63  |uments YUV 411 c|
0000a0a0  6f 6c 6f 75 72 20 76 69  64 65 6f 20 66 6f 72 6d  |olour video form|
0000a0b0  61 74 0a 20 37 20 62 69  74 73 20 59 2c 20 75 70  |at. 7 bits Y, up|
0000a0c0  20 74 6f 20 37 20 62 69  74 73 20 55 20 61 6e 64  | to 7 bits U and|
0000a0d0  20 56 2e 0a 20 2b 20 52  65 63 6f 67 6e 69 73 65  | V.. + Recognise|
0000a0e0  64 20 62 79 20 49 72 6c  61 6d 20 59 55 56 20 34  |d by Irlam YUV 4|
0000a0f0  31 31 20 61 74 20 74 68  65 20 73 74 61 72 74 20  |11 at the start |
0000a100  6f 66 20 74 68 65 20 66  69 6c 65 0a 20 2d 20 6e  |of the file. - n|
0000a110  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
0000a120  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
0000a130  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
0000a140  0a 0a 54 68 65 20 4a 50  45 47 20 27 4a 46 49 46  |..The JPEG 'JFIF|
0000a150  27 20 46 69 6c 65 20 49  6e 74 65 72 63 68 61 6e  |' File Interchan|
0000a160  67 65 20 46 6f 72 6d 61  74 0a 20 55 70 20 74 6f  |ge Format. Up to|
0000a170  20 32 34 20 62 69 74 73  20 52 2c 47 2c 42 2c 20  | 24 bits R,G,B, |
0000a180  63 6f 6d 70 72 65 73 73  65 64 20 62 79 20 74 68  |compressed by th|
0000a190  65 20 4a 50 45 47 20 63  6f 6d 70 72 65 73 73 69  |e JPEG compressi|
0000a1a0  6f 6e 20 73 79 73 74 65  6d 2e 0a 20 2b 20 52 65  |on system.. + Re|
0000a1b0  63 6f 67 6e 69 73 65 64  20 62 79 20 4a 46 49 46  |cognised by JFIF|
0000a1c0  20 61 74 20 70 6f 73 69  74 69 6f 6e 20 36 20 69  | at position 6 i|
0000a1d0  6e 20 74 68 65 20 66 69  6c 65 20 28 79 6f 75 20  |n the file (you |
0000a1e0  6d 61 79 20 68 61 76 65  20 74 6f 0a 20 20 20 63  |may have to.   c|
0000a1f0  75 74 20 68 65 61 64 65  72 73 20 6f 66 66 20 66  |ut headers off f|
0000a200  69 6c 65 73 2c 20 70 61  72 74 69 63 75 6c 61 72  |iles, particular|
0000a210  6c 79 20 69 66 20 74 68  65 79 20 61 72 65 20 66  |ly if they are f|
0000a220  72 6f 6d 20 4d 61 63 73  29 2e 0a 20 2b 20 4f 66  |rom Macs).. + Of|
0000a230  74 65 6e 20 68 69 67 68  6c 79 20 63 6f 6d 70 72  |ten highly compr|
0000a240  65 73 73 65 64 0a 20 2b  20 49 66 20 43 68 61 6e  |essed. + If Chan|
0000a250  67 65 46 53 49 24 43 61  63 68 65 20 69 73 20 6c  |geFSI$Cache is l|
0000a260  61 72 67 65 20 65 6e 6f  75 67 68 20 28 62 69 67  |arge enough (big|
0000a270  67 65 72 20 74 68 61 6e  20 74 68 65 20 66 69 6c  |ger than the fil|
0000a280  65 29 2c 20 74 68 65 6e  20 68 69 67 68 0a 20 20  |e), then high.  |
0000a290  20 73 70 65 65 64 20 72  6f 75 74 69 6e 65 73 20  | speed routines |
0000a2a0  61 72 65 20 75 73 65 64  20 74 6f 20 64 65 63 6f  |are used to deco|
0000a2b0  6d 70 72 65 73 73 2e 20  4f 74 68 65 72 77 69 73  |mpress. Otherwis|
0000a2c0  65 3a 0a 20 2d 20 43 68  61 6e 67 65 46 53 49 20  |e:. - ChangeFSI |
0000a2d0  63 61 6c 6c 73 20 61 20  64 6a 70 65 67 20 72 6f  |calls a djpeg ro|
0000a2e0  75 74 69 6e 65 2e 20 54  68 69 73 20 63 61 6e 20  |utine. This can |
0000a2f0  62 65 20 6f 6e 20 74 68  65 20 52 75 6e 24 50 61  |be on the Run$Pa|
0000a300  74 68 2c 20 69 6d 70 6c  65 6d 65 6e 74 65 64 0a  |th, implemented.|
0000a310  20 20 20 61 73 20 61 6e  20 41 6c 69 61 73 20 28  |   as an Alias (|
0000a320  69 6e 20 77 68 69 63 68  20 63 61 73 65 20 69 74  |in which case it|
0000a330  20 2a 6d 75 73 74 2a 20  75 73 65 20 57 69 6d 70  | *must* use Wimp|
0000a340  54 61 73 6b 20 74 6f 20  73 74 61 72 74 29 20 6f  |Task to start) o|
0000a350  72 20 66 6f 75 6e 64 0a  20 20 20 69 6e 73 69 64  |r found.   insid|
0000a360  65 20 43 68 61 6e 67 65  46 53 49 24 44 69 72 20  |e ChangeFSI$Dir |
0000a370  69 66 20 61 6c 6c 20 65  6c 73 65 20 66 61 69 6c  |if all else fail|
0000a380  73 2e 20 63 6a 70 65 67  20 28 74 68 65 20 63 6f  |s. cjpeg (the co|
0000a390  6d 70 72 65 73 73 6f 72  29 20 69 73 20 61 6c 73  |mpressor) is als|
0000a3a0  6f 0a 20 20 20 61 76 61  69 6c 61 62 6c 65 20 69  |o.   available i|
0000a3b0  6e 73 69 64 65 20 43 68  61 6e 67 65 46 53 49 24  |nside ChangeFSI$|
0000a3c0  44 69 72 20 2d 20 79 6f  75 20 77 69 6c 6c 20 6e  |Dir - you will n|
0000a3d0  65 65 64 20 74 6f 20 63  6f 6e 76 65 72 74 20 74  |eed to convert t|
0000a3e0  68 65 20 69 6d 61 67 65  20 74 6f 0a 20 20 20 50  |he image to.   P|
0000a3f0  36 20 66 6f 72 6d 61 74  20 62 65 66 6f 72 65 20  |6 format before |
0000a400  69 74 20 63 61 6e 20 62  65 20 63 6f 6d 70 72 65  |it can be compre|
0000a410  73 73 65 64 2e 20 44 6a  70 65 67 20 61 6e 64 20  |ssed. Djpeg and |
0000a420  63 6a 70 65 67 20 61 72  65 20 62 79 20 74 68 65  |cjpeg are by the|
0000a430  0a 20 20 20 50 44 20 4a  50 45 47 20 67 72 6f 75  |.   PD JPEG grou|
0000a440  70 2e 0a 20 2d 20 2e 2e  2e 20 61 6e 64 20 74 68  |p.. - ... and th|
0000a450  65 72 65 66 6f 72 65 20  73 6c 6f 77 2e 20 4e 65  |erefore slow. Ne|
0000a460  65 64 73 20 61 20 6c 6f  74 20 6f 66 20 73 70 61  |eds a lot of spa|
0000a470  63 65 20 69 6e 20 3c 57  69 6d 70 24 53 63 72 61  |ce in <Wimp$Scra|
0000a480  70 3e 2e 0a 20 2d 20 6e  6f 20 72 65 73 6f 6c 75  |p>.. - no resolu|
0000a490  74 69 6f 6e 20 73 70 65  63 69 66 69 65 64 2c 20  |tion specified, |
0000a4a0  65 71 75 61 6c 20 74 6f  20 6d 6f 64 65 20 32 37  |equal to mode 27|
0000a4b0  20 61 73 73 75 6d 65 64  0a 0a 54 68 65 20 52 6f  | assumed..The Ro|
0000a4c0  6e 61 6c 64 20 41 6c 70  69 61 72 20 33 36 20 61  |nald Alpiar 36 a|
0000a4d0  6e 64 20 34 38 20 62 69  74 20 70 65 72 20 70 69  |nd 48 bit per pi|
0000a4e0  78 65 6c 20 66 6f 72 6d  61 74 73 0a 20 31 32 20  |xel formats. 12 |
0000a4f0  61 6e 64 20 31 36 20 62  69 74 73 20 66 6f 72 20  |and 16 bits for |
0000a500  65 61 63 68 20 6f 66 20  52 2c 47 2c 42 2c 20 75  |each of R,G,B, u|
0000a510  6e 63 6f 6d 70 72 65 73  73 65 64 0a 20 2b 20 52  |ncompressed. + R|
0000a520  65 63 6f 67 6e 69 73 65  64 20 62 79 20 41 4c 50  |ecognised by ALP|
0000a530  49 41 52 31 32 20 6f 72  20 41 4c 50 49 41 52 31  |IAR12 or ALPIAR1|
0000a540  36 20 61 74 20 73 74 61  72 74 20 6f 66 20 66 69  |6 at start of fi|
0000a550  6c 65 0a 20 2b 20 66 6f  6c 6c 6f 77 65 64 20 62  |le. + followed b|
0000a560  79 20 6c 69 74 74 6c 65  20 65 6e 64 69 61 6e 20  |y little endian |
0000a570  77 6f 72 64 20 6f 66 20  58 20 73 69 7a 65 20 61  |word of X size a|
0000a580  6e 64 20 77 6f 72 64 20  6f 66 20 59 20 73 69 7a  |nd word of Y siz|
0000a590  65 0a 20 2b 20 66 6f 6c  6c 6f 77 65 64 20 62 79  |e. + followed by|
0000a5a0  20 72 2c 67 2c 62 20 61  73 20 6c 69 74 74 6c 65  | r,g,b as little|
0000a5b0  20 65 6e 64 69 61 6e 20  68 61 6c 66 20 77 6f 72  | endian half wor|
0000a5c0  64 73 0a 20 2d 20 6e 6f  20 72 65 73 6f 6c 75 74  |ds. - no resolut|
0000a5d0  69 6f 6e 20 73 70 65 63  69 66 69 65 64 2c 20 65  |ion specified, e|
0000a5e0  71 75 61 6c 20 74 6f 20  6d 6f 64 65 20 32 37 20  |qual to mode 27 |
0000a5f0  61 73 73 75 6d 65 64 0a  0a 54 68 65 20 62 74 70  |assumed..The btp|
0000a600  63 20 66 69 6c 65 20 66  6f 72 6d 61 74 0a 20 55  |c file format. U|
0000a610  70 20 74 6f 20 32 34 20  62 69 74 73 20 52 2c 47  |p to 24 bits R,G|
0000a620  2c 42 2c 20 63 6f 6d 70  72 65 73 73 65 64 20 62  |,B, compressed b|
0000a630  79 20 74 68 65 20 62 74  70 63 20 63 6f 6d 70 72  |y the btpc compr|
0000a640  65 73 73 69 6f 6e 20 73  79 73 74 65 6d 0a 20 2b  |ession system. +|
0000a650  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 62  | Recognised by b|
0000a660  74 70 63 20 61 74 20 73  74 61 72 74 20 6f 66 20  |tpc at start of |
0000a670  74 68 65 20 66 69 6c 65  0a 20 2b 20 48 69 67 68  |the file. + High|
0000a680  6c 79 20 63 6f 6d 70 72  65 73 73 65 64 20 28 73  |ly compressed (s|
0000a690  6f 6d 65 74 69 6d 65 73  20 6d 6f 72 65 20 74 68  |ometimes more th|
0000a6a0  61 6e 20 4a 50 45 47 29  0a 20 2d 20 43 68 61 6e  |an JPEG). - Chan|
0000a6b0  67 65 46 53 49 20 63 61  6c 6c 73 20 61 20 28 73  |geFSI calls a (s|
0000a6c0  6c 6f 77 29 20 64 62 74  70 63 20 72 6f 75 74 69  |low) dbtpc routi|
0000a6d0  6e 65 0a 20 2d 20 6e 6f  20 72 65 73 6f 6c 75 74  |ne. - no resolut|
0000a6e0  69 6f 6e 20 73 70 65 63  69 66 69 65 64 2c 20 65  |ion specified, e|
0000a6f0  71 75 61 6c 20 74 6f 20  6d 6f 64 65 20 32 37 20  |qual to mode 27 |
0000a700  61 73 73 75 6d 65 64 0a  0a 3e 3e 20 54 68 65 20  |assumed..>> The |
0000a710  66 6f 6c 6c 6f 77 69 6e  67 20 66 69 6c 65 20 66  |following file f|
0000a720  6f 72 6d 61 74 73 20 61  72 65 20 6f 6e 6c 79 20  |ormats are only |
0000a730  72 65 63 6f 67 6e 69 73  65 64 20 62 79 20 74 68  |recognised by th|
0000a740  65 69 72 20 6e 61 6d 65  73 2e 0a 0a 41 6e 20 75  |eir names...An u|
0000a750  6e 6b 6e 6f 77 6e 20 50  43 20 2e 44 53 50 20 66  |nknown PC .DSP f|
0000a760  6f 72 6d 61 74 0a 20 45  78 70 65 72 69 6d 65 6e  |ormat. Experimen|
0000a770  74 61 6c 6c 79 20 64 65  74 65 72 6d 69 6e 65 64  |tally determined|
0000a780  20 74 68 61 74 20 69 74  20 68 6f 6c 64 73 20 61  | that it holds a|
0000a790  20 36 34 30 20 62 79 20  33 35 30 20 45 47 41 20  | 640 by 350 EGA |
0000a7a0  70 69 63 74 75 72 65 20  61 74 20 34 20 62 69 74  |picture at 4 bit|
0000a7b0  73 0a 20 70 65 72 20 70  69 78 65 6c 2e 20 43 68  |s. per pixel. Ch|
0000a7c0  61 6e 67 65 46 53 49 20  22 6b 6e 6f 77 73 22 20  |angeFSI "knows" |
0000a7d0  74 68 65 20 64 65 66 61  75 6c 74 20 45 47 41 20  |the default EGA |
0000a7e0  70 61 6c 65 74 74 65 20  28 66 72 6f 6d 20 49 42  |palette (from IB|
0000a7f0  4d 20 6c 69 74 65 72 61  74 75 72 65 29 2e 0a 20  |M literature).. |
0000a800  2d 20 52 65 63 6f 67 6e  69 73 65 64 20 62 79 20  |- Recognised by |
0000a810  62 65 69 6e 67 20 69 6e  20 61 20 64 69 72 65 63  |being in a direc|
0000a820  74 6f 72 79 20 22 44 53  50 22 0a 20 2d 20 44 6f  |tory "DSP". - Do|
0000a830  63 75 6d 65 6e 74 61 74  69 6f 6e 20 6e 65 76 65  |cumentation neve|
0000a840  72 20 73 65 65 6e 0a 20  2d 20 4e 6f 20 72 65 73  |r seen. - No res|
0000a850  6f 6c 75 74 69 6f 6e 20  73 70 65 63 69 66 69 65  |olution specifie|
0000a860  64 2c 20 65 71 75 61 6c  20 74 6f 20 6d 6f 64 65  |d, equal to mode|
0000a870  20 32 37 20 61 73 73 75  6d 65 64 0a 20 2d 20 4f  | 27 assumed. - O|
0000a880  6e 6c 79 20 74 77 6f 20  65 78 61 6d 70 6c 65 73  |nly two examples|
0000a890  20 72 65 61 64 28 21 29  0a 0a 54 68 65 20 51 52  | read(!)..The QR|
0000a8a0  54 20 2e 72 61 77 20 66  6f 72 6d 61 74 0a 20 4f  |T .raw format. O|
0000a8b0  75 74 70 75 74 20 66 72  6f 6d 20 53 74 65 76 65  |utput from Steve|
0000a8c0  20 4b 6f 72 65 6e 27 73  20 70 75 62 6c 69 63 20  | Koren's public |
0000a8d0  64 6f 6d 61 69 6e 20 72  61 79 20 74 72 61 63 65  |domain ray trace|
0000a8e0  72 3a 20 61 72 62 69 74  72 61 72 79 20 73 69 7a  |r: arbitrary siz|
0000a8f0  65 20 69 6e 20 32 5e 32  34 0a 20 63 6f 6c 6f 75  |e in 2^24. colou|
0000a900  72 73 2c 20 75 6e 63 6f  6d 70 72 65 73 73 65 64  |rs, uncompressed|
0000a910  2e 20 44 6f 63 75 6d 65  6e 74 61 74 69 6f 6e 20  |. Documentation |
0000a920  70 61 72 74 20 6f 66 20  51 52 54 2e 0a 20 2d 20  |part of QRT.. - |
0000a930  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 74 68  |Recognised by th|
0000a940  65 20 6e 61 6d 65 20 65  6e 64 69 6e 67 20 22 2e  |e name ending ".|
0000a950  52 61 77 22 2e 20 4f 72  20 62 79 20 74 79 70 65  |Raw". Or by type|
0000a960  20 26 36 39 38 2e 0a 20  2d 20 4e 6f 20 72 65 73  | &698.. - No res|
0000a970  6f 6c 75 74 69 6f 6e 20  73 70 65 63 69 66 69 65  |olution specifie|
0000a980  64 2c 20 65 71 75 61 6c  20 74 6f 20 6d 6f 64 65  |d, equal to mode|
0000a990  20 32 37 20 61 73 73 75  6d 65 64 0a 0a 54 68 65  | 27 assumed..The|
0000a9a0  20 4d 54 56 20 70 69 63  2e 20 66 6f 72 6d 61 74  | MTV pic. format|
0000a9b0  0a 20 4f 75 74 70 75 74  20 66 72 6f 6d 20 4d 61  |. Output from Ma|
0000a9c0  72 6b 20 54 65 72 72 65  6e 63 65 20 56 61 6e 64  |rk Terrence Vand|
0000a9d0  65 57 65 74 74 65 72 69  6e 67 20 70 75 62 6c 69  |eWettering publi|
0000a9e0  63 20 64 6f 6d 61 69 6e  20 72 61 79 20 74 72 61  |c domain ray tra|
0000a9f0  63 65 72 20 61 72 62 69  74 72 61 72 79 0a 20 73  |cer arbitrary. s|
0000aa00  69 7a 65 20 69 6e 20 32  5e 32 34 20 63 6f 6c 6f  |ize in 2^24 colo|
0000aa10  75 72 73 2c 20 75 6e 63  6f 6d 70 72 65 73 73 65  |urs, uncompresse|
0000aa20  64 2e 20 44 6f 63 75 6d  65 6e 74 61 74 69 6f 6e  |d. Documentation|
0000aa30  20 70 61 72 74 20 6f 66  20 4d 54 56 2e 20 41 6c  | part of MTV. Al|
0000aa40  73 6f 20 75 73 65 64 20  62 79 0a 20 22 52 61 79  |so used by. "Ray|
0000aa50  53 68 61 64 65 22 2e 0a  20 2d 20 52 65 63 6f 67  |Shade".. - Recog|
0000aa60  6e 69 73 65 64 20 62 79  20 62 65 69 6e 67 20 69  |nised by being i|
0000aa70  6e 20 61 20 64 69 72 65  63 74 6f 72 79 20 22 50  |n a directory "P|
0000aa80  69 63 2e 22 2e 20 4f 72  20 62 79 20 74 79 70 65  |ic.". Or by type|
0000aa90  20 26 36 39 39 2e 0a 20  2d 20 4e 6f 20 72 65 73  | &699.. - No res|
0000aaa0  6f 6c 75 74 69 6f 6e 20  73 70 65 63 69 66 69 65  |olution specifie|
0000aab0  64 2c 20 65 71 75 61 6c  20 74 6f 20 6d 6f 64 65  |d, equal to mode|
0000aac0  20 32 37 20 61 73 73 75  6d 65 64 0a 0a 54 68 65  | 27 assumed..The|
0000aad0  20 52 54 20 69 6d 61 67  65 2e 20 66 6f 72 6d 61  | RT image. forma|
0000aae0  74 0a 20 4f 75 74 70 75  74 20 66 72 6f 6d 20 22  |t. Output from "|
0000aaf0  52 54 22 2c 20 61 20 70  72 69 76 61 74 65 20 72  |RT", a private r|
0000ab00  61 79 20 74 72 61 63 65  72 20 62 79 20 42 72 69  |ay tracer by Bri|
0000ab10  61 6e 20 44 20 57 61 74  74 28 3f 29 20 61 72 62  |an D Watt(?) arb|
0000ab20  69 74 72 61 72 79 20 73  69 7a 65 20 69 6e 0a 20  |itrary size in. |
0000ab30  32 5e 32 34 20 63 6f 6c  6f 75 72 73 2c 20 72 75  |2^24 colours, ru|
0000ab40  6e 20 6c 65 6e 67 74 68  20 65 6e 63 6f 64 65 64  |n length encoded|
0000ab50  2e 0a 20 2d 20 52 65 63  6f 67 6e 69 73 65 64 20  |.. - Recognised |
0000ab60  62 79 20 62 65 69 6e 67  20 69 6e 20 61 20 64 69  |by being in a di|
0000ab70  72 65 63 74 6f 72 79 20  22 49 6d 61 67 65 2e 22  |rectory "Image."|
0000ab80  0a 20 2d 20 4e 6f 20 72  65 73 6f 6c 75 74 69 6f  |. - No resolutio|
0000ab90  6e 20 73 70 65 63 69 66  69 65 64 2c 20 65 71 75  |n specified, equ|
0000aba0  61 6c 20 74 6f 20 6d 6f  64 65 20 32 37 20 61 73  |al to mode 27 as|
0000abb0  73 75 6d 65 64 0a 0a 46  6f 72 20 6d 61 6e 79 20  |sumed..For many |
0000abc0  6f 66 20 74 68 65 73 65  20 66 6f 72 6d 61 74 73  |of these formats|
0000abd0  2c 20 65 73 70 65 63 69  61 6c 6c 79 20 74 68 65  |, especially the|
0000abe0  20 75 6e 63 6f 6d 70 72  65 73 73 65 64 20 6f 6e  | uncompressed on|
0000abf0  65 73 2c 20 73 65 74 74  69 6e 67 20 74 68 65 0a  |es, setting the.|
0000ac00  76 61 72 69 61 62 6c 65  20 22 43 68 61 6e 67 65  |variable "Change|
0000ac10  46 53 49 24 43 61 63 68  65 22 20 74 6f 20 74 68  |FSI$Cache" to th|
0000ac20  65 20 6e 75 6d 62 65 72  20 6f 66 20 62 79 74 65  |e number of byte|
0000ac30  73 20 6f 66 20 74 65 6d  70 6f 72 61 72 79 20 6d  |s of temporary m|
0000ac40  65 6d 6f 72 79 20 79 6f  75 0a 77 69 73 68 20 74  |emory you.wish t|
0000ac50  68 65 20 70 72 6f 67 72  61 6d 20 74 6f 20 75 73  |he program to us|
0000ac60  65 20 77 69 6c 6c 20 73  70 65 65 64 20 75 70 20  |e will speed up |
0000ac70  72 65 61 64 69 6e 67 20  74 68 65 20 69 6e 66 6f  |reading the info|
0000ac80  72 6d 61 74 69 6f 6e 2e  20 54 68 65 20 64 65 66  |rmation. The def|
0000ac90  61 75 6c 74 0a 69 73 20  34 39 31 35 32 20 62 79  |ault.is 49152 by|
0000aca0  74 65 73 2e 20 46 6f 72  20 65 78 61 6d 70 6c 65  |tes. For example|
0000acb0  20 22 2a 73 65 74 20 43  68 61 6e 67 65 46 53 49  | "*set ChangeFSI|
0000acc0  24 43 61 63 68 65 20 38  30 6b 22 2e 20 46 6f 72  |$Cache 80k". For|
0000acd0  20 74 68 6f 73 65 20 77  6f 72 72 69 65 64 0a 61  | those worried.a|
0000ace0  62 6f 75 74 20 73 70 65  65 64 2c 20 74 68 65 20  |bout speed, the |
0000acf0  70 72 6f 67 72 61 6d 20  77 69 6c 6c 20 67 6f 20  |program will go |
0000ad00  66 61 73 74 65 72 20 69  66 3a 0a 0a 20 2d 20 79  |faster if:.. - y|
0000ad10  6f 75 20 75 73 65 20 2d  6e 6f 73 63 61 6c 65 20  |ou use -noscale |
0000ad20  61 6e 64 20 6b 65 65 70  20 31 3a 31 20 72 61 74  |and keep 1:1 rat|
0000ad30  69 6f 73 20 28 64 6f 6e  27 74 20 73 70 65 63 69  |ios (don't speci|
0000ad40  66 79 20 74 68 65 6d 29  0a 20 20 20 28 61 6c 74  |fy them).   (alt|
0000ad50  68 6f 75 67 68 20 2d 6e  6f 73 69 7a 65 20 61 6e  |hough -nosize an|
0000ad60  64 20 31 3a 31 20 6f 72  20 31 3a 32 20 72 61 74  |d 1:1 or 1:2 rat|
0000ad70  69 6f 73 20 61 72 65 20  71 75 69 63 6b 2c 20 74  |ios are quick, t|
0000ad80  6f 6f 29 0a 20 2d 20 79  6f 75 20 64 6f 6e 27 74  |oo). - you don't|
0000ad90  20 6e 65 65 64 20 73 68  61 72 70 65 6e 69 6e 67  | need sharpening|
0000ada0  2f 73 6d 6f 6f 74 68 69  6e 67 2c 20 68 69 73 74  |/smoothing, hist|
0000adb0  6f 67 72 61 6d 20 65 71  75 61 6c 69 73 61 74 69  |ogram equalisati|
0000adc0  6f 6e 2c 20 72 61 6e 67  65 20 65 78 70 61 6e 73  |on, range expans|
0000add0  69 6f 6e 0a 20 2d 20 79  6f 75 20 75 73 65 20 6d  |ion. - you use m|
0000ade0  6f 6e 6f 63 68 72 6f 6d  65 20 28 65 2e 67 2e 20  |onochrome (e.g. |
0000adf0  32 35 2c 20 32 36 2c 20  32 37 20 61 6e 64 20 32  |25, 26, 27 and 2|
0000ae00  37 74 29 20 6d 6f 64 65  73 0a 0a 61 64 64 69 74  |7t) modes..addit|
0000ae10  69 6f 6e 61 6c 6c 79 20  79 6f 75 20 63 61 6e 20  |ionally you can |
0000ae20  64 69 73 61 62 6c 65 20  64 69 74 68 65 72 69 6e  |disable ditherin|
0000ae30  67 20 28 2d 6e 6f 64 69  74 68 65 72 29 20 65 73  |g (-nodither) es|
0000ae40  70 65 63 69 61 6c 6c 79  20 77 68 65 6e 20 72 65  |pecially when re|
0000ae50  61 64 69 6e 67 0a 6d 6f  6e 6f 63 68 72 6f 6d 65  |ading.monochrome|
0000ae60  20 73 6f 75 72 63 65 2e  0a 0a 59 6f 75 20 63 61  | source...You ca|
0000ae70  6e 20 61 76 6f 69 64 20  74 68 65 20 70 72 6f 67  |n avoid the prog|
0000ae80  72 61 6d 20 63 68 61 6e  67 69 6e 67 20 6d 6f 64  |ram changing mod|
0000ae90  65 20 62 79 20 70 75 74  74 69 6e 67 20 2d 6e 6f  |e by putting -no|
0000aea0  6d 6f 64 65 20 6f 6e 20  74 68 65 20 63 6f 6d 6d  |mode on the comm|
0000aeb0  61 6e 64 20 6c 69 6e 65  2e 0a 0a 56 65 72 79 20  |and line...Very |
0000aec0  6c 61 72 67 65 20 6f 75  74 70 75 74 20 66 69 6c  |large output fil|
0000aed0  65 73 20 63 61 6e 20 62  65 20 62 75 69 6c 74 20  |es can be built |
0000aee0  73 74 72 69 70 73 20 61  74 20 61 20 74 69 6d 65  |strips at a time|
0000aef0  20 61 6e 64 20 73 65 6e  74 20 64 69 72 65 63 74  | and sent direct|
0000af00  6c 79 20 74 6f 20 64 69  73 6b 0a 75 73 69 6e 67  |ly to disk.using|
0000af10  20 74 68 65 20 70 61 72  61 6d 65 74 65 72 20 22  | the parameter "|
0000af20  2d 6d 61 78 22 20 65 2e  67 3a 0a 0a 20 20 43 68  |-max" e.g:..  Ch|
0000af30  61 6e 67 65 46 53 49 20  3c 69 6e 3e 20 3c 6f 75  |angeFSI <in> <ou|
0000af40  74 3e 20 32 38 20 2d 6d  61 78 35 31 32 4b 0a 0a  |t> 28 -max512K..|
0000af50  77 69 6c 6c 20 63 6f 6e  76 65 72 74 20 74 68 65  |will convert the|
0000af60  20 66 69 6c 65 20 77 69  74 68 20 61 20 6d 61 78  | file with a max|
0000af70  69 6d 75 6d 20 6f 66 20  35 31 32 4b 42 79 74 65  |imum of 512KByte|
0000af80  73 20 68 65 6c 64 20 69  6e 20 6d 65 6d 6f 72 79  |s held in memory|
0000af90  2e 20 4f 70 74 69 6f 6e  73 20 32 35 74 2c 0a 2d  |. Options 25t,.-|
0000afa0  72 6f 74 61 74 65 20 61  6e 64 20 2d 76 66 6c 69  |rotate and -vfli|
0000afb0  70 20 64 6f 6e 27 74 20  77 6f 72 6b 20 77 68 65  |p don't work whe|
0000afc0  6e 20 74 68 69 73 20 69  73 20 62 65 69 6e 67 20  |n this is being |
0000afd0  64 6f 6e 65 2e 0a 0a 57  6f 72 6b 20 77 69 6c 6c  |done...Work will|
0000afe0  20 62 65 20 64 6f 6e 65  20 6f 6e 20 6f 74 68 65  | be done on othe|
0000aff0  72 20 66 6f 72 6d 61 74  73 20 77 68 65 6e 20 61  |r formats when a|
0000b000  6e 64 20 69 66 20 62 6f  74 68 20 69 6d 61 67 65  |nd if both image|
0000b010  20 61 6e 64 20 64 6f 63  75 6d 65 6e 74 61 74 69  | and documentati|
0000b020  6f 6e 0a 61 72 72 69 76  65 20 61 74 20 41 63 6f  |on.arrive at Aco|
0000b030  72 6e 2e 20 41 64 64 69  6e 67 20 61 20 6e 65 77  |rn. Adding a new|
0000b040  20 66 6f 72 6d 61 74 20  69 73 20 61 20 6d 61 74  | format is a mat|
0000b050  74 65 72 20 6f 66 20 28  61 29 20 70 75 74 74 69  |ter of (a) putti|
0000b060  6e 67 20 69 6e 20 61 75  74 6f 6d 61 74 69 63 0a  |ng in automatic.|
0000b070  72 65 63 6f 67 6e 69 74  69 6f 6e 20 6f 66 20 74  |recognition of t|
0000b080  68 65 20 66 6f 72 6d 61  74 20 61 74 20 74 68 65  |he format at the|
0000b090  20 73 74 61 72 74 20 6f  66 20 74 68 65 20 70 72  | start of the pr|
0000b0a0  6f 67 72 61 6d 20 28 62  29 20 72 65 61 64 69 6e  |ogram (b) readin|
0000b0b0  67 20 74 68 65 20 73 69  7a 65 20 6f 66 0a 74 68  |g the size of.th|
0000b0c0  65 20 69 6d 61 67 65 20  61 6e 64 20 74 68 65 20  |e image and the |
0000b0d0  63 6f 6c 6f 75 72 20 70  61 6c 65 74 74 65 20 6d  |colour palette m|
0000b0e0  61 70 70 69 6e 67 20 5b  69 6e 20 74 68 65 20 6e  |apping [in the n|
0000b0f0  65 78 74 20 73 65 63 74  69 6f 6e 20 6f 66 20 74  |ext section of t|
0000b100  68 65 20 70 72 6f 67 72  61 6d 5d 0a 28 63 29 20  |he program].(c) |
0000b110  77 72 69 74 69 6e 67 20  61 20 22 72 65 61 64 20  |writing a "read |
0000b120  70 69 78 65 6c 20 72 6f  77 22 20 65 6c 65 6d 65  |pixel row" eleme|
0000b130  6e 74 20 69 6e 73 69 64  65 20 50 52 4f 43 69 70  |nt inside PROCip|
0000b140  72 6f 77 20 28 64 29 20  70 72 6f 76 69 64 69 6e  |row (d) providin|
0000b150  67 20 61 6e 20 65 6e 74  72 79 0a 69 6e 20 50 52  |g an entry.in PR|
0000b160  4f 43 72 65 77 69 6e 64  2e 20 49 66 20 79 6f 75  |OCrewind. If you|
0000b170  20 77 72 69 74 65 20 61  20 6e 65 77 20 66 6f 72  | write a new for|
0000b180  6d 61 74 20 69 6e 74 65  72 66 61 63 65 2c 20 70  |mat interface, p|
0000b190  6c 65 61 73 65 20 73 65  6e 64 20 69 74 20 74 6f  |lease send it to|
0000b1a0  20 6d 65 20 73 6f 0a 74  68 61 74 20 69 74 20 77  | me so.that it w|
0000b1b0  69 6c 6c 20 62 65 20 69  6e 63 6c 75 64 65 64 20  |ill be included |
0000b1c0  69 6e 20 6c 61 74 65 72  20 76 65 72 73 69 6f 6e  |in later version|
0000b1d0  73 2e 20 43 68 61 6e 67  65 46 53 49 20 68 61 73  |s. ChangeFSI has|
0000b1e0  20 61 6c 72 65 61 64 79  20 67 6f 74 20 63 6f 64  | already got cod|
0000b1f0  65 20 66 6f 72 0a 64 65  61 6c 69 6e 67 20 77 69  |e for.dealing wi|
0000b200  74 68 20 69 6d 61 67 65  73 20 77 69 74 68 20 31  |th images with 1|
0000b210  2c 20 32 2c 20 34 20 61  6e 64 20 38 20 62 69 74  |, 2, 4 and 8 bit|
0000b220  73 20 70 65 72 20 70 69  78 65 6c 20 70 61 63 6b  |s per pixel pack|
0000b230  65 64 20 69 6e 74 6f 20  62 79 74 65 73 20 61 6e  |ed into bytes an|
0000b240  64 20 66 6f 72 0a 69 6d  61 67 65 73 20 77 69 74  |d for.images wit|
0000b250  68 20 75 70 20 74 6f 20  38 20 62 69 74 20 70 6c  |h up to 8 bit pl|
0000b260  61 6e 65 73 2e 20 54 68  65 72 65 20 69 73 20 73  |anes. There is s|
0000b270  75 70 70 6f 72 74 20 63  6f 64 65 20 66 6f 72 20  |upport code for |
0000b280  4c 5a 57 20 64 65 63 6f  6d 70 72 65 73 73 69 6f  |LZW decompressio|
0000b290  6e 20 61 6e 64 0a 4c 5a  57 20 64 65 63 6f 64 69  |n and.LZW decodi|
0000b2a0  6e 67 2e 0a 0a 41 73 20  61 20 73 70 65 63 69 61  |ng...As a specia|
0000b2b0  6c 20 66 65 61 74 75 72  65 2c 20 43 68 61 6e 67  |l feature, Chang|
0000b2c0  65 46 53 49 20 77 69 6c  6c 20 61 6c 73 6f 20 77  |eFSI will also w|
0000b2d0  72 69 74 65 20 6f 75 74  20 32 35 36 20 67 72 65  |rite out 256 gre|
0000b2e0  79 20 6c 65 76 65 6c 20  66 69 6c 65 73 20 28 61  |y level files (a|
0000b2f0  6c 74 65 72 0a 72 77 74  2c 20 67 77 74 20 61 6e  |lter.rwt, gwt an|
0000b300  64 20 62 77 74 20 74 6f  20 67 65 74 20 32 35 36  |d bwt to get 256|
0000b310  20 6c 65 76 65 6c 20 63  6f 6c 6f 75 72 20 73 65  | level colour se|
0000b320  70 61 72 61 74 69 6f 6e  73 29 20 69 6e 20 41 49  |parations) in AI|
0000b330  4d 20 66 6f 72 6d 61 74  2e 20 54 68 69 73 20 69  |M format. This i|
0000b340  73 0a 66 69 6c 65 20 74  79 70 65 20 34 20 77 69  |s.file type 4 wi|
0000b350  74 68 20 62 79 74 65 73  20 72 65 70 72 65 73 65  |th bytes represe|
0000b360  6e 74 69 6e 67 20 74 68  65 20 67 72 65 79 20 6c  |nting the grey l|
0000b370  65 76 65 6c 2e 20 55 73  65 20 74 68 65 20 3d 20  |evel. Use the = |
0000b380  6f 70 65 72 61 74 69 6f  6e 20 74 6f 0a 72 65 73  |operation to.res|
0000b390  74 72 69 63 74 20 74 68  65 20 70 69 63 74 75 72  |trict the pictur|
0000b3a0  65 20 74 6f 20 32 35 36  78 32 35 36 79 2c 20 6f  |e to 256x256y, o|
0000b3b0  74 68 65 72 77 69 73 65  20 69 74 20 77 69 6c 6c  |therwise it will|
0000b3c0  20 62 65 20 74 68 65 20  73 61 6d 65 20 73 69 7a  | be the same siz|
0000b3d0  65 20 61 73 20 74 68 65  0a 69 6e 70 75 74 2e 20  |e as the.input. |
0000b3e0  53 70 65 63 69 66 79 20  22 61 69 6d 22 20 61 73  |Specify "aim" as|
0000b3f0  20 74 68 65 20 6d 6f 64  65 20 73 74 72 69 6e 67  | the mode string|
0000b400  20 74 6f 20 64 6f 20 74  68 69 73 2e 0a 0a 46 6f  | to do this...Fo|
0000b410  72 20 70 6f 72 74 61 62  69 6c 69 74 79 20 74 6f  |r portability to|
0000b420  20 6f 74 68 65 72 20 6d  61 63 68 69 6e 65 73 2c  | other machines,|
0000b430  20 43 68 61 6e 67 65 46  53 49 20 63 61 6e 20 77  | ChangeFSI can w|
0000b440  72 69 74 65 20 6f 75 74  20 66 69 6c 65 73 20 69  |rite out files i|
0000b450  6e 20 22 70 62 6d 22 0a  66 6f 72 6d 61 74 2e 20  |n "pbm".format. |
0000b460  54 68 65 72 65 20 61 72  65 20 33 20 74 79 70 65  |There are 3 type|
0000b470  73 20 6f 66 20 66 6f 72  6d 61 74 20 22 62 6c 61  |s of format "bla|
0000b480  63 6b 2f 77 68 69 74 65  22 20 28 70 62 6d 29 2c  |ck/white" (pbm),|
0000b490  20 22 67 72 65 79 22 20  28 70 67 6d 29 20 61 6e  | "grey" (pgm) an|
0000b4a0  64 0a 22 63 6f 6c 6f 75  72 22 20 28 70 70 6d 29  |d."colour" (ppm)|
0000b4b0  20 77 69 74 68 20 70 75  72 65 20 41 53 43 49 49  | with pure ASCII|
0000b4c0  20 61 6e 64 20 62 69 6e  61 72 79 20 65 6e 63 6f  | and binary enco|
0000b4d0  64 69 6e 67 73 20 6f 66  20 65 61 63 68 3a 0a 0a  |dings of each:..|
0000b4e0  41 53 43 49 49 20 20 20  20 20 20 20 20 20 20 20  |ASCII           |
0000b4f0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000b500  20 20 20 20 20 20 20 20  42 69 6e 61 72 79 0a 70  |        Binary.p|
0000b510  31 20 20 20 20 20 20 20  20 22 62 6c 61 63 6b 2f  |1        "black/|
0000b520  77 68 69 74 65 22 20 28  6c 69 6b 65 20 6d 6f 64  |white" (like mod|
0000b530  65 20 31 38 29 20 20 70  34 20 28 62 69 67 20 65  |e 18)  p4 (big e|
0000b540  6e 64 69 61 6e 20 62 79  74 65 73 21 29 0a 70 32  |ndian bytes!).p2|
0000b550  20 20 20 20 20 20 20 20  22 67 72 65 79 22 20 28  |        "grey" (|
0000b560  6c 69 6b 65 20 6d 6f 64  65 20 32 30 74 29 20 20  |like mode 20t)  |
0000b570  20 20 20 20 20 20 70 35  0a 70 33 20 20 20 20 20  |      p5.p3     |
0000b580  20 20 20 22 74 72 75 65  20 63 6f 6c 6f 75 72 22  |   "true colour"|
0000b590  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000b5a0  20 70 36 0a 0a 46 69 6c  65 73 20 63 61 6e 20 62  | p6..Files can b|
0000b5b0  65 20 72 65 61 64 20 77  69 74 68 20 4a 65 66 20  |e read with Jef |
0000b5c0  50 6f 73 6b 61 6e 7a 65  72 27 73 20 70 6f 72 74  |Poskanzer's port|
0000b5d0  61 62 6c 65 20 74 6f 6f  6c 6b 69 74 20 6f 6e 20  |able toolkit on |
0000b5e0  6f 74 68 65 72 20 6d 61  63 68 69 6e 65 73 2e 20  |other machines. |
0000b5f0  54 68 65 0a 70 32 20 66  6f 72 6d 61 74 20 69 73  |The.p2 format is|
0000b600  20 65 61 73 69 6c 79 20  63 6f 6e 76 65 72 74 69  | easily converti|
0000b610  62 6c 65 20 62 79 20 70  72 6f 67 72 61 6d 6d 65  |ble by programme|
0000b620  72 73 3b 20 69 74 20 63  6f 6e 73 69 73 74 73 20  |rs; it consists |
0000b630  6f 66 3a 0a 0a 50 32 0a  23 20 63 6f 6d 6d 65 6e  |of:..P2.# commen|
0000b640  74 20 6c 69 6e 65 0a 78  73 69 7a 65 20 79 73 69  |t line.xsize ysi|
0000b650  7a 65 0a 6d 61 78 69 6d  75 6d 5f 76 61 6c 75 65  |ze.maximum_value|
0000b660  0a 70 69 78 65 6c 5f 76  61 6c 75 65 20 3c 77 68  |.pixel_value <wh|
0000b670  69 74 65 73 70 61 63 65  3e 20 70 69 78 65 6c 5f  |itespace> pixel_|
0000b680  76 61 6c 75 65 0a 0a 77  68 65 72 65 20 61 6c 6c  |value..where all|
0000b690  20 74 68 65 20 6e 75 6d  62 65 72 73 20 61 72 65  | the numbers are|
0000b6a0  20 69 6e 20 64 65 63 69  6d 61 6c 20 28 41 53 43  | in decimal (ASC|
0000b6b0  49 49 29 2e 20 30 20 6d  65 61 6e 73 20 62 6c 61  |II). 0 means bla|
0000b6c0  63 6b 2c 20 6d 61 78 69  6d 75 6d 5f 76 61 6c 75  |ck, maximum_valu|
0000b6d0  65 20 28 3d 0a 31 35 29  20 6d 65 61 6e 73 20 77  |e (=.15) means w|
0000b6e0  68 69 74 65 2e 20 54 68  65 20 70 33 20 66 6f 72  |hite. The p3 for|
0000b6f0  6d 61 74 20 69 73 20 73  69 6d 69 6c 61 72 20 77  |mat is similar w|
0000b700  69 74 68 20 72 2c 20 67  2c 20 62 20 74 72 69 70  |ith r, g, b trip|
0000b710  6c 65 73 20 66 6f 72 20  65 61 63 68 20 70 69 78  |les for each pix|
0000b720  65 6c 0a 76 61 6c 75 65  2e 20 54 68 65 20 6e 75  |el.value. The nu|
0000b730  6d 62 65 72 20 6f 66 20  62 69 74 73 20 70 65 72  |mber of bits per|
0000b740  20 63 6f 6d 70 6f 6e 65  6e 74 20 28 64 65 66 61  | component (defa|
0000b750  75 6c 74 20 38 29 20 63  61 6e 20 62 65 20 73 65  |ult 8) can be se|
0000b760  74 20 66 72 6f 6d 20 74  68 65 20 63 6f 6d 6d 61  |t from the comma|
0000b770  6e 64 0a 6c 69 6e 65 20  77 69 74 68 2c 20 66 6f  |nd.line with, fo|
0000b780  72 20 65 78 61 6d 70 6c  65 2c 20 22 70 33 2c 34  |r example, "p3,4|
0000b790  22 20 66 6f 72 20 34 20  62 69 74 73 20 70 65 72  |" for 4 bits per|
0000b7a0  20 63 6f 6d 70 6f 6e 65  6e 74 2e 0a 0a 41 73 20  | component...As |
0000b7b0  61 20 73 70 65 63 69 61  6c 20 70 61 63 6b 65 64  |a special packed|
0000b7c0  20 6f 75 74 70 75 74 20  66 6f 72 6d 61 74 2c 20  | output format, |
0000b7d0  22 50 31 35 22 20 68 61  73 20 62 65 65 6e 20 69  |"P15" has been i|
0000b7e0  6d 70 6c 65 6d 65 6e 74  65 64 2e 20 4f 75 74 70  |mplemented. Outp|
0000b7f0  75 74 20 69 73 20 62 69  6e 61 72 79 0a 70 69 78  |ut is binary.pix|
0000b800  65 6c 20 76 61 6c 75 65  73 2c 20 35 20 62 69 74  |el values, 5 bit|
0000b810  73 20 70 65 72 20 63 6f  6d 70 6f 6e 65 6e 74 2c  |s per component,|
0000b820  20 6c 69 74 74 6c 65 20  65 6e 64 69 61 6e 20 52  | little endian R|
0000b830  47 42 20 6f 72 64 65 72  20 70 61 63 6b 65 64 20  |GB order packed |
0000b840  69 6e 74 6f 20 31 36 0a  62 69 74 73 2e 20 48 65  |into 16.bits. He|
0000b850  61 64 65 72 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  |ader information|
0000b860  20 61 73 20 74 68 65 20  6f 74 68 65 72 20 70 20  | as the other p |
0000b870  66 6f 72 6d 61 74 73 2e  0a 0a 46 69 6c 65 73 20  |formats...Files |
0000b880  63 61 6e 20 62 65 20 77  72 69 74 74 65 6e 20 61  |can be written a|
0000b890  73 20 6e 65 77 20 52 49  53 43 20 4f 53 20 73 70  |s new RISC OS sp|
0000b8a0  72 69 74 65 73 20 75 73  69 6e 67 20 53 31 36 20  |rites using S16 |
0000b8b0  61 6e 64 20 53 33 32 20  61 73 20 74 68 65 20 66  |and S32 as the f|
0000b8c0  6f 72 6d 61 74 73 2e 0a  54 68 65 20 78 20 61 6e  |ormats..The x an|
0000b8d0  64 20 79 20 70 69 78 65  6c 73 20 70 65 72 20 69  |d y pixels per i|
0000b8e0  6e 63 68 20 61 72 65 20  67 69 76 65 6e 20 61 73  |nch are given as|
0000b8f0  20 61 20 63 6f 6d 6d 61  20 73 65 70 65 72 61 74  | a comma seperat|
0000b900  65 64 20 6c 69 73 74 20  2d 20 61 20 31 36 20 62  |ed list - a 16 b|
0000b910  69 74 20 6d 6f 64 65 0a  31 32 20 65 71 75 69 76  |it mode.12 equiv|
0000b920  61 6c 65 6e 74 20 69 73  20 53 31 36 2c 39 30 2c  |alent is S16,90,|
0000b930  34 35 20 77 68 69 6c 65  20 61 20 33 32 20 62 69  |45 while a 32 bi|
0000b940  74 20 6d 6f 64 65 20 32  38 20 65 71 75 69 76 61  |t mode 28 equiva|
0000b950  6c 65 6e 74 20 69 73 20  53 33 32 2c 39 30 2c 39  |lent is S32,90,9|
0000b960  30 2e 0a 0a 46 69 6c 65  73 20 63 61 6e 20 62 65  |0...Files can be|
0000b970  20 77 72 69 74 74 65 6e  20 61 73 20 4a 50 45 47  | written as JPEG|
0000b980  20 69 6d 61 67 65 73 20  75 73 69 6e 67 20 4a 50  | images using JP|
0000b990  45 47 20 28 63 6f 6c 6f  75 72 29 20 6f 72 20 4a  |EG (colour) or J|
0000b9a0  50 45 47 4d 4f 4e 4f 2e  20 41 20 71 75 61 6c 69  |PEGMONO. A quali|
0000b9b0  74 79 0a 69 6e 20 74 68  65 20 72 61 6e 67 65 20  |ty.in the range |
0000b9c0  31 20 74 6f 20 31 30 30  20 6d 75 73 74 20 62 65  |1 to 100 must be|
0000b9d0  20 61 64 64 65 64 20 74  6f 20 74 68 65 20 65 6e  | added to the en|
0000b9e0  64 20 28 65 2e 67 2e 20  4a 50 45 47 37 35 20 6f  |d (e.g. JPEG75 o|
0000b9f0  72 20 4a 50 45 47 4d 4f  4e 4f 35 30 29 2e 0a 0a  |r JPEGMONO50)...|
0000ba00  43 68 61 6e 67 65 46 53  49 20 63 61 6e 20 77 72  |ChangeFSI can wr|
0000ba10  69 74 65 20 49 72 6c 61  6d 20 66 6f 72 6d 61 74  |ite Irlam format|
0000ba20  20 69 6d 61 67 65 73 20  28 73 6f 6d 65 77 68 61  | images (somewha|
0000ba30  74 20 73 6c 6f 77 65 72  20 74 68 61 6e 20 70 36  |t slower than p6|
0000ba40  20 69 6d 61 67 65 73 2e  2e 2e 29 2e 0a 0a 20 20  | images...)...  |
0000ba50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000ba60  20 20 20 20 20 20 20 20  20 20 20 20 4f 75 74 70  |            Outp|
0000ba70  75 74 20 73 75 6d 6d 61  72 79 0a 20 20 20 20 20  |ut summary.     |
0000ba80  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000ba90  20 20 20 20 20 20 20 20  20 3d 3d 3d 3d 3d 3d 3d  |         =======|
0000baa0  3d 3d 3d 3d 3d 3d 3d 0a  0a 23 20 63 6f 6c 73 20  |=======..# cols |
0000bab0  20 20 43 6f 6c 6f 75 72  20 43 75 62 65 20 20 42  |  Colour Cube  B|
0000bac0  69 74 73 20 75 73 65 64  20 20 43 6f 6e 73 69 73  |its used  Consis|
0000bad0  74 65 6e 74 20 48 75 65  20 20 44 65 73 6b 74 6f  |tent Hue  Deskto|
0000bae0  70 20 50 61 6c 65 74 74  65 20 20 4d 6f 64 65 26  |p Palette  Mode&|
0000baf0  53 75 66 66 69 78 0a 0a  32 5e 32 34 20 20 20 20  |Suffix..2^24    |
0000bb00  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000bb10  20 20 32 34 20 20 20 20  20 20 20 20 20 20 20 59  |  24           Y|
0000bb20  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 20 20  |             -  |
0000bb30  20 20 20 20 20 20 20 20  20 20 53 33 32 2c 20 70  |          S32, p|
0000bb40  33 20 6f 72 20 70 36 20  6f 72 20 49 72 6c 61 6d  |3 or p6 or Irlam|
0000bb50  20 6f 72 20 4a 50 45 47  0a 32 5e 32 31 20 20 20  | or JPEG.2^21   |
0000bb60  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000bb70  20 20 20 32 31 20 20 20  20 20 20 20 20 20 20 20  |   21           |
0000bb80  59 20 20 20 20 20 20 20  20 20 20 20 20 20 2d 20  |Y             - |
0000bb90  20 20 20 20 20 20 20 20  20 20 20 70 36 2c 37 0a  |           p6,7.|
0000bba0  32 5e 31 38 20 20 20 20  20 20 20 20 20 20 20 20  |2^18            |
0000bbb0  59 20 20 20 20 20 20 20  20 20 31 38 20 20 20 20  |Y         18    |
0000bbc0  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000bbd0  20 20 20 20 20 2d 20 20  20 20 20 20 20 20 20 20  |     -          |
0000bbe0  20 20 70 36 2c 36 0a 32  5e 31 35 20 20 20 20 20  |  p6,6.2^15     |
0000bbf0  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000bc00  20 31 35 20 20 20 20 20  20 20 20 20 20 20 59 20  | 15           Y |
0000bc10  20 20 20 20 20 20 20 20  20 20 20 20 2d 20 20 20  |            -   |
0000bc20  20 20 20 20 20 20 20 20  20 53 31 36 2c 20 70 31  |         S16, p1|
0000bc30  35 20 6f 72 20 70 36 2c  35 0a 32 5e 31 32 20 20  |5 or p6,5.2^12  |
0000bc40  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000bc50  20 20 20 20 31 32 20 20  20 20 20 20 20 20 20 20  |    12          |
0000bc60  20 59 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  | Y             -|
0000bc70  20 20 20 20 20 20 20 20  20 20 20 20 70 36 2c 34  |            p6,4|
0000bc80  0a 35 31 32 20 20 20 20  20 20 20 20 20 20 20 20  |.512            |
0000bc90  20 59 20 20 20 20 20 20  20 20 20 20 39 20 20 20  | Y          9   |
0000bca0  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000bcb0  20 20 20 20 20 20 2d 20  20 20 20 20 20 20 20 20  |      -         |
0000bcc0  20 20 20 70 36 2c 33 0a  32 35 36 20 67 72 65 79  |   p6,3.256 grey|
0000bcd0  20 20 20 20 20 20 20 20  6e 20 20 20 20 20 20 20  |        n       |
0000bce0  20 20 20 38 20 20 20 20  20 20 20 20 20 20 20 59  |   8           Y|
0000bcf0  20 20 20 20 20 20 20 20  20 20 20 20 20 2d 20 20  |             -  |
0000bd00  20 20 20 20 20 20 20 20  20 20 61 69 6d 20 6f 72  |          aim or|
0000bd10  20 4a 50 45 47 4d 4f 4e  4f 0a 32 35 36 20 67 72  | JPEGMONO.256 gr|
0000bd20  65 79 20 20 20 20 20 20  20 20 6e 20 20 20 20 20  |ey        n     |
0000bd30  20 20 20 20 20 38 20 20  20 20 20 20 20 20 20 20  |     8          |
0000bd40  20 59 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  | Y             -|
0000bd50  20 20 20 20 20 20 20 20  20 20 20 20 32 38 64 0a  |            28d.|
0000bd60  32 35 36 20 20 20 20 20  20 20 20 20 20 20 20 20  |256             |
0000bd70  59 20 20 20 20 20 20 20  20 20 20 38 20 20 20 20  |Y          8    |
0000bd80  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000bd90  20 20 20 20 20 59 20 20  20 20 20 20 20 20 20 20  |     Y          |
0000bda0  20 20 32 38 0a 32 35 36  20 20 20 20 20 20 20 20  |  28.256        |
0000bdb0  20 20 20 20 20 59 20 20  20 20 20 20 20 20 20 20  |     Y          |
0000bdc0  38 20 20 20 20 20 20 20  20 20 20 20 59 20 20 20  |8           Y   |
0000bdd0  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000bde0  20 20 20 20 20 20 20 32  38 72 0a 31 36 20 67 72  |       28r.16 gr|
0000bdf0  65 79 20 20 20 20 20 20  20 20 20 6e 20 20 20 20  |ey         n    |
0000be00  20 20 20 20 20 20 34 20  20 20 20 20 20 20 20 20  |      4         |
0000be10  20 20 59 20 20 20 20 20  20 20 20 20 20 20 20 20  |  Y             |
0000be20  6e 20 20 20 20 20 20 20  20 20 20 20 20 32 37 74  |n            27t|
0000be30  0a 31 36 20 67 72 65 79  20 20 20 20 20 20 20 20  |.16 grey        |
0000be40  20 6e 20 20 20 20 20 20  20 20 20 20 34 20 20 20  | n          4   |
0000be50  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000be60  20 20 20 20 20 20 6e 20  20 20 20 20 20 20 20 20  |      n         |
0000be70  20 20 20 70 32 20 6f 72  20 70 35 0a 38 20 67 72  |   p2 or p5.8 gr|
0000be80  65 79 20 20 20 20 20 20  20 20 20 20 6e 20 20 20  |ey          n   |
0000be90  20 20 20 20 20 20 20 33  20 20 20 20 20 20 20 20  |       3        |
0000bea0  20 20 20 59 20 20 20 20  20 20 20 20 20 20 20 20  |   Y            |
0000beb0  20 59 20 20 20 20 20 20  20 20 20 20 20 20 32 37  | Y            27|
0000bec0  0a 31 36 20 20 20 20 20  20 20 20 20 20 20 20 20  |.16             |
0000bed0  20 3f 20 20 20 20 20 20  20 20 20 20 34 20 20 20  | ?          4   |
0000bee0  20 20 20 20 20 20 20 20  3f 20 20 20 20 20 20 20  |        ?       |
0000bef0  20 20 20 20 20 20 59 20  20 20 20 20 20 20 20 20  |      Y         |
0000bf00  20 20 20 32 37 72 0a 31  36 20 20 20 20 20 20 20  |   27r.16       |
0000bf10  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000bf20  20 20 33 20 20 20 20 20  20 20 20 20 20 20 59 20  |  3           Y |
0000bf30  20 20 20 20 20 20 20 20  20 20 63 61 6e 20 62 65  |          can be|
0000bf40  20 20 20 20 20 20 20 20  20 32 37 64 0a 34 20 67  |         27d.4 g|
0000bf50  72 65 79 20 20 20 20 20  20 20 20 20 20 6e 20 20  |rey          n  |
0000bf60  20 20 20 20 20 20 20 20  32 20 20 20 20 20 20 20  |        2       |
0000bf70  20 20 20 20 59 20 20 20  20 20 20 20 20 20 20 20  |    Y           |
0000bf80  20 20 59 20 20 20 20 20  20 20 20 20 20 20 20 32  |  Y            2|
0000bf90  36 0a 34 20 20 20 20 20  20 20 20 20 20 20 20 20  |6.4             |
0000bfa0  20 20 6e 20 20 20 20 20  20 20 20 20 20 32 20 20  |  n          2  |
0000bfb0  20 20 20 20 20 20 20 20  20 6e 20 20 20 20 20 20  |         n      |
0000bfc0  20 20 20 20 20 20 20 6e  20 20 20 20 20 20 20 20  |       n        |
0000bfd0  20 20 20 20 32 36 63 0a  34 20 20 20 20 20 20 20  |    26c.4       |
0000bfe0  20 20 20 20 20 20 20 20  6e 20 20 20 20 20 20 20  |        n       |
0000bff0  20 20 20 32 20 20 20 20  20 20 20 20 20 20 20 6e  |   2           n|
0000c000  20 20 20 20 20 20 20 20  20 20 20 20 20 6e 20 20  |             n  |
0000c010  20 20 20 20 20 20 20 20  20 20 32 36 72 0a 32 20  |          26r.2 |
0000c020  28 62 6c 61 63 6b 2f 77  68 69 74 65 29 20 6e 20  |(black/white) n |
0000c030  20 20 20 20 20 20 20 20  20 31 20 20 20 20 20 20  |         1      |
0000c040  20 20 20 20 20 59 20 20  20 20 20 20 20 20 20 20  |     Y          |
0000c050  20 20 20 59 20 20 20 20  20 20 20 20 20 20 20 20  |   Y            |
0000c060  32 35 0a 32 20 28 62 6c  61 63 6b 2f 77 68 69 74  |25.2 (black/whit|
0000c070  65 29 20 6e 20 20 20 20  20 20 20 20 20 20 31 20  |e) n          1 |
0000c080  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000c090  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000c0a0  20 20 20 20 20 32 35 63  2f 64 2f 74 0a 32 20 28  |     25c/d/t.2 (|
0000c0b0  62 6c 61 63 6b 2f 77 68  69 74 65 29 20 6e 20 20  |black/white) n  |
0000c0c0  20 20 20 20 20 20 20 20  31 20 20 20 20 20 20 20  |        1       |
0000c0d0  20 20 20 20 59 20 20 20  20 20 20 20 20 20 20 20  |    Y           |
0000c0e0  20 20 59 20 20 20 20 20  20 20 20 20 20 20 20 70  |  Y            p|
0000c0f0  31 20 6f 72 20 70 34 0a  0a 0a 43 68 61 6e 67 65  |1 or p4...Change|
0000c100  46 53 49 20 63 61 6e 20  62 65 20 75 73 65 64 20  |FSI can be used |
0000c110  66 72 6f 6d 20 62 6f 74  68 20 74 68 65 20 64 65  |from both the de|
0000c120  73 6b 74 6f 70 20 66 72  6f 6e 74 20 65 6e 64 20  |sktop front end |
0000c130  61 6e 64 20 66 72 6f 6d  20 74 68 65 20 63 6f 6d  |and from the com|
0000c140  6d 61 6e 64 0a 6c 69 6e  65 2e 20 49 74 20 63 61  |mand.line. It ca|
0000c150  6e 20 61 6c 73 6f 20 62  65 20 75 73 65 64 20 61  |n also be used a|
0000c160  73 20 61 20 42 41 53 49  43 20 6c 69 62 72 61 72  |s a BASIC librar|
0000c170  79 20 66 75 6e 63 74 69  6f 6e 3a 0a 4c 49 42 52  |y function:.LIBR|
0000c180  41 52 59 22 3c 43 68 61  6e 67 65 46 53 49 24 44  |ARY"<ChangeFSI$D|
0000c190  69 72 3e 2e 43 68 61 6e  67 65 46 53 49 22 20 67  |ir>.ChangeFSI" g|
0000c1a0  69 76 65 73 20 61 20 6e  65 77 20 66 75 6e 63 74  |ives a new funct|
0000c1b0  69 6f 6e 2c 20 46 4e 43  68 61 6e 67 65 46 53 49  |ion, FNChangeFSI|
0000c1c0  20 74 6f 20 74 68 65 0a  42 41 53 49 43 20 70 72  | to the.BASIC pr|
0000c1d0  6f 67 72 61 6d 6d 65 72  2e 20 54 68 69 73 20 66  |ogrammer. This f|
0000c1e0  75 6e 63 74 69 6f 6e 20  74 61 6b 65 73 3a 0a 20  |unction takes:. |
0000c1f0  20 41 24 3a 20 61 20 63  6f 6d 6d 61 6e 64 20 6c  | A$: a command l|
0000c200  69 6e 65 20 61 72 67 75  6d 65 6e 74 0a 20 20 73  |ine argument.  s|
0000c210  70 72 69 74 65 61 72 65  61 25 3a 20 61 6e 20 61  |pritearea%: an a|
0000c220  64 64 72 65 73 73 20 6f  72 20 2d 31 20 66 6f 72  |ddress or -1 for|
0000c230  20 74 68 65 20 73 70 72  69 74 65 61 72 65 61 20  | the spritearea |
0000c240  62 75 69 6c 74 20 62 79  20 43 68 61 6e 67 65 46  |built by ChangeF|
0000c250  53 49 0a 20 20 77 6f 72  6b 73 70 61 63 65 25 3a  |SI.  workspace%:|
0000c260  20 61 6e 20 61 64 64 72  65 73 73 20 6f 72 20 2d  | an address or -|
0000c270  31 20 66 6f 72 20 43 68  61 6e 67 65 46 53 49 27  |1 for ChangeFSI'|
0000c280  73 20 6f 74 68 65 72 20  77 6f 72 6b 73 70 61 63  |s other workspac|
0000c290  65 0a 20 20 77 6f 72 6b  6c 69 6d 69 74 25 3a 20  |e.  worklimit%: |
0000c2a0  61 6e 20 61 64 64 72 65  73 73 20 28 75 6e 75 73  |an address (unus|
0000c2b0  65 64 20 69 66 20 77 6f  72 6b 73 70 61 63 65 25  |ed if workspace%|
0000c2c0  3c 30 29 0a 20 20 66 61  73 74 25 3a 20 54 52 55  |<0).  fast%: TRU|
0000c2d0  45 20 66 6f 72 20 4d 4f  44 45 20 30 20 73 65 6c  |E for MODE 0 sel|
0000c2e0  65 63 74 69 6f 6e 0a 49  74 20 70 72 6f 64 75 63  |ection.It produc|
0000c2f0  65 73 20 61 6e 20 65 72  72 6f 72 20 28 74 6f 20  |es an error (to |
0000c300  77 68 61 74 65 76 65 72  20 65 72 72 6f 72 20 68  |whatever error h|
0000c310  61 6e 64 6c 65 72 20 69  73 20 70 72 65 73 65 6e  |andler is presen|
0000c320  74 29 20 69 66 20 69 74  20 66 61 69 6c 73 2e 20  |t) if it fails. |
0000c330  49 66 0a 73 70 72 69 74  65 61 72 65 61 25 20 69  |If.spritearea% i|
0000c340  73 20 3c 30 20 69 74 20  77 69 6c 6c 20 73 61 76  |s <0 it will sav|
0000c350  65 20 74 68 65 20 73 70  72 69 74 65 20 74 6f 20  |e the sprite to |
0000c360  74 68 65 20 66 69 6c 65  20 67 69 76 65 6e 20 69  |the file given i|
0000c370  6e 20 74 68 65 20 63 6f  6d 6d 61 6e 64 0a 73 74  |n the command.st|
0000c380  72 69 6e 67 2c 20 6f 74  68 65 72 77 69 73 65 20  |ring, otherwise |
0000c390  69 74 20 77 6f 6e 27 74  2e 20 54 68 65 20 66 75  |it won't. The fu|
0000c3a0  6e 63 74 69 6f 6e 20 46  4e 43 68 61 6e 67 65 46  |nction FNChangeF|
0000c3b0  53 49 56 65 72 73 69 6f  6e 20 72 65 74 75 72 6e  |SIVersion return|
0000c3c0  73 20 74 68 65 20 76 65  72 73 69 6f 6e 0a 73 74  |s the version.st|
0000c3d0  72 69 6e 67 20 6f 66 20  74 68 65 20 6c 69 62 72  |ring of the libr|
0000c3e0  61 72 79 20 28 69 6e 20  74 68 65 20 69 6e 66 6f  |ary (in the info|
0000c3f0  20 62 6f 78 20 6f 66 20  74 68 65 20 64 65 73 6b  | box of the desk|
0000c400  74 6f 70 20 61 70 70 6c  69 63 61 74 69 6f 6e 29  |top application)|
0000c410  2e 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |...             |
0000c420  20 20 20 20 20 20 20 20  20 20 20 20 20 20 43 6f  |              Co|
0000c430  6d 6d 61 6e 64 20 53 75  6d 6d 61 72 79 0a 20 20  |mmand Summary.  |
0000c440  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000c450  20 20 20 20 20 20 20 20  20 3d 3d 3d 3d 3d 3d 3d  |         =======|
0000c460  3d 3d 3d 3d 3d 3d 3d 3d  0a 0a 2d 69 6e 66 6f 20  |========..-info |
0000c470  20 20 20 20 67 69 76 65  20 64 65 74 61 69 6c 73  |    give details|
0000c480  0a 0a 2d 68 69 73 74 20  20 20 20 20 64 6f 6e 27  |..-hist     don'|
0000c490  74 20 70 72 6f 63 65 73  73 20 69 6d 61 67 65 2c  |t process image,|
0000c4a0  20 62 75 74 20 64 69 73  70 6c 61 79 20 68 69 73  | but display his|
0000c4b0  74 6f 67 72 61 6d 20 6f  66 20 69 74 20 69 6e 73  |togram of it ins|
0000c4c0  74 65 61 64 0a 0a 2d 68  66 6c 69 70 20 20 20 20  |tead..-hflip    |
0000c4d0  68 6f 72 69 7a 6f 6e 74  61 6c 6c 79 20 66 6c 69  |horizontally fli|
0000c4e0  70 20 74 68 65 20 69 6d  61 67 65 0a 2d 76 66 6c  |p the image.-vfl|
0000c4f0  69 70 20 20 20 20 76 65  72 74 69 63 61 6c 6c 79  |ip    vertically|
0000c500  20 66 6c 69 70 20 74 68  65 20 69 6d 61 67 65 0a  | flip the image.|
0000c510  2d 72 6f 74 61 74 65 20  20 20 72 6f 74 61 74 65  |-rotate   rotate|
0000c520  20 74 68 65 20 69 6d 61  67 65 20 62 79 20 2b 39  | the image by +9|
0000c530  30 20 64 65 67 72 65 65  73 20 28 69 2e 65 2e 20  |0 degrees (i.e. |
0000c540  61 6e 74 69 2d 63 6c 6f  63 6b 77 69 73 65 29 0a  |anti-clockwise).|
0000c550  2d 72 6f 74 61 74 65 2d  20 20 72 6f 74 61 74 65  |-rotate-  rotate|
0000c560  20 74 68 65 20 69 6d 61  67 65 20 62 79 20 2d 39  | the image by -9|
0000c570  30 20 64 65 67 72 65 65  73 20 28 69 2e 65 2e 20  |0 degrees (i.e. |
0000c580  63 6c 6f 63 6b 77 69 73  65 29 0a 2d 6d 61 78 20  |clockwise).-max |
0000c590  20 20 20 20 20 73 65 74  20 74 68 65 20 6d 61 78  |     set the max|
0000c5a0  69 6d 75 6d 20 73 69 7a  65 20 6f 66 20 74 68 65  |imum size of the|
0000c5b0  20 69 6d 61 67 65 20 62  65 66 6f 72 65 20 64 69  | image before di|
0000c5c0  73 63 20 69 73 20 75 73  65 64 0a 0a 2d 6e 6f 73  |sc is used..-nos|
0000c5d0  63 61 6c 65 20 20 64 69  73 61 62 6c 65 20 61 75  |cale  disable au|
0000c5e0  74 6f 6d 61 74 69 63 20  70 69 78 65 6c 20 73 69  |tomatic pixel si|
0000c5f0  7a 65 20 63 6f 72 72 65  63 74 69 6f 6e 0a 2d 6e  |ze correction.-n|
0000c600  6f 73 69 7a 65 20 20 20  64 69 73 61 62 6c 65 20  |osize   disable |
0000c610  61 75 74 6f 6d 61 74 69  63 20 70 69 78 65 6c 20  |automatic pixel |
0000c620  73 69 7a 65 20 63 6f 72  72 65 63 74 69 6f 6e 20  |size correction |
0000c630  66 6f 72 20 69 6e 70 75  74 20 70 69 78 65 6c 73  |for input pixels|
0000c640  20 6f 6e 6c 79 0a 2d 6e  6f 64 69 74 68 65 72 20  | only.-nodither |
0000c650  64 69 73 61 62 6c 65 20  64 69 74 68 65 72 69 6e  |disable ditherin|
0000c660  67 0a 2d 6e 6f 6d 6f 64  65 20 20 20 64 6f 6e 27  |g.-nomode   don'|
0000c670  74 20 63 68 61 6e 67 65  20 74 6f 20 6d 6f 64 65  |t change to mode|
0000c680  20 30 20 77 68 69 6c 65  20 70 72 6f 63 65 73 73  | 0 while process|
0000c690  69 6e 67 20 74 68 65 20  70 69 63 74 75 72 65 0a  |ing the picture.|
0000c6a0  2d 69 6e 76 65 72 74 20  20 20 69 6e 76 65 72 74  |-invert   invert|
0000c6b0  20 63 6f 6c 6f 75 72 20  72 61 6e 67 65 20 6f 66  | colour range of|
0000c6c0  20 69 6d 61 67 65 0a 0a  2d 72 61 6e 67 65 20 20  | image..-range  |
0000c6d0  20 20 65 78 70 61 6e 64  20 69 6e 70 75 74 27 73  |  expand input's|
0000c6e0  20 64 79 6e 61 6d 69 63  20 72 61 6e 67 65 20 74  | dynamic range t|
0000c6f0  6f 20 66 75 6c 6c 20 73  63 61 6c 65 0a 2d 65 71  |o full scale.-eq|
0000c700  75 61 6c 20 20 20 20 68  69 73 74 6f 67 72 61 6d  |ual    histogram|
0000c710  20 65 71 75 61 6c 69 73  61 74 69 6f 6e 0a 2d 73  | equalisation.-s|
0000c720  68 61 72 70 65 6e 20 20  64 69 67 69 74 61 6c 6c  |harpen  digitall|
0000c730  79 20 73 68 61 72 70 65  6e 20 74 68 65 20 70 69  |y sharpen the pi|
0000c740  63 74 75 72 65 0a 2d 73  6d 6f 6f 74 68 20 20 20  |cture.-smooth   |
0000c750  64 69 67 69 74 61 6c 6c  79 20 73 6d 6f 6f 74 68  |digitally smooth|
0000c760  20 74 68 65 20 70 69 63  74 75 72 65 0a 0a 2d 67  | the picture..-g|
0000c770  61 6d 6d 61 20 20 20 20  73 65 74 20 67 61 6d 6d  |amma    set gamm|
0000c780  61 20 63 6f 72 72 65 63  74 69 6f 6e 0a 2d 62 6c  |a correction.-bl|
0000c790  61 63 6b 20 20 20 20 63  6f 72 72 65 63 74 20 66  |ack    correct f|
0000c7a0  6f 72 20 62 6c 61 63 6b  20 69 6e 6b 20 73 70 6f  |or black ink spo|
0000c7b0  74 20 73 69 7a 65 0a 2d  72 65 64 20 20 20 20 20  |t size.-red     |
0000c7c0  20 63 68 61 6e 67 65 20  72 65 64 20 77 65 69 67  | change red weig|
0000c7d0  68 74 20 66 6f 72 20 64  65 72 69 76 69 6e 67 20  |ht for deriving |
0000c7e0  6d 6f 6e 6f 63 68 72 6f  6d 65 20 6c 75 6d 69 6e  |monochrome lumin|
0000c7f0  61 6e 63 65 0a 2d 67 72  65 65 6e 20 20 20 20 63  |ance.-green    c|
0000c800  68 61 6e 67 65 20 67 72  65 65 6e 20 77 65 69 67  |hange green weig|
0000c810  68 74 20 66 6f 72 20 64  65 72 69 76 69 6e 67 20  |ht for deriving |
0000c820  6d 6f 6e 6f 63 68 72 6f  6d 65 20 6c 75 6d 69 6e  |monochrome lumin|
0000c830  61 6e 63 65 0a 2d 62 6c  75 65 20 20 20 20 20 63  |ance.-blue     c|
0000c840  68 61 6e 67 65 20 62 6c  75 65 20 77 65 69 67 68  |hange blue weigh|
0000c850  74 20 66 6f 72 20 64 65  72 69 76 69 6e 67 20 6d  |t for deriving m|
0000c860  6f 6e 6f 63 68 72 6f 6d  65 20 6c 75 6d 69 6e 61  |onochrome lumina|
0000c870  6e 63 65 0a 0a 2d 62 72  69 67 68 74 65 6e 20 68  |nce..-brighten h|
0000c880  6f 72 72 65 6e 64 6f 75  73 20 68 61 63 6b 20 74  |orrendous hack t|
0000c890  6f 20 73 6c 69 67 68 74  6c 79 20 62 72 69 67 68  |o slightly brigh|
0000c8a0  74 65 6e 20 69 6d 61 67  65 73 3a 20 6d 61 79 20  |ten images: may |
0000c8b0  63 6f 6e 76 65 72 74 20  68 75 65 73 0a 20 20 20  |convert hues.   |
0000c8c0  20 20 20 20 20 20 20 63  6c 6f 73 65 20 74 6f 20  |       close to |
0000c8d0  77 68 69 74 65 20 74 6f  20 77 68 69 74 65 2e 20  |white to white. |
0000c8e0  28 49 74 20 63 61 75 73  65 73 20 74 68 65 20 6f  |(It causes the o|
0000c8f0  75 74 70 75 74 20 72 61  6e 67 65 20 30 2e 2e 31  |utput range 0..1|
0000c900  35 20 74 6f 0a 20 20 20  20 20 20 20 20 20 20 62  |5 to.          b|
0000c910  65 20 63 6f 6e 73 69 64  65 72 65 64 20 61 73 20  |e considered as |
0000c920  30 2e 2e 28 31 35 2f 31  36 29 20 69 6e 73 74 65  |0..(15/16) inste|
0000c930  61 64 20 6f 66 20 30 2e  2e 28 31 35 2f 31 35 29  |ad of 0..(15/15)|
0000c940  29 2e 0a 0a 20 20 20 20  20 20 20 20 20 20 20 20  |)...            |
0000c950  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 4d  |               M|
0000c960  6f 64 65 20 53 75 66 66  69 78 65 73 0a 20 20 20  |ode Suffixes.   |
0000c970  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000c980  20 20 20 20 20 20 20 20  3d 3d 3d 3d 3d 3d 3d 3d  |        ========|
0000c990  3d 3d 3d 3d 3d 0a 0a 63  0a 20 20 31 20 62 69 74  |=====..c.  1 bit|
0000c9a0  20 6d 6f 64 65 73 3a 20  75 73 65 20 63 6c 75 73  | modes: use clus|
0000c9b0  74 65 72 65 64 20 64 69  74 68 65 72 69 6e 67 20  |tered dithering |
0000c9c0  77 69 74 68 20 34 78 34  20 63 65 6c 6c 0a 20 20  |with 4x4 cell.  |
0000c9d0  32 20 62 69 74 20 6d 6f  64 65 73 3a 20 75 73 65  |2 bit modes: use|
0000c9e0  20 74 68 65 20 66 6f 75  72 20 63 6f 6c 6f 75 72  | the four colour|
0000c9f0  73 20 22 62 6c 61 63 6b  22 2c 20 22 63 79 61 6e  |s "black", "cyan|
0000ca00  22 2c 20 22 6d 61 67 65  6e 74 61 22 20 61 6e 64  |", "magenta" and|
0000ca10  20 22 79 65 6c 6c 6f 77  22 0a 64 0a 20 20 31 20  | "yellow".d.  1 |
0000ca20  62 69 74 20 6d 6f 64 65  73 3a 20 75 73 65 20 63  |bit modes: use c|
0000ca30  6c 75 73 74 65 72 65 64  20 64 69 74 68 65 72 69  |lustered ditheri|
0000ca40  6e 67 20 77 69 74 68 20  32 78 32 20 63 65 6c 6c  |ng with 2x2 cell|
0000ca50  0a 20 20 34 20 62 69 74  20 6d 6f 64 65 73 3a 20  |.  4 bit modes: |
0000ca60  75 73 65 20 31 20 62 69  74 20 72 65 64 2c 20 31  |use 1 bit red, 1|
0000ca70  20 62 69 74 20 67 72 65  65 6e 2c 20 31 20 62 69  | bit green, 1 bi|
0000ca80  74 20 62 6c 75 65 0a 20  20 38 20 62 69 74 20 6d  |t blue.  8 bit m|
0000ca90  6f 64 65 73 3a 20 75 73  65 20 32 35 36 20 6c 65  |odes: use 256 le|
0000caa0  76 65 6c 20 67 72 65 79  20 73 63 61 6c 65 0a 74  |vel grey scale.t|
0000cab0  0a 20 20 31 20 62 69 74  20 6d 6f 64 65 73 3a 20  |.  1 bit modes: |
0000cac0  75 73 65 20 63 6c 75 73  74 65 72 65 64 20 64 69  |use clustered di|
0000cad0  74 68 65 72 69 6e 67 20  77 69 74 68 20 33 78 33  |thering with 3x3|
0000cae0  20 63 65 6c 6c 0a 20 20  34 20 62 69 74 20 6d 6f  | cell.  4 bit mo|
0000caf0  64 65 73 3a 20 31 36 20  6c 65 76 65 6c 20 67 72  |des: 16 level gr|
0000cb00  65 79 20 73 63 61 6c 65  0a 72 0a 20 20 32 20 62  |ey scale.r.  2 b|
0000cb10  69 74 20 6d 6f 64 65 73  3a 20 44 65 76 69 6f 75  |it modes: Deviou|
0000cb20  73 20 63 6f 6c 6f 75 72  20 6d 61 74 63 68 69 6e  |s colour matchin|
0000cb30  67 20 61 6c 67 6f 72 69  74 68 6d 0a 20 20 34 20  |g algorithm.  4 |
0000cb40  62 69 74 20 6d 6f 64 65  73 3a 20 44 65 76 69 6f  |bit modes: Devio|
0000cb50  75 73 20 63 6f 6c 6f 75  72 20 6d 61 74 63 68 69  |us colour matchi|
0000cb60  6e 67 20 61 6c 67 6f 72  69 74 68 6d 0a 20 20 38  |ng algorithm.  8|
0000cb70  20 62 69 74 20 6d 6f 64  65 73 3a 20 44 65 76 69  | bit modes: Devi|
0000cb80  6f 75 73 20 63 6f 6c 6f  75 72 20 6d 61 74 63 68  |ous colour match|
0000cb90  69 6e 67 20 61 6c 67 6f  72 69 74 68 6d 0a 2d 6e  |ing algorithm.-n|
0000cba0  6f 20 73 75 66 66 69 78  2d 0a 20 20 31 20 62 69  |o suffix-.  1 bi|
0000cbb0  74 20 6d 6f 64 65 73 3a  20 62 2f 77 20 64 69 73  |t modes: b/w dis|
0000cbc0  70 65 72 73 65 64 20 64  6f 74 20 64 69 74 68 65  |persed dot dithe|
0000cbd0  72 69 6e 67 0a 20 20 32  20 62 69 74 20 6d 6f 64  |ring.  2 bit mod|
0000cbe0  65 73 3a 20 34 20 6c 65  76 65 6c 20 67 72 65 79  |es: 4 level grey|
0000cbf0  20 73 63 61 6c 65 0a 20  20 34 20 62 69 74 20 6d  | scale.  4 bit m|
0000cc00  6f 64 65 73 3a 20 38 20  6c 65 76 65 6c 20 67 72  |odes: 8 level gr|
0000cc10  65 79 20 73 63 61 6c 65  0a 20 20 38 20 62 69 74  |ey scale.  8 bit|
0000cc20  20 6d 6f 64 65 73 3a 20  4a 6f 68 6e 20 42 6f 77  | modes: John Bow|
0000cc30  6c 65 72 27 73 20 63 6f  6c 6f 75 72 20 6d 61 74  |ler's colour mat|
0000cc40  63 68 69 6e 67 20 61 6c  67 6f 72 69 74 68 6d 0a  |ching algorithm.|
0000cc50  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 28  |               (|
0000cc60  64 65 66 61 75 6c 74 73  20 74 6f 20 27 72 27 20  |defaults to 'r' |
0000cc70  6d 6f 64 65 20 69 66 20  6e 6f 74 20 56 49 44 43  |mode if not VIDC|
0000cc80  31 20 63 6f 6d 70 61 74  69 62 6c 65 29 0a 0a 43  |1 compatible)..C|
0000cc90  6f 6c 6f 75 72 20 6d 61  74 63 68 69 6e 67 20 69  |olour matching i|
0000cca0  73 20 64 6f 6e 65 20 69  6e 20 72 2c 20 67 2c 20  |s done in r, g, |
0000ccb0  62 20 73 70 61 63 65 3a  20 74 68 65 20 6d 69 6e  |b space: the min|
0000ccc0  69 6d 75 6d 20 64 69 73  74 61 6e 63 65 20 62 65  |imum distance be|
0000ccd0  74 77 65 65 6e 20 63 6f  6c 6f 75 72 73 0a 69 73  |tween colours.is|
0000cce0  20 74 68 65 20 73 71 75  61 72 65 20 72 6f 6f 74  | the square root|
0000ccf0  20 6f 66 3a 0a 20 20 20  64 65 6c 74 61 5f 72 5e  | of:.   delta_r^|
0000cd00  32 2a 72 6d 61 74 63 68  77 74 2b 64 65 6c 74 61  |2*rmatchwt+delta|
0000cd10  5f 67 5e 32 2a 67 6d 61  74 63 68 77 74 2b 64 65  |_g^2*gmatchwt+de|
0000cd20  6c 74 61 5f 62 5e 32 2a  62 6d 61 74 63 68 77 74  |lta_b^2*bmatchwt|
0000cd30  0a 43 68 61 6e 67 65 46  53 49 20 68 61 73 20 68  |.ChangeFSI has h|
0000cd40  61 72 64 20 77 69 72 65  64 20 77 65 69 67 68 74  |ard wired weight|
0000cd50  73 20 6f 66 20 33 2c 20  31 30 2c 20 31 20 72 65  |s of 3, 10, 1 re|
0000cd60  73 70 65 63 74 69 76 65  6c 79 20 66 6f 72 20 69  |spectively for i|
0000cd70  74 73 20 63 6f 6c 6f 75  72 0a 6d 61 74 63 68 69  |ts colour.matchi|
0000cd80  6e 67 20 61 6c 67 6f 72  69 74 68 6d 73 2e 20 4a  |ng algorithms. J|
0000cd90  6f 68 6e 20 42 6f 77 6c  65 72 27 73 20 61 6c 67  |ohn Bowler's alg|
0000cda0  6f 72 69 74 68 6d 20 28  64 65 66 61 75 6c 74 20  |orithm (default |
0000cdb0  66 6f 72 20 52 49 53 43  20 4f 53 20 38 20 62 69  |for RISC OS 8 bi|
0000cdc0  74 20 6d 6f 64 65 73 29  0a 61 6c 74 68 6f 75 67  |t modes).althoug|
0000cdd0  68 20 73 6f 6d 65 77 68  61 74 20 73 6c 6f 77 65  |h somewhat slowe|
0000cde0  72 2c 20 69 73 20 66 61  73 74 20 65 6e 6f 75 67  |r, is fast enoug|
0000cdf0  68 20 74 6f 20 68 61 76  65 20 72 65 70 6c 61 63  |h to have replac|
0000ce00  65 64 20 61 6c 6c 20 74  68 65 20 70 72 65 76 69  |ed all the previ|
0000ce10  6f 75 73 0a 6d 65 74 68  6f 64 73 20 5b 41 53 49  |ous.methods [ASI|
0000ce20  44 45 20 69 74 20 67 69  76 65 73 20 70 69 63 74  |DE it gives pict|
0000ce30  75 72 65 73 20 61 74 20  6c 65 61 73 74 20 61 73  |ures at least as|
0000ce40  20 67 6f 6f 64 20 61 73  20 22 70 22 20 6d 6f 64  | good as "p" mod|
0000ce50  65 20 69 6e 20 70 72 65  20 41 75 67 20 39 31 0a  |e in pre Aug 91.|
0000ce60  43 68 61 6e 67 65 46 53  49 27 73 5d 2e 20 54 68  |ChangeFSI's]. Th|
0000ce70  65 20 44 65 76 69 6f 75  73 20 63 6f 6c 6f 75 72  |e Devious colour|
0000ce80  20 6d 61 74 63 68 69 6e  67 20 61 6c 67 6f 72 69  | matching algori|
0000ce90  74 68 6d 20 69 73 20 72  65 63 6f 6d 6d 65 6e 64  |thm is recommend|
0000cea0  65 64 2c 20 61 6e 64 20  69 73 0a 75 73 65 64 20  |ed, and is.used |
0000ceb0  61 75 74 6f 6d 61 74 69  63 61 6c 6c 79 20 69 66  |automatically if|
0000cec0  20 74 68 65 20 38 20 62  69 74 20 70 65 72 20 70  | the 8 bit per p|
0000ced0  69 78 65 6c 20 6d 6f 64  65 20 64 6f 65 73 20 6e  |ixel mode does n|
0000cee0  6f 74 20 68 61 76 65 20  74 68 65 20 64 65 66 61  |ot have the defa|
0000cef0  75 6c 74 20 52 49 53 43  0a 4f 53 20 63 6f 6c 6f  |ult RISC.OS colo|
0000cf00  75 72 20 73 65 74 2e 0a  0a 5b 4e 4f 54 45 3a 20  |ur set...[NOTE: |
0000cf10  74 68 61 6e 6b 73 20 61  72 65 20 64 75 65 20 74  |thanks are due t|
0000cf20  6f 20 53 74 65 76 65 20  47 72 65 65 6e 20 61 6e  |o Steve Green an|
0000cf30  64 20 74 68 65 20 42 42  43 20 61 6e 64 20 49 72  |d the BBC and Ir|
0000cf40  6c 61 6d 20 49 6e 73 74  72 75 6d 65 6e 74 73 20  |lam Instruments |
0000cf50  66 6f 72 0a 74 68 65 20  69 6e 74 65 72 6d 65 64  |for.the intermed|
0000cf60  69 61 74 65 20 73 79 73  74 65 6d 73 20 74 68 61  |iate systems tha|
0000cf70  74 20 6c 65 64 20 74 6f  20 4a 6f 68 6e 20 42 6f  |t led to John Bo|
0000cf80  77 6c 65 72 27 73 20 61  6e 64 20 74 68 65 20 44  |wler's and the D|
0000cf90  65 76 69 6f 75 73 0a 61  6c 67 6f 72 69 74 68 6d  |evious.algorithm|
0000cfa0  73 3a 20 75 6e 74 69 6c  20 41 75 67 20 39 31 20  |s: until Aug 91 |
0000cfb0  43 68 61 6e 67 65 46 53  49 20 75 73 65 64 20 74  |ChangeFSI used t|
0000cfc0  68 65 69 72 20 77 6f 72  6b 20 66 6f 72 20 69 74  |heir work for it|
0000cfd0  73 20 22 50 72 65 63 69  73 65 0a 4d 61 74 63 68  |s "Precise.Match|
0000cfe0  69 6e 67 22 20 61 6c 67  6f 72 69 74 68 6d 2e 20  |ing" algorithm. |
0000cff0  49 74 20 6e 6f 20 6c 6f  6e 67 65 72 20 75 73 65  |It no longer use|
0000d000  73 20 61 6e 79 20 6f 66  20 74 68 65 69 72 20 63  |s any of their c|
0000d010  6f 64 65 2c 20 62 75 74  20 6f 77 65 73 20 61 20  |ode, but owes a |
0000d020  64 65 62 74 0a 66 6f 72  20 6f 76 65 72 61 6c 6c  |debt.for overall|
0000d030  20 61 70 70 72 6f 61 63  68 2e 20 41 20 73 6d 61  | approach. A sma|
0000d040  6c 6c 20 74 68 61 6e 6b  20 79 6f 75 20 74 6f 20  |ll thank you to |
0000d050  53 70 65 6e 63 65 72 20  54 68 6f 6d 61 73 20 66  |Spencer Thomas f|
0000d060  6f 72 20 70 75 74 74 69  6e 67 20 6d 65 20 6f 6e  |or putting me on|
0000d070  0a 74 68 65 20 74 72 61  63 6b 20 77 68 69 63 68  |.the track which|
0000d080  20 6c 65 64 20 74 6f 20  74 68 65 20 44 65 76 69  | led to the Devi|
0000d090  6f 75 73 20 63 6f 6c 6f  75 72 20 6d 61 74 63 68  |ous colour match|
0000d0a0  69 6e 67 20 73 79 73 74  65 6d 27 73 20 61 6c 67  |ing system's alg|
0000d0b0  6f 72 69 74 68 6d 2e 5d  0a 0a 46 75 72 74 68 65  |orithm.]..Furthe|
0000d0c0  72 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 20 6f 6e  |r information on|
0000d0d0  20 64 69 74 68 65 72 69  6e 67 20 63 61 6e 20 62  | dithering can b|
0000d0e0  65 20 66 6f 75 6e 64 20  69 6e 20 22 44 69 67 69  |e found in "Digi|
0000d0f0  74 61 6c 20 48 61 6c 66  74 6f 6e 69 6e 67 22 20  |tal Halftoning" |
0000d100  62 79 20 52 6f 62 65 72  74 0a 55 6c 69 63 68 6e  |by Robert.Ulichn|
0000d110  65 79 20 70 75 62 6c 69  73 68 65 64 20 62 79 20  |ey published by |
0000d120  74 68 65 20 4d 49 54 20  50 72 65 73 73 2c 20 49  |the MIT Press, I|
0000d130  53 42 4e 20 30 2d 32 36  32 2d 32 31 30 30 39 2d  |SBN 0-262-21009-|
0000d140  36 2e 20 41 20 62 6f 6f  6b 20 77 68 69 63 68 20  |6. A book which |
0000d150  77 6f 75 6c 64 20 68 61  76 65 0a 62 65 65 6e 20  |would have.been |
0000d160  75 73 65 66 75 6c 20 77  68 65 6e 20 73 74 61 72  |useful when star|
0000d170  74 69 6e 67 20 77 72 69  74 69 6e 67 20 74 68 65  |ting writing the|
0000d180  20 70 72 6f 67 72 61 6d  2c 20 72 61 74 68 65 72  | program, rather|
0000d190  20 74 68 61 6e 20 61 66  74 65 72 20 69 74 20 77  | than after it w|
0000d1a0  61 73 20 6e 65 61 72 6c  79 0a 66 69 6e 69 73 68  |as nearly.finish|
0000d1b0  65 64 21 20 48 69 73 74  6f 67 72 61 6d 20 65 71  |ed! Histogram eq|
0000d1c0  75 61 6c 69 73 61 74 69  6f 6e 20 69 73 20 69 6e  |ualisation is in|
0000d1d0  20 22 41 6c 67 6f 72 69  74 68 6d 73 20 66 6f 72  | "Algorithms for|
0000d1e0  20 47 72 61 70 68 69 63  73 20 61 6e 64 20 49 6d  | Graphics and Im|
0000d1f0  61 67 65 0a 50 72 6f 63  65 73 73 69 6e 67 22 20  |age.Processing" |
0000d200  62 79 20 54 68 65 6f 20  50 61 76 6c 69 64 69 73  |by Theo Pavlidis|
0000d210  20 70 75 62 6c 69 73 68  65 64 20 62 79 20 43 6f  | published by Co|
0000d220  6d 70 75 74 65 72 20 53  63 69 65 6e 63 65 20 50  |mputer Science P|
0000d230  72 65 73 73 2c 20 49 53  42 4e 0a 30 2d 39 31 34  |ress, ISBN.0-914|
0000d240  38 39 34 2d 36 35 2d 58  2e 0a                    |894-65-X..|
0000d24a
!ChangeFSI/FSIinfo
00000000  20 20 20 20 20 43 68 61  6e 67 65 46 53 49 3a 20  |     ChangeFSI: |
00000010  43 6f 6c 6f 75 72 20 49  6d 61 67 65 20 50 72 6f  |Colour Image Pro|
00000020  63 65 73 73 69 6e 67 20  55 73 69 6e 67 20 74 68  |cessing Using th|
00000030  65 20 32 35 36 20 63 6f  6c 6f 75 72 20 6d 6f 64  |e 256 colour mod|
00000040  65 73 0a 0a 41 72 63 68  69 6d 65 64 65 73 20 63  |es..Archimedes c|
00000050  6f 6d 70 75 74 65 72 73  20 68 61 76 65 20 66 75  |omputers have fu|
00000060  6c 6c 20 63 6f 6c 6f 75  72 20 64 69 73 70 6c 61  |ll colour displa|
00000070  79 20 63 61 70 61 62 69  6c 69 74 69 65 73 20 62  |y capabilities b|
00000080  75 69 6c 74 20 69 6e 74  6f 20 74 68 65 6d 20 61  |uilt into them a|
00000090  73 0a 73 74 61 6e 64 61  72 64 2e 20 48 6f 77 65  |s.standard. Howe|
000000a0  76 65 72 2c 20 63 6f 6d  70 61 72 65 64 20 77 69  |ver, compared wi|
000000b0  74 68 20 74 68 65 20 68  61 72 64 77 61 72 65 20  |th the hardware |
000000c0  66 6f 75 6e 64 20 69 6e  20 6c 61 72 67 65 72 20  |found in larger |
000000d0  77 6f 72 6b 73 74 61 74  69 6f 6e 73 2c 20 74 68  |workstations, th|
000000e0  65 0a 66 61 63 69 6c 69  74 69 65 73 20 70 72 6f  |e.facilities pro|
000000f0  76 69 64 65 64 20 68 61  76 65 20 62 65 65 6e 20  |vided have been |
00000100  63 61 72 65 66 75 6c 6c  79 20 72 65 64 75 63 65  |carefully reduce|
00000110  64 20 28 69 6e 20 6f 72  64 65 72 20 74 6f 20 6d  |d (in order to m|
00000120  61 6b 65 20 74 68 65 6d  20 63 68 65 61 70 0a 65  |ake them cheap.e|
00000130  6e 6f 75 67 68 20 74 6f  20 66 69 74 20 61 6c 6c  |nough to fit all|
00000140  20 74 68 65 20 74 69 6d  65 29 2e 20 53 6f 20 74  | the time). So t|
00000150  68 65 20 70 72 65 63 69  73 69 6f 6e 20 6f 66 20  |he precision of |
00000160  74 68 65 20 64 69 67 69  74 61 6c 20 74 6f 20 61  |the digital to a|
00000170  6e 61 6c 6f 67 75 65 0a  63 6f 6e 76 65 72 74 65  |nalogue.converte|
00000180  72 73 20 69 73 20 6f 6e  6c 79 20 34 20 62 69 74  |rs is only 4 bit|
00000190  73 20 28 69 6e 73 74 65  61 64 20 6f 66 20 38 29  |s (instead of 8)|
000001a0  20 61 6e 64 20 74 68 65  20 63 6f 6c 6f 75 72 20  | and the colour |
000001b0  70 61 6c 65 74 74 65 20  6f 6e 6c 79 20 68 61 73  |palette only has|
000001c0  20 31 36 0a 65 6e 74 72  69 65 73 20 28 69 6e 73  | 16.entries (ins|
000001d0  74 65 61 64 20 6f 66 20  32 35 36 29 2e 0a 0a 54  |tead of 256)...T|
000001e0  68 65 20 56 49 44 43 20  32 35 36 20 63 6f 6c 6f  |he VIDC 256 colo|
000001f0  75 72 20 6d 6f 64 65 0a  3d 3d 3d 3d 3d 3d 3d 3d  |ur mode.========|
00000200  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |================|
00000210  3d 0a 0a 48 61 73 20 34  20 64 69 72 65 63 74 20  |=..Has 4 direct |
00000220  62 69 74 73 20 28 74 6f  70 20 32 20 67 72 65 65  |bits (top 2 gree|
00000230  6e 2c 20 74 6f 70 20 72  65 64 20 61 6e 64 20 62  |n, top red and b|
00000240  6c 75 65 29 20 70 6c 75  73 20 34 20 70 61 6c 65  |lue) plus 4 pale|
00000250  74 74 65 20 6c 6f 6f 6b  20 75 70 20 62 69 74 73  |tte look up bits|
00000260  0a 77 68 69 63 68 20 61  66 66 65 63 74 20 74 68  |.which affect th|
00000270  65 20 72 65 6d 61 69 6e  69 6e 67 20 44 41 43 20  |e remaining DAC |
00000280  62 69 74 73 2e 20 54 68  69 73 20 74 68 65 72 65  |bits. This there|
00000290  66 6f 72 65 20 67 69 76  65 73 20 61 20 63 68 6f  |fore gives a cho|
000002a0  69 63 65 20 6f 66 20 32  35 36 0a 63 6f 6c 6f 75  |ice of 256.colou|
000002b0  72 73 20 66 72 6f 6d 20  34 30 39 36 2c 20 62 75  |rs from 4096, bu|
000002c0  74 20 74 68 65 20 63 68  6f 69 63 65 20 69 73 20  |t the choice is |
000002d0  6e 6f 74 20 61 20 66 72  65 65 20 6f 6e 65 20 69  |not a free one i|
000002e0  6e 20 74 68 61 74 20 74  68 65 20 34 20 64 69 72  |n that the 4 dir|
000002f0  65 63 74 20 62 69 74 73  0a 61 72 65 20 61 6c 77  |ect bits.are alw|
00000300  61 79 73 20 63 6f 6e 6e  65 63 74 65 64 3a 20 74  |ays connected: t|
00000310  68 69 73 20 6c 65 61 76  65 73 20 6f 6e 6c 79 20  |his leaves only |
00000320  32 35 36 20 73 65 6c 65  63 74 69 6f 6e 73 20 61  |256 selections a|
00000330  76 61 69 6c 61 62 6c 65  20 66 72 6f 6d 20 74 68  |vailable from th|
00000340  65 20 34 30 39 36 0a 63  6f 6c 6f 75 72 20 72 61  |e 4096.colour ra|
00000350  6e 67 65 2e 20 54 6f 20  72 65 70 65 61 74 3a 20  |nge. To repeat: |
00000360  74 68 65 72 65 20 61 72  65 20 32 35 36 20 73 69  |there are 256 si|
00000370  6d 75 6c 74 61 6e 65 6f  75 73 20 63 6f 6c 6f 75  |multaneous colou|
00000380  72 73 20 69 6e 20 61 20  73 65 6c 65 63 74 69 6f  |rs in a selectio|
00000390  6e 20 6f 75 74 0a 6f 66  20 34 30 39 36 20 63 6f  |n out.of 4096 co|
000003a0  6c 6f 75 72 73 2c 20 77  68 65 72 65 20 74 68 65  |lours, where the|
000003b0  72 65 20 61 72 65 20 6f  6e 6c 79 20 32 35 36 20  |re are only 256 |
000003c0  22 6c 65 67 61 6c 22 20  73 65 6c 65 63 74 69 6f  |"legal" selectio|
000003d0  6e 73 2e 20 54 68 65 20  6e 65 77 20 56 49 44 43  |ns. The new VIDC|
000003e0  32 30 0a 61 6c 6c 6f 77  73 20 61 6e 20 61 72 62  |20.allows an arb|
000003f0  69 74 72 61 72 79 20 73  65 6c 65 63 74 69 6f 6e  |itrary selection|
00000400  20 6f 66 20 63 6f 6c 6f  75 72 73 2c 20 62 75 74  | of colours, but|
00000410  20 74 68 65 20 64 65 66  61 75 6c 74 20 73 69 74  | the default sit|
00000420  75 61 74 69 6f 6e 20 69  73 0a 69 64 65 6e 74 69  |uation is.identi|
00000430  63 61 6c 2e 0a 0a 54 68  65 72 65 20 61 72 65 20  |cal...There are |
00000440  22 6f 70 74 69 6d 61 6c  22 20 73 65 6c 65 63 74  |"optimal" select|
00000450  69 6f 6e 73 2e 20 41 6e  20 6f 70 74 69 6d 61 6c  |ions. An optimal|
00000460  20 73 65 6c 65 63 74 69  6f 6e 20 69 73 20 6f 6e  | selection is on|
00000470  65 20 77 68 69 63 68 20  63 6f 76 65 72 73 20 74  |e which covers t|
00000480  68 65 0a 65 6e 74 69 72  65 20 52 2c 20 47 2c 20  |he.entire R, G, |
00000490  42 20 63 6f 6c 6f 75 72  20 63 75 62 65 20 28 69  |B colour cube (i|
000004a0  2e 65 2e 20 30 2d 66 75  6c 6c 73 63 61 6c 65 20  |.e. 0-fullscale |
000004b0  66 6f 72 20 65 61 63 68  20 6f 66 20 74 68 65 20  |for each of the |
000004c0  63 6f 6c 6f 75 72 73 29  20 61 6e 64 20 63 61 6e  |colours) and can|
000004d0  0a 74 68 75 73 20 62 65  20 64 69 74 68 65 72 65  |.thus be dithere|
000004e0  64 20 74 6f 20 66 72 6f  6d 20 61 6e 79 20 70 69  |d to from any pi|
000004f0  63 74 75 72 65 20 28 69  66 20 6f 6e 65 20 63 6f  |cture (if one co|
00000500  6e 73 69 64 65 72 73 20  70 69 63 74 75 72 65 27  |nsiders picture'|
00000510  73 20 63 6f 6c 6f 75 72  20 72 61 6e 67 65 0a 61  |s colour range.a|
00000520  73 20 61 6e 20 61 72 62  69 74 72 61 72 79 20 76  |s an arbitrary v|
00000530  6f 6c 75 6d 65 20 69 6e  20 74 68 65 20 63 6f 6c  |olume in the col|
00000540  6f 75 72 20 63 75 62 65  2c 20 74 68 65 6e 20 79  |our cube, then y|
00000550  6f 75 20 63 61 6e 20 64  69 74 68 65 72 2f 64 69  |ou can dither/di|
00000560  73 70 6c 61 79 20 61 0a  70 69 63 74 75 72 65 20  |splay a.picture |
00000570  61 63 63 75 72 61 74 65  6c 79 20 69 66 20 61 6e  |accurately if an|
00000580  64 20 6f 6e 6c 79 20 69  66 20 74 68 65 20 76 6f  |d only if the vo|
00000590  6c 75 6d 65 20 63 6f 76  65 72 65 64 20 62 79 20  |lume covered by |
000005a0  74 68 65 20 61 76 61 69  6c 61 62 6c 65 20 63 6f  |the available co|
000005b0  6c 6f 75 72 73 0a 65 6e  63 6c 6f 73 65 73 20 74  |lours.encloses t|
000005c0  68 65 20 70 69 63 74 75  72 65 27 73 29 2e 20 54  |he picture's). T|
000005d0  68 65 20 6f 70 74 69 6d  61 6c 20 73 65 6c 65 63  |he optimal selec|
000005e0  74 69 6f 6e 20 75 73 65  64 20 66 6f 72 20 74 68  |tion used for th|
000005f0  65 20 52 49 53 43 20 4f  53 20 32 35 36 20 63 6f  |e RISC OS 256 co|
00000600  6c 6f 75 72 0a 6d 6f 64  65 20 70 61 6c 65 74 74  |lour.mode palett|
00000610  65 20 63 6f 6e 74 61 69  6e 73 20 32 20 6d 6f 73  |e contains 2 mos|
00000620  74 20 73 69 67 6e 69 66  69 63 61 6e 74 20 62 69  |t significant bi|
00000630  74 73 20 6f 66 20 52 65  64 2c 20 32 20 6d 6f 73  |ts of Red, 2 mos|
00000640  74 20 73 69 67 6e 69 66  69 63 61 6e 74 20 62 69  |t significant bi|
00000650  74 73 0a 6f 66 20 47 72  65 65 6e 20 61 6e 64 20  |ts.of Green and |
00000660  32 20 6d 6f 73 74 20 73  69 67 6e 69 66 69 63 61  |2 most significa|
00000670  6e 74 20 62 69 74 73 20  6f 66 20 42 6c 75 65 2c  |nt bits of Blue,|
00000680  20 77 69 74 68 20 74 68  65 20 6c 61 73 74 20 32  | with the last 2|
00000690  20 62 69 74 73 20 63 6f  6e 74 72 6f 6c 6c 69 6e  | bits controllin|
000006a0  67 0a 74 68 65 20 32 20  6c 65 61 73 74 20 73 69  |g.the 2 least si|
000006b0  67 6e 69 66 69 63 61 6e  74 20 62 69 74 73 20 69  |gnificant bits i|
000006c0  6e 20 70 61 72 61 6c 6c  65 6c 20 28 22 61 64 64  |n parallel ("add|
000006d0  73 20 77 68 69 74 65 22  20 74 6f 20 61 20 63 6f  |s white" to a co|
000006e0  6c 6f 75 72 29 2e 20 54  68 75 73 20 70 65 61 6b  |lour). Thus peak|
000006f0  0a 52 2c 20 47 2c 20 42  20 69 73 20 6f 62 74 61  |.R, G, B is obta|
00000700  69 6e 65 64 20 28 77 69  74 68 6f 75 74 20 73 69  |ined (without si|
00000710  64 65 20 65 66 66 65 63  74 73 20 69 66 20 76 61  |de effects if va|
00000720  72 69 65 64 20 73 69 6d  75 6c 74 61 6e 65 6f 75  |ried simultaneou|
00000730  73 6c 79 2c 20 77 69 74  68 20 61 20 73 69 64 65  |sly, with a side|
00000740  0a 65 66 66 65 63 74 20  69 66 20 70 65 61 6b 20  |.effect if peak |
00000750  52 20 28 73 61 79 29 20  61 6c 6f 6e 65 20 69 73  |R (say) alone is|
00000760  20 72 65 71 75 69 72 65  64 29 2e 20 41 20 63 6f  | required). A co|
00000770  72 72 65 63 74 6c 79 20  64 65 73 69 67 6e 65 64  |rrectly designed|
00000780  20 65 72 72 6f 72 20 64  69 66 66 75 73 69 6f 6e  | error diffusion|
00000790  0a 64 69 74 68 65 72 20  61 6c 67 6f 72 69 74 68  |.dither algorith|
000007a0  6d 20 63 61 6e 20 64 69  73 70 6c 61 79 20 70 69  |m can display pi|
000007b0  63 74 75 72 65 73 20 77  69 74 68 20 76 65 72 79  |ctures with very|
000007c0  20 68 69 67 68 20 66 69  64 65 6c 69 74 79 2e 20  | high fidelity. |
000007d0  5b 6e 6f 74 65 20 74 68  61 74 0a 64 69 74 68 65  |[note that.dithe|
000007e0  72 69 6e 67 20 61 6c 6c  20 70 69 63 74 75 72 65  |ring all picture|
000007f0  73 20 77 69 74 68 20 61  20 73 69 6e 67 6c 65 20  |s with a single |
00000800  70 61 6c 65 74 74 65 20  70 65 72 6d 69 74 73 20  |palette permits |
00000810  74 68 65 69 72 20 64 69  73 70 6c 61 79 0a 73 69  |their display.si|
00000820  6d 75 6c 74 61 6e 65 6f  75 73 6c 79 20 6f 6e 20  |multaneously on |
00000830  74 68 65 20 73 63 72 65  65 6e 2c 20 61 6c 73 6f  |the screen, also|
00000840  20 6e 6f 74 65 20 74 68  61 74 20 64 69 74 68 65  | note that dithe|
00000850  72 69 6e 67 20 74 6f 20  61 20 66 69 78 65 64 20  |ring to a fixed |
00000860  70 61 6c 65 74 74 65 20  69 73 0a 6d 75 63 68 20  |palette is.much |
00000870  71 75 69 63 6b 65 72 20  74 68 61 6e 20 73 65 6c  |quicker than sel|
00000880  65 63 74 69 6e 67 20 61  20 70 61 6c 65 74 74 65  |ecting a palette|
00000890  20 66 69 72 73 74 21 5d  0a 0a 4f 6e 65 20 63 61  | first!]..One ca|
000008a0  6e 20 61 6c 73 6f 20 70  72 6f 67 72 61 6d 20 74  |n also program t|
000008b0  68 65 20 73 79 73 74 65  6d 20 66 6f 72 20 61 20  |he system for a |
000008c0  6c 61 72 67 65 20 6e 75  6d 62 65 72 20 6f 66 20  |large number of |
000008d0  6e 20 62 69 74 73 20 70  65 72 20 63 6f 6c 6f 75  |n bits per colou|
000008e0  72 20 6d 6f 64 65 73 2c  0a 77 69 74 68 20 74 68  |r modes,.with th|
000008f0  65 20 6e 20 62 69 74 73  20 73 74 61 72 74 69 6e  |e n bits startin|
00000900  67 20 61 74 20 74 68 65  20 6d 6f 73 74 20 73 69  |g at the most si|
00000910  67 6e 69 66 69 63 61 6e  74 20 65 6e 64 20 6f 66  |gnificant end of|
00000920  20 74 68 65 20 63 6f 6c  6f 75 72 20 72 61 6e 67  | the colour rang|
00000930  65 2e 20 46 6f 72 0a 65  78 61 6d 70 6c 65 20 34  |e. For.example 4|
00000940  20 62 69 74 73 20 6f 66  20 67 72 65 65 6e 2c 20  | bits of green, |
00000950  33 20 62 69 74 73 20 6f  66 20 72 65 64 20 61 6e  |3 bits of red an|
00000960  64 20 31 20 62 69 74 20  6f 66 20 62 6c 75 65 2e  |d 1 bit of blue.|
00000970  20 54 68 65 20 63 6f 6e  73 74 72 61 69 6e 74 73  | The constraints|
00000980  20 61 72 65 3a 0a 20 20  20 20 20 32 20 3c 3d 20  | are:.     2 <= |
00000990  6e 47 72 65 65 6e 20 3c  3d 20 34 0a 20 20 20 20  |nGreen <= 4.    |
000009a0  20 31 20 3c 3d 20 6e 52  65 64 20 20 20 3c 3d 20  | 1 <= nRed   <= |
000009b0  34 0a 20 20 20 20 20 31  20 3c 3d 20 6e 42 6c 75  |4.     1 <= nBlu|
000009c0  65 20 20 3c 3d 20 34 0a  20 20 20 20 20 28 61 6e  |e  <= 4.     (an|
000009d0  64 20 6e 52 65 64 2b 6e  42 6c 75 65 2b 6e 47 72  |d nRed+nBlue+nGr|
000009e0  65 65 6e 3d 38 29 0a 4d  6f 64 65 73 20 6c 69 6b  |een=8).Modes lik|
000009f0  65 20 74 68 65 73 65 20  61 72 65 20 6f 66 74 65  |e these are ofte|
00000a00  6e 20 75 73 65 66 75 6c  20 66 6f 72 20 72 65 61  |n useful for rea|
00000a10  6c 20 74 69 6d 65 20 73  6f 6c 69 64 20 6d 6f 64  |l time solid mod|
00000a20  65 6c 6c 69 6e 67 20 28  77 68 65 72 65 20 74 68  |elling (where th|
00000a30  65 0a 65 78 70 65 6e 73  65 20 6f 66 20 64 69 74  |e.expense of dit|
00000a40  68 65 72 69 6e 67 20 77  69 74 68 20 65 72 72 6f  |hering with erro|
00000a50  72 20 64 69 66 66 75 73  69 6f 6e 20 28 63 69 72  |r diffusion (cir|
00000a60  63 61 20 31 30 30 20 63  79 63 6c 65 73 20 70 65  |ca 100 cycles pe|
00000a70  72 20 70 69 78 65 6c 29  20 63 61 6e 6e 6f 74 0a  |r pixel) cannot.|
00000a80  62 65 20 61 66 66 6f 72  64 65 64 29 2e 20 54 68  |be afforded). Th|
00000a90  65 73 65 20 73 65 6c 65  63 74 69 6f 6e 73 20 61  |ese selections a|
00000aa0  72 65 20 6e 6f 6e 2d 6f  70 74 69 6d 61 6c 3a 20  |re non-optimal: |
00000ab0  74 68 65 20 63 6f 6c 6f  75 72 20 63 75 62 65 20  |the colour cube |
00000ac0  69 73 20 6e 6f 74 0a 63  6f 6d 70 6c 65 74 65 6c  |is not.completel|
00000ad0  79 20 73 70 61 6e 6e 65  64 2e 0a 0a 44 69 73 70  |y spanned...Disp|
00000ae0  6c 61 79 69 6e 67 20 41  20 50 69 63 74 75 72 65  |laying A Picture|
00000af0  0a 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |.===============|
00000b00  3d 3d 3d 3d 3d 0a 0a 53  69 6e 63 65 20 61 20 63  |=====..Since a c|
00000b10  6f 6c 6f 75 72 20 69 6e  20 74 68 65 20 32 35 36  |olour in the 256|
00000b20  20 63 6f 6c 6f 75 72 20  6d 6f 64 65 20 63 61 6e  | colour mode can|
00000b30  20 62 65 20 73 75 63 68  20 61 20 63 6f 6d 70 6c  | be such a compl|
00000b40  69 63 61 74 65 64 20 74  68 69 6e 67 2c 20 77 69  |icated thing, wi|
00000b50  74 68 0a 76 61 72 79 69  6e 67 20 63 61 70 61 62  |th.varying capab|
00000b60  69 6c 69 74 79 20 6f 66  20 73 70 61 6e 6e 69 6e  |ility of spannin|
00000b70  67 20 74 68 65 20 63 6f  6c 6f 75 72 20 63 75 62  |g the colour cub|
00000b80  65 20 61 6e 64 20 61 6e  20 75 6e 6b 6e 6f 77 6e  |e and an unknown|
00000b90  20 61 63 63 75 72 61 63  79 2c 20 74 68 65 72 65  | accuracy, there|
00000ba0  0a 69 73 20 61 20 52 49  53 43 20 4f 53 20 73 74  |.is a RISC OS st|
00000bb0  61 6e 64 61 72 64 20 77  61 79 20 6f 66 20 73 70  |andard way of sp|
00000bc0  65 63 69 66 79 69 6e 67  20 61 20 63 6f 6c 6f 75  |ecifying a colou|
00000bd0  72 20 79 6f 75 20 77 69  73 68 20 74 6f 20 64 72  |r you wish to dr|
00000be0  61 77 20 77 69 74 68 20  75 73 69 6e 67 20 38 0a  |aw with using 8.|
00000bf0  62 69 74 73 20 66 6f 72  20 52 2c 20 47 20 61 6e  |bits for R, G an|
00000c00  64 20 42 20 63 6f 6d 70  6f 6e 65 6e 74 73 2e 20  |d B components. |
00000c10  41 20 63 61 6c 6c 20 74  6f 20 74 68 65 20 6f 70  |A call to the op|
00000c20  65 72 61 74 69 6e 67 20  73 79 73 74 65 6d 20 63  |erating system c|
00000c30  6f 6e 76 65 72 74 73 20  74 68 69 73 20 74 6f 0a  |onverts this to.|
00000c40  74 68 65 20 6e 65 61 72  65 73 74 20 63 6f 6c 6f  |the nearest colo|
00000c50  75 72 20 61 6e 64 20 6e  65 77 20 6f 62 6a 65 63  |ur and new objec|
00000c60  74 73 20 63 61 6e 20 62  65 20 64 72 61 77 6e 2e  |ts can be drawn.|
00000c70  0a 0a 57 68 65 72 65 20  74 68 65 20 6f 62 6a 65  |..Where the obje|
00000c80  63 74 20 74 6f 20 62 65  20 64 72 61 77 6e 20 69  |ct to be drawn i|
00000c90  73 20 61 20 70 72 65 76  69 6f 75 73 6c 79 20 67  |s a previously g|
00000ca0  65 6e 65 72 61 74 65 64  20 70 69 63 74 75 72 65  |enerated picture|
00000cb0  2c 20 74 68 65 20 6d 6f  64 75 6c 65 73 0a 22 53  |, the modules."S|
00000cc0  70 72 69 74 65 45 78 74  65 6e 64 22 20 28 69 6e  |priteExtend" (in|
00000cd0  20 74 68 65 20 52 4f 4d  29 20 61 6e 64 20 22 43  | the ROM) and "C|
00000ce0  6f 6c 6f 75 72 54 72 61  6e 73 22 20 28 69 6e 20  |olourTrans" (in |
00000cf0  74 68 65 20 21 53 79 73  74 65 6d 20 64 69 72 65  |the !System dire|
00000d00  63 74 6f 72 79 29 20 69  6e 0a 52 49 53 43 20 4f  |ctory) in.RISC O|
00000d10  53 20 70 72 6f 76 69 64  65 20 73 6f 6d 65 20 63  |S provide some c|
00000d20  61 70 61 62 69 6c 69 74  65 73 20 66 6f 72 20 64  |apabilites for d|
00000d30  69 73 70 6c 61 79 69 6e  67 20 70 69 63 74 75 72  |isplaying pictur|
00000d40  65 73 20 69 6e 20 64 69  66 66 65 72 65 6e 74 20  |es in different |
00000d50  73 63 72 65 65 6e 0a 6d  6f 64 65 73 2e 20 43 6f  |screen.modes. Co|
00000d60  6c 6f 75 72 54 72 61 6e  73 20 63 61 6e 20 6c 6f  |lourTrans can lo|
00000d70  6f 6b 20 61 74 20 74 68  65 20 70 61 6c 65 74 74  |ok at the palett|
00000d80  65 20 77 68 69 63 68 20  61 20 73 70 72 69 74 65  |e which a sprite|
00000d90  20 75 73 65 73 20 61 6e  64 20 72 65 74 75 72 6e  | uses and return|
00000da0  20 61 0a 6c 69 73 74 20  6f 66 20 74 68 65 20 65  | a.list of the e|
00000db0  71 75 69 76 61 6c 65 6e  74 20 27 63 6c 6f 73 65  |quivalent 'close|
00000dc0  73 74 27 20 63 6f 6c 6f  75 72 73 20 69 6e 20 74  |st' colours in t|
00000dd0  68 65 20 63 75 72 72 65  6e 74 20 73 63 72 65 65  |he current scree|
00000de0  6e 20 6d 6f 64 65 2e 0a  53 70 72 69 74 65 45 78  |n mode..SpriteEx|
00000df0  74 65 6e 64 20 63 61 6e  20 70 61 69 6e 74 20 73  |tend can paint s|
00000e00  70 72 69 74 65 73 20 75  73 69 6e 67 20 74 68 65  |prites using the|
00000e10  20 6c 69 73 74 20 6f 66  20 65 71 75 69 76 61 6c  | list of equival|
00000e20  65 6e 74 20 63 6f 6c 6f  75 72 73 20 61 6e 64 20  |ent colours and |
00000e30  63 61 6e 0a 63 68 61 6e  67 65 20 74 68 65 20 73  |can.change the s|
00000e40  69 7a 65 20 6f 66 20 74  68 65 20 69 6d 61 67 65  |ize of the image|
00000e50  20 69 6e 74 6f 20 74 68  65 20 62 61 72 67 61 69  | into the bargai|
00000e60  6e 2e 20 54 68 69 73 20  69 73 20 61 6c 6c 20 76  |n. This is all v|
00000e70  65 72 79 20 77 65 6c 6c  20 66 6f 72 20 73 69 6d  |ery well for sim|
00000e80  70 6c 65 0a 70 69 63 74  75 72 65 73 20 6f 72 20  |ple.pictures or |
00000e90  70 69 63 74 75 72 65 73  20 63 72 65 61 74 65 64  |pictures created|
00000ea0  20 64 69 72 65 63 74 6c  79 20 66 6f 72 20 61 20  | directly for a |
00000eb0  70 61 72 74 69 63 75 6c  61 72 20 6d 6f 64 65 2c  |particular mode,|
00000ec0  20 62 75 74 20 77 68 61  74 20 68 61 70 70 65 6e  | but what happen|
00000ed0  73 0a 66 6f 72 20 6d 6f  72 65 20 64 65 74 61 69  |s.for more detai|
00000ee0  6c 65 64 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |led information |
00000ef0  6f 72 20 70 69 63 74 75  72 65 73 20 66 72 6f 6d  |or pictures from|
00000f00  20 6f 74 68 65 72 20 73  6f 75 72 63 65 73 20 77  | other sources w|
00000f10  69 74 68 20 72 65 73 6f  6c 75 74 69 6f 6e 0a 6e  |ith resolution.n|
00000f20  6f 74 20 6d 61 74 63 68  65 64 20 62 79 20 74 68  |ot matched by th|
00000f30  65 20 41 72 63 68 69 6d  65 64 65 73 20 68 61 72  |e Archimedes har|
00000f40  64 77 61 72 65 3f 0a 0a  41 6c 73 6f 20 74 68 65  |dware?..Also the|
00000f50  20 61 62 6f 76 65 20 66  61 63 69 6c 69 74 69 65  | above facilitie|
00000f60  73 20 61 72 65 20 72 61  74 68 65 72 20 62 61 73  |s are rather bas|
00000f70  69 63 3a 20 43 6f 6c 6f  75 72 54 72 61 6e 73 20  |ic: ColourTrans |
00000f80  6d 61 6b 65 73 20 6e 6f  20 65 66 66 6f 72 74 20  |makes no effort |
00000f90  74 6f 20 75 73 65 0a 64  69 74 68 65 72 69 6e 67  |to use.dithering|
00000fa0  20 28 74 68 65 20 70 72  61 63 74 69 73 65 20 6f  | (the practise o|
00000fb0  66 20 70 75 74 74 69 6e  67 20 70 61 74 74 65 72  |f putting patter|
00000fc0  6e 73 20 6f 66 20 64 69  66 66 65 72 65 6e 74 20  |ns of different |
00000fd0  63 6f 6c 6f 75 72 65 64  20 70 69 78 65 6c 73 0a  |coloured pixels.|
00000fe0  74 6f 67 65 74 68 65 72  20 74 6f 20 72 65 70 72  |together to repr|
00000ff0  65 73 65 6e 74 20 6f 74  68 65 72 20 63 6f 6c 6f  |esent other colo|
00001000  75 72 73 29 20 61 6e 64  20 53 70 72 69 74 65 45  |urs) and SpriteE|
00001010  78 74 65 6e 64 20 73 69  6d 70 6c 79 20 64 69 73  |xtend simply dis|
00001020  63 61 72 64 73 0a 61 64  64 69 74 69 6f 6e 61 6c  |cards.additional|
00001030  20 69 6e 66 6f 72 6d 61  74 69 6f 6e 20 69 66 20  | information if |
00001040  72 65 64 75 63 69 6e 67  20 74 68 65 20 70 69 63  |reducing the pic|
00001050  74 75 72 65 20 69 6e 20  73 69 7a 65 20 28 61 6e  |ture in size (an|
00001060  64 20 74 6f 67 65 74 68  65 72 20 74 68 65 79 20  |d together they |
00001070  6d 61 6b 65 0a 6e 6f 20  61 74 74 65 6d 70 74 20  |make.no attempt |
00001080  74 6f 20 65 6e 68 61 6e  63 65 20 74 68 65 20 70  |to enhance the p|
00001090  69 63 74 75 72 65 20 77  68 65 6e 20 6d 61 6b 69  |icture when maki|
000010a0  6e 67 20 69 74 20 6c 61  72 67 65 72 29 2e 20 54  |ng it larger). T|
000010b0  68 65 20 72 65 61 73 6f  6e 20 66 6f 72 20 74 68  |he reason for th|
000010c0  65 73 65 0a 73 68 6f 72  74 63 6f 6d 69 6e 67 73  |ese.shortcomings|
000010d0  20 69 73 20 71 75 69 74  65 20 73 69 6d 70 6c 65  | is quite simple|
000010e0  3a 20 73 70 65 65 64 2e  20 54 68 65 20 61 6c 67  |: speed. The alg|
000010f0  6f 72 69 74 68 6d 20 75  73 65 64 20 69 6e 20 43  |orithm used in C|
00001100  68 61 6e 67 65 46 53 49  20 75 73 65 73 20 31 30  |hangeFSI uses 10|
00001110  35 0a 41 52 4d 20 69 6e  73 74 72 75 63 74 69 6f  |5.ARM instructio|
00001120  6e 73 20 70 65 72 20 70  69 78 65 6c 20 2d 20 61  |ns per pixel - a|
00001130  6e 64 20 74 68 61 74 27  73 20 61 70 61 72 74 20  |nd that's apart |
00001140  66 72 6f 6d 20 61 6e 79  20 69 6e 73 74 72 75 63  |from any instruc|
00001150  74 69 6f 6e 73 20 75 73  65 64 20 74 6f 0a 72 65  |tions used to.re|
00001160  61 64 20 74 68 65 20 69  6d 61 67 65 20 69 6e 2c  |ad the image in,|
00001170  20 63 68 61 6e 67 65 20  69 74 73 20 73 69 7a 65  | change its size|
00001180  20 61 6e 64 20 77 72 69  74 65 20 74 68 65 20 72  | and write the r|
00001190  65 73 75 6c 74 20 6f 75  74 2e 20 46 6f 72 20 63  |esult out. For c|
000011a0  6f 6d 70 61 72 69 73 6f  6e 2c 0a 74 68 65 20 6e  |omparison,.the n|
000011b0  6f 72 6d 61 6c 20 73 70  72 69 74 65 20 70 6c 6f  |ormal sprite plo|
000011c0  74 20 74 61 6b 65 73 20  6f 6e 6c 79 20 6f 6e 65  |t takes only one|
000011d0  20 69 6e 73 74 72 75 63  74 69 6f 6e 20 70 65 72  | instruction per|
000011e0  20 70 69 78 65 6c 20 28  34 20 69 6e 73 74 72 75  | pixel (4 instru|
000011f0  63 74 69 6f 6e 73 20 66  6f 72 0a 66 6f 75 72 20  |ctions for.four |
00001200  38 20 62 69 74 20 70 69  78 65 6c 73 29 2e 20 50  |8 bit pixels). P|
00001210  72 6f 63 65 73 73 69 6e  67 20 61 20 4d 4f 44 45  |rocessing a MODE|
00001220  20 31 35 20 70 69 63 74  75 72 65 20 74 68 75 73  | 15 picture thus|
00001230  20 75 73 65 73 20 75 70  20 74 6f 6f 20 6d 61 6e  | uses up too man|
00001240  79 20 73 65 63 6f 6e 64  73 0a 6f 66 20 41 52 4d  |y seconds.of ARM|
00001250  20 63 70 75 20 74 69 6d  65 20 74 6f 20 69 6d 61  | cpu time to ima|
00001260  67 69 6e 65 20 69 74 20  61 73 20 70 61 72 74 20  |gine it as part |
00001270  6f 66 20 74 68 65 20 69  6e 74 65 72 61 63 74 69  |of the interacti|
00001280  76 65 20 64 65 73 6b 74  6f 70 2e 0a 0a 53 6f 20  |ve desktop...So |
00001290  77 68 61 74 20 64 6f 65  73 20 43 68 61 6e 67 65  |what does Change|
000012a0  46 53 49 20 64 6f 20 74  6f 20 6d 61 6b 65 20 74  |FSI do to make t|
000012b0  68 65 20 73 69 74 75 61  74 69 6f 6e 20 62 65 74  |he situation bet|
000012c0  74 65 72 3f 20 41 6e 64  20 77 68 79 20 64 6f 65  |ter? And why doe|
000012d0  73 20 69 74 20 74 61 6b  65 20 73 6f 0a 6c 6f 6e  |s it take so.lon|
000012e0  67 3f 20 4f 6e 65 20 63  61 6e 20 69 6d 6d 65 64  |g? One can immed|
000012f0  69 61 74 65 6c 79 20 64  72 61 77 20 75 70 20 73  |iately draw up s|
00001300  6f 6d 65 20 64 65 73 69  72 61 62 6c 65 20 70 72  |ome desirable pr|
00001310  6f 70 65 72 74 69 65 73  20 66 6f 72 20 61 6e 79  |operties for any|
00001320  20 73 6f 6c 75 74 69 6f  6e 20 74 6f 0a 74 68 65  | solution to.the|
00001330  20 69 6d 61 67 65 20 63  68 61 6e 67 69 6e 67 20  | image changing |
00001340  70 72 6f 62 6c 65 6d 3a  0a 0a 28 31 29 20 4d 61  |problem:..(1) Ma|
00001350  78 69 6d 69 73 69 6e 67  20 74 68 65 20 76 6f 6c  |ximising the vol|
00001360  75 6d 65 20 6f 66 20 74  68 65 20 63 6f 6c 6f 75  |ume of the colou|
00001370  72 20 63 75 62 65 2e 20  43 6f 6c 6f 75 72 20 72  |r cube. Colour r|
00001380  65 70 72 65 73 65 6e 74  65 64 20 69 6e 20 74 68  |epresented in th|
00001390  65 20 52 65 64 2c 0a 47  72 65 65 6e 20 61 6e 64  |e Red,.Green and|
000013a0  20 42 6c 75 65 20 63 6f  6d 70 75 74 65 72 20 67  | Blue computer g|
000013b0  72 61 70 68 69 63 73 20  73 79 73 74 65 6d 20 63  |raphics system c|
000013c0  61 6e 20 62 65 20 74 68  6f 75 67 68 74 20 6f 66  |an be thought of|
000013d0  20 61 73 20 61 20 70 6f  69 6e 74 20 69 6e 20 61  | as a point in a|
000013e0  20 33 44 0a 63 75 62 65  20 77 68 6f 73 65 20 61  | 3D.cube whose a|
000013f0  78 65 73 20 61 72 65 20  74 68 65 20 72 65 64 2c  |xes are the red,|
00001400  20 67 72 65 65 6e 20 61  6e 64 20 62 6c 75 65 20  | green and blue |
00001410  76 61 6c 75 65 73 2e 20  57 68 61 74 65 76 65 72  |values. Whatever|
00001420  20 63 6c 65 76 65 72 0a  61 70 70 72 6f 78 69 6d  | clever.approxim|
00001430  61 74 69 6f 6e 73 2c 20  64 69 74 68 65 72 69 6e  |ations, ditherin|
00001440  67 20 6f 72 20 65 72 72  6f 72 20 64 69 66 66 75  |g or error diffu|
00001450  73 69 6f 6e 20 74 65 63  68 6e 69 71 75 65 73 20  |sion techniques |
00001460  61 72 65 20 75 73 65 64  2c 20 74 68 65 20 63 6f  |are used, the co|
00001470  6c 6f 75 72 0a 76 6f 6c  75 6d 65 20 73 70 61 6e  |lour.volume span|
00001480  6e 65 64 20 62 79 20 74  68 65 20 72 2c 20 67 20  |ned by the r, g |
00001490  61 6e 64 20 62 20 61 78  65 73 20 69 6e 20 74 68  |and b axes in th|
000014a0  65 20 74 61 72 67 65 74  20 73 68 6f 75 6c 64 20  |e target should |
000014b0  62 65 20 6c 61 72 67 65  20 65 6e 6f 75 67 68 20  |be large enough |
000014c0  74 6f 0a 63 6f 6e 74 61  69 6e 20 74 68 65 20 73  |to.contain the s|
000014d0  6f 75 72 63 65 20 76 6f  6c 75 6d 65 2e 20 49 66  |ource volume. If|
000014e0  20 6e 6f 74 2c 20 74 68  65 6e 20 74 68 65 20 70  | not, then the p|
000014f0  69 63 74 75 72 65 20 77  69 6c 6c 20 61 70 70 65  |icture will appe|
00001500  61 72 20 66 61 64 65 64  20 69 6e 20 73 6f 6d 65  |ar faded in some|
00001510  0a 77 61 79 20 63 6f 6d  70 61 72 65 64 20 74 6f  |.way compared to|
00001520  20 74 68 65 20 6f 72 69  67 69 6e 61 6c 20 28 22  | the original ("|
00001530  74 68 65 20 72 65 64 20  64 6f 65 73 6e 27 74 20  |the red doesn't |
00001540  73 65 65 6d 20 71 75 69  74 65 20 74 68 65 20 73  |seem quite the s|
00001550  61 6d 65 22 29 2e 20 46  6f 72 20 61 0a 73 69 6e  |ame"). For a.sin|
00001560  67 6c 65 20 70 69 63 74  75 72 65 20 61 20 63 6f  |gle picture a co|
00001570  6c 6f 75 72 20 76 6f 6c  75 6d 65 20 6f 6e 6c 79  |lour volume only|
00001580  20 61 73 20 6c 61 72 67  65 20 61 73 20 74 68 65  | as large as the|
00001590  20 69 6e 70 75 74 20 63  6f 75 6c 64 20 62 65 20  | input could be |
000015a0  63 68 6f 73 65 6e 3b 0a  61 6c 74 65 72 6e 61 74  |chosen;.alternat|
000015b0  69 76 65 6c 79 20 66 6f  72 20 61 6e 20 61 72 62  |ively for an arb|
000015c0  69 74 72 61 72 79 20 73  65 74 20 6f 66 20 69 6e  |itrary set of in|
000015d0  70 75 74 20 70 69 63 74  75 72 65 73 2c 20 74 68  |put pictures, th|
000015e0  65 20 63 6f 6c 6f 75 72  20 76 6f 6c 75 6d 65 20  |e colour volume |
000015f0  6f 6e 20 74 68 65 0a 6f  75 74 70 75 74 20 73 79  |on the.output sy|
00001600  73 74 65 6d 20 68 61 73  20 74 6f 20 62 65 20 6d  |stem has to be m|
00001610  61 64 65 20 61 73 20 6c  61 72 67 65 20 61 73 20  |ade as large as |
00001620  70 6f 73 73 69 62 6c 65  2e 20 57 68 65 72 65 20  |possible. Where |
00001630  61 6e 69 6d 61 74 69 6f  6e 20 69 73 20 72 65 71  |animation is req|
00001640  75 69 72 65 64 0a 74 68  65 20 63 6f 6c 6f 75 72  |uired.the colour|
00001650  20 76 6f 6c 75 6d 65 20  68 61 73 20 74 6f 20 62  | volume has to b|
00001660  65 20 63 6f 6e 73 69 73  74 65 6e 74 20 66 6f 72  |e consistent for|
00001670  20 61 6c 6c 20 74 68 65  20 70 69 63 74 75 72 65  | all the picture|
00001680  73 2e 20 57 68 65 6e 20  67 65 6e 65 72 61 74 69  |s. When generati|
00001690  6e 67 0a 74 68 65 20 6c  61 72 67 65 73 74 20 76  |ng.the largest v|
000016a0  6f 6c 75 6d 65 2c 20 69  74 20 69 73 20 69 6d 70  |olume, it is imp|
000016b0  6f 72 74 61 6e 74 20 74  6f 20 75 73 65 20 74 68  |ortant to use th|
000016c0  65 20 73 79 73 74 65 6d  20 68 61 72 64 77 61 72  |e system hardwar|
000016d0  65 20 74 6f 20 74 68 65  20 6c 69 6d 69 74 3a 0a  |e to the limit:.|
000016e0  66 6f 72 20 65 78 61 6d  70 6c 65 2c 20 69 66 20  |for example, if |
000016f0  6f 6e 65 20 68 61 73 20  74 77 6f 20 62 69 74 73  |one has two bits|
00001700  20 6f 66 20 63 6f 6e 74  72 6f 6c 20 6f 76 65 72  | of control over|
00001710  20 74 68 65 20 41 72 63  68 69 6d 65 64 65 73 20  | the Archimedes |
00001720  34 20 62 69 74 20 44 20  74 6f 20 41 0a 63 6f 6e  |4 bit D to A.con|
00001730  76 65 72 74 65 72 73 2c  20 74 68 65 20 6c 61 72  |verters, the lar|
00001740  67 65 73 74 20 72 61 6e  67 65 20 69 73 20 63 6f  |gest range is co|
00001750  76 65 72 65 64 20 62 79  20 76 61 6c 75 65 73 20  |vered by values |
00001760  30 2c 20 35 2c 20 31 30  20 61 6e 64 20 31 35 20  |0, 5, 10 and 15 |
00001770  28 72 61 74 68 65 72 20  74 68 61 6e 0a 30 2c 20  |(rather than.0, |
00001780  34 2c 20 38 20 61 6e 64  20 31 32 29 2e 0a 0a 28  |4, 8 and 12)...(|
00001790  32 29 20 47 69 76 69 6e  67 20 68 75 65 20 63 6f  |2) Giving hue co|
000017a0  6e 73 69 73 74 65 6e 63  79 20 61 74 20 64 69 66  |nsistency at dif|
000017b0  66 65 72 65 6e 74 20 73  61 74 75 72 61 74 69 6f  |ferent saturatio|
000017c0  6e 73 2e 20 46 6f 72 20  65 78 61 6d 70 6c 65 2c  |ns. For example,|
000017d0  20 77 69 74 68 20 61 0a  70 61 6c 65 74 74 65 20  | with a.palette |
000017e0  77 69 74 68 20 64 69 66  66 65 72 65 6e 74 20 6e  |with different n|
000017f0  75 6d 62 65 72 73 20 6f  66 20 62 69 74 73 20 6f  |umbers of bits o|
00001800  66 20 72 2c 20 67 20 61  6e 64 20 62 20 69 74 20  |f r, g and b it |
00001810  6d 61 79 20 62 65 20 69  6d 70 6f 73 73 69 62 6c  |may be impossibl|
00001820  65 20 74 6f 0a 68 61 76  65 20 61 20 63 6f 6e 73  |e to.have a cons|
00001830  69 73 74 65 6e 74 20 73  65 74 20 6f 66 20 63 6f  |istent set of co|
00001840  6c 6f 75 72 73 20 72 65  70 72 65 73 65 6e 74 69  |lours representi|
00001850  6e 67 20 64 65 72 69 76  65 64 20 63 6f 6c 6f 75  |ng derived colou|
00001860  72 73 20 61 74 20 64 69  66 66 65 72 65 6e 74 0a  |rs at different.|
00001870  6c 65 76 65 6c 73 20 6f  66 20 69 6e 74 65 6e 73  |levels of intens|
00001880  69 74 79 2e 20 53 68 61  64 65 73 20 6f 66 20 77  |ity. Shades of w|
00001890  68 69 74 65 20 61 6e 64  20 73 65 63 6f 6e 64 61  |hite and seconda|
000018a0  72 79 20 63 6f 6c 6f 75  72 73 20 28 63 79 61 6e  |ry colours (cyan|
000018b0  2c 20 6d 61 67 65 6e 74  61 20 61 6e 64 0a 79 65  |, magenta and.ye|
000018c0  6c 6c 6f 77 29 20 61 72  65 20 70 61 72 74 69 63  |llow) are partic|
000018d0  75 6c 61 72 6c 79 20 64  69 66 66 69 63 75 6c 74  |ularly difficult|
000018e0  2e 0a 0a 28 33 29 20 57  6f 72 6b 69 6e 67 20 77  |...(3) Working w|
000018f0  69 74 68 20 74 68 65 20  6d 75 6c 74 69 2d 74 61  |ith the multi-ta|
00001900  73 6b 69 6e 67 20 64 65  73 6b 74 6f 70 2e 20 41  |sking desktop. A|
00001910  63 6f 72 6e 20 61 72 65  20 61 73 6b 69 6e 67 20  |corn are asking |
00001920  66 6f 72 20 61 6c 6c 20  6e 65 77 0a 73 6f 66 74  |for all new.soft|
00001930  77 61 72 65 20 74 6f 20  62 65 20 62 75 69 6c 74  |ware to be built|
00001940  20 6f 6e 20 74 68 65 20  6d 75 6c 74 69 74 61 73  | on the multitas|
00001950  6b 69 6e 67 20 73 79 73  74 65 6d 2e 20 54 68 69  |king system. Thi|
00001960  73 20 69 6d 70 6c 69 65  73 20 74 68 61 74 20 74  |s implies that t|
00001970  68 65 20 70 61 6c 65 74  74 65 0a 73 68 6f 75 6c  |he palette.shoul|
00001980  64 20 6e 6f 74 20 62 65  20 63 68 61 6e 67 65 64  |d not be changed|
00001990  20 28 6f 72 20 74 68 61  74 20 74 68 65 20 61 67  | (or that the ag|
000019a0  72 65 65 6d 65 6e 74 20  6f 66 20 61 6c 6c 20 70  |reement of all p|
000019b0  72 6f 67 72 61 6d 73 20  63 75 72 72 65 6e 74 6c  |rograms currentl|
000019c0  79 20 72 75 6e 6e 69 6e  67 0a 69 73 20 6f 62 74  |y running.is obt|
000019d0  61 69 6e 65 64 20 66 69  72 73 74 29 2e 0a 0a 54  |ained first)...T|
000019e0  68 65 20 64 65 73 6b 74  6f 70 20 28 64 65 66 61  |he desktop (defa|
000019f0  75 6c 74 29 20 70 61 6c  65 74 74 65 20 69 6e 20  |ult) palette in |
00001a00  74 68 65 20 32 35 36 20  63 6f 6c 6f 75 72 20 6d  |the 256 colour m|
00001a10  6f 64 65 73 20 28 65 2e  67 2e 20 6d 6f 64 65 73  |odes (e.g. modes|
00001a20  20 31 33 2c 20 31 35 2c  20 32 31 2c 0a 32 34 20  | 13, 15, 21,.24 |
00001a30  61 6e 64 20 32 38 29 20  69 73 20 71 75 69 74 65  |and 28) is quite|
00001a40  20 77 65 6c 6c 20 64 65  73 69 67 6e 65 64 2e 20  | well designed. |
00001a50  49 74 20 64 6f 65 73 20  68 61 76 65 20 74 68 65  |It does have the|
00001a60  20 70 72 6f 70 65 72 74  69 65 73 20 6f 66 20 28  | properties of (|
00001a70  31 29 20 61 6e 64 20 28  32 29 0a 28 69 74 20 65  |1) and (2).(it e|
00001a80  76 65 6e 20 68 61 73 20  31 36 20 73 68 61 64 65  |ven has 16 shade|
00001a90  73 20 6f 66 20 67 72 65  79 29 20 61 6e 64 20 61  |s of grey) and a|
00001aa0  75 74 6f 6d 61 74 69 63  61 6c 6c 79 20 73 61 74  |utomatically sat|
00001ab0  69 73 66 69 65 73 20 28  33 29 2e 20 49 74 20 69  |isfies (3). It i|
00001ac0  73 20 75 73 65 64 20 62  79 0a 6d 61 6e 79 20 41  |s used by.many A|
00001ad0  63 6f 72 6e 20 70 72 6f  67 72 61 6d 73 20 28 44  |corn programs (D|
00001ae0  72 61 77 2c 20 50 61 69  6e 74 29 20 61 6e 64 20  |raw, Paint) and |
00001af0  62 79 20 65 78 74 65 72  6e 61 6c 20 70 72 6f 67  |by external prog|
00001b00  72 61 6d 73 20 28 45 75  63 6c 69 64 2c 20 50 72  |rams (Euclid, Pr|
00001b10  6f 41 72 74 69 73 61 6e  2c 0a 41 74 65 6c 69 65  |oArtisan,.Atelie|
00001b20  72 2c 20 2e 2e 29 20 74  6f 20 67 72 65 61 74 20  |r, ..) to great |
00001b30  65 66 66 65 63 74 20 61  6e 64 20 69 73 20 61 20  |effect and is a |
00001b40  73 61 66 65 20 63 68 6f  69 63 65 20 66 6f 72 20  |safe choice for |
00001b50  43 68 61 6e 67 65 46 53  49 2e 20 54 68 65 72 65  |ChangeFSI. There|
00001b60  20 61 72 65 20 74 77 6f  0a 77 61 79 73 20 43 68  | are two.ways Ch|
00001b70  61 6e 67 65 46 53 49 20  63 61 6e 20 63 68 6f 6f  |angeFSI can choo|
00001b80  73 65 20 61 20 63 6f 6c  6f 75 72 3a 0a 0a 28 61  |se a colour:..(a|
00001b90  29 20 61 20 6d 65 74 68  6f 64 20 77 68 69 63 68  |) a method which|
00001ba0  20 64 65 72 69 76 65 73  20 76 61 6c 75 65 73 20  | derives values |
00001bb0  66 6f 72 20 72 2c 20 67  2c 20 62 20 61 6e 64 20  |for r, g, b and |
00001bc0  74 69 6e 74 20 61 6c 67  6f 72 69 74 68 6d 69 63  |tint algorithmic|
00001bd0  61 6c 6c 79 20 28 6e 6f  0a 73 75 66 66 69 78 29  |ally (no.suffix)|
00001be0  20 28 73 75 69 74 61 62  6c 65 20 6f 6e 6c 79 20  | (suitable only |
00001bf0  66 6f 72 20 74 68 65 20  64 65 66 61 75 6c 74 20  |for the default |
00001c00  52 49 53 43 20 4f 53 20  32 35 36 20 63 6f 6c 6f  |RISC OS 256 colo|
00001c10  75 72 20 70 61 6c 65 74  74 65 29 0a 0a 28 62 29  |ur palette)..(b)|
00001c20  20 73 65 61 72 63 68 20  74 68 65 20 70 61 6c 65  | search the pale|
00001c30  74 74 65 20 66 6f 72 20  74 68 65 20 63 6c 6f 73  |tte for the clos|
00001c40  65 73 74 20 63 6f 6c 6f  75 72 20 28 72 20 73 75  |est colour (r su|
00001c50  66 66 69 78 29 2e 20 54  68 65 20 70 72 65 63 69  |ffix). The preci|
00001c60  73 65 20 6d 65 74 68 6f  64 20 62 79 0a 77 68 69  |se method by.whi|
00001c70  63 68 20 74 68 69 73 20  69 73 20 64 6f 6e 65 20  |ch this is done |
00001c80  69 73 20 74 68 65 20 73  75 62 6a 65 63 74 20 6f  |is the subject o|
00001c90  66 20 61 6e 6f 74 68 65  72 20 64 6f 63 75 6d 65  |f another docume|
00001ca0  6e 74 2e 0a 0a 41 53 49  44 45 3a 20 74 68 65 20  |nt...ASIDE: the |
00001cb0  63 6c 6f 73 65 73 74 20  63 6f 6c 6f 75 72 20 69  |closest colour i|
00001cc0  73 20 63 68 6f 73 65 6e  20 73 75 63 68 20 74 68  |s chosen such th|
00001cd0  61 74 20 74 68 65 20 64  69 73 74 61 6e 63 65 20  |at the distance |
00001ce0  62 65 74 77 65 65 6e 20  74 68 65 20 74 72 75 65  |between the true|
00001cf0  0a 63 6f 6c 6f 75 72 20  61 6e 64 20 74 68 65 20  |.colour and the |
00001d00  63 68 6f 69 63 65 20 69  73 20 6d 69 6e 69 6d 69  |choice is minimi|
00001d10  73 65 64 20 69 6e 20 74  68 65 20 63 6f 6c 6f 75  |sed in the colou|
00001d20  72 20 63 75 62 65 20 73  70 61 63 65 2e 20 53 69  |r cube space. Si|
00001d30  6e 63 65 20 74 68 65 20  68 75 6d 61 6e 0a 65 79  |nce the human.ey|
00001d40  65 20 69 73 20 6d 6f 72  65 20 73 65 6e 73 69 74  |e is more sensit|
00001d50  69 76 65 20 74 6f 20 67  72 65 65 6e 2c 20 74 68  |ive to green, th|
00001d60  65 6e 20 72 65 64 20 61  6e 64 20 6c 61 73 74 6c  |en red and lastl|
00001d70  79 20 62 6c 75 65 2c 20  74 68 65 20 64 69 73 74  |y blue, the dist|
00001d80  61 6e 63 65 20 66 75 6e  63 74 69 6f 6e 0a 69 73  |ance function.is|
00001d90  20 77 65 69 67 68 74 65  64 20 31 30 2c 20 33 20  | weighted 10, 3 |
00001da0  61 6e 64 20 31 20 69 6e  20 67 72 65 65 6e 27 73  |and 1 in green's|
00001db0  20 66 61 76 6f 75 72 2e  0a 0a 57 69 74 68 20 74  | favour...With t|
00001dc0  68 65 20 31 36 20 63 6f  6c 6f 75 72 20 6d 6f 64  |he 16 colour mod|
00001dd0  65 73 20 28 65 2e 67 2e  20 6d 6f 64 65 73 20 39  |es (e.g. modes 9|
00001de0  2c 20 31 32 2c 20 31 36  2c 20 32 30 20 61 6e 64  |, 12, 16, 20 and|
00001df0  20 32 37 29 20 74 68 65  20 64 65 66 61 75 6c 74  | 27) the default|
00001e00  20 70 61 6c 65 74 74 65  0a 64 6f 65 73 20 6e 6f  | palette.does no|
00001e10  74 20 73 61 74 69 73 66  79 20 28 31 29 20 61 6e  |t satisfy (1) an|
00001e20  64 20 28 32 29 20 75 6e  6c 65 73 73 20 74 68 65  |d (2) unless the|
00001e30  20 6f 75 74 70 75 74 20  69 73 20 70 75 72 65 6c  | output is purel|
00001e40  79 20 73 68 61 64 65 73  20 6f 66 20 67 72 65 79  |y shades of grey|
00001e50  20 2d 0a 43 68 61 6e 67  65 46 53 49 20 63 61 6e  | -.ChangeFSI can|
00001e60  20 75 73 65 20 65 69 74  68 65 72 20 38 20 67 72  | use either 8 gr|
00001e70  65 79 73 20 28 66 6f 72  20 74 68 65 20 64 65 73  |eys (for the des|
00001e80  6b 74 6f 70 29 20 6f 72  20 31 36 20 67 72 65 79  |ktop) or 16 grey|
00001e90  73 20 28 6f 75 74 20 6f  66 20 74 68 65 0a 64 65  |s (out of the.de|
00001ea0  73 6b 74 6f 70 20 6f 72  20 77 69 74 68 20 74 68  |sktop or with th|
00001eb0  65 20 64 65 73 6b 74 6f  70 20 70 61 6c 65 74 74  |e desktop palett|
00001ec0  65 20 61 6c 74 65 72 65  64 20 74 6f 20 70 72 6f  |e altered to pro|
00001ed0  76 69 64 65 20 31 36 20  67 72 65 79 73 29 2e 20  |vide 16 greys). |
00001ee0  46 6f 72 20 63 6f 6c 6f  75 72 0a 72 65 70 72 65  |For colour.repre|
00001ef0  73 65 6e 74 61 74 69 6f  6e 2c 20 43 68 61 6e 67  |sentation, Chang|
00001f00  65 46 53 49 20 63 61 6e  20 65 69 74 68 65 72 3a  |eFSI can either:|
00001f10  0a 0a 28 61 29 20 75 73  65 20 31 20 62 69 74 20  |..(a) use 1 bit |
00001f20  6f 66 20 72 65 64 2c 20  31 20 62 69 74 20 6f 66  |of red, 1 bit of|
00001f30  20 67 72 65 65 6e 20 61  6e 64 20 31 20 62 69 74  | green and 1 bit|
00001f40  20 6f 66 20 62 6c 75 65  20 28 69 2e 65 2e 20 74  | of blue (i.e. t|
00001f50  68 65 20 73 74 61 6e 64  61 72 64 20 38 0a 64 69  |he standard 8.di|
00001f60  67 69 74 61 6c 20 63 6f  6c 6f 75 72 73 20 42 6c  |gital colours Bl|
00001f70  61 63 6b 2c 20 52 65 64  2c 20 47 72 65 65 6e 2c  |ack, Red, Green,|
00001f80  20 42 6c 75 65 2c 20 59  65 6c 6c 6f 77 2c 20 4d  | Blue, Yellow, M|
00001f90  61 67 65 6e 74 61 2c 20  43 79 61 6e 20 61 6e 64  |agenta, Cyan and|
00001fa0  20 57 68 69 74 65 29 2e  20 54 68 69 73 0a 73 70  | White). This.sp|
00001fb0  61 6e 73 20 74 68 65 20  63 6f 6c 6f 75 72 20 63  |ans the colour c|
00001fc0  75 62 65 20 61 6e 64 20  69 73 20 68 75 65 20 63  |ube and is hue c|
00001fd0  6f 6e 73 69 73 74 65 6e  74 2c 20 62 75 74 20 64  |onsistent, but d|
00001fe0  6f 65 73 6e 27 74 20 75  73 65 20 74 68 65 20 66  |oesn't use the f|
00001ff0  75 6c 6c 20 72 61 6e 67  65 20 6f 66 0a 62 69 74  |ull range of.bit|
00002000  73 20 70 72 6f 76 69 64  65 64 20 69 6e 20 74 68  |s provided in th|
00002010  65 20 66 6f 72 6d 61 74  2e 20 43 6f 6c 6f 75 72  |e format. Colour|
00002020  54 72 61 6e 73 20 63 61  6e 20 6d 61 70 20 74 68  |Trans can map th|
00002030  69 73 20 74 6f 20 74 68  65 20 64 65 73 6b 74 6f  |is to the deskto|
00002040  70 20 77 69 74 68 20 74  68 65 0a 73 74 61 6e 64  |p with the.stand|
00002050  61 72 64 20 70 61 6c 65  74 74 65 20 77 69 74 68  |ard palette with|
00002060  20 66 61 69 72 20 73 75  63 63 65 73 73 2c 20 65  | fair success, e|
00002070  78 63 65 70 74 20 66 6f  72 20 74 68 65 20 6c 61  |xcept for the la|
00002080  63 6b 20 6f 66 20 6d 61  67 65 6e 74 61 20 28 66  |ck of magenta (f|
00002090  75 6c 6c 0a 72 65 64 2b  66 75 6c 6c 20 62 6c 75  |ull.red+full blu|
000020a0  65 29 20 69 6e 20 74 68  65 20 70 61 6c 65 74 74  |e) in the palett|
000020b0  65 2e 20 41 20 62 65 74  74 65 72 20 72 65 73 75  |e. A better resu|
000020c0  6c 74 20 63 61 6e 20 62  65 20 61 63 68 69 65 76  |lt can be achiev|
000020d0  65 64 20 62 79 20 73 65  74 74 69 6e 67 20 36 20  |ed by setting 6 |
000020e0  6f 66 0a 74 68 65 20 63  6f 6c 6f 75 72 73 20 69  |of.the colours i|
000020f0  6e 20 74 68 65 20 70 61  6c 65 74 74 65 20 74 6f  |n the palette to|
00002100  20 72 65 64 2c 20 67 72  65 65 6e 2c 20 79 65 6c  | red, green, yel|
00002110  6c 6f 77 2c 20 62 6c 75  65 2c 20 6d 61 67 65 6e  |low, blue, magen|
00002120  74 61 20 61 6e 64 20 63  79 61 6e 2e 20 53 69 6e  |ta and cyan. Sin|
00002130  63 65 0a 43 6f 6c 6f 75  72 54 72 61 6e 73 20 77  |ce.ColourTrans w|
00002140  69 6c 6c 20 6d 61 70 20  74 68 65 20 63 6f 6c 6f  |ill map the colo|
00002150  75 72 73 20 61 6e 79 77  61 79 2c 20 69 74 20 64  |urs anyway, it d|
00002160  6f 65 73 6e 27 74 20 6d  61 74 74 65 72 20 77 68  |oesn't matter wh|
00002170  69 63 68 20 36 2c 20 62  75 74 20 74 68 65 0a 6d  |ich 6, but the.m|
00002180  6f 73 74 20 63 6f 6e 73  69 73 74 65 6e 74 20 76  |ost consistent v|
00002190  61 6c 75 65 73 20 61 72  65 20 38 3d 62 6c 75 65  |alues are 8=blue|
000021a0  2c 20 39 3d 79 65 6c 6c  6f 77 2c 20 31 30 3d 67  |, 9=yellow, 10=g|
000021b0  72 65 65 6e 2c 20 31 31  3d 72 65 64 2c 20 31 33  |reen, 11=red, 13|
000021c0  3d 63 79 61 6e 2c 0a 31  34 3d 6d 61 67 65 6e 74  |=cyan,.14=magent|
000021d0  61 20 28 6c 65 61 76 69  6e 67 20 30 2d 37 2c 20  |a (leaving 0-7, |
000021e0  31 32 20 61 6e 64 20 31  35 20 75 6e 63 68 61 6e  |12 and 15 unchan|
000021f0  67 65 64 29 2e 20 54 68  69 73 20 6f 70 74 69 6f  |ged). This optio|
00002200  6e 20 69 73 20 73 65 6c  65 63 74 65 64 20 62 79  |n is selected by|
00002210  20 61 20 22 64 22 0a 28  64 69 67 69 74 61 6c 20  | a "d".(digital |
00002220  52 47 42 29 20 73 75 66  66 69 78 20 74 6f 20 74  |RGB) suffix to t|
00002230  68 65 20 70 72 6f 67 72  61 6d 27 73 20 6d 6f 64  |he program's mod|
00002240  65 20 61 72 67 75 6d 65  6e 74 2e 0a 0a 6f 72 20  |e argument...or |
00002250  28 62 29 20 73 65 61 72  63 68 20 74 68 65 20 70  |(b) search the p|
00002260  61 6c 65 74 74 65 20 66  6f 72 20 74 68 65 20 63  |alette for the c|
00002270  6c 6f 73 65 73 74 20 63  6f 6c 6f 75 72 20 28 72  |losest colour (r|
00002280  20 73 75 66 66 69 78 29  20 5b 43 68 61 6e 67 65  | suffix) [Change|
00002290  46 53 49 20 6e 65 65 64  73 20 74 6f 0a 62 65 20  |FSI needs to.be |
000022a0  69 6e 20 74 68 65 20 31  36 20 63 6f 6c 6f 75 72  |in the 16 colour|
000022b0  20 6d 6f 64 65 20 69 6e  20 6f 72 64 65 72 20 74  | mode in order t|
000022c0  6f 20 72 65 61 64 20 74  68 65 20 70 61 6c 65 74  |o read the palet|
000022d0  74 65 5d 0a 0a 57 69 74  68 20 74 68 65 20 34 20  |te]..With the 4 |
000022e0  63 6f 6c 6f 75 72 20 6d  6f 64 65 73 20 28 65 2e  |colour modes (e.|
000022f0  67 2e 20 6d 6f 64 65 73  20 38 2c 20 31 31 2c 20  |g. modes 8, 11, |
00002300  31 39 20 61 6e 64 20 32  36 29 20 43 68 61 6e 67  |19 and 26) Chang|
00002310  65 46 53 49 20 69 73 20  72 65 61 6c 6c 79 0a 70  |eFSI is really.p|
00002320  75 73 68 65 64 2e 20 53  68 61 64 65 73 20 6f 66  |ushed. Shades of|
00002330  20 67 72 65 79 20 6f 75  74 70 75 74 20 69 73 20  | grey output is |
00002340  64 6f 6e 65 20 77 69 74  68 20 74 68 65 20 30 2c  |done with the 0,|
00002350  20 35 2c 20 31 30 2c 20  31 35 20 6c 65 76 65 6c  | 5, 10, 15 level|
00002360  20 70 61 6c 65 74 74 65  2e 20 42 75 74 0a 68 6f  | palette. But.ho|
00002370  77 20 63 61 6e 20 63 6f  6c 6f 75 72 20 62 65 20  |w can colour be |
00002380  64 6f 6e 65 3f 20 46 6f  72 20 65 78 61 6d 70 6c  |done? For exampl|
00002390  65 2c 20 65 61 63 68 20  70 69 78 65 6c 20 63 61  |e, each pixel ca|
000023a0  6e 20 64 69 73 70 6c 61  79 20 6f 6e 6c 79 20 6f  |n display only o|
000023b0  6e 65 20 6f 66 20 28 73  61 79 29 0a 62 6c 61 63  |ne of (say).blac|
000023c0  6b 2c 20 72 65 64 2c 20  67 72 65 65 6e 20 6f 72  |k, red, green or|
000023d0  20 62 6c 75 65 2e 20 54  68 69 73 20 66 61 69 6c  | blue. This fail|
000023e0  73 20 74 6f 20 73 70 61  6e 20 74 68 65 20 63 6f  |s to span the co|
000023f0  6c 6f 75 72 20 63 75 62  65 20 28 69 74 20 64 6f  |lour cube (it do|
00002400  65 73 20 6f 6e 6c 79 0a  68 61 6c 66 20 6f 66 20  |es only.half of |
00002410  69 74 29 2c 20 68 6f 77  65 76 65 72 2c 20 73 6f  |it), however, so|
00002420  20 62 6c 61 63 6b 2c 20  63 79 61 6e 2c 20 6d 61  | black, cyan, ma|
00002430  67 65 6e 74 61 20 61 6e  64 20 79 65 6c 6c 6f 77  |genta and yellow|
00002440  20 61 72 65 20 75 73 65  64 20 69 6e 73 74 65 61  | are used instea|
00002450  64 2e 20 54 68 65 0a 72  65 73 74 20 68 61 73 20  |d. The.rest has |
00002460  74 6f 20 62 65 20 6c 65  66 74 20 74 6f 20 6c 75  |to be left to lu|
00002470  63 6b 3a 20 74 68 65 72  65 20 69 73 20 6e 6f 20  |ck: there is no |
00002480  77 61 79 20 69 74 20 63  61 6e 20 61 70 70 72 6f  |way it can appro|
00002490  78 69 6d 61 74 65 20 74  6f 20 70 75 72 65 20 73  |ximate to pure s|
000024a0  68 61 64 65 73 0a 6f 66  20 72 65 64 2c 20 67 72  |hades.of red, gr|
000024b0  65 65 6e 20 6f 72 20 62  6c 75 65 2e 20 34 20 62  |een or blue. 4 b|
000024c0  69 74 20 63 6f 6c 6f 75  72 20 70 69 63 74 75 72  |it colour pictur|
000024d0  65 73 20 63 61 6e 20 62  65 20 73 65 65 6e 20 6f  |es can be seen o|
000024e0  6e 20 74 68 65 20 64 65  73 6b 74 6f 70 20 69 6e  |n the desktop in|
000024f0  20 31 36 0a 63 6f 6c 6f  75 72 20 6d 6f 64 65 73  | 16.colour modes|
00002500  20 77 69 74 68 20 74 68  65 20 61 62 6f 76 65 20  | with the above |
00002510  70 61 6c 65 74 74 65 20  6f 72 20 69 6e 20 32 35  |palette or in 25|
00002520  36 20 63 6f 6c 6f 75 72  20 6d 6f 64 65 73 2e 20  |6 colour modes. |
00002530  54 68 69 73 20 6f 70 74  69 6f 6e 20 69 73 20 62  |This option is b|
00002540  79 20 61 0a 22 63 22 20  73 75 66 66 69 78 2e 20  |y a."c" suffix. |
00002550  49 66 20 79 6f 75 20 63  61 6e 20 70 72 6f 76 69  |If you can provi|
00002560  64 65 20 61 20 62 65 74  74 65 72 20 70 61 6c 65  |de a better pale|
00002570  74 74 65 2c 20 74 68 65  6e 20 43 68 61 6e 67 65  |tte, then Change|
00002580  46 53 49 20 63 61 6e 20  75 73 65 20 69 74 20 77  |FSI can use it w|
00002590  69 74 68 0a 74 68 65 20  22 72 22 20 73 75 66 66  |ith.the "r" suff|
000025a0  69 78 20 73 65 61 72 63  68 20 6d 65 74 68 6f 64  |ix search method|
000025b0  2e 0a 0a 57 69 74 68 20  32 20 63 6f 6c 6f 75 72  |...With 2 colour|
000025c0  20 6d 6f 64 65 73 20 28  65 2e 67 2e 20 6d 6f 64  | modes (e.g. mod|
000025d0  65 73 20 30 2c 20 31 38  2c 20 32 33 20 61 6e 64  |es 0, 18, 23 and|
000025e0  20 32 35 29 20 70 69 78  65 6c 73 20 61 72 65 20  | 25) pixels are |
000025f0  65 69 74 68 65 72 20 4f  4e 20 6f 72 20 4f 46 46  |either ON or OFF|
00002600  2c 0a 43 68 61 6e 67 65  46 53 49 20 77 69 6c 6c  |,.ChangeFSI will|
00002610  20 6f 6e 6c 79 20 64 6f  20 73 68 61 64 65 73 20  | only do shades |
00002620  6f 66 20 67 72 65 79 20  6f 75 74 70 75 74 2e 2e  |of grey output..|
00002630  2e 2e 20 48 6f 77 65 76  65 72 2c 20 74 68 65 20  |.. However, the |
00002640  6d 65 74 68 6f 64 20 75  73 65 64 20 63 61 6e 0a  |method used can.|
00002650  62 65 20 76 61 72 69 65  64 20 28 73 65 65 20 6c  |be varied (see l|
00002660  61 74 65 72 29 2e 0a 0a  53 6f 20 74 68 61 74 27  |ater)...So that'|
00002670  73 20 74 68 65 20 63 61  6e 76 61 73 20 43 68 61  |s the canvas Cha|
00002680  6e 67 65 46 53 49 20 68  61 73 20 74 6f 20 77 6f  |ngeFSI has to wo|
00002690  72 6b 20 6f 6e 2e 20 48  6f 77 20 64 6f 65 73 20  |rk on. How does |
000026a0  69 74 20 64 69 73 70 6c  61 79 20 74 68 65 20 69  |it display the i|
000026b0  6e 70 75 74 0a 72 61 6e  67 65 20 6f 66 20 63 6f  |nput.range of co|
000026c0  6c 6f 75 72 73 20 6f 6e  20 74 68 65 73 65 20 6f  |lours on these o|
000026d0  75 74 70 75 74 73 3f 20  54 68 65 20 61 6e 73 77  |utputs? The answ|
000026e0  65 72 20 69 73 2c 20 61  73 20 73 74 61 74 65 64  |er is, as stated|
000026f0  20 61 62 6f 76 65 2c 20  64 69 74 68 65 72 69 6e  | above, ditherin|
00002700  67 3a 0a 74 68 65 20 70  72 6f 63 65 73 73 20 6f  |g:.the process o|
00002710  66 20 61 70 70 72 6f 78  69 6d 61 74 69 6e 67 20  |f approximating |
00002720  69 6e 74 65 6e 73 69 74  79 20 76 61 72 69 61 74  |intensity variat|
00002730  69 6f 6e 73 20 77 69 74  68 20 70 61 74 74 65 72  |ions with patter|
00002740  6e 65 64 20 61 72 65 61  73 2e 20 54 68 65 72 65  |ned areas. There|
00002750  0a 61 72 65 20 74 77 6f  20 62 61 73 69 63 20 74  |.are two basic t|
00002760  79 70 65 73 20 6f 66 20  64 69 74 68 65 72 69 6e  |ypes of ditherin|
00002770  67 20 74 65 63 68 6e 69  71 75 65 3a 20 74 68 61  |g technique: tha|
00002780  74 20 75 73 65 64 20 74  6f 20 70 72 69 6e 74 20  |t used to print |
00002790  63 6f 6c 6f 75 72 20 6d  61 67 61 7a 69 6e 65 73  |colour magazines|
000027a0  0a 61 6e 64 20 6e 65 77  73 70 61 70 65 72 20 70  |.and newspaper p|
000027b0  68 6f 74 6f 67 72 61 70  68 73 20 22 63 6c 75 73  |hotographs "clus|
000027c0  74 65 72 65 64 20 64 6f  74 20 64 69 74 68 65 72  |tered dot dither|
000027d0  22 20 2d 20 74 68 65 20  73 69 7a 65 20 6f 66 20  |" - the size of |
000027e0  74 68 65 20 64 6f 74 20  6f 66 20 69 6e 6b 0a 67  |the dot of ink.g|
000027f0  69 76 65 73 20 74 68 65  20 69 6e 74 65 6e 73 69  |ives the intensi|
00002800  74 79 3b 20 61 6e 64 20  74 68 61 74 20 75 73 65  |ty; and that use|
00002810  64 20 6f 6e 20 64 6f 74  20 6d 61 74 72 69 78 20  |d on dot matrix |
00002820  64 69 73 70 6c 61 79 73  2c 20 66 6f 72 20 65 78  |displays, for ex|
00002830  61 6d 70 6c 65 20 74 68  65 20 67 72 65 79 0a 6c  |ample the grey.l|
00002840  65 76 65 6c 20 70 61 74  74 65 72 6e 73 20 75 73  |evel patterns us|
00002850  65 64 20 62 79 20 31 20  62 69 74 20 70 65 72 20  |ed by 1 bit per |
00002860  70 69 78 65 6c 20 6d 6f  64 65 20 6f 6e 20 74 68  |pixel mode on th|
00002870  65 20 64 65 73 6b 74 6f  70 20 22 64 69 73 70 65  |e desktop "dispe|
00002880  72 73 65 64 20 64 6f 74  0a 64 69 74 68 65 72 22  |rsed dot.dither"|
00002890  20 77 68 65 72 65 20 74  68 65 20 61 76 65 72 61  | where the avera|
000028a0  67 65 20 6e 75 6d 62 65  72 20 6f 66 20 64 6f 74  |ge number of dot|
000028b0  73 20 69 6e 20 74 68 65  20 61 72 65 61 20 67 69  |s in the area gi|
000028c0  76 65 73 20 74 68 65 20  69 6e 74 65 6e 73 69 74  |ves the intensit|
000028d0  79 2e 0a 0a 57 68 79 20  64 6f 65 73 20 74 68 65  |y...Why does the|
000028e0  20 77 6f 72 6c 64 20 6e  65 65 64 20 74 77 6f 20  | world need two |
000028f0  64 69 66 66 65 72 65 6e  74 20 74 65 63 68 6e 69  |different techni|
00002900  71 75 65 73 3f 20 57 65  6c 6c 2c 20 64 69 66 66  |ques? Well, diff|
00002910  65 72 65 6e 74 20 64 65  76 69 63 65 73 0a 72 65  |erent devices.re|
00002920  70 72 6f 64 75 63 65 20  70 69 78 65 6c 73 20 64  |produce pixels d|
00002930  69 66 66 65 72 65 6e 74  6c 79 2e 20 54 68 65 20  |ifferently. The |
00002940  22 69 64 65 61 6c 20 73  71 75 61 72 65 22 20 70  |"ideal square" p|
00002950  69 78 65 6c 73 20 70 72  6f 64 75 63 65 64 20 62  |ixels produced b|
00002960  79 20 61 6e 20 4c 43 44  20 61 72 65 0a 70 65 72  |y an LCD are.per|
00002970  66 65 63 74 20 66 6f 72  20 64 69 73 70 65 72 73  |fect for dispers|
00002980  65 64 20 64 6f 74 20 64  69 74 68 65 72 3b 20 61  |ed dot dither; a|
00002990  20 43 52 54 20 70 72 6f  64 75 63 65 73 20 61 20  | CRT produces a |
000029a0  67 61 75 73 73 69 61 6e  20 73 70 6f 74 20 28 61  |gaussian spot (a|
000029b0  20 63 69 72 63 6c 65 20  6f 72 0a 65 6c 6c 69 70  | circle or.ellip|
000029c0  73 65 20 77 68 69 63 68  20 64 65 63 61 79 73 20  |se which decays |
000029d0  69 6e 20 69 6e 74 65 6e  73 69 74 79 20 74 6f 77  |in intensity tow|
000029e0  61 72 64 73 20 74 68 65  20 65 64 67 65 73 29 20  |ards the edges) |
000029f0  69 6e 73 74 65 61 64 20  6f 66 20 61 20 73 71 75  |instead of a squ|
00002a00  61 72 65 20 2d 0a 64 69  73 70 65 72 73 65 64 20  |are -.dispersed |
00002a10  64 6f 74 20 64 69 74 68  65 72 20 77 6f 72 6b 73  |dot dither works|
00002a20  20 77 65 6c 6c 3b 20 61  20 64 6f 74 20 6d 61 74  | well; a dot mat|
00002a30  72 69 78 20 69 6d 70 61  63 74 20 70 72 69 6e 74  |rix impact print|
00002a40  65 72 20 6f 72 20 61 20  22 77 72 69 74 65 20 62  |er or a "write b|
00002a50  6c 61 63 6b 22 0a 6c 61  73 65 72 20 70 72 69 6e  |lack".laser prin|
00002a60  74 65 72 20 70 72 6f 64  75 63 65 20 6c 61 72 67  |ter produce larg|
00002a70  65 20 64 6f 74 73 20 28  64 69 61 6d 65 74 65 72  |e dots (diameter|
00002a80  20 61 74 20 6c 65 61 73  74 20 53 51 52 28 32 29  | at least SQR(2)|
00002a90  20 6f 76 65 72 20 75 6e  69 74 20 70 69 78 65 6c  | over unit pixel|
00002aa0  0a 73 71 75 61 72 65 29  20 61 6e 64 20 74 68 75  |.square) and thu|
00002ab0  73 20 6d 61 6b 65 20 70  69 63 74 75 72 65 73 20  |s make pictures |
00002ac0  74 6f 6f 20 64 61 72 6b  20 69 66 20 64 69 73 70  |too dark if disp|
00002ad0  65 72 73 65 64 20 64 6f  74 20 64 69 74 68 65 72  |ersed dot dither|
00002ae0  20 69 73 20 75 73 65 64  3b 20 61 0a 22 77 72 69  | is used; a."wri|
00002af0  74 65 20 77 68 69 74 65  22 20 6c 61 73 65 72 20  |te white" laser |
00002b00  70 72 69 6e 74 65 72 20  70 72 69 6e 74 73 20 6e  |printer prints n|
00002b10  65 67 61 74 69 76 65 20  22 77 68 69 74 65 20 64  |egative "white d|
00002b20  6f 74 73 22 20 6f 6e 20  61 20 62 6c 61 63 6b 20  |ots" on a black |
00002b30  66 69 65 6c 64 20 61 6e  64 0a 74 68 75 73 20 22  |field and.thus "|
00002b40  63 61 76 65 73 20 69 6e  22 20 74 68 65 20 73 69  |caves in" the si|
00002b50  64 65 73 20 6f 66 20 70  69 78 65 6c 73 20 6d 61  |des of pixels ma|
00002b60  6b 69 6e 67 20 70 69 63  74 75 72 65 73 20 74 6f  |king pictures to|
00002b70  6f 20 77 68 69 74 65 20  77 69 74 68 20 64 69 73  |o white with dis|
00002b80  70 65 72 73 65 64 0a 64  6f 74 20 64 69 74 68 65  |persed.dot dithe|
00002b90  72 2e 20 43 6c 75 73 74  65 72 65 64 20 64 6f 74  |r. Clustered dot|
00002ba0  20 64 69 74 68 65 72 20  72 65 64 75 63 65 73 20  | dither reduces |
00002bb0  74 68 65 20 65 66 66 65  63 74 73 20 6f 66 20 6d  |the effects of m|
00002bc0  69 73 2d 73 69 7a 65 64  20 70 69 78 65 6c 73 20  |is-sized pixels |
00002bd0  62 79 0a 65 6e 73 75 72  69 6e 67 20 74 68 65 79  |by.ensuring they|
00002be0  20 61 72 65 20 61 64 6a  61 63 65 6e 74 20 28 61  | are adjacent (a|
00002bf0  6e 64 20 74 68 75 73 20  74 68 65 20 65 72 72 6f  |nd thus the erro|
00002c00  72 20 69 73 20 63 6f 6e  66 69 6e 65 64 20 74 6f  |r is confined to|
00002c10  20 74 68 65 20 70 65 72  69 70 68 65 72 79 20 6f  | the periphery o|
00002c20  66 0a 74 68 65 20 73 68  61 70 65 29 20 62 75 74  |f.the shape) but|
00002c30  20 74 68 69 73 20 64 6f  65 73 20 68 61 76 65 20  | this does have |
00002c40  61 20 63 6f 73 74 20 69  6e 20 70 6f 6f 72 65 72  |a cost in poorer|
00002c50  20 72 65 73 6f 6c 75 74  69 6f 6e 2e 0a 0a 53 69  | resolution...Si|
00002c60  6e 63 65 20 43 68 61 6e  67 65 46 53 49 27 73 20  |nce ChangeFSI's |
00002c70  63 6f 6c 6f 75 72 20 6f  72 20 67 72 65 79 73 63  |colour or greysc|
00002c80  61 6c 65 20 6f 75 74 70  75 74 20 69 73 20 74 6f  |ale output is to|
00002c90  20 43 52 54 73 20 28 6f  72 20 4c 43 44 73 20 69  | CRTs (or LCDs i|
00002ca0  6e 20 73 6f 6d 65 0a 64  69 73 74 61 6e 74 20 66  |n some.distant f|
00002cb0  75 74 75 72 65 29 20 69  74 20 61 75 74 6f 6d 61  |uture) it automa|
00002cc0  74 69 63 61 6c 6c 79 20  75 73 65 73 20 61 20 64  |tically uses a d|
00002cd0  69 73 70 65 72 73 65 64  20 64 6f 74 20 64 69 74  |ispersed dot dit|
00002ce0  68 65 72 2e 20 4d 6f 6e  6f 63 68 72 6f 6d 65 20  |her. Monochrome |
00002cf0  6f 75 74 70 75 74 0a 63  6f 75 6c 64 20 62 65 20  |output.could be |
00002d00  66 6f 72 20 74 68 65 20  73 63 72 65 65 6e 20 6f  |for the screen o|
00002d10  72 20 66 6f 72 20 61 20  70 72 69 6e 74 65 72 3a  |r for a printer:|
00002d20  20 74 68 65 20 75 73 65  72 20 63 61 6e 20 73 65  | the user can se|
00002d30  6c 65 63 74 20 62 65 74  77 65 65 6e 20 64 69 73  |lect between dis|
00002d40  70 65 72 73 65 64 0a 61  6e 64 20 63 6c 75 73 74  |persed.and clust|
00002d50  65 72 65 64 20 6d 65 74  68 6f 64 73 20 62 79 20  |ered methods by |
00002d60  61 64 64 69 6e 67 20 61  20 76 61 72 69 6f 75 73  |adding a various|
00002d70  20 73 75 66 66 69 63 65  73 20 28 22 63 22 2c 20  | suffices ("c", |
00002d80  22 64 22 20 6f 72 20 22  74 22 29 20 74 6f 20 74  |"d" or "t") to t|
00002d90  68 65 0a 6d 6f 64 65 20  6e 75 6d 62 65 72 20 66  |he.mode number f|
00002da0  6f 72 20 63 6c 75 73 74  65 72 65 64 20 6f 75 74  |or clustered out|
00002db0  70 75 74 2e 20 46 6f 72  20 22 63 22 20 74 68 65  |put. For "c" the|
00002dc0  20 61 6c 67 6f 72 69 74  68 6d 20 28 64 75 65 20  | algorithm (due |
00002dd0  74 6f 20 52 6f 62 65 72  74 20 4c 20 47 61 72 64  |to Robert L Gard|
00002de0  2c 0a 31 39 37 36 29 20  61 70 70 72 6f 78 69 6d  |,.1976) approxim|
00002df0  61 74 65 73 20 74 6f 6e  65 73 20 69 6e 20 74 68  |ates tones in th|
00002e00  65 20 72 61 6e 67 65 20  30 2e 2e 31 36 20 28 31  |e range 0..16 (1|
00002e10  37 20 6c 65 76 65 6c 73  29 20 62 79 20 75 73 69  |7 levels) by usi|
00002e20  6e 67 20 30 2e 2e 31 36  20 22 6f 6e 22 0a 70 69  |ng 0..16 "on".pi|
00002e30  78 65 6c 73 20 69 6e 20  61 20 34 20 62 79 20 34  |xels in a 4 by 4|
00002e40  20 63 65 6c 6c 2e 20 46  6f 72 20 22 64 22 20 74  | cell. For "d" t|
00002e50  68 65 20 61 6c 67 6f 72  69 74 68 6d 20 28 64 65  |he algorithm (de|
00002e60  76 65 6c 6f 70 65 64 20  62 79 20 6d 65 2c 20 62  |veloped by me, b|
00002e70  75 74 20 73 69 6d 69 6c  61 72 20 74 6f 0a 47 61  |ut similar to.Ga|
00002e80  72 64 27 73 29 20 61 70  70 72 6f 78 69 6d 61 74  |rd's) approximat|
00002e90  65 73 20 74 6f 6e 65 73  20 69 6e 20 74 68 65 20  |es tones in the |
00002ea0  72 61 6e 67 65 20 30 2e  2e 34 20 28 35 20 6c 65  |range 0..4 (5 le|
00002eb0  76 65 6c 73 29 20 62 79  20 75 73 69 6e 67 20 30  |vels) by using 0|
00002ec0  2e 2e 34 20 22 6f 6e 22  0a 70 69 78 65 6c 73 20  |..4 "on".pixels |
00002ed0  69 6e 20 61 20 32 20 62  79 20 32 20 63 65 6c 6c  |in a 2 by 2 cell|
00002ee0  2e 20 46 6f 72 20 22 74  22 20 74 68 65 20 61 6c  |. For "t" the al|
00002ef0  67 6f 72 69 74 68 6d 20  28 64 69 74 74 6f 20 61  |gorithm (ditto a|
00002f00  73 20 22 64 22 29 20 61  70 70 72 6f 78 69 6d 61  |s "d") approxima|
00002f10  74 65 73 0a 74 6f 6e 65  73 20 69 6e 20 74 68 65  |tes.tones in the|
00002f20  20 72 61 6e 67 65 20 30  2e 2e 39 20 28 31 30 20  | range 0..9 (10 |
00002f30  6c 65 76 65 6c 73 29 20  62 79 20 75 73 69 6e 67  |levels) by using|
00002f40  20 30 2e 2e 39 20 22 6f  6e 22 20 70 69 78 65 6c  | 0..9 "on" pixel|
00002f50  73 20 69 6e 20 61 20 33  20 62 79 20 33 20 63 65  |s in a 3 by 3 ce|
00002f60  6c 6c 2e 0a 54 68 65 20  22 6f 6e 22 20 70 69 78  |ll..The "on" pix|
00002f70  65 6c 73 20 61 72 65 20  63 61 72 65 66 75 6c 6c  |els are carefull|
00002f80  79 20 63 68 6f 73 65 6e  20 74 6f 20 70 72 6f 76  |y chosen to prov|
00002f90  69 64 65 3a 20 28 61 29  20 73 79 6d 6d 65 74 72  |ide: (a) symmetr|
00002fa0  79 20 6f 66 20 77 68 69  74 65 2f 62 6c 61 63 6b  |y of white/black|
00002fb0  0a 61 6e 64 20 62 6c 61  63 6b 2f 77 68 69 74 65  |.and black/white|
00002fc0  20 70 61 74 74 65 72 6e  73 20 28 62 29 20 64 69  | patterns (b) di|
00002fd0  61 67 6f 6e 61 6c 6c 79  20 6f 72 69 65 6e 74 65  |agonally oriente|
00002fe0  64 20 64 6f 74 20 67 72  69 64 2e 20 54 68 65 20  |d dot grid. The |
00002ff0  64 69 61 67 6f 6e 61 6c  20 61 6e 67 6c 65 0a 72  |diagonal angle.r|
00003000  65 64 75 63 65 73 20 74  68 65 20 65 79 65 27 73  |educes the eye's|
00003010  20 61 62 69 6c 69 74 79  20 74 6f 20 73 65 65 20  | ability to see |
00003020  74 68 65 20 72 65 63 74  61 6e 67 75 6c 61 72 20  |the rectangular |
00003030  70 61 74 74 65 72 6e 73  20 70 72 6f 64 75 63 65  |patterns produce|
00003040  64 2e 20 54 68 65 20 76  61 72 69 6f 75 73 0a 73  |d. The various.s|
00003050  69 7a 65 73 20 6f 66 20  74 68 65 20 68 61 6c 66  |izes of the half|
00003060  74 6f 6e 65 20 63 65 6c  6c 20 61 6c 6c 6f 77 20  |tone cell allow |
00003070  73 6f 6d 65 20 74 72 61  64 65 20 6f 66 66 20 62  |some trade off b|
00003080  65 74 77 65 65 6e 20 72  65 70 72 65 73 65 6e 74  |etween represent|
00003090  69 6e 67 20 74 68 65 20  74 6f 6e 61 6c 0a 76 61  |ing the tonal.va|
000030a0  6c 75 65 73 20 63 6f 72  72 65 63 74 6c 79 20 61  |lues correctly a|
000030b0  6e 64 20 6c 6f 73 73 20  6f 66 20 72 65 73 6f 6c  |nd loss of resol|
000030c0  75 74 69 6f 6e 2e 20 53  74 61 72 74 20 77 69 74  |ution. Start wit|
000030d0  68 20 22 63 22 20 61 6e  64 20 70 72 6f 67 72 65  |h "c" and progre|
000030e0  73 73 20 74 6f 20 22 74  22 20 61 6e 64 0a 74 68  |ss to "t" and.th|
000030f0  65 6e 20 22 64 22 20 69  66 20 74 68 65 20 72 65  |en "d" if the re|
00003100  73 6f 6c 75 74 69 6f 6e  20 69 73 20 6e 6f 74 20  |solution is not |
00003110  61 63 63 65 70 74 61 62  6c 65 2e 0a 0a 43 68 61  |acceptable...Cha|
00003120  6e 67 65 46 53 49 20 63  61 6e 20 67 65 6e 65 72  |ngeFSI can gener|
00003130  61 74 65 20 72 65 61 73  6f 6e 61 62 6c 65 20 70  |ate reasonable p|
00003140  69 63 74 75 72 65 73 20  6f 6e 20 22 77 72 69 74  |ictures on "writ|
00003150  65 20 62 6c 61 63 6b 22  20 70 72 69 6e 74 65 72  |e black" printer|
00003160  73 20 77 69 74 68 20 61  0a 64 69 73 70 65 72 73  |s with a.dispers|
00003170  65 64 20 64 6f 74 20 64  69 74 68 65 72 20 62 79  |ed dot dither by|
00003180  20 75 73 69 6e 67 20 74  68 65 20 22 2d 62 6c 61  | using the "-bla|
00003190  63 6b 22 20 70 61 72 61  6d 65 74 65 72 3b 20 68  |ck" parameter; h|
000031a0  6f 77 65 76 65 72 20 69  6d 61 67 65 73 20 70 72  |owever images pr|
000031b0  6f 64 75 63 65 64 0a 6c  69 6b 65 20 74 68 69 73  |oduced.like this|
000031c0  20 64 6f 20 6e 6f 74 20  70 68 6f 74 6f 63 6f 70  | do not photocop|
000031d0  79 20 61 74 20 61 6c 6c  20 77 65 6c 6c 20 28 74  |y at all well (t|
000031e0  68 65 20 70 68 6f 74 6f  63 6f 70 69 65 72 20 6d  |he photocopier m|
000031f0  61 6b 65 73 20 74 68 65  20 64 6f 74 73 20 62 6c  |akes the dots bl|
00003200  61 63 6b 65 72 0a 61 67  61 69 6e 21 29 2e 20 54  |acker.again!). T|
00003210  68 65 20 70 61 72 61 6d  65 74 65 72 20 74 6f 20  |he parameter to |
00003220  2d 62 6c 61 63 6b 20 28  64 65 66 61 75 6c 74 20  |-black (default |
00003230  76 61 6c 75 65 20 33 32  2c 20 72 61 6e 67 65 20  |value 32, range |
00003240  30 2e 2e 31 32 38 29 20  74 65 6c 6c 73 0a 43 68  |0..128) tells.Ch|
00003250  61 6e 67 65 46 53 49 20  68 6f 77 20 6d 75 63 68  |angeFSI how much|
00003260  20 6c 61 72 67 65 72 20  74 68 61 6e 20 74 68 65  | larger than the|
00003270  20 69 64 65 61 6c 20 73  71 75 61 72 65 20 70 69  | ideal square pi|
00003280  78 65 6c 20 74 68 65 20  64 6f 74 73 20 70 72 6f  |xel the dots pro|
00003290  64 75 63 65 64 20 62 79  20 74 68 65 0a 70 72 69  |duced by the.pri|
000032a0  6e 74 65 72 20 61 72 65  20 2d 20 31 32 38 20 63  |nter are - 128 c|
000032b0  6f 72 72 65 73 70 6f 6e  64 73 20 74 6f 20 61 6e  |orresponds to an|
000032c0  20 69 6e 6b 65 64 20 64  6f 74 20 63 6f 76 65 72  | inked dot cover|
000032d0  69 6e 67 20 66 6f 75 72  20 74 69 6d 65 73 20 74  |ing four times t|
000032e0  68 65 20 61 72 65 61 20  6f 66 0a 74 68 65 20 69  |he area of.the i|
000032f0  64 65 61 6c 20 62 6c 61  63 6b 20 73 71 75 61 72  |deal black squar|
00003300  65 20 70 69 78 65 6c 20  28 61 6e 64 20 74 68 69  |e pixel (and thi|
00003310  73 20 77 69 6c 6c 20 67  65 6e 65 72 61 6c 6c 79  |s will generally|
00003320  20 6d 65 61 6e 20 43 68  61 6e 67 65 46 53 49 20  | mean ChangeFSI |
00003330  70 72 6f 64 75 63 65 73  0a 61 6e 20 65 6e 74 69  |produces.an enti|
00003340  72 65 6c 79 20 77 68 69  74 65 20 6f 75 74 70 75  |rely white outpu|
00003350  74 21 29 2e 20 56 61 6c  75 65 73 20 61 62 6f 76  |t!). Values abov|
00003360  65 20 36 34 20 67 69 76  65 20 72 61 74 68 65 72  |e 64 give rather|
00003370  20 70 6f 6f 72 20 72 65  73 75 6c 74 73 20 6f 6e  | poor results on|
00003380  20 73 6f 6d 65 0a 70 69  63 74 75 72 65 73 20 62  | some.pictures b|
00003390  75 74 20 6d 61 79 20 62  65 20 77 6f 72 74 68 20  |ut may be worth |
000033a0  65 78 70 65 72 69 6d 65  6e 74 69 6e 67 20 77 69  |experimenting wi|
000033b0  74 68 2e 20 54 68 65 20  64 65 66 61 75 6c 74 20  |th. The default |
000033c0  69 73 20 33 32 2c 20 61  20 64 6f 74 20 63 6f 76  |is 32, a dot cov|
000033d0  65 72 69 6e 67 0a 35 30  25 20 6d 6f 72 65 20 61  |ering.50% more a|
000033e0  72 65 61 20 74 68 61 6e  20 74 68 65 20 73 71 75  |rea than the squ|
000033f0  61 72 65 20 70 69 78 65  6c 20 28 74 68 65 20 6d  |are pixel (the m|
00003400  69 6e 69 6d 75 6d 20 63  69 72 63 6c 65 20 65 6e  |inimum circle en|
00003410  63 6c 6f 73 69 6e 67 20  74 68 65 20 70 69 78 65  |closing the pixe|
00003420  6c 0a 73 71 75 61 72 65  29 2e 20 53 6f 6d 65 20  |l.square). Some |
00003430  70 72 69 6e 74 65 72 73  20 70 72 6f 64 75 63 65  |printers produce|
00003440  20 64 6f 74 73 20 6f 66  20 28 70 73 65 75 64 6f  | dots of (pseudo|
00003450  2d 72 61 6e 64 6f 6d 6c  79 29 20 76 61 72 79 69  |-randomly) varyi|
00003460  6e 67 20 73 69 7a 65 73  20 61 6e 64 0a 62 6c 61  |ng sizes and.bla|
00003470  63 6b 20 63 6f 72 72 65  63 74 69 6f 6e 20 6d 61  |ck correction ma|
00003480  79 20 6e 6f 74 20 68 65  6c 70 20 77 69 74 68 20  |y not help with |
00003490  74 68 65 73 65 20 28 74  68 65 20 70 69 63 74 75  |these (the pictu|
000034a0  72 65 20 6c 6f 6f 6b 73  20 22 6e 6f 69 73 79 22  |re looks "noisy"|
000034b0  29 20 69 6e 20 77 68 69  63 68 0a 63 61 73 65 20  |) in which.case |
000034c0  75 73 65 20 6f 6e 65 20  6f 66 20 74 68 65 20 63  |use one of the c|
000034d0  6c 75 73 74 65 72 65 64  20 6f 75 74 70 75 74 20  |lustered output |
000034e0  6d 65 74 68 6f 64 73 2e  20 2d 62 6c 61 63 6b 20  |methods. -black |
000034f0  63 6f 72 72 65 63 74 69  6f 6e 20 6d 61 6b 65 73  |correction makes|
00003500  20 70 69 63 74 75 72 65  73 0a 6f 6e 20 74 68 65  | pictures.on the|
00003510  20 73 63 72 65 65 6e 20  6c 6f 6f 6b 20 76 65 72  | screen look ver|
00003520  79 20 70 61 6c 65 2c 20  73 69 6e 63 65 2c 20 69  |y pale, since, i|
00003530  66 20 61 6e 79 74 68 69  6e 67 2c 20 62 6c 61 63  |f anything, blac|
00003540  6b 20 70 69 78 65 6c 73  20 6f 6e 20 73 63 72 65  |k pixels on scre|
00003550  65 6e 20 61 72 65 0a 73  6d 61 6c 6c 65 72 20 74  |en are.smaller t|
00003560  68 61 6e 20 74 68 65 20  69 64 65 61 6c 20 73 71  |han the ideal sq|
00003570  75 61 72 65 2e 0a 0a 5b  61 73 69 64 65 3a 20 74  |uare...[aside: t|
00003580  6f 20 70 72 69 6e 74 20  74 68 65 73 65 20 70 69  |o print these pi|
00003590  63 74 75 72 65 73 2c 20  79 6f 75 20 6e 65 65 64  |ctures, you need|
000035a0  20 61 20 6d 65 74 68 6f  64 20 77 68 69 63 68 20  | a method which |
000035b0  63 6f 70 69 65 73 20 74  68 65 20 70 69 78 65 6c  |copies the pixel|
000035c0  73 0a 43 68 61 6e 67 65  46 53 49 20 68 61 73 20  |s.ChangeFSI has |
000035d0  6d 61 64 65 20 65 78 61  63 74 6c 79 20 74 6f 20  |made exactly to |
000035e0  74 68 6f 73 65 20 6f 66  20 74 68 65 20 6f 75 74  |those of the out|
000035f0  70 75 74 20 64 65 76 69  63 65 2e 20 55 73 69 6e  |put device. Usin|
00003600  67 20 21 50 61 69 6e 74  2c 20 73 63 61 6c 65 20  |g !Paint, scale |
00003610  58 0a 61 6e 64 20 59 20  62 79 20 39 30 3a 33 30  |X.and Y by 90:30|
00003620  30 20 66 6f 72 20 61 20  33 30 30 64 70 69 20 70  |0 for a 300dpi p|
00003630  72 69 6e 74 65 72 2e 5d  0a 0a 49 6e 20 61 6c 6c  |rinter.]..In all|
00003640  20 63 61 73 65 73 2c 20  61 6e 20 61 70 70 72 6f  | cases, an appro|
00003650  78 69 6d 61 74 69 6f 6e  20 74 6f 20 61 20 63 6f  |ximation to a co|
00003660  6c 6f 75 72 20 77 69 6c  6c 20 70 72 6f 64 75 63  |lour will produc|
00003670  65 20 61 6e 20 65 72 72  6f 72 20 28 77 68 69 63  |e an error (whic|
00003680  68 20 6d 69 67 68 74 0a  70 6f 73 73 69 62 6c 79  |h might.possibly|
00003690  20 62 65 20 7a 65 72 6f  20 69 66 20 43 68 61 6e  | be zero if Chan|
000036a0  67 65 46 53 49 20 69 73  20 76 65 72 79 20 6c 75  |geFSI is very lu|
000036b0  63 6b 79 29 2e 20 43 68  61 6e 67 65 46 53 49 20  |cky). ChangeFSI |
000036c0  74 72 61 63 6b 73 20 74  68 65 73 65 20 65 72 72  |tracks these err|
000036d0  6f 72 73 20 61 6e 64 0a  65 6e 73 75 72 65 73 20  |ors and.ensures |
000036e0  74 68 61 74 20 6f 76 65  72 20 77 69 64 65 20 61  |that over wide a|
000036f0  72 65 61 73 20 74 68 65  72 65 20 69 73 20 6e 6f  |reas there is no|
00003700  20 6f 76 65 72 61 6c 6c  20 65 72 72 6f 72 20 75  | overall error u|
00003710  73 69 6e 67 20 61 20 74  65 63 68 6e 69 71 75 65  |sing a technique|
00003720  20 63 61 6c 6c 65 64 0a  22 65 72 72 6f 72 20 64  | called."error d|
00003730  69 66 66 75 73 69 6f 6e  22 2c 20 66 69 72 73 74  |iffusion", first|
00003740  20 64 65 76 69 73 65 64  20 62 79 20 52 20 57 20  | devised by R W |
00003750  46 6c 6f 79 64 20 61 6e  64 20 4c 20 53 74 65 69  |Floyd and L Stei|
00003760  6e 62 65 72 67 20 69 6e  20 31 39 37 35 2e 20 49  |nberg in 1975. I|
00003770  6e 20 74 68 69 73 0a 74  65 63 68 6e 69 71 75 65  |n this.technique|
00003780  20 74 68 65 20 61 70 70  72 6f 78 69 6d 61 74 69  | the approximati|
00003790  6f 6e 20 69 73 20 6d 61  64 65 20 61 6e 64 20 74  |on is made and t|
000037a0  68 65 20 65 72 72 6f 72  20 64 69 73 74 72 69 62  |he error distrib|
000037b0  75 74 65 64 20 74 6f 20  6e 65 61 72 62 79 20 70  |uted to nearby p|
000037c0  69 78 65 6c 73 0a 69 6e  20 74 68 65 20 66 6f 6c  |ixels.in the fol|
000037d0  6c 6f 77 69 6e 67 20 72  61 74 69 6f 73 3a 0a 0a  |lowing ratios:..|
000037e0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
000037f0  63 75 72 72 65 6e 74 20  70 69 78 65 6c 20 20 20  |current pixel   |
00003800  37 2f 31 36 20 6f 66 20  65 72 72 6f 72 0a 33 2f  |7/16 of error.3/|
00003810  31 36 20 6f 66 20 65 72  72 6f 72 20 20 20 35 2f  |16 of error   5/|
00003820  31 36 20 6f 66 20 65 72  72 6f 72 20 20 20 31 2f  |16 of error   1/|
00003830  31 36 20 6f 66 20 65 72  72 6f 72 0a 0a 43 68 61  |16 of error..Cha|
00003840  6e 67 65 46 53 49 20 67  65 74 73 20 73 6f 6d 65  |ngeFSI gets some|
00003850  20 6f 66 20 69 74 73 20  6e 61 6d 65 20 66 72 6f  | of its name fro|
00003860  6d 20 46 6c 6f 79 64 20  61 6e 64 20 53 74 65 69  |m Floyd and Stei|
00003870  6e 62 65 72 67 2e 20 41  64 64 69 74 69 6f 6e 61  |nberg. Additiona|
00003880  6c 6c 79 2c 0a 43 68 61  6e 67 65 46 53 49 20 73  |lly,.ChangeFSI s|
00003890  63 61 6e 73 20 74 68 72  6f 75 67 68 20 74 68 65  |cans through the|
000038a0  20 70 69 63 74 75 72 65  20 69 6e 20 61 20 73 65  | picture in a se|
000038b0  72 70 65 6e 74 69 6e 65  20 66 61 73 68 69 6f 6e  |rpentine fashion|
000038c0  2c 20 64 6f 69 6e 67 20  61 20 72 6f 77 20 6f 66  |, doing a row of|
000038d0  0a 70 69 78 65 6c 73 20  6c 65 66 74 20 74 6f 20  |.pixels left to |
000038e0  72 69 67 68 74 20 66 6f  6c 6c 6f 77 65 64 20 62  |right followed b|
000038f0  79 20 74 68 65 20 6e 65  78 74 20 72 6f 77 20 72  |y the next row r|
00003900  69 67 68 74 20 74 6f 20  6c 65 66 74 2e 20 54 68  |ight to left. Th|
00003910  69 73 20 72 65 64 75 63  65 73 20 74 68 65 0a 70  |is reduces the.p|
00003920  72 6f 62 61 62 69 6c 69  74 79 20 6f 66 20 72 65  |robability of re|
00003930  67 75 6c 61 72 20 70 61  74 74 65 72 6e 73 20 77  |gular patterns w|
00003940  68 69 63 68 20 74 68 65  20 65 79 65 20 69 73 20  |hich the eye is |
00003950  73 65 6e 73 69 74 69 76  65 20 74 6f 2e 20 54 68  |sensitive to. Th|
00003960  65 20 66 69 6e 61 6c 20  49 20 6f 66 0a 74 68 65  |e final I of.the|
00003970  20 6e 61 6d 65 20 69 73  20 66 6f 72 20 49 6e 74  | name is for Int|
00003980  65 67 65 72 3a 20 43 68  61 6e 67 65 46 53 49 20  |eger: ChangeFSI |
00003990  64 6f 65 73 20 61 6c 6c  20 69 74 73 20 77 6f 72  |does all its wor|
000039a0  6b 20 69 6e 20 33 32 20  62 69 74 20 66 69 78 65  |k in 32 bit fixe|
000039b0  64 20 70 6f 69 6e 74 0a  69 6e 74 65 67 65 72 20  |d point.integer |
000039c0  61 72 69 74 68 6d 65 74  69 63 20 28 77 69 74 68  |arithmetic (with|
000039d0  20 74 68 65 20 70 6f 69  6e 74 20 61 74 20 62 69  | the point at bi|
000039e0  74 20 32 38 29 20 69 6e  73 74 65 61 64 20 6f 66  |t 28) instead of|
000039f0  20 66 6c 6f 61 74 69 6e  67 20 70 6f 69 6e 74 2e  | floating point.|
00003a00  0a 44 69 74 68 65 72 69  6e 67 20 63 61 6e 20 62  |.Dithering can b|
00003a10  65 20 74 75 72 6e 65 64  20 6f 66 66 20 75 73 69  |e turned off usi|
00003a20  6e 67 20 75 73 69 6e 67  20 22 44 69 73 61 62 6c  |ng using "Disabl|
00003a30  65 20 44 69 74 68 65 72  69 6e 67 22 20 6f 6e 20  |e Dithering" on |
00003a40  74 68 65 20 50 72 6f 63  65 73 73 69 6e 67 0a 64  |the Processing.d|
00003a50  69 61 6c 6f 67 75 65 20  28 22 2d 6e 6f 64 69 74  |ialogue ("-nodit|
00003a60  68 65 72 22 20 6f 6e 20  74 68 65 20 63 6f 6d 6d  |her" on the comm|
00003a70  61 6e 64 20 6c 69 6e 65  29 20 77 68 69 63 68 20  |and line) which |
00003a80  61 74 20 6c 65 61 73 74  20 61 6c 6c 6f 77 73 20  |at least allows |
00003a90  79 6f 75 20 74 6f 20 73  65 65 20 68 6f 77 0a 77  |you to see how.w|
00003aa0  65 6c 6c 20 69 74 20 64  6f 65 73 21 0a 0a 54 68  |ell it does!..Th|
00003ab0  65 20 63 6f 6e 76 65 72  73 69 6f 6e 20 66 72 6f  |e conversion fro|
00003ac0  6d 20 6f 6e 65 20 63 6f  6c 6f 75 72 20 72 61 6e  |m one colour ran|
00003ad0  67 65 20 74 6f 20 61 6e  6f 74 68 65 72 20 69 73  |ge to another is|
00003ae0  20 6d 61 64 65 20 61 74  20 74 68 65 20 73 61 6d  | made at the sam|
00003af0  65 20 74 69 6d 65 20 61  73 20 61 0a 63 68 61 6e  |e time as a.chan|
00003b00  67 65 20 69 6e 20 73 69  7a 65 20 6f 66 20 74 68  |ge in size of th|
00003b10  65 20 69 6d 61 67 65 2e  20 53 69 7a 65 20 69 73  |e image. Size is|
00003b20  20 63 68 61 6e 67 65 64  20 62 79 20 72 61 74 69  | changed by rati|
00003b30  6f 73 20 6f 66 20 61 72  65 61 73 20 62 65 74 77  |os of areas betw|
00003b40  65 65 6e 20 74 68 65 0a  69 6e 70 75 74 20 61 6e  |een the.input an|
00003b50  64 20 6f 75 74 70 75 74  3a 20 74 68 65 20 74 6f  |d output: the to|
00003b60  74 61 6c 20 77 65 69 67  68 74 20 6f 66 20 72 2c  |tal weight of r,|
00003b70  20 67 2c 20 61 6e 64 20  62 20 69 6e 20 74 68 65  | g, and b in the|
00003b80  20 73 6f 75 72 63 65 20  61 72 65 61 20 69 73 0a  | source area is.|
00003b90  63 61 6c 63 75 6c 61 74  65 64 20 75 73 69 6e 67  |calculated using|
00003ba0  20 74 68 65 20 66 69 78  65 64 20 70 6f 69 6e 74  | the fixed point|
00003bb0  20 61 72 69 74 68 6d 65  74 69 63 20 61 6e 64 20  | arithmetic and |
00003bc0  74 68 69 73 20 72 65 73  75 6c 74 20 69 73 20 74  |this result is t|
00003bd0  68 65 6e 0a 61 70 70 72  6f 78 69 6d 61 74 65 64  |hen.approximated|
00003be0  20 74 6f 20 74 68 65 20  6f 75 74 70 75 74 20 75  | to the output u|
00003bf0  73 69 6e 67 20 74 68 65  20 65 72 72 6f 72 20 64  |sing the error d|
00003c00  69 66 66 75 73 69 6f 6e  20 74 6f 20 70 72 65 73  |iffusion to pres|
00003c10  65 72 76 65 20 69 6e 66  6f 72 6d 61 74 69 6f 6e  |erve information|
00003c20  0a 28 66 6f 72 20 65 78  61 6d 70 6c 65 2c 20 63  |.(for example, c|
00003c30  6f 6e 73 69 64 65 72 20  68 61 6c 76 69 6e 67 20  |onsider halving |
00003c40  69 6e 20 73 69 7a 65 20  61 6e 20 69 6d 61 67 65  |in size an image|
00003c50  20 77 69 74 68 20 61 64  6a 61 63 65 6e 74 20 70  | with adjacent p|
00003c60  69 78 65 6c 73 20 6f 66  0a 69 6e 74 65 6e 73 69  |ixels of.intensi|
00003c70  74 69 65 73 20 31 20 61  6e 64 20 32 3b 20 74 68  |ties 1 and 2; th|
00003c80  65 20 6f 75 74 70 75 74  20 70 69 78 65 6c 20 6e  |e output pixel n|
00003c90  65 65 64 73 20 74 6f 20  62 65 20 76 61 6c 75 65  |eeds to be value|
00003ca0  20 31 2e 35 2c 20 73 6f  20 74 68 65 20 30 2e 35  | 1.5, so the 0.5|
00003cb0  20 65 72 72 6f 72 0a 69  73 20 73 65 6e 74 20 74  | error.is sent t|
00003cc0  6f 20 61 64 6a 61 63 65  6e 74 20 70 69 78 65 6c  |o adjacent pixel|
00003cd0  73 20 74 6f 20 6b 65 65  70 20 74 68 65 20 6f 76  |s to keep the ov|
00003ce0  65 72 61 6c 6c 20 63 6f  6c 6f 75 72 20 74 68 65  |erall colour the|
00003cf0  20 73 61 6d 65 29 2e 20  54 68 65 20 73 69 7a 65  | same). The size|
00003d00  0a 63 68 61 6e 67 65 20  69 73 20 65 78 70 72 65  |.change is expre|
00003d10  73 73 65 64 20 61 73 20  61 20 72 61 74 69 6f 20  |ssed as a ratio |
00003d20  6f 66 20 6f 75 74 70 75  74 20 74 6f 20 69 6e 70  |of output to inp|
00003d30  75 74 20 28 65 2e 67 2e  20 34 30 3a 32 30 29 20  |ut (e.g. 40:20) |
00003d40  77 68 69 63 68 20 43 68  61 6e 67 65 46 53 49 0a  |which ChangeFSI.|
00003d50  72 65 64 75 63 65 73 20  74 6f 20 74 68 65 20 73  |reduces to the s|
00003d60  6d 61 6c 6c 65 73 74 20  70 6f 73 73 69 62 6c 65  |mallest possible|
00003d70  20 74 65 72 6d 73 20 28  32 3a 31 20 69 6e 20 74  | terms (2:1 in t|
00003d80  68 69 73 20 63 61 73 65  29 20 73 6f 20 74 68 61  |his case) so tha|
00003d90  74 20 79 6f 75 20 61 72  65 20 66 72 65 65 0a 74  |t you are free.t|
00003da0  6f 20 67 69 76 65 20 76  61 6c 75 65 73 20 6c 69  |o give values li|
00003db0  6b 65 20 32 35 36 3a 35  31 32 20 69 66 20 74 68  |ke 256:512 if th|
00003dc0  61 74 27 73 20 77 68 61  74 20 79 6f 75 20 6d 65  |at's what you me|
00003dd0  61 6e 21 20 53 69 7a 65  20 63 68 61 6e 67 65 20  |an! Size change |
00003de0  69 73 20 65 69 74 68 65  72 20 62 6f 74 68 0a 78  |is either both.x|
00003df0  20 61 6e 64 20 79 20 28  69 66 20 6f 6e 65 20 72  | and y (if one r|
00003e00  61 74 69 6f 20 69 73 20  67 69 76 65 6e 29 20 6f  |atio is given) o|
00003e10  72 20 73 65 70 61 72 61  74 65 20 78 20 61 6e 64  |r separate x and|
00003e20  20 79 20 28 69 66 20 74  77 6f 20 72 61 74 69 6f  | y (if two ratio|
00003e30  73 20 61 72 65 20 67 69  76 65 6e 29 2e 0a 4e 6f  |s are given)..No|
00003e40  74 65 20 74 68 61 74 20  74 68 65 20 73 69 7a 65  |te that the size|
00003e50  20 6f 66 20 61 20 52 49  53 43 20 4f 53 20 70 69  | of a RISC OS pi|
00003e60  78 65 6c 20 69 73 20 6b  6e 6f 77 6e 2c 20 73 6f  |xel is known, so|
00003e70  20 63 68 61 6e 67 69 6e  67 20 66 72 6f 6d 20 28  | changing from (|
00003e80  73 61 79 29 20 6d 6f 64  65 20 32 31 0a 74 6f 20  |say) mode 21.to |
00003e90  28 73 61 79 29 20 6d 6f  64 65 20 31 33 20 64 6f  |(say) mode 13 do|
00003ea0  65 73 20 6e 6f 74 20 6e  65 65 64 20 61 6e 79 20  |es not need any |
00003eb0  61 64 64 69 74 69 6f 6e  61 6c 20 73 70 65 63 69  |additional speci|
00003ec0  66 69 65 64 20 73 63 61  6c 69 6e 67 2e 20 54 68  |fied scaling. Th|
00003ed0  65 20 66 75 6c 6c 20 73  69 7a 65 0a 6f 75 74 70  |e full size.outp|
00003ee0  75 74 20 66 6f 72 20 6d  6f 64 65 20 32 31 20 69  |ut for mode 21 i|
00003ef0  73 20 74 68 65 20 72 65  66 65 72 65 6e 63 65 2c  |s the reference,|
00003f00  20 73 6f 20 73 63 61 6c  65 20 74 6f 20 36 34 30  | so scale to 640|
00003f10  20 62 79 20 35 31 32 2e  20 41 20 63 6f 6d 6d 6f  | by 512. A commo|
00003f20  6e 20 73 63 61 6c 69 6e  67 0a 69 73 20 74 6f 20  |n scaling.is to |
00003f30  66 69 6c 6c 20 74 68 65  20 6f 75 74 70 75 74 20  |fill the output |
00003f40  73 70 72 69 74 65 20 77  69 74 68 20 74 68 65 20  |sprite with the |
00003f50  69 6e 70 75 74 20 61 6e  64 20 61 6e 20 22 3d 22  |input and an "="|
00003f60  20 70 61 72 61 6d 65 74  65 72 20 74 6f 20 78 20  | parameter to x |
00003f70  61 6e 64 2f 6f 72 20 79  0a 72 61 74 69 6f 73 20  |and/or y.ratios |
00003f80  77 69 6c 6c 20 64 6f 20  74 68 69 73 20 77 69 74  |will do this wit|
00003f90  68 6f 75 74 20 65 76 65  72 20 68 61 76 69 6e 67  |hout ever having|
00003fa0  20 74 6f 20 6b 6e 6f 77  20 74 68 65 20 73 69 7a  | to know the siz|
00003fb0  65 20 6f 66 20 74 68 65  20 69 6e 70 75 74 2e 20  |e of the input. |
00003fc0  53 69 6d 70 6c 79 0a 6f  6d 69 74 74 69 6e 67 20  |Simply.omitting |
00003fd0  74 68 65 20 66 72 61 63  74 69 6f 6e 61 6c 20 70  |the fractional p|
00003fe0  61 72 74 20 63 61 75 73  65 73 20 43 68 61 6e 67  |art causes Chang|
00003ff0  65 46 53 49 20 74 6f 20  70 75 74 20 69 6e 20 74  |eFSI to put in t|
00004000  68 65 20 73 6f 75 72 63  65 20 73 69 7a 65 2c 20  |he source size, |
00004010  74 68 75 73 0a 67 69 76  69 6e 67 20 6f 75 74 70  |thus.giving outp|
00004020  75 74 20 77 68 69 63 68  20 69 73 20 74 68 65 20  |ut which is the |
00004030  73 70 65 63 69 66 69 65  64 20 6e 75 6d 62 65 72  |specified number|
00004040  20 6f 66 20 70 69 78 65  6c 73 20 69 6e 20 73 69  | of pixels in si|
00004050  7a 65 2e 0a 0a 43 6f 6e  76 65 72 73 69 6f 6e 20  |ze...Conversion |
00004060  66 72 6f 6d 20 63 6f 6c  6f 75 72 20 74 6f 20 6d  |from colour to m|
00004070  6f 6e 6f 63 68 72 6f 6d  65 20 73 68 61 64 65 73  |onochrome shades|
00004080  20 6f 66 20 67 72 65 79  20 69 73 20 64 6f 6e 65  | of grey is done|
00004090  20 77 69 74 68 20 74 68  65 20 43 49 45 0a 6c 75  | with the CIE.lu|
000040a0  6d 69 6e 61 6e 63 65 20  77 65 69 67 68 74 73 20  |minance weights |
000040b0  66 6f 72 20 72 2c 20 67  20 61 6e 64 20 62 20 28  |for r, g and b (|
000040c0  30 2e 32 39 39 2c 20 30  2e 35 38 37 2c 20 30 2e  |0.299, 0.587, 0.|
000040d0  31 31 34 29 20 77 68 69  63 68 20 69 73 20 74 68  |114) which is th|
000040e0  65 20 73 74 61 6e 64 61  72 64 0a 63 6f 6e 76 65  |e standard.conve|
000040f0  72 73 69 6f 6e 20 66 6f  72 20 62 72 6f 61 64 63  |rsion for broadc|
00004100  61 73 74 20 74 65 6c 65  76 69 73 69 6f 6e 2e 20  |ast television. |
00004110  54 68 65 73 65 20 76 61  6c 75 65 73 20 63 61 6e  |These values can|
00004120  20 62 65 20 61 6c 74 65  72 65 64 20 75 73 69 6e  | be altered usin|
00004130  67 20 74 68 65 0a 2d 72  65 64 2c 20 2d 67 72 65  |g the.-red, -gre|
00004140  65 6e 20 61 6e 64 20 2d  62 6c 75 65 20 63 6f 6d  |en and -blue com|
00004150  6d 61 6e 64 73 20 61 6e  64 20 61 6c 6c 6f 77 20  |mands and allow |
00004160  64 69 66 66 65 72 65 6e  74 20 77 65 69 67 68 74  |different weight|
00004170  69 6e 67 73 20 66 6f 72  20 63 6f 6e 76 65 72 73  |ings for convers|
00004180  69 6f 6e 0a 74 6f 20 6d  6f 6e 6f 63 68 72 6f 6d  |ion.to monochrom|
00004190  65 20 74 6f 20 62 65 20  74 72 69 65 64 2c 20 74  |e to be tried, t|
000041a0  68 69 73 20 61 6c 73 6f  20 61 6c 6c 6f 77 73 20  |his also allows |
000041b0  73 65 6c 65 63 74 69 6f  6e 20 6f 66 20 61 6e 20  |selection of an |
000041c0  69 6d 61 67 65 20 63 6f  6d 70 6f 73 65 64 20 6f  |image composed o|
000041d0  66 0a 6f 6e 6c 79 20 73  6f 6d 65 20 6f 66 20 74  |f.only some of t|
000041e0  68 65 20 63 6f 6c 6f 75  72 73 20 28 65 2e 67 2e  |he colours (e.g.|
000041f0  20 2d 72 65 64 31 20 2d  67 72 65 65 6e 30 20 2d  | -red1 -green0 -|
00004200  62 6c 75 65 30 29 20 69  6e 20 6d 61 6b 69 6e 67  |blue0) in making|
00004210  20 61 20 62 6c 61 63 6b  20 61 6e 64 0a 77 68 69  | a black and.whi|
00004220  74 65 20 69 6d 61 67 65  2e 0a 0a 43 68 61 6e 67  |te image...Chang|
00004230  65 46 53 49 20 63 61 6e  20 74 61 6b 65 20 61 6e  |eFSI can take an|
00004240  79 20 52 49 53 43 20 4f  53 20 73 70 72 69 74 65  |y RISC OS sprite|
00004250  73 20 28 32 2c 20 34 2c  20 31 36 20 6f 72 20 32  |s (2, 4, 16 or 2|
00004260  35 36 20 63 6f 6c 6f 75  72 73 29 2e 20 49 66 20  |56 colours). If |
00004270  74 68 65 72 65 20 69 73  20 61 0a 70 61 6c 65 74  |there is a.palet|
00004280  74 65 20 69 74 20 77 69  6c 6c 20 62 65 20 75 73  |te it will be us|
00004290  65 64 2c 20 6f 74 68 65  72 77 69 73 65 20 74 68  |ed, otherwise th|
000042a0  65 20 73 74 61 6e 64 61  72 64 20 32 2c 20 34 2c  |e standard 2, 4,|
000042b0  20 31 36 20 61 6e 64 20  32 35 36 20 63 6f 6c 6f  | 16 and 256 colo|
000042c0  75 72 20 64 65 73 6b 74  6f 70 0a 70 61 6c 65 74  |ur desktop.palet|
000042d0  74 65 73 20 61 72 65 20  75 73 65 64 2e 20 43 68  |tes are used. Ch|
000042e0  61 6e 67 65 46 53 49 20  63 61 6e 20 61 6c 73 6f  |angeFSI can also|
000042f0  20 72 65 61 64 20 74 68  65 20 31 36 62 70 70 20  | read the 16bpp |
00004300  61 6e 64 20 32 34 62 70  70 20 73 70 72 69 74 65  |and 24bpp sprite|
00004310  73 20 77 68 69 63 68 0a  68 61 76 65 20 6e 6f 20  |s which.have no |
00004320  70 61 6c 65 74 74 65 73  2e 0a 0a 43 68 61 6e 67  |palettes...Chang|
00004330  65 46 53 49 20 69 73 20  62 6f 74 68 20 61 20 63  |eFSI is both a c|
00004340  6f 6d 6d 61 6e 64 20 6c  69 6e 65 20 64 72 69 76  |ommand line driv|
00004350  65 6e 20 70 72 6f 67 72  61 6d 20 61 6e 64 20 61  |en program and a|
00004360  20 64 65 73 6b 74 6f 70  20 61 70 70 6c 69 63 61  | desktop applica|
00004370  74 69 6f 6e 2e 20 54 68  65 0a 66 69 6c 65 20 21  |tion. The.file !|
00004380  48 65 6c 70 20 64 65 73  63 72 69 62 65 73 20 68  |Help describes h|
00004390  6f 77 20 74 6f 20 75 73  65 20 74 68 65 20 61 70  |ow to use the ap|
000043a0  70 6c 69 63 61 74 69 6f  6e 20 66 72 6f 6d 20 74  |plication from t|
000043b0  68 65 20 64 65 73 6b 74  6f 70 2c 20 69 66 20 79  |he desktop, if y|
000043c0  6f 75 20 6e 65 65 64 0a  74 6f 20 75 73 65 20 74  |ou need.to use t|
000043d0  68 65 20 70 72 6f 67 72  61 6d 20 61 73 20 61 20  |he program as a |
000043e0  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 20 64 72 69  |command line dri|
000043f0  76 65 6e 20 70 72 6f 67  72 61 6d 20 79 6f 75 20  |ven program you |
00004400  77 69 6c 6c 20 6e 65 65  64 20 74 6f 20 68 61 76  |will need to hav|
00004410  65 20 69 74 20 69 6e 0a  74 68 65 20 6c 69 62 72  |e it in.the libr|
00004420  61 72 79 20 28 6f 72 20  6f 6e 20 72 75 6e 24 70  |ary (or on run$p|
00004430  61 74 68 29 20 61 6e 64  20 70 72 65 73 73 20 66  |ath) and press f|
00004440  31 32 20 74 6f 20 67 65  74 20 6f 75 74 20 6f 66  |12 to get out of|
00004450  20 74 68 65 20 64 65 73  6b 74 6f 70 2e 20 54 68  | the desktop. Th|
00004460  65 20 66 69 6c 65 0a 22  46 53 49 75 73 65 22 20  |e file."FSIuse" |
00004470  64 65 73 63 72 69 62 65  73 20 74 68 65 20 70 61  |describes the pa|
00004480  72 61 6d 65 74 65 72 73  20 63 6f 6e 63 69 73 65  |rameters concise|
00004490  6c 79 2e 20 54 68 65 20  70 72 6f 67 72 61 6d 20  |ly. The program |
000044a0  73 65 6c 65 63 74 73 20  6d 6f 64 65 20 30 20 77  |selects mode 0 w|
000044b0  68 65 6e 0a 72 75 6e 20  66 72 6f 6d 20 74 68 65  |hen.run from the|
000044c0  20 63 6f 6d 6d 61 6e 64  20 6c 69 6e 65 20 77 68  | command line wh|
000044d0  65 6e 20 64 6f 69 6e 67  20 61 6e 79 20 77 6f 72  |en doing any wor|
000044e0  6b 20 69 6e 20 6f 72 64  65 72 20 74 6f 20 73 70  |k in order to sp|
000044f0  65 65 64 20 75 70 20 70  72 6f 63 65 73 73 69 6e  |eed up processin|
00004500  67 0a 28 74 68 69 73 20  63 61 6e 20 62 65 20 64  |g.(this can be d|
00004510  69 73 61 62 6c 65 64 20  77 69 74 68 20 2d 6e 6f  |isabled with -no|
00004520  6d 6f 64 65 29 2e 20 49  74 20 6d 61 79 20 61 6c  |mode). It may al|
00004530  73 6f 20 62 65 20 61 20  67 6f 6f 64 20 69 64 65  |so be a good ide|
00004540  61 20 74 6f 20 52 4d 46  61 73 74 65 72 0a 42 41  |a to RMFaster.BA|
00004550  53 49 43 2e 20 41 6e 20  68 6f 75 72 67 6c 61 73  |SIC. An hourglas|
00004560  73 20 25 61 67 65 20 70  72 6f 63 65 73 73 65 64  |s %age processed|
00004570  20 66 69 67 75 72 65 20  69 73 20 64 69 73 70 6c  | figure is displ|
00004580  61 79 65 64 20 28 74 68  69 73 20 6d 61 79 20 72  |ayed (this may r|
00004590  75 6e 20 74 68 72 6f 75  67 68 0a 74 77 69 63 65  |un through.twice|
000045a0  20 66 6f 72 20 73 6f 6d  65 20 6f 66 20 74 68 65  | for some of the|
000045b0  20 6d 6f 72 65 20 65 78  70 65 6e 73 69 76 65 20  | more expensive |
000045c0  6f 70 74 69 6f 6e 73 29  2e 20 54 68 65 20 70 72  |options). The pr|
000045d0  6f 67 72 61 6d 20 72 65  61 64 73 20 74 68 65 20  |ogram reads the |
000045e0  73 6f 75 72 63 65 0a 69  6d 61 67 65 20 66 72 6f  |source.image fro|
000045f0  6d 20 64 69 73 63 20 61  6e 64 20 62 75 69 6c 64  |m disc and build|
00004600  73 20 74 68 65 20 6f 75  74 70 75 74 20 69 6e 20  |s the output in |
00004610  6d 65 6d 6f 72 79 2c 20  68 61 76 69 6e 67 20 63  |memory, having c|
00004620  6c 61 69 6d 65 64 20 73  6f 6d 65 20 66 72 6f 6d  |laimed some from|
00004630  20 74 68 65 0a 73 79 73  74 65 6d 2e 0a 0a 49 6e  | the.system...In|
00004640  20 61 64 64 69 74 69 6f  6e 20 74 6f 20 73 74 72  | addition to str|
00004650  69 63 74 6c 79 20 63 6f  6e 76 65 72 74 69 6e 67  |ictly converting|
00004660  20 74 68 65 20 73 6f 75  72 63 65 20 69 6d 61 67  | the source imag|
00004670  65 2c 20 43 68 61 6e 67  65 46 53 49 20 63 61 6e  |e, ChangeFSI can|
00004680  20 61 6c 73 6f 20 70 72  6f 63 65 73 73 0a 69 74  | also process.it|
00004690  2e 20 41 20 74 72 69 76  69 61 6c 20 6f 70 74 69  |. A trivial opti|
000046a0  6f 6e 20 69 73 20 22 2d  69 6e 66 6f 22 3a 20 43  |on is "-info": C|
000046b0  68 61 6e 67 65 46 53 49  20 77 69 6c 6c 20 74 65  |hangeFSI will te|
000046c0  6c 6c 20 79 6f 75 20 77  68 61 74 20 69 74 20 69  |ll you what it i|
000046d0  73 20 64 6f 69 6e 67 20  28 61 0a 67 6f 6f 64 20  |s doing (a.good |
000046e0  77 61 79 20 6f 66 20 66  69 6e 64 69 6e 67 20 6f  |way of finding o|
000046f0  75 74 20 77 68 61 74 20  74 68 65 20 73 6f 75 72  |ut what the sour|
00004700  63 65 20 69 6d 61 67 65  20 61 63 74 75 61 6c 6c  |ce image actuall|
00004710  79 20 69 73 2c 20 61 6e  64 20 68 6f 77 20 74 68  |y is, and how th|
00004720  65 20 73 63 61 6c 69 6e  67 0a 74 75 72 6e 73 20  |e scaling.turns |
00004730  6f 75 74 21 29 2e 20 53  69 6d 69 6c 61 72 6c 79  |out!). Similarly|
00004740  20 74 72 69 76 69 61 6c  20 61 72 65 20 2d 76 66  | trivial are -vf|
00004750  6c 69 70 20 61 6e 64 20  2d 68 66 6c 69 70 20 2d  |lip and -hflip -|
00004760  20 74 68 65 20 70 69 63  74 75 72 65 20 63 61 6e  | the picture can|
00004770  20 62 65 0a 70 72 6f 64  75 63 65 20 75 70 73 69  | be.produce upsi|
00004780  64 65 20 64 6f 77 6e 20  61 6e 64 20 6c 65 66 74  |de down and left|
00004790  2f 72 69 67 68 74 20 72  65 76 65 72 73 65 64 2e  |/right reversed.|
000047a0  20 4e 6f 74 20 73 6f 20  74 72 69 76 69 61 6c 20  | Not so trivial |
000047b0  69 73 20 2d 72 6f 74 61  74 65 2c 20 77 68 69 63  |is -rotate, whic|
000047c0  68 0a 77 69 6c 6c 20 72  6f 74 61 74 65 20 74 68  |h.will rotate th|
000047d0  65 20 69 6d 61 67 65 20  62 79 20 39 30 20 64 65  |e image by 90 de|
000047e0  67 72 65 65 73 20 28 74  68 61 74 20 69 73 2c 20  |grees (that is, |
000047f0  61 6e 20 61 6e 74 69 2d  20 63 6c 6f 63 6b 77 69  |an anti- clockwi|
00004800  73 65 20 71 75 61 72 74  65 72 20 74 75 72 6e 29  |se quarter turn)|
00004810  2e 0a 2d 72 6f 74 61 74  65 2d 20 72 6f 74 61 74  |..-rotate- rotat|
00004820  65 73 20 62 79 20 2d 39  30 20 64 65 67 72 65 65  |es by -90 degree|
00004830  73 20 28 63 6c 6f 63 6b  77 69 73 65 20 71 75 61  |s (clockwise qua|
00004840  72 74 65 72 20 74 75 72  6e 29 2e 0a 0a 53 6f 6d  |rter turn)...Som|
00004850  65 74 69 6d 65 73 20 75  73 65 66 75 6c 20 69 73  |etimes useful is|
00004860  20 22 2d 6e 6f 73 69 7a  65 22 3a 20 43 68 61 6e  | "-nosize": Chan|
00004870  67 65 46 53 49 20 63 61  6e 20 72 65 61 64 20 70  |geFSI can read p|
00004880  69 78 65 6c 20 73 69 7a  65 20 69 6e 66 6f 72 6d  |ixel size inform|
00004890  61 74 69 6f 6e 20 66 72  6f 6d 0a 74 68 65 20 73  |ation from.the s|
000048a0  6f 75 72 63 65 20 69 6d  61 67 65 20 28 69 66 20  |ource image (if |
000048b0  70 72 65 73 65 6e 74 29  20 6f 72 20 67 75 65 73  |present) or gues|
000048c0  73 20 69 74 20 28 65 2e  67 2e 20 69 66 20 74 68  |s it (e.g. if th|
000048d0  65 72 65 20 61 72 65 20  6c 65 73 73 20 74 68 61  |ere are less tha|
000048e0  6e 20 33 32 30 20 62 79  0a 32 35 36 20 70 69 78  |n 320 by.256 pix|
000048f0  65 6c 73 20 69 6e 20 61  20 73 6f 75 72 63 65 20  |els in a source |
00004900  69 6d 61 67 65 2c 20 43  68 61 6e 67 65 46 53 49  |image, ChangeFSI|
00004910  20 61 73 73 75 6d 65 73  20 74 68 65 20 70 69 78  | assumes the pix|
00004920  65 6c 73 20 61 72 65 20  74 68 65 20 73 61 6d 65  |els are the same|
00004930  20 73 69 7a 65 20 61 73  0a 4d 4f 44 45 20 31 33  | size as.MODE 13|
00004940  27 73 20 5b 34 35 20 70  65 72 20 69 6e 63 68 5d  |'s [45 per inch]|
00004950  29 20 6f 72 20 64 65 72  69 76 65 20 69 74 20 66  |) or derive it f|
00004960  72 6f 6d 20 6f 74 68 65  72 20 69 6e 66 6f 72 6d  |rom other inform|
00004970  61 74 69 6f 6e 20 61 6e  64 20 73 63 61 6c 65 20  |ation and scale |
00004980  74 68 65 0a 6f 75 74 70  75 74 20 69 6d 61 67 65  |the.output image|
00004990  20 28 63 6f 6d 70 6f 73  65 64 20 6f 66 20 52 49  | (composed of RI|
000049a0  53 43 20 4f 53 20 73 71  75 61 72 65 20 6f 72 20  |SC OS square or |
000049b0  31 3a 32 20 73 69 7a 65  64 20 70 69 78 65 6c 73  |1:2 sized pixels|
000049c0  29 20 61 70 70 72 6f 70  72 69 61 74 65 6c 79 2e  |) appropriately.|
000049d0  0a 2d 6e 6f 73 69 7a 65  20 73 74 6f 70 73 20 74  |.-nosize stops t|
000049e0  68 69 73 20 66 72 6f 6d  20 68 61 70 70 65 6e 69  |his from happeni|
000049f0  6e 67 2e 20 5b 74 68 69  73 20 73 65 65 6d 73 20  |ng. [this seems |
00004a00  70 61 72 74 69 63 75 6c  61 72 6c 79 20 72 65 6c  |particularly rel|
00004a10  65 76 61 6e 74 20 6f 6e  20 66 6f 72 6d 61 74 73  |evant on formats|
00004a20  0a 6c 69 6b 65 20 54 49  46 46 20 6f 72 20 49 46  |.like TIFF or IF|
00004a30  46 20 77 68 65 72 65 20  74 68 65 20 70 69 78 65  |F where the pixe|
00004a40  6c 20 73 69 7a 65 20 69  73 20 73 70 65 63 69 66  |l size is specif|
00004a50  69 65 64 20 2a 62 75 74  20 6d 61 79 20 62 65 20  |ied *but may be |
00004a60  77 72 6f 6e 67 2a 5d 20  55 73 69 6e 67 0a 2d 69  |wrong*] Using.-i|
00004a70  6e 66 6f 20 77 69 6c 6c  20 64 69 73 70 6c 61 79  |nfo will display|
00004a80  20 74 68 65 20 70 69 78  65 6c 20 72 61 74 69 6f  | the pixel ratio|
00004a90  73 20 77 68 69 63 68 20  43 68 61 6e 67 65 46 53  |s which ChangeFS|
00004aa0  49 20 69 73 20 75 73 69  6e 67 20 2d 20 61 20 63  |I is using - a c|
00004ab0  6f 6d 62 69 6e 61 74 69  6f 6e 20 6f 66 0a 74 68  |ombination of.th|
00004ac0  65 20 73 69 7a 65 20 67  75 65 73 73 2c 20 74 68  |e size guess, th|
00004ad0  65 20 6f 75 74 70 75 74  20 70 69 78 65 6c 20 73  |e output pixel s|
00004ae0  69 7a 65 20 61 6e 64 20  61 6e 79 20 64 65 6c 69  |ize and any deli|
00004af0  62 65 72 61 74 65 20 73  63 61 6c 69 6e 67 2e 20  |berate scaling. |
00004b00  22 2d 6e 6f 73 63 61 6c  65 22 0a 74 75 72 6e 73  |"-noscale".turns|
00004b10  20 6f 66 66 20 74 68 65  20 6f 75 74 70 75 74 20  | off the output |
00004b20  73 63 61 6c 69 6e 67 20  61 73 20 77 65 6c 6c 2e  |scaling as well.|
00004b30  0a 0a 54 68 65 20 73 69  6d 70 6c 65 73 74 20 69  |..The simplest i|
00004b40  6d 61 67 65 20 70 72 6f  63 65 73 73 69 6e 67 20  |mage processing |
00004b50  6f 70 74 69 6f 6e 20 69  73 20 22 2d 72 61 6e 67  |option is "-rang|
00004b60  65 22 20 77 68 69 63 68  20 77 69 6c 6c 20 65 78  |e" which will ex|
00004b70  70 61 6e 64 20 74 68 65  20 64 79 6e 61 6d 69 63  |pand the dynamic|
00004b80  0a 72 61 6e 67 65 20 6f  66 20 74 68 65 20 69 6e  |.range of the in|
00004b90  70 75 74 20 70 69 63 74  75 72 65 20 73 6f 20 74  |put picture so t|
00004ba0  68 61 74 20 69 74 20 66  69 6c 6c 73 20 74 68 65  |hat it fills the|
00004bb0  20 61 76 61 69 6c 61 62  6c 65 20 61 72 65 61 20  | available area |
00004bc0  28 6e 6f 74 20 61 20 67  6f 6f 64 0a 6f 70 74 69  |(not a good.opti|
00004bd0  6f 6e 20 66 6f 72 20 61  6e 69 6d 61 74 65 64 20  |on for animated |
00004be0  73 65 71 75 65 6e 63 65  73 20 75 6e 6c 65 73 73  |sequences unless|
00004bf0  20 61 6c 6c 20 73 6f 75  72 63 65 20 69 6d 61 67  | all source imag|
00004c00  65 73 20 70 6f 73 73 65  73 73 20 74 68 65 20 73  |es possess the s|
00004c10  61 6d 65 20 72 61 6e 67  65 29 2e 0a 53 69 6e 63  |ame range)..Sinc|
00004c20  65 20 72 2c 20 67 2c 20  62 20 61 72 65 20 70 72  |e r, g, b are pr|
00004c30  6f 63 65 73 73 65 64 20  62 79 20 74 68 65 20 73  |ocessed by the s|
00004c40  61 6d 65 20 61 6d 6f 75  6e 74 2c 20 2d 72 61 6e  |ame amount, -ran|
00004c50  67 65 20 70 72 65 73 65  72 76 65 73 20 74 68 65  |ge preserves the|
00004c60  20 63 6f 6c 6f 75 72 20  6f 66 0a 70 69 78 65 6c  | colour of.pixel|
00004c70  73 20 69 6e 20 63 6f 6c  6f 75 72 65 64 20 70 69  |s in coloured pi|
00004c80  63 74 75 72 65 73 2e 0a  0a 41 20 75 73 65 66 75  |ctures...A usefu|
00004c90  6c 20 6f 70 74 69 6f 6e  20 66 6f 72 20 6f 75 74  |l option for out|
00004ca0  70 75 74 20 69 6e 74 65  6e 64 65 64 20 66 6f 72  |put intended for|
00004cb0  20 74 68 65 20 73 63 72  65 65 6e 20 6f 6e 6c 79  | the screen only|
00004cc0  20 69 73 20 47 61 6d 6d  61 20 63 6f 72 72 65 63  | is Gamma correc|
00004cd0  74 69 6f 6e 2e 0a 43 52  54 20 64 69 73 70 6c 61  |tion..CRT displa|
00004ce0  79 73 20 64 6f 20 6e 6f  74 20 68 61 76 65 20 61  |ys do not have a|
00004cf0  20 73 69 6d 70 6c 65 20  6c 69 6e 65 61 72 20 72  | simple linear r|
00004d00  65 6c 61 74 69 6f 6e 73  68 69 70 20 62 65 74 77  |elationship betw|
00004d10  65 65 6e 20 62 72 69 67  68 74 6e 65 73 73 20 6f  |een brightness o|
00004d20  66 20 74 68 65 0a 73 70  6f 74 20 61 6e 64 20 69  |f the.spot and i|
00004d30  6e 70 75 74 20 76 6f 6c  74 61 67 65 3a 20 69 6e  |nput voltage: in|
00004d40  73 74 65 61 64 20 6f 66  20 62 72 69 67 68 74 6e  |stead of brightn|
00004d50  65 73 73 20 3d 20 63 6f  6e 73 74 20 2a 20 76 6f  |ess = const * vo|
00004d60  6c 74 61 67 65 2c 20 74  68 65 20 72 65 73 70 6f  |ltage, the respo|
00004d70  6e 73 65 0a 69 73 20 62  72 69 67 68 74 6e 65 73  |nse.is brightnes|
00004d80  73 20 3d 20 63 6f 6e 73  74 20 2a 20 76 6f 6c 74  |s = const * volt|
00004d90  61 67 65 20 5e 20 28 31  2f 67 61 6d 6d 61 29 2e  |age ^ (1/gamma).|
00004da0  20 49 6e 20 74 68 65 20  54 56 20 69 6e 64 75 73  | In the TV indus|
00004db0  74 72 79 2c 20 67 61 6d  6d 61 20 68 61 73 20 62  |try, gamma has b|
00004dc0  65 65 6e 0a 73 74 61 6e  64 61 72 64 69 73 65 64  |een.standardised|
00004dd0  20 61 73 20 32 2e 32 2c  20 62 75 74 20 74 68 65  | as 2.2, but the|
00004de0  72 65 20 69 73 20 77 69  64 65 20 76 61 72 69 61  |re is wide varia|
00004df0  74 69 6f 6e 20 69 6e 20  74 68 65 20 63 6f 6d 70  |tion in the comp|
00004e00  75 74 65 72 20 69 6e 64  75 73 74 72 79 3a 20 74  |uter industry: t|
00004e10  68 65 0a 6d 6f 6e 69 74  6f 72 27 73 20 72 65 73  |he.monitor's res|
00004e20  70 6f 6e 73 65 20 77 69  6c 6c 20 76 61 72 79 20  |ponse will vary |
00004e30  64 65 70 65 6e 64 69 6e  67 20 6f 6e 20 77 68 61  |depending on wha|
00004e40  74 20 6d 61 6b 65 20 69  74 20 69 73 20 61 6e 64  |t make it is and|
00004e50  20 68 6f 77 20 69 74 20  69 73 0a 61 64 6a 75 73  | how it is.adjus|
00004e60  74 65 64 2e 20 4c 6f 77  20 76 61 6c 75 65 73 20  |ted. Low values |
00004e70  6f 66 20 67 61 6d 6d 61  20 28 30 20 74 6f 20 31  |of gamma (0 to 1|
00004e80  29 20 6d 61 6b 65 20 63  6f 6c 6f 75 72 73 20 64  |) make colours d|
00004e90  61 72 6b 65 72 20 61 6e  64 20 68 69 67 68 20 76  |arker and high v|
00004ea0  61 6c 75 65 73 0a 28 61  62 6f 76 65 20 31 29 20  |alues.(above 1) |
00004eb0  6d 61 6b 65 20 63 6f 6c  6f 75 72 73 20 6c 69 67  |make colours lig|
00004ec0  68 74 65 72 20 77 69 74  68 20 74 68 65 20 65 66  |hter with the ef|
00004ed0  66 65 63 74 73 20 62 65  69 6e 67 20 70 61 72 74  |fects being part|
00004ee0  69 63 75 6c 61 72 6c 79  20 6e 6f 74 69 63 65 61  |icularly noticea|
00004ef0  62 6c 65 0a 6f 6e 20 64  69 6d 20 63 6f 6c 6f 75  |ble.on dim colou|
00004f00  72 73 2e 20 22 2d 67 61  6d 6d 61 22 20 75 73 65  |rs. "-gamma" use|
00004f10  73 20 74 68 65 20 64 65  66 61 75 6c 74 20 6f 66  |s the default of|
00004f20  20 32 2e 32 2c 20 61 6e  64 20 69 74 20 63 61 6e  | 2.2, and it can|
00004f30  20 62 65 20 73 65 74 20  62 79 0a 22 2d 67 61 6d  | be set by."-gam|
00004f40  6d 61 31 2e 35 22 20 73  61 79 2e 20 47 61 6d 6d  |ma1.5" say. Gamm|
00004f50  61 20 63 6f 72 72 65 63  74 69 6f 6e 20 69 73 20  |a correction is |
00004f60  6d 6f 73 74 20 72 65 6c  65 76 61 6e 74 20 77 68  |most relevant wh|
00004f70  65 6e 20 69 74 73 20 6b  6e 6f 77 6e 20 74 68 61  |en its known tha|
00004f80  74 20 74 68 65 0a 69 6e  70 75 74 20 68 61 73 20  |t the.input has |
00004f90  61 20 6c 69 6e 65 61 72  20 69 6e 74 65 6e 73 69  |a linear intensi|
00004fa0  74 79 20 28 69 6e 70 75  74 20 66 72 6f 6d 20 61  |ty (input from a|
00004fb0  20 73 63 61 6e 6e 65 72  20 6f 72 20 66 72 6f 6d  | scanner or from|
00004fc0  20 61 6e 6f 74 68 65 72  20 63 6f 6d 70 75 74 65  | another compute|
00004fd0  72 0a 77 69 74 68 20 6d  6f 72 65 20 62 69 74 73  |r.with more bits|
00004fe0  20 70 65 72 20 63 6f 6c  6f 75 72 20 63 6f 6d 70  | per colour comp|
00004ff0  6f 6e 65 6e 74 20 74 68  61 6e 20 74 68 65 20 41  |onent than the A|
00005000  72 63 68 69 6d 65 64 65  73 29 2e 0a 0a 41 20 6d  |rchimedes)...A m|
00005010  6f 72 65 20 63 6f 6d 70  6c 65 78 20 70 72 69 6d  |ore complex prim|
00005020  69 74 69 76 65 20 69 73  20 22 2d 65 71 75 61 6c  |itive is "-equal|
00005030  22 20 77 68 69 63 68 20  70 65 72 66 6f 72 6d 73  |" which performs|
00005040  20 22 68 69 73 74 6f 67  72 61 6d 20 65 71 75 61  | "histogram equa|
00005050  6c 69 73 61 74 69 6f 6e  22 20 6f 6e 0a 74 68 65  |lisation" on.the|
00005060  20 69 6d 61 67 65 2e 20  54 68 69 73 20 6d 61 6b  | image. This mak|
00005070  65 73 20 74 68 65 20 68  69 73 74 6f 67 72 61 6d  |es the histogram|
00005080  20 6f 66 20 6c 65 76 65  6c 20 76 65 72 73 75 73  | of level versus|
00005090  20 6e 75 6d 62 65 72 20  6f 66 20 70 6f 69 6e 74  | number of point|
000050a0  73 20 61 74 20 74 68 61  74 0a 6c 65 76 65 6c 20  |s at that.level |
000050b0  61 73 20 66 6c 61 74 20  61 73 20 70 6f 73 73 69  |as flat as possi|
000050c0  62 6c 65 20 67 69 76 69  6e 67 20 66 75 6c 6c 20  |ble giving full |
000050d0  75 73 65 20 6f 66 20 74  68 65 20 6e 75 6d 62 65  |use of the numbe|
000050e0  72 20 6f 66 20 63 6f 6c  6f 75 72 73 20 61 76 61  |r of colours ava|
000050f0  69 6c 61 62 6c 65 2e 0a  2d 65 71 75 61 6c 20 69  |ilable..-equal i|
00005100  73 20 61 20 76 65 72 79  20 68 61 72 73 68 20 70  |s a very harsh p|
00005110  72 69 6d 69 74 69 76 65  2c 20 65 76 65 6e 20 6f  |rimitive, even o|
00005120  6e 20 6d 6f 6e 6f 63 68  72 6f 6d 65 20 69 6e 70  |n monochrome inp|
00005130  75 74 73 20 69 74 20 63  61 6e 20 70 72 6f 64 75  |uts it can produ|
00005140  63 65 20 61 6e 0a 69 6e  66 65 72 69 6f 72 20 70  |ce an.inferior p|
00005150  69 63 74 75 72 65 3b 20  77 68 69 6c 65 20 6f 6e  |icture; while on|
00005160  20 63 6f 6c 6f 75 72 20  70 69 63 74 75 72 65 73  | colour pictures|
00005170  20 69 74 20 63 61 6e 20  64 69 73 74 6f 72 74 20  | it can distort |
00005180  74 68 65 20 63 6f 6c 6f  75 72 20 6f 66 20 65 61  |the colour of ea|
00005190  63 68 0a 70 6f 69 6e 74  20 28 73 69 6e 63 65 20  |ch.point (since |
000051a0  72 2c 20 67 2c 20 62 20  61 72 65 20 63 6f 6d 70  |r, g, b are comp|
000051b0  75 74 65 64 20 73 65 70  61 72 61 74 65 6c 79 29  |uted separately)|
000051c0  2e 20 42 75 74 20 2d 65  71 75 61 6c 20 63 61 6e  |. But -equal can|
000051d0  20 6f 66 74 65 6e 20 72  65 63 6f 76 65 72 20 61  | often recover a|
000051e0  0a 70 69 63 74 75 72 65  20 74 68 61 74 20 69 73  |.picture that is|
000051f0  20 6f 74 68 65 72 77 69  73 65 20 63 6f 6d 70 6c  | otherwise compl|
00005200  65 74 65 6c 79 20 75 73  65 6c 65 73 73 20 6f 72  |etely useless or|
00005210  20 65 78 70 6f 73 65 20  69 6e 66 6f 72 6d 61 74  | expose informat|
00005220  69 6f 6e 20 6c 6f 63 6b  65 64 20 69 6e 20 61 0a  |ion locked in a.|
00005230  73 6d 61 6c 6c 20 70 61  72 74 20 6f 66 20 74 68  |small part of th|
00005240  65 20 69 6e 70 75 74 20  73 63 61 6c 65 2e 0a 0a  |e input scale...|
00005250  49 6d 61 67 65 20 63 6f  6c 6f 75 72 73 20 6d 61  |Image colours ma|
00005260  79 20 62 65 20 69 6e 76  65 72 74 65 64 20 77 69  |y be inverted wi|
00005270  74 68 20 74 68 65 20 2d  69 6e 76 65 72 74 20 6f  |th the -invert o|
00005280  70 74 69 6f 6e 2e 20 57  68 69 63 68 20 6d 61 79  |ption. Which may|
00005290  20 62 65 20 66 75 6e 20  69 6e 0a 63 6f 6c 6f 75  | be fun in.colou|
000052a0  72 20 62 75 74 20 69 73  20 72 61 72 65 6c 79 20  |r but is rarely |
000052b0  75 73 65 66 75 6c 21 20  48 6f 77 65 76 65 72 2c  |useful! However,|
000052c0  20 6d 6f 6e 6f 63 68 72  6f 6d 65 20 69 6d 61 67  | monochrome imag|
000052d0  65 73 20 66 72 65 71 75  65 6e 74 6c 79 20 6e 65  |es frequently ne|
000052e0  65 64 0a 69 6e 76 65 72  74 69 6e 67 2c 20 65 73  |ed.inverting, es|
000052f0  70 65 63 69 61 6c 6c 79  20 6f 6e 65 20 62 69 74  |pecially one bit|
00005300  20 70 65 72 20 70 69 78  65 6c 20 73 6f 75 72 63  | per pixel sourc|
00005310  65 73 2e 0a 0a 41 20 6d  6f 72 65 20 70 6f 77 65  |es...A more powe|
00005320  72 66 75 6c 20 6f 70 74  69 6f 6e 20 69 73 20 22  |rful option is "|
00005330  2d 73 68 61 72 70 65 6e  22 20 77 68 69 63 68 20  |-sharpen" which |
00005340  65 6e 68 61 6e 63 65 73  20 74 68 65 20 65 64 67  |enhances the edg|
00005350  65 73 20 6f 66 20 6f 62  6a 65 63 74 73 20 69 6e  |es of objects in|
00005360  20 74 68 65 0a 70 69 63  74 75 72 65 3a 20 74 68  | the.picture: th|
00005370  69 73 20 69 73 20 76 65  72 79 20 75 73 65 66 75  |is is very usefu|
00005380  6c 20 73 69 6e 63 65 20  74 68 65 20 64 69 74 68  |l since the dith|
00005390  65 72 69 6e 67 20 70 72  6f 63 65 73 73 20 69 6e  |ering process in|
000053a0  65 76 69 74 61 62 6c 79  20 73 6d 65 61 72 73 0a  |evitably smears.|
000053b0  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 6f 76 65 72  |information over|
000053c0  20 74 68 65 20 64 69 73  70 6c 61 79 2e 20 50 72  | the display. Pr|
000053d0  65 2d 73 68 61 72 70 65  6e 69 6e 67 20 74 68 65  |e-sharpening the|
000053e0  20 69 6d 61 67 65 20 63  61 6e 20 72 65 73 75 6c  | image can resul|
000053f0  74 20 69 6e 20 61 20 6d  6f 72 65 0a 61 63 63 65  |t in a more.acce|
00005400  70 74 61 62 6c 65 20 6f  75 74 70 75 74 2e 20 44  |ptable output. D|
00005410  65 66 61 75 6c 74 20 76  61 6c 75 65 73 20 6f 66  |efault values of|
00005420  20 73 68 61 72 70 65 6e  69 6e 67 20 63 61 6e 20  | sharpening can |
00005430  62 65 20 6f 76 65 72 72  69 64 64 65 6e 20 66 6f  |be overridden fo|
00005440  72 20 73 70 65 63 69 61  6c 0a 65 66 66 65 63 74  |r special.effect|
00005450  73 3a 20 2d 73 68 61 72  70 65 6e 38 20 64 6f 65  |s: -sharpen8 doe|
00005460  73 20 65 64 67 65 20 64  65 74 65 63 74 69 6f 6e  |s edge detection|
00005470  2e 20 4c 6f 77 65 72 20  61 6d 6f 75 6e 74 73 20  |. Lower amounts |
00005480  6f 66 20 73 68 61 72 70  65 6e 69 6e 67 20 61 72  |of sharpening ar|
00005490  65 0a 6f 62 74 61 69 6e  65 64 20 77 69 74 68 20  |e.obtained with |
000054a0  6c 61 72 67 65 72 20 2d  73 68 61 72 70 65 6e 20  |larger -sharpen |
000054b0  6e 75 6d 62 65 72 73 2e  20 49 6e 20 67 65 6e 65  |numbers. In gene|
000054c0  72 61 6c 20 74 68 65 20  6d 6f 72 65 20 69 6e 70  |ral the more inp|
000054d0  75 74 20 61 6e 64 20 6f  75 74 70 75 74 0a 70 69  |ut and output.pi|
000054e0  78 65 6c 73 20 61 6e 64  20 74 68 65 20 67 72 65  |xels and the gre|
000054f0  61 74 65 72 20 74 68 65  20 6f 75 74 70 75 74 20  |ater the output |
00005500  72 61 6e 67 65 20 69 6e  20 61 20 70 69 78 65 6c  |range in a pixel|
00005510  20 69 6e 20 74 68 65 20  69 6d 61 67 65 73 2c 20  | in the images, |
00005520  74 68 65 20 6c 65 73 73  0a 73 68 61 72 70 65 6e  |the less.sharpen|
00005530  69 6e 67 20 69 73 20 72  65 71 75 69 72 65 64 2e  |ing is required.|
00005540  20 53 68 61 72 70 65 6e  69 6e 67 20 61 20 70 69  | Sharpening a pi|
00005550  63 74 75 72 65 20 77 68  69 63 68 20 69 73 20 61  |cture which is a|
00005560  6c 72 65 61 64 79 20 64  69 74 68 65 72 65 64 20  |lready dithered |
00005570  63 61 6e 20 67 69 76 65  0a 61 20 76 65 72 79 20  |can give.a very |
00005580  62 61 64 20 72 65 73 75  6c 74 2e 2e 2e 2e 0a 0a  |bad result......|
00005590  54 68 65 20 73 68 61 72  70 65 6e 69 6e 67 20 69  |The sharpening i|
000055a0  73 20 61 63 68 69 65 76  65 64 20 77 69 74 68 20  |s achieved with |
000055b0  74 68 65 20 66 6f 6c 6c  6f 77 69 6e 67 20 6d 61  |the following ma|
000055c0  74 72 69 78 3a 0a 0a 20  20 20 2d 31 20 20 20 20  |trix:..   -1    |
000055d0  2d 31 20 20 20 20 2d 31  0a 20 20 20 2d 31 20 73  |-1    -1.   -1 s|
000055e0  68 61 72 70 65 6e 20 20  2d 31 0a 20 20 20 2d 31  |harpen  -1.   -1|
000055f0  20 20 20 20 2d 31 20 20  20 20 2d 31 0a 0a 43 68  |    -1    -1..Ch|
00005600  61 6e 67 65 46 53 49 20  63 6f 6d 70 75 74 65 73  |angeFSI computes|
00005610  20 74 68 65 20 73 75 6d  20 6f 66 20 6e 69 6e 65  | the sum of nine|
00005620  20 70 69 78 65 6c 73 20  77 69 74 68 20 74 68 65  | pixels with the|
00005630  20 61 62 6f 76 65 20 77  65 69 67 68 74 73 20 66  | above weights f|
00005640  6f 72 20 65 61 63 68 20  69 6e 70 75 74 0a 70 69  |or each input.pi|
00005650  78 65 6c 20 61 6e 64 20  72 65 6e 6f 72 6d 61 6c  |xel and renormal|
00005660  69 73 65 73 20 74 68 65  20 72 65 73 75 6c 74 20  |ises the result |
00005670  28 64 69 76 69 64 65 73  20 62 79 20 73 68 61 72  |(divides by shar|
00005680  70 65 6e 2d 38 29 2e 0a  0a 41 6e 20 6f 70 74 69  |pen-8)...An opti|
00005690  6f 6e 20 66 6f 72 20 74  65 73 74 69 6e 67 20 69  |on for testing i|
000056a0  73 20 22 2d 6e 6f 64 69  74 68 65 72 22 20 77 68  |s "-nodither" wh|
000056b0  69 63 68 20 64 69 73 61  62 6c 65 73 20 74 68 65  |ich disables the|
000056c0  20 46 6c 6f 79 64 20 53  74 65 69 6e 62 65 72 67  | Floyd Steinberg|
000056d0  20 65 72 72 6f 72 0a 64  69 66 66 75 73 69 6f 6e  | error.diffusion|
000056e0  20 73 74 65 70 20 63 6f  6d 70 6c 65 74 65 6c 79  | step completely|
000056f0  2e 20 56 65 72 73 69 6f  6e 73 20 61 66 74 65 72  |. Versions after|
00005700  20 36 74 68 20 4a 75 6e  65 20 31 39 39 30 20 61  | 6th June 1990 a|
00005710  72 65 20 6d 6f 72 65 20  61 63 63 75 72 61 74 65  |re more accurate|
00005720  20 61 74 0a 64 6f 69 6e  67 20 74 68 69 73 2e 0a  | at.doing this..|
00005730  0a 54 68 65 20 76 61 72  69 6f 75 73 20 70 72 6f  |.The various pro|
00005740  63 65 73 73 65 73 20 64  65 73 63 72 69 62 65 64  |cesses described|
00005750  20 61 62 6f 76 65 20 61  72 65 20 61 70 70 6c 69  | above are appli|
00005760  65 64 20 69 6e 20 74 68  65 20 66 6f 6c 6c 6f 77  |ed in the follow|
00005770  69 6e 67 20 6f 72 64 65  72 20 66 6f 72 0a 70 69  |ing order for.pi|
00005780  63 74 75 72 65 73 20 77  69 74 68 20 6d 6f 72 65  |ctures with more|
00005790  20 6f 75 74 70 75 74 20  70 69 78 65 6c 73 20 74  | output pixels t|
000057a0  68 61 6e 20 69 6e 70 75  74 3a 0a 20 20 20 28 61  |han input:.   (a|
000057b0  29 20 72 61 6e 67 65 20  6f 72 20 68 69 73 74 6f  |) range or histo|
000057c0  67 72 61 6d 20 65 71 75  61 6c 69 73 61 74 69 6f  |gram equalisatio|
000057d0  6e 2c 0a 20 20 20 28 62  29 20 73 68 61 72 70 65  |n,.   (b) sharpe|
000057e0  6e 2c 0a 20 20 20 28 63  29 20 73 63 61 6c 65 2c  |n,.   (c) scale,|
000057f0  0a 20 20 20 28 64 29 20  65 72 72 6f 72 20 64 69  |.   (d) error di|
00005800  66 66 75 73 69 6f 6e 2e  0a 54 68 69 73 20 6f 72  |ffusion..This or|
00005810  64 65 72 20 69 73 20 63  68 6f 73 65 6e 20 73 6f  |der is chosen so|
00005820  20 74 68 61 74 3a 0a 20  20 20 28 31 29 20 73 69  | that:.   (1) si|
00005830  6e 63 65 20 74 68 65 20  69 6e 70 75 74 20 70 69  |nce the input pi|
00005840  78 65 6c 73 20 28 72 61  74 68 65 72 20 74 68 61  |xels (rather tha|
00005850  6e 20 74 68 65 20 6f 75  74 70 75 74 20 70 69 78  |n the output pix|
00005860  65 6c 73 29 20 61 72 65  20 73 68 61 72 70 65 6e  |els) are sharpen|
00005870  65 64 2c 0a 20 20 20 20  20 20 20 74 68 65 72 65  |ed,.       there|
00005880  20 69 73 20 6e 6f 20 66  61 6c 73 65 20 65 64 67  | is no false edg|
00005890  65 20 69 6e 74 72 6f 64  75 63 65 64 20 77 68 65  |e introduced whe|
000058a0  6e 20 70 69 78 65 6c 73  20 61 72 65 20 72 65 70  |n pixels are rep|
000058b0  6c 69 63 61 74 65 64 2e  0a 0a 54 68 65 20 76 61  |licated...The va|
000058c0  72 69 6f 75 73 20 70 72  6f 63 65 73 73 65 73 20  |rious processes |
000058d0  64 65 73 63 72 69 62 65  64 20 61 62 6f 76 65 20  |described above |
000058e0  61 72 65 20 61 70 70 6c  69 65 64 20 69 6e 20 74  |are applied in t|
000058f0  68 65 20 66 6f 6c 6c 6f  77 69 6e 67 20 6f 72 64  |he following ord|
00005900  65 72 20 66 6f 72 0a 70  69 63 74 75 72 65 73 20  |er for.pictures |
00005910  77 69 74 68 20 66 65 77  65 72 20 6f 75 74 70 75  |with fewer outpu|
00005920  74 20 70 69 78 65 6c 73  20 74 68 61 6e 20 69 6e  |t pixels than in|
00005930  70 75 74 3a 0a 20 20 20  28 61 29 20 73 63 61 6c  |put:.   (a) scal|
00005940  65 2c 0a 20 20 20 28 62  29 20 72 61 6e 67 65 20  |e,.   (b) range |
00005950  6f 72 20 68 69 73 74 6f  67 72 61 6d 20 65 71 75  |or histogram equ|
00005960  61 6c 69 73 61 74 69 6f  6e 2c 0a 20 20 20 28 63  |alisation,.   (c|
00005970  29 20 73 68 61 72 70 65  6e 2c 0a 20 20 20 28 64  |) sharpen,.   (d|
00005980  29 20 65 72 72 6f 72 20  64 69 66 66 75 73 69 6f  |) error diffusio|
00005990  6e 2e 0a 54 68 69 73 20  6f 72 64 65 72 20 69 73  |n..This order is|
000059a0  20 63 68 6f 73 65 6e 20  73 6f 20 74 68 61 74 3a  | chosen so that:|
000059b0  0a 20 20 20 28 31 29 20  72 61 6e 67 69 6e 67 20  |.   (1) ranging |
000059c0  63 61 6e 20 65 6e 68 61  6e 63 65 20 64 6f 77 6e  |can enhance down|
000059d0  2d 73 69 7a 65 64 20 69  6d 61 67 65 73 2e 20 53  |-sized images. S|
000059e0  61 79 20 61 20 62 6c 61  63 6b 2f 77 68 69 74 65  |ay a black/white|
000059f0  20 64 69 74 68 65 72 65  64 20 69 6d 61 67 65 0a  | dithered image.|
00005a00  20 20 20 20 20 20 20 69  73 20 72 65 64 75 63 65  |       is reduce|
00005a10  64 20 69 6e 20 73 69 7a  65 2c 20 73 6f 20 74 68  |d in size, so th|
00005a20  61 74 20 74 68 65 20 6f  75 74 70 75 74 20 66 72  |at the output fr|
00005a30  6f 6d 20 74 68 65 20 73  63 61 6c 69 6e 67 20 70  |om the scaling p|
00005a40  72 6f 63 65 73 73 20 69  73 20 28 73 6f 6d 65 0a  |rocess is (some.|
00005a50  20 20 20 20 20 20 20 61  70 70 72 6f 78 69 6d 61  |       approxima|
00005a60  74 69 6f 6e 20 74 6f 29  20 74 68 65 20 6f 72 69  |tion to) the ori|
00005a70  67 69 6e 61 6c 20 67 72  65 79 20 6c 65 76 65 6c  |ginal grey level|
00005a80  73 3b 20 74 68 65 6e 20  72 61 6e 67 69 6e 67 20  |s; then ranging |
00005a90  63 61 6e 20 65 78 70 61  6e 64 20 74 68 69 73 0a  |can expand this.|
00005aa0  20 20 20 20 20 20 20 69  66 20 70 6f 73 73 69 62  |       if possib|
00005ab0  6c 65 2e 0a 20 20 20 28  32 29 20 73 68 61 72 70  |le..   (2) sharp|
00005ac0  65 6e 69 6e 67 20 63 61  6e 20 62 65 20 75 73 65  |ening can be use|
00005ad0  64 20 74 6f 20 6f 66 66  73 65 74 20 74 68 65 20  |d to offset the |
00005ae0  62 6c 75 72 72 69 6e 67  20 65 66 66 65 63 74 73  |blurring effects|
00005af0  20 6f 66 20 73 63 61 6c  69 6e 67 2e 0a 20 20 20  | of scaling..   |
00005b00  28 33 29 20 73 69 6e 63  65 20 74 68 65 20 6f 75  |(3) since the ou|
00005b10  74 70 75 74 20 70 69 78  65 6c 73 20 28 72 61 74  |tput pixels (rat|
00005b20  68 65 72 20 74 68 61 6e  20 74 68 65 20 69 6e 70  |her than the inp|
00005b30  75 74 20 70 69 78 65 6c  73 29 20 61 72 65 20 73  |ut pixels) are s|
00005b40  68 61 72 70 65 6e 65 64  2c 0a 20 20 20 20 20 20  |harpened,.      |
00005b50  20 74 68 65 20 65 66 66  65 63 74 20 6f 66 20 2d  | the effect of -|
00005b60  73 68 61 72 70 65 6e 4e  20 69 73 20 63 6f 6e 73  |sharpenN is cons|
00005b70  69 73 74 65 6e 74 20 6f  76 65 72 20 64 69 66 66  |istent over diff|
00005b80  65 72 65 6e 74 6c 79 20  73 63 61 6c 65 64 20 69  |erently scaled i|
00005b90  6d 61 67 65 73 2e 0a 0a  54 68 65 72 65 20 6d 61  |mages...There ma|
00005ba0  79 20 62 65 20 74 69 6d  65 73 20 77 68 65 6e 20  |y be times when |
00005bb0  74 68 69 73 20 61 75 74  6f 6d 61 74 69 63 20 73  |this automatic s|
00005bc0  65 6c 65 63 74 69 6f 6e  20 6f 66 20 6f 72 64 65  |election of orde|
00005bd0  72 20 67 65 74 73 20 69  74 20 77 72 6f 6e 67 2c  |r gets it wrong,|
00005be0  0a 70 61 72 74 69 63 75  6c 61 72 6c 79 20 77 68  |.particularly wh|
00005bf0  65 6e 20 63 68 61 6e 67  69 6e 67 20 74 68 65 20  |en changing the |
00005c00  61 73 70 65 63 74 20 72  61 74 69 6f 2c 20 69 74  |aspect ratio, it|
00005c10  20 69 73 20 70 6f 73 73  69 62 6c 65 20 74 6f 20  | is possible to |
00005c20  74 72 69 67 67 65 72 20  73 6f 6d 65 0a 75 6e 64  |trigger some.und|
00005c30  65 73 69 72 61 62 6c 65  20 73 68 61 72 70 65 6e  |esirable sharpen|
00005c40  69 6e 67 20 61 72 74 69  66 61 63 74 73 2e 20 55  |ing artifacts. U|
00005c50  73 65 20 74 68 65 20 70  72 6f 67 72 61 6d 20 74  |se the program t|
00005c60  77 69 63 65 20 77 69 74  68 20 73 68 61 72 70 65  |wice with sharpe|
00005c70  6e 69 6e 67 20 28 73 61  79 29 0a 64 69 73 61 62  |ning (say).disab|
00005c80  6c 65 64 20 61 6e 64 20  65 6e 61 62 6c 65 64 20  |led and enabled |
00005c90  69 6e 20 74 68 65 20 6f  72 64 65 72 20 72 65 71  |in the order req|
00005ca0  75 69 72 65 64 2e 0a 0a  45 78 61 6d 70 6c 65 73  |uired...Examples|
00005cb0  20 6f 66 20 75 73 65 3a  0a 0a 4d 61 6b 65 20 22  | of use:..Make "|
00005cc0  73 74 61 6e 64 61 72 64  20 70 61 6c 65 74 74 65  |standard palette|
00005cd0  22 20 76 65 72 73 69 6f  6e 73 20 6f 66 20 65 78  |" versions of ex|
00005ce0  69 73 74 69 6e 67 20 32  35 36 20 63 6f 6c 6f 75  |isting 256 colou|
00005cf0  72 20 69 6d 61 67 65 73  20 28 66 6f 72 20 65 78  |r images (for ex|
00005d00  61 6d 70 6c 65 0a 74 68  65 20 57 61 74 66 6f 72  |ample.the Watfor|
00005d10  64 20 64 69 67 69 74 69  73 65 72 20 70 6c 75 73  |d digitiser plus|
00005d20  20 63 6f 6c 6f 75 72 20  62 6f 61 72 64 20 64 6f  | colour board do|
00005d30  65 73 6e 27 74 20 75 73  65 20 74 68 65 20 73 74  |esn't use the st|
00005d40  61 6e 64 61 72 64 20 70  61 6c 65 74 74 65 29 2e  |andard palette).|
00005d50  0a 20 20 28 65 2e 67 2e  20 22 63 68 61 6e 67 65  |.  (e.g. "change|
00005d60  66 73 69 20 69 6e 20 6f  75 74 20 31 33 70 22 20  |fsi in out 13p" |
00005d70  66 6f 72 20 61 20 63 6f  6c 6f 75 72 65 64 20 57  |for a coloured W|
00005d80  61 74 66 6f 72 64 20 70  69 63 74 75 72 65 29 0a  |atford picture).|
00005d90  0a 4f 72 20 63 6f 6e 76  65 72 74 20 61 20 63 6f  |.Or convert a co|
00005da0  6c 6f 75 72 20 70 69 63  74 75 72 65 20 74 6f 20  |lour picture to |
00005db0  73 6f 6d 65 74 68 69 6e  67 20 79 6f 75 20 63 61  |something you ca|
00005dc0  6e 20 73 65 65 20 6f 6e  20 79 6f 75 72 20 68 69  |n see on your hi|
00005dd0  67 68 20 72 65 73 20 6d  6f 6e 6f 0a 6d 6f 6e 69  |gh res mono.moni|
00005de0  74 6f 72 2e 0a 20 20 28  65 2e 67 2e 20 22 63 68  |tor..  (e.g. "ch|
00005df0  61 6e 67 65 66 73 69 20  69 6e 20 6f 75 74 20 31  |angefsi in out 1|
00005e00  38 20 2d 73 68 61 72 70  65 6e 20 2d 69 6e 66 6f  |8 -sharpen -info|
00005e10  22 29 0a 0a 4f 72 20 63  6f 6e 76 65 72 74 20 61  |")..Or convert a|
00005e20  20 6c 61 72 67 65 20 6d  6f 6e 6f 63 68 72 6f 6d  | large monochrom|
00005e30  65 20 70 69 63 74 75 72  65 20 28 66 72 6f 6d 20  |e picture (from |
00005e40  61 20 73 63 61 6e 6e 65  72 2c 20 73 61 79 29 20  |a scanner, say) |
00005e50  74 6f 20 73 6f 6d 65 74  68 69 6e 67 0a 77 68 69  |to something.whi|
00005e60  63 68 20 63 61 6e 20 62  65 20 73 65 65 6e 2e 0a  |ch can be seen..|
00005e70  20 20 28 65 2e 67 2e 20  22 63 68 61 6e 67 65 66  |  (e.g. "changef|
00005e80  73 69 20 69 6e 20 6f 75  74 20 32 30 74 20 31 3a  |si in out 20t 1:|
00005e90  34 20 2d 67 61 6d 6d 61  22 29 0a 0a 4f 72 20 63  |4 -gamma")..Or c|
00005ea0  6f 6e 76 65 72 74 20 61  20 63 6f 6c 6f 75 72 20  |onvert a colour |
00005eb0  70 69 63 74 75 72 65 20  74 6f 20 67 72 65 79 20  |picture to grey |
00005ec0  73 63 61 6c 65 20 66 6f  72 20 74 68 65 20 64 65  |scale for the de|
00005ed0  73 6b 74 6f 70 2e 0a 20  20 28 65 2e 67 2e 20 22  |sktop..  (e.g. "|
00005ee0  63 68 61 6e 67 65 66 73  69 20 69 6e 20 6f 75 74  |changefsi in out|
00005ef0  20 32 30 22 29 0a 0a 4f  72 20 63 68 61 6e 67 65  | 20")..Or change|
00005f00  20 61 20 35 31 32 20 62  79 20 34 38 30 20 69 6d  | a 512 by 480 im|
00005f10  61 67 65 20 74 6f 20 73  74 61 6e 64 61 72 64 20  |age to standard |
00005f20  66 6f 72 6d 61 74 20 61  6e 64 20 61 73 70 65 63  |format and aspec|
00005f30  74 20 72 61 74 69 6f 0a  20 20 28 65 2e 67 2e 20  |t ratio.  (e.g. |
00005f40  22 63 68 61 6e 67 65 66  73 69 20 69 6e 20 6f 75  |"changefsi in ou|
00005f50  74 20 31 35 20 36 34 30  3a 35 31 32 20 35 31 32  |t 15 640:512 512|
00005f60  3a 34 38 30 22 29 0a 20  20 28 6f 72 20 22 63 68  |:480").  (or "ch|
00005f70  61 6e 67 65 66 73 69 20  69 6e 20 6f 75 74 20 3d  |angefsi in out =|
00005f80  20 2d 72 61 6e 67 65 22  29 0a 0a 4f 72 20 63 68  | -range")..Or ch|
00005f90  61 6e 67 65 20 74 6f 20  64 69 67 69 74 61 6c 20  |ange to digital |
00005fa0  72 2c 20 67 2c 20 62 0a  20 20 28 65 2e 67 2e 20  |r, g, b.  (e.g. |
00005fb0  22 63 68 61 6e 67 65 66  73 69 20 69 6e 20 6f 75  |"changefsi in ou|
00005fc0  74 20 32 30 64 20 2d 73  68 61 72 70 65 6e 31 36  |t 20d -sharpen16|
00005fd0  22 29 0a 0a 4f 72 20 63  6f 6e 76 65 72 74 20 61  |")..Or convert a|
00005fe0  20 70 69 63 74 75 72 65  20 66 6f 72 20 70 72 69  | picture for pri|
00005ff0  6e 74 69 6e 67 20 6f 6e  20 61 20 33 30 30 64 70  |nting on a 300dp|
00006000  69 20 6c 61 73 65 72 2e  0a 20 20 28 65 2e 67 2e  |i laser..  (e.g.|
00006010  20 22 63 68 61 6e 67 65  66 73 69 20 69 6e 20 6f  | "changefsi in o|
00006020  75 74 20 31 38 63 20 33  30 30 3a 39 30 20 2d 73  |ut 18c 300:90 -s|
00006030  68 61 72 70 65 6e 22 29  0a 0a 41 6e 64 20 6d 61  |harpen")..And ma|
00006040  6e 79 20 6d 6f 72 65 20  75 73 65 73 20 73 75 63  |ny more uses suc|
00006050  68 20 61 73 20 6d 61 6b  69 6e 67 20 6d 69 6e 69  |h as making mini|
00006060  61 74 75 72 65 73 20 6f  66 20 70 69 63 74 75 72  |atures of pictur|
00006070  65 73 2c 20 61 6e 69 6d  61 74 65 64 20 73 65 71  |es, animated seq|
00006080  75 65 6e 63 65 73 20 6f  66 0a 70 69 63 74 75 72  |uences of.pictur|
00006090  65 73 20 63 68 61 6e 67  69 6e 67 20 73 69 7a 65  |es changing size|
000060a0  20 28 6f 72 20 73 68 61  72 70 6e 65 73 73 21 29  | (or sharpness!)|
000060b0  2c 20 63 6f 6e 76 65 72  74 69 6e 67 20 41 72 74  |, converting Art|
000060c0  69 73 61 6e 20 70 69 63  74 75 72 65 73 20 74 6f  |isan pictures to|
000060d0  20 74 68 65 0a 64 65 73  6b 74 6f 70 20 28 74 72  | the.desktop (tr|
000060e0  79 20 6c 6f 6f 6b 69 6e  67 20 61 74 20 74 68 65  |y looking at the|
000060f0  20 41 72 74 69 73 61 6e  20 47 61 72 64 65 6e 20  | Artisan Garden |
00006100  77 69 74 68 20 74 68 65  20 64 65 73 6b 74 6f 70  |with the desktop|
00006110  20 69 6e 20 32 35 36 20  63 6f 6c 6f 75 72 73 20  | in 256 colours |
00006120  61 6e 64 0a 43 68 61 6e  67 65 46 53 49 27 73 20  |and.ChangeFSI's |
00006130  76 65 72 73 69 6f 6e 20  2d 20 74 68 65 20 73 74  |version - the st|
00006140  72 69 70 65 73 20 6f 6e  20 74 68 65 20 6c 61 77  |ripes on the law|
00006150  6e 20 76 61 6e 69 73 68  20 77 69 74 68 20 74 68  |n vanish with th|
00006160  65 20 73 74 61 6e 64 61  72 64 0a 76 65 72 73 69  |e standard.versi|
00006170  6f 6e 29 2e 20 4f 62 76  69 6f 75 73 6c 79 20 79  |on). Obviously y|
00006180  6f 75 20 77 69 6c 6c 20  6e 65 65 64 20 74 6f 20  |ou will need to |
00006190  68 61 76 65 20 63 61 70  74 75 72 65 64 20 69 6e  |have captured in|
000061a0  70 75 74 20 61 73 20 61  20 73 70 72 69 74 65 20  |put as a sprite |
000061b0  66 69 72 73 74 21 0a 55  73 69 6e 67 20 6d 6f 72  |first!.Using mor|
000061c0  65 20 70 69 78 65 6c 73  20 70 65 72 20 69 6e 63  |e pixels per inc|
000061d0  68 20 63 61 6e 20 69 6d  70 72 6f 76 65 20 74 68  |h can improve th|
000061e0  65 20 71 75 61 6c 69 74  79 20 6f 66 20 74 68 65  |e quality of the|
000061f0  20 72 65 73 75 6c 74 2c  20 70 61 72 74 69 63 75  | result, particu|
00006200  6c 61 72 6c 79 0a 63 6f  6e 76 65 72 74 69 6e 67  |larly.converting|
00006210  20 74 6f 20 6d 75 6c 74  69 73 79 6e 63 20 6d 6f  | to multisync mo|
00006220  64 65 73 2e 0a 0a 4e 6f  74 65 20 74 68 61 74 2c  |des...Note that,|
00006230  20 66 6f 72 20 61 6c 6c  20 77 6f 72 6b 20 77 69  | for all work wi|
00006240  74 68 20 43 68 61 6e 67  65 46 53 49 2c 20 69 74  |th ChangeFSI, it|
00006250  20 69 73 20 61 20 67 6f  6f 64 20 69 64 65 61 20  | is a good idea |
00006260  74 6f 20 73 74 61 72 74  20 66 72 6f 6d 20 74 68  |to start from th|
00006270  65 0a 75 6e 70 72 6f 63  65 73 73 65 64 20 69 6e  |e.unprocessed in|
00006280  70 75 74 20 65 61 63 68  20 74 69 6d 65 20 61 6e  |put each time an|
00006290  64 20 64 6f 20 65 76 65  72 79 74 68 69 6e 67 20  |d do everything |
000062a0  69 6e 20 6f 6e 65 20 70  61 73 73 20 28 72 61 74  |in one pass (rat|
000062b0  68 65 72 20 74 68 61 6e  20 75 73 69 6e 67 0a 74  |her than using.t|
000062c0  68 65 20 70 72 6f 67 72  61 6d 20 73 65 76 65 72  |he program sever|
000062d0  61 6c 20 74 69 6d 65 73  20 77 69 74 68 20 73 69  |al times with si|
000062e0  6d 70 6c 65 20 61 72 67  75 6d 65 6e 74 73 29 2e  |mple arguments).|
000062f0  20 49 74 20 69 73 20 6e  6f 74 20 61 20 67 6f 6f  | It is not a goo|
00006300  64 20 69 64 65 61 20 74  6f 0a 73 68 61 72 70 65  |d idea to.sharpe|
00006310  6e 20 61 20 64 69 74 68  65 72 65 64 20 69 6d 61  |n a dithered ima|
00006320  67 65 20 28 75 6e 6c 65  73 73 20 69 74 20 68 61  |ge (unless it ha|
00006330  73 20 62 65 65 6e 20 73  68 72 75 6e 6b 29 2e 0a  |s been shrunk)..|
00006340  0a 2a 2a 2a 20 49 74 20  69 73 20 61 20 76 65 72  |.*** It is a ver|
00006350  79 20 67 6f 6f 64 20 69  64 65 61 20 74 6f 20 6b  |y good idea to k|
00006360  65 65 70 20 74 68 65 20  68 69 67 68 65 73 74 20  |eep the highest |
00006370  72 65 73 6f 6c 75 74 69  6f 6e 20 6d 61 73 74 65  |resolution maste|
00006380  72 20 74 68 61 74 20 79  6f 75 20 63 61 6e 0a 61  |r that you can.a|
00006390  66 66 6f 72 64 20 74 68  65 20 64 69 73 63 20 73  |fford the disc s|
000063a0  70 61 63 65 20 66 6f 72  2e 2e 2e 2e 0a 0a 54 68  |pace for......Th|
000063b0  65 20 43 68 61 6e 67 65  46 53 49 20 70 72 6f 67  |e ChangeFSI prog|
000063c0  72 61 6d 20 63 61 6e 20  61 6c 73 6f 20 63 6f 6e  |ram can also con|
000063d0  76 65 72 74 20 66 72 6f  6d 20 6e 6f 6e 20 52 49  |vert from non RI|
000063e0  53 43 20 4f 53 20 73 70  72 69 74 65 20 66 6f 72  |SC OS sprite for|
000063f0  6d 61 74 73 20 77 68 69  6c 65 0a 64 6f 69 6e 67  |mats while.doing|
00006400  20 61 6c 6c 20 6f 66 20  74 68 65 20 61 62 6f 76  | all of the abov|
00006410  65 20 70 72 6f 63 65 73  73 69 6e 67 2e 20 43 68  |e processing. Ch|
00006420  61 6e 67 65 46 53 49 20  77 69 6c 6c 20 77 6f 72  |angeFSI will wor|
00006430  6b 20 6f 75 74 20 77 68  61 74 20 74 68 65 20 66  |k out what the f|
00006440  6f 72 6d 61 74 20 69 73  0a 61 75 74 6f 6d 61 74  |ormat is.automat|
00006450  69 63 61 6c 6c 79 2e 20  46 6f 72 20 6e 61 74 69  |ically. For nati|
00006460  76 65 20 52 49 53 43 20  4f 53 20 66 6f 72 6d 61  |ve RISC OS forma|
00006470  74 73 2c 20 69 74 20 75  73 65 73 20 74 68 65 20  |ts, it uses the |
00006480  66 69 6c 65 74 79 70 65  20 61 6e 64 20 74 68 65  |filetype and the|
00006490  72 65 20 63 61 6e 0a 62  65 20 6e 6f 20 63 6f 6e  |re can.be no con|
000064a0  66 75 73 69 6f 6e 2e 20  46 6f 72 20 61 6c 69 65  |fusion. For alie|
000064b0  6e 20 66 6f 72 6d 61 74  73 2c 20 69 74 20 66 69  |n formats, it fi|
000064c0  72 73 74 20 74 72 69 65  73 20 6c 6f 6f 6b 69 6e  |rst tries lookin|
000064d0  67 20 66 6f 72 20 70 61  72 74 69 63 75 6c 61 72  |g for particular|
000064e0  0a 69 64 65 6e 74 69 66  79 69 6e 67 20 69 6e 66  |.identifying inf|
000064f0  6f 72 6d 61 74 69 6f 6e  20 69 6e 73 69 64 65 20  |ormation inside |
00006500  74 68 65 20 66 69 6c 65  20 61 6e 64 20 74 68 65  |the file and the|
00006510  6e 20 28 69 66 20 74 68  69 73 20 66 61 69 6c 73  |n (if this fails|
00006520  20 74 6f 20 68 61 76 65  0a 69 64 65 6e 74 69 66  | to have.identif|
00006530  69 65 64 20 61 20 66 6f  72 6d 61 74 29 20 74 72  |ied a format) tr|
00006540  69 65 73 20 75 73 69 6e  67 20 74 68 65 20 66 69  |ies using the fi|
00006550  6c 65 20 6e 61 6d 65 20  69 74 73 65 6c 66 2e 20  |le name itself. |
00006560  53 65 65 20 74 68 65 20  64 65 74 61 69 6c 73 20  |See the details |
00006570  62 65 6c 6f 77 3a 0a 0a  54 68 65 20 52 49 53 43  |below:..The RISC|
00006580  20 4f 53 20 73 70 72 69  74 65 20 66 6f 72 6d 61  | OS sprite forma|
00006590  74 0a 20 43 6f 6e 74 61  69 6e 73 20 31 2c 20 32  |t. Contains 1, 2|
000065a0  2c 20 34 20 6f 72 20 38  20 62 69 74 73 20 70 65  |, 4 or 8 bits pe|
000065b0  72 20 70 69 78 65 6c 20  77 69 74 68 20 61 20 6d  |r pixel with a m|
000065c0  6f 64 69 66 69 63 61 74  69 6f 6e 20 70 61 6c 65  |odification pale|
000065d0  74 74 65 20 6f 66 20 75  70 20 74 6f 0a 20 31 36  |tte of up to. 16|
000065e0  20 65 6e 74 72 69 65 73  3b 20 61 6e 79 20 6e 75  | entries; any nu|
000065f0  6d 62 65 72 20 6f 66 20  70 69 78 65 6c 73 20 77  |mber of pixels w|
00006600  69 64 65 20 61 6e 64 20  68 69 67 68 20 75 6e 63  |ide and high unc|
00006610  6f 6d 70 72 65 73 73 65  64 2e 20 44 65 74 61 69  |ompressed. Detai|
00006620  6c 73 20 61 72 65 20 69  6e 0a 20 41 63 6f 72 6e  |ls are in. Acorn|
00006630  27 73 20 50 72 6f 67 72  61 6d 6d 65 72 27 73 20  |'s Programmer's |
00006640  52 65 66 65 72 65 6e 63  65 20 4d 61 6e 75 61 6c  |Reference Manual|
00006650  2e 0a 20 2b 20 52 65 63  6f 67 6e 69 73 65 64 20  |.. + Recognised |
00006660  62 79 20 66 69 6c 65 20  74 79 70 65 20 46 46 39  |by file type FF9|
00006670  20 28 61 20 70 61 69 6e  74 20 62 72 75 73 68 20  | (a paint brush |
00006680  61 6e 64 20 68 6f 75 73  65 20 69 63 6f 6e 29 0a  |and house icon).|
00006690  20 2d 20 44 65 74 61 69  6c 73 20 6f 66 20 68 6f  | - Details of ho|
000066a0  77 20 6d 61 6e 79 20 62  69 74 73 20 70 65 72 20  |w many bits per |
000066b0  70 69 78 65 6c 20 61 6e  64 20 74 68 65 20 70 69  |pixel and the pi|
000066c0  78 65 6c 20 73 69 7a 65  20 61 72 65 20 6f 62 74  |xel size are obt|
000066d0  61 69 6e 65 64 20 66 72  6f 6d 0a 20 20 20 74 68  |ained from.   th|
000066e0  65 20 6f 70 65 72 61 74  69 6e 67 20 73 79 73 74  |e operating syst|
000066f0  65 6d 20 28 72 61 74 68  65 72 20 74 68 61 6e 20  |em (rather than |
00006700  62 65 69 6e 67 20 69 6e  20 74 68 65 20 66 69 6c  |being in the fil|
00006710  65 29 20 66 72 6f 6d 20  74 68 65 20 22 4d 4f 44  |e) from the "MOD|
00006720  45 22 0a 20 20 20 6e 75  6d 62 65 72 2e 20 4d 6f  |E".   number. Mo|
00006730  64 65 20 65 78 74 65 6e  73 69 6f 6e 73 20 63 61  |de extensions ca|
00006740  6e 20 72 65 73 75 6c 74  20 69 6e 20 61 20 73 6f  |n result in a so|
00006750  75 72 63 65 20 69 6d 61  67 65 20 63 6f 6e 74 61  |urce image conta|
00006760  69 6e 69 6e 67 20 61 20  4d 4f 44 45 0a 20 20 20  |ining a MODE.   |
00006770  6e 75 6d 62 65 72 20 77  68 69 63 68 20 79 6f 75  |number which you|
00006780  72 20 63 6f 6d 70 75 74  65 72 20 64 6f 65 73 20  |r computer does |
00006790  6e 6f 74 20 75 6e 64 65  72 73 74 61 6e 64 2e 0a  |not understand..|
000067a0  20 2d 20 4d 61 73 6b 20  69 6e 66 6f 72 6d 61 74  | - Mask informat|
000067b0  69 6f 6e 20 69 67 6e 6f  72 65 64 0a 20 2d 20 4c  |ion ignored. - L|
000067c0  65 66 74 68 61 6e 64 20  77 61 73 74 61 67 65 20  |efthand wastage |
000067d0  69 67 6e 6f 72 65 64 0a  0a 54 68 65 20 6e 65 77  |ignored..The new|
000067e0  20 52 49 53 43 20 4f 53  20 73 70 72 69 74 65 20  | RISC OS sprite |
000067f0  66 6f 72 6d 61 74 0a 20  43 6f 6e 74 61 69 6e 73  |format. Contains|
00006800  20 31 2c 20 32 2c 20 34  2c 20 38 2c 20 31 36 20  | 1, 2, 4, 8, 16 |
00006810  6f 72 20 33 32 20 62 69  74 73 20 70 65 72 20 70  |or 32 bits per p|
00006820  69 78 65 6c 2e 0a 20 2b  20 52 65 63 6f 67 6e 69  |ixel.. + Recogni|
00006830  73 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |sed by file type|
00006840  20 46 46 39 0a 20 2b 20  6e 6f 20 70 72 6f 62 6c  | FF9. + no probl|
00006850  65 6d 20 77 69 74 68 20  6d 6f 64 65 20 65 78 74  |em with mode ext|
00006860  65 6e 73 69 6f 6e 73 3a  20 69 6e 66 6f 72 6d 61  |ensions: informa|
00006870  74 69 6f 6e 20 69 73 20  63 6f 64 65 64 20 69 6e  |tion is coded in|
00006880  74 6f 20 74 68 65 20 66  6f 72 6d 61 74 0a 20 2d  |to the format. -|
00006890  20 4d 61 73 6b 20 69 6e  66 6f 72 6d 61 74 69 6f  | Mask informatio|
000068a0  6e 20 69 67 6e 6f 72 65  64 0a 0a 4b 6f 64 61 6b  |n ignored..Kodak|
000068b0  20 50 68 6f 74 6f 43 44  0a 20 32 34 20 62 69 74  | PhotoCD. 24 bit|
000068c0  20 70 65 72 20 70 69 78  65 6c 20 69 6d 61 67 65  | per pixel image|
000068d0  73 20 61 74 20 76 61 72  69 6f 75 73 20 72 65 73  |s at various res|
000068e0  6f 6c 75 74 69 6f 6e 73  0a 20 2b 20 52 65 63 6f  |olutions. + Reco|
000068f0  67 6e 69 73 65 64 20 62  79 20 66 69 6c 65 20 74  |gnised by file t|
00006900  79 70 65 20 42 45 38 0a  20 2d 20 53 65 74 20 43  |ype BE8. - Set C|
00006910  68 61 6e 67 65 46 53 49  24 50 43 44 49 6e 64 65  |hangeFSI$PCDInde|
00006920  78 20 74 6f 20 72 65 61  64 20 72 65 73 6f 6c 75  |x to read resolu|
00006930  74 69 6f 6e 73 20 6f 74  68 65 72 20 74 68 61 6e  |tions other than|
00006940  20 62 61 73 65 20 28 3d  33 29 0a 0a 54 68 65 20  | base (=3)..The |
00006950  41 72 56 69 73 20 66 6f  72 6d 61 74 20 5b 6f 66  |ArVis format [of|
00006960  20 41 72 56 69 73 20 4d  75 6c 74 69 6d 65 64 69  | ArVis Multimedi|
00006970  61 5d 0a 20 43 6f 6e 74  61 69 6e 73 20 35 20 62  |a]. Contains 5 b|
00006980  69 74 73 20 6f 66 20 72  65 64 2c 20 67 72 65 65  |its of red, gree|
00006990  6e 20 61 6e 64 20 62 6c  75 65 20 69 6e 66 6f 72  |n and blue infor|
000069a0  6d 61 74 69 6f 6e 20 65  6e 63 6f 64 65 64 20 69  |mation encoded i|
000069b0  6e 74 6f 20 74 77 6f 20  52 49 53 43 20 4f 53 0a  |nto two RISC OS.|
000069c0  20 73 70 72 69 74 65 73  20 22 48 49 50 2e 3c 66  | sprites "HIP.<f|
000069d0  69 6c 65 6e 61 6d 65 3e  22 20 61 6e 64 20 22 4c  |ilename>" and "L|
000069e0  4f 50 2e 3c 66 69 6c 65  6e 61 6d 65 3e 22 20 63  |OP.<filename>" c|
000069f0  6f 6d 70 72 69 73 69 6e  67 20 61 20 36 34 30 20  |omprising a 640 |
00006a00  70 69 78 65 6c 20 77 69  64 65 0a 20 61 6e 64 20  |pixel wide. and |
00006a10  32 35 36 20 6c 69 6e 65  20 74 61 6c 6c 20 69 6d  |256 line tall im|
00006a20  61 67 65 20 77 69 74 68  20 70 69 78 65 6c 73 20  |age with pixels |
00006a30  73 69 7a 65 64 20 31 3a  32 2e 20 44 65 74 61 69  |sized 1:2. Detai|
00006a40  6c 73 20 66 72 6f 6d 20  41 72 56 69 73 20 4d 75  |ls from ArVis Mu|
00006a50  6c 74 69 6d 65 64 69 61  0a 20 2d 20 52 65 63 6f  |ltimedia. - Reco|
00006a60  67 6e 69 73 65 64 20 62  79 20 70 72 6f 76 69 64  |gnised by provid|
00006a70  69 6e 67 20 74 68 65 20  48 49 50 2e 3c 66 69 6c  |ing the HIP.<fil|
00006a80  65 6e 61 6d 65 3e 20 28  77 68 69 63 68 20 6d 75  |ename> (which mu|
00006a90  73 74 20 62 65 20 6f 66  20 66 69 6c 65 20 74 79  |st be of file ty|
00006aa0  70 65 20 46 46 39 29 0a  20 2d 20 55 6e 63 6f 6d  |pe FF9). - Uncom|
00006ab0  70 72 65 73 73 65 64 20  28 69 6e 64 65 65 64 20  |pressed (indeed |
00006ac0  72 65 70 72 65 73 65 6e  74 73 20 31 36 20 62 69  |represents 16 bi|
00006ad0  74 73 20 69 6e 73 74 65  61 64 20 6f 66 20 31 35  |ts instead of 15|
00006ae0  29 2e 0a 0a 54 68 65 20  50 69 6e 65 61 70 70 6c  |)...The Pineappl|
00006af0  65 20 63 6f 6c 6f 75 72  20 64 69 67 69 74 69 73  |e colour digitis|
00006b00  65 72 20 66 6f 72 6d 61  74 20 28 6f 66 20 50 69  |er format (of Pi|
00006b10  6e 65 61 70 70 6c 65 20  53 6f 66 74 77 61 72 65  |neapple Software|
00006b20  29 0a 20 43 6f 6e 74 61  69 6e 73 20 36 20 62 69  |). Contains 6 bi|
00006b30  74 73 20 6f 66 20 67 72  65 65 6e 2c 20 35 20 62  |ts of green, 5 b|
00006b40  69 74 73 20 6f 66 20 72  65 64 20 61 6e 64 20 62  |its of red and b|
00006b50  6c 75 65 20 69 6e 66 6f  72 6d 61 74 69 6f 6e 20  |lue information |
00006b60  66 69 6c 65 64 20 61 73  20 61 0a 20 73 69 6e 67  |filed as a. sing|
00006b70  6c 65 20 64 61 74 61 20  66 69 6c 65 20 73 74 61  |le data file sta|
00006b80  72 74 69 6e 67 20 22 46  53 49 66 69 6c 65 22 20  |rting "FSIfile" |
00006b90  63 6f 6d 70 72 69 73 69  6e 67 20 61 20 35 31 32  |comprising a 512|
00006ba0  20 70 69 78 65 6c 20 77  69 64 65 20 61 6e 64 20  | pixel wide and |
00006bb0  32 35 36 0a 20 6c 69 6e  65 20 74 61 6c 6c 20 69  |256. line tall i|
00006bc0  6d 61 67 65 20 77 69 74  68 20 70 69 78 65 6c 73  |mage with pixels|
00006bd0  20 73 69 7a 65 64 20 31  3a 32 2e 0a 20 2d 20 52  | sized 1:2.. - R|
00006be0  65 63 6f 67 6e 69 73 65  64 20 62 79 20 22 46 53  |ecognised by "FS|
00006bf0  49 66 69 6c 65 22 20 69  6e 20 74 68 65 20 66 69  |Ifile" in the fi|
00006c00  6c 65 20 28 77 68 69 63  68 20 63 61 6e 20 62 65  |le (which can be|
00006c10  20 61 6e 79 20 74 79 70  65 29 0a 20 2d 20 55 6e  | any type). - Un|
00006c20  63 6f 6d 70 72 65 73 73  65 64 0a 0a 54 68 65 20  |compressed..The |
00006c30  57 61 74 66 6f 72 64 20  56 69 64 65 6f 20 44 69  |Watford Video Di|
00006c40  67 69 74 69 73 65 72 20  22 70 69 63 74 75 72 65  |gitiser "picture|
00006c50  22 20 66 6f 72 6d 61 74  0a 20 43 6f 6e 74 61 69  |" format. Contai|
00006c60  6e 73 20 61 20 72 75 6e  20 6c 65 6e 67 74 68 20  |ns a run length |
00006c70  65 6e 63 6f 64 65 64 20  36 34 20 67 72 65 79 20  |encoded 64 grey |
00006c80  6c 65 76 65 6c 20 35 31  32 20 70 69 78 65 6c 20  |level 512 pixel |
00006c90  77 69 64 65 2c 20 32 35  36 20 6c 69 6e 65 20 69  |wide, 256 line i|
00006ca0  6d 61 67 65 2c 0a 20 77  69 74 68 20 70 69 78 65  |mage,. with pixe|
00006cb0  6c 73 20 73 69 7a 65 64  20 31 3a 32 2e 20 44 65  |ls sized 1:2. De|
00006cc0  74 61 69 6c 73 20 66 72  6f 6d 20 57 61 74 66 6f  |tails from Watfo|
00006cd0  72 64 20 45 6c 65 63 74  72 6f 6e 69 63 73 20 4c  |rd Electronics L|
00006ce0  74 64 2e 0a 20 2b 20 52  65 63 6f 67 6e 69 73 65  |td.. + Recognise|
00006cf0  64 20 62 79 20 66 69 6c  65 20 74 79 70 65 20 44  |d by file type D|
00006d00  46 41 20 28 61 20 73 6d  61 6c 6c 20 67 72 65 79  |FA (a small grey|
00006d10  20 70 69 63 74 75 72 65  20 6f 66 20 53 74 65 76  | picture of Stev|
00006d20  69 65 20 4e 69 63 6b 73  29 0a 20 2d 20 57 61 72  |ie Nicks). - War|
00006d30  6e 69 6e 67 3a 20 64 6f  6e 27 74 20 66 6f 72 67  |ning: don't forg|
00006d40  65 74 20 74 6f 20 73 61  76 65 20 74 68 65 20 70  |et to save the p|
00006d50  69 63 74 75 72 65 73 20  69 6e 20 2a 75 6e 2d 64  |ictures in *un-d|
00006d60  69 74 68 65 72 65 64 2a  20 73 74 61 74 65 21 0a  |ithered* state!.|
00006d70  20 57 68 65 6e 20 75 73  65 64 20 77 69 74 68 20  | When used with |
00006d80  61 20 63 6f 6c 6f 75 72  20 63 6f 6e 76 65 72 74  |a colour convert|
00006d90  65 72 2c 20 43 68 61 6e  67 65 46 53 49 20 63 61  |er, ChangeFSI ca|
00006da0  6e 20 72 65 61 64 20 74  68 72 65 65 20 63 6f 6c  |n read three col|
00006db0  6f 75 72 0a 20 73 65 70  61 72 61 74 69 6f 6e 73  |our. separations|
00006dc0  20 73 74 6f 72 65 64 20  69 6e 20 61 20 64 69 72  | stored in a dir|
00006dd0  65 63 74 6f 72 79 20 6f  66 20 73 65 70 61 72 61  |ectory of separa|
00006de0  74 65 20 22 72 65 64 22  2c 20 22 67 72 65 65 6e  |te "red", "green|
00006df0  22 20 61 6e 64 20 22 62  6c 75 65 22 0a 20 66 69  |" and "blue". fi|
00006e00  6c 65 73 2e 20 42 65 77  61 72 65 20 6f 66 20 61  |les. Beware of a|
00006e10  75 74 6f 2d 67 61 69 6e  2f 63 6f 6e 74 72 61 73  |uto-gain/contras|
00006e20  74 20 77 68 65 6e 20 75  73 69 6e 67 20 73 75 63  |t when using suc|
00006e30  68 20 69 6e 66 6f 72 6d  61 74 69 6f 6e 21 0a 0a  |h information!..|
00006e40  54 68 65 20 50 72 6f 41  72 74 69 73 61 6e 20 63  |The ProArtisan c|
00006e50  6f 6d 70 72 65 73 73 65  64 20 70 69 63 74 75 72  |ompressed pictur|
00006e60  65 20 66 69 6c 65 20 66  6f 72 6d 61 74 0a 20 43  |e file format. C|
00006e70  6f 6e 74 61 69 6e 73 20  61 20 28 6d 69 6c 64 6c  |ontains a (mildl|
00006e80  79 29 20 63 6f 6d 70 72  65 73 73 65 64 20 4d 4f  |y) compressed MO|
00006e90  44 45 20 31 35 20 28 36  34 30 20 62 79 20 32 35  |DE 15 (640 by 25|
00006ea0  36 20 62 79 20 32 35 36  20 63 6f 6c 6f 75 72 73  |6 by 256 colours|
00006eb0  29 20 70 69 63 74 75 72  65 2e 0a 20 44 65 74 61  |) picture.. Deta|
00006ec0  69 6c 73 20 66 72 6f 6d  20 43 6c 61 72 65 73 2e  |ils from Clares.|
00006ed0  0a 20 2b 20 52 65 63 6f  67 6e 69 73 65 64 20 62  |. + Recognised b|
00006ee0  79 20 66 69 6c 65 20 74  79 70 65 20 44 45 32 20  |y file type DE2 |
00006ef0  28 61 20 62 65 69 67 65  20 6d 6f 6e 69 74 6f 72  |(a beige monitor|
00006f00  20 69 6e 20 61 20 67 72  65 79 20 73 75 72 72 6f  | in a grey surro|
00006f10  75 6e 64 29 0a 0a 54 68  65 20 54 69 6d 65 53 74  |und)..The TimeSt|
00006f20  65 70 20 73 61 74 65 6c  6c 69 74 65 20 69 6d 61  |ep satellite ima|
00006f30  67 65 20 66 6f 72 6d 61  74 0a 20 54 68 69 73 20  |ge format. This |
00006f40  67 69 76 65 73 20 61 6e  20 75 6e 63 6f 6d 70 72  |gives an uncompr|
00006f50  65 73 73 65 64 20 38 30  30 20 62 79 20 38 30 30  |essed 800 by 800|
00006f60  20 77 69 74 68 20 32 35  36 20 67 72 65 79 20 6c  | with 256 grey l|
00006f70  65 76 65 6c 73 2e 0a 20  2b 20 52 65 63 6f 67 6e  |evels.. + Recogn|
00006f80  69 73 65 64 20 62 79 20  66 69 6c 65 20 74 79 70  |ised by file typ|
00006f90  65 20 37 41 30 20 28 69  63 6f 6e 20 6e 65 76 65  |e 7A0 (icon neve|
00006fa0  72 20 73 65 65 6e 29 0a  20 2d 20 4e 6f 20 72 65  |r seen). - No re|
00006fb0  73 6f 6c 75 74 69 6f 6e  20 73 70 65 63 69 66 69  |solution specifi|
00006fc0  65 64 2c 20 65 71 75 61  6c 20 74 6f 20 6d 6f 64  |ed, equal to mod|
00006fd0  65 20 32 37 20 61 73 73  75 6d 65 64 0a 20 2d 20  |e 27 assumed. - |
00006fe0  44 6f 63 75 6d 65 6e 74  61 74 69 6f 6e 20 6e 65  |Documentation ne|
00006ff0  76 65 72 20 73 65 65 6e  2e 20 41 6e 20 65 78 74  |ver seen. An ext|
00007000  72 61 20 68 65 61 64 65  72 20 66 69 6c 65 20 3c  |ra header file <|
00007010  6e 61 6d 65 3e 21 20 69  73 20 6e 6f 74 20 75 6e  |name>! is not un|
00007020  64 65 72 73 74 6f 6f 64  0a 20 20 20 61 74 20 61  |derstood.   at a|
00007030  6c 6c 2e 2e 2e 2e 2e 0a  0a 43 43 49 52 36 30 31  |ll.......CCIR601|
00007040  20 34 3a 32 3a 32 20 69  6d 61 67 65 73 0a 20 43  | 4:2:2 images. C|
00007050  6f 6e 74 61 69 6e 20 37  32 30 20 70 69 78 65 6c  |ontain 720 pixel|
00007060  73 20 62 79 20 32 38 38  20 72 6f 77 73 20 28 50  |s by 288 rows (P|
00007070  41 4c 29 20 5b 32 34 33  20 72 6f 77 73 20 4e 54  |AL) [243 rows NT|
00007080  53 43 5d 20 59 55 56 20  63 6f 64 65 64 20 77 69  |SC] YUV coded wi|
00007090  74 68 0a 20 70 69 78 65  6c 73 20 73 69 7a 65 64  |th. pixels sized|
000070a0  20 31 3a 32 2e 0a 20 2b  20 52 65 63 6f 67 6e 69  | 1:2.. + Recogni|
000070b0  73 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |sed by file type|
000070c0  20 36 30 31 0a 20 2d 20  6f 6e 65 20 66 69 65 6c  | 601. - one fiel|
000070d0  64 20 6f 6e 6c 79 0a 0a  41 6e 6f 74 68 65 72 20  |d only..Another |
000070e0  54 69 6d 65 53 74 65 70  20 73 61 74 65 6c 6c 69  |TimeStep satelli|
000070f0  74 65 20 69 6d 61 67 65  20 66 6f 72 6d 61 74 0a  |te image format.|
00007100  20 47 69 76 69 6e 67 20  61 6e 20 75 6e 63 6f 6d  | Giving an uncom|
00007110  70 72 65 73 73 65 64 20  31 32 38 20 70 69 78 65  |pressed 128 pixe|
00007120  6c 73 20 77 69 64 65 20  62 79 20 32 35 36 20 6c  |ls wide by 256 l|
00007130  69 6e 65 73 20 77 69 74  68 20 32 35 36 20 67 72  |ines with 256 gr|
00007140  65 79 20 6c 65 76 65 6c  73 2c 0a 20 70 69 78 65  |ey levels,. pixe|
00007150  6c 73 20 73 69 7a 65 64  20 32 3a 31 2e 20 55 73  |ls sized 2:1. Us|
00007160  65 64 20 62 79 20 54 69  6d 65 53 74 65 70 27 73  |ed by TimeStep's|
00007170  20 21 49 6d 50 72 6f 63  65 73 73 20 61 70 70 6c  | !ImProcess appl|
00007180  69 63 61 74 69 6f 6e 2e  0a 20 2b 20 52 65 63 6f  |ication.. + Reco|
00007190  67 6e 69 73 65 64 20 62  79 20 66 69 6c 65 20 74  |gnised by file t|
000071a0  79 70 65 20 33 30 30 20  28 22 69 22 20 69 6e 20  |ype 300 ("i" in |
000071b0  61 20 64 6f 63 75 6d 65  6e 74 20 66 72 61 6d 65  |a document frame|
000071c0  29 0a 20 2d 20 44 6f 63  75 6d 65 6e 74 61 74 69  |). - Documentati|
000071d0  6f 6e 20 6e 65 76 65 72  20 73 65 65 6e 2e 0a 20  |on never seen.. |
000071e0  2d 20 41 20 62 69 74 20  63 6f 61 72 73 65 0a 20  |- A bit coarse. |
000071f0  54 68 65 20 67 72 65 79  20 6c 65 76 65 6c 73 20  |The grey levels |
00007200  72 65 70 72 65 73 65 6e  74 20 69 6e 74 65 6e 73  |represent intens|
00007210  69 74 79 20 69 6e 20 76  61 72 69 6f 75 73 20 64  |ity in various d|
00007220  69 66 66 65 72 65 6e 74  20 77 61 76 65 20 62 61  |ifferent wave ba|
00007230  6e 64 73 2e 20 42 79 0a  20 6e 61 6d 69 6e 67 20  |nds. By. naming |
00007240  66 69 6c 65 73 20 22 72  65 64 22 2c 20 22 67 72  |files "red", "gr|
00007250  65 65 6e 22 20 61 6e 64  20 22 62 6c 75 65 22 20  |een" and "blue" |
00007260  61 6e 64 20 68 61 6e 64  69 6e 67 20 43 68 61 6e  |and handing Chan|
00007270  67 65 46 53 49 20 74 68  65 20 64 69 72 65 63 74  |geFSI the direct|
00007280  6f 72 79 2c 0a 20 79 6f  75 20 63 61 6e 20 70 72  |ory,. you can pr|
00007290  6f 64 75 63 65 20 61 20  66 61 6c 73 65 20 63 6f  |oduce a false co|
000072a0  6c 6f 75 72 20 69 6d 61  67 65 2e 20 48 6f 75 72  |lour image. Hour|
000072b0  73 20 6f 66 20 65 78 70  65 72 69 6d 65 6e 74 61  |s of experimenta|
000072c0  74 69 6f 6e 20 63 61 6e  20 70 72 6f 64 75 63 65  |tion can produce|
000072d0  0a 20 61 6e 20 61 6c 6d  6f 73 74 20 72 65 61 73  |. an almost reas|
000072e0  6f 6e 61 62 6c 65 20 70  69 63 74 75 72 65 2e 2e  |onable picture..|
000072f0  2e 0a 0a 54 68 65 20 41  49 4d 20 61 6e 64 20 57  |...The AIM and W|
00007300  69 6c 64 20 56 69 73 69  6f 6e 20 56 31 30 20 66  |ild Vision V10 f|
00007310  6f 72 6d 61 74 0a 20 54  68 69 73 20 70 72 6f 76  |ormat. This prov|
00007320  69 64 65 73 20 61 6e 20  75 6e 63 6f 6d 70 72 65  |ides an uncompre|
00007330  73 73 65 64 20 32 35 36  20 62 79 20 32 35 36 20  |ssed 256 by 256 |
00007340  69 6d 61 67 65 20 77 69  74 68 20 32 35 36 20 67  |image with 256 g|
00007350  72 65 79 20 6c 65 76 65  6c 73 2e 20 44 65 74 61  |rey levels. Deta|
00007360  69 6c 73 0a 20 66 72 6f  6d 20 44 65 6c 66 74 20  |ils. from Delft |
00007370  55 6e 69 76 65 72 73 69  74 79 20 6f 66 20 54 65  |University of Te|
00007380  63 68 6e 6f 6c 6f 67 79  20 61 6e 64 20 45 43 44  |chnology and ECD|
00007390  20 43 6f 6d 70 75 74 65  72 73 20 44 65 6c 66 74  | Computers Delft|
000073a0  20 42 2e 56 2e 0a 20 2b  20 52 65 63 6f 67 6e 69  | B.V.. + Recogni|
000073b0  73 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |sed by file type|
000073c0  20 30 30 34 20 28 61 20  70 69 63 74 75 72 65 20  | 004 (a picture |
000073d0  6f 66 20 27 54 72 75 69  27 20 77 69 74 68 20 22  |of 'Trui' with "|
000073e0  54 55 22 20 69 6e 20 62  6c 75 65 29 0a 20 2b 20  |TU" in blue). + |
000073f0  43 68 61 6e 67 65 46 53  49 20 63 61 6e 20 77 72  |ChangeFSI can wr|
00007400  69 74 65 20 74 6f 20 74  68 69 73 20 66 6f 72 6d  |ite to this form|
00007410  61 74 20 28 73 70 65 63  69 66 79 20 22 61 69 6d  |at (specify "aim|
00007420  22 20 69 6e 20 74 68 65  20 6d 6f 64 65 20 70 6f  |" in the mode po|
00007430  73 69 74 69 6f 6e 29 0a  20 20 20 61 6e 64 20 73  |sition).   and s|
00007440  70 65 63 69 66 79 20 3d  20 69 6e 20 74 68 65 20  |pecify = in the |
00007450  73 69 7a 69 6e 67 20 74  6f 20 67 65 74 20 61 20  |sizing to get a |
00007460  32 35 36 20 62 79 20 32  35 36 20 6f 75 74 70 75  |256 by 256 outpu|
00007470  74 20 28 6f 74 68 65 72  77 69 73 65 20 69 74 20  |t (otherwise it |
00007480  77 69 6c 6c 0a 20 20 20  62 65 20 74 68 65 20 73  |will.   be the s|
00007490  61 6d 65 20 73 69 7a 65  20 61 73 20 74 68 65 20  |ame size as the |
000074a0  73 6f 75 72 63 65 20 69  6d 61 67 65 29 0a 20 2d  |source image). -|
000074b0  20 4e 6f 20 72 65 73 6f  6c 75 74 69 6f 6e 20 73  | No resolution s|
000074c0  70 65 63 69 66 69 65 64  2c 20 65 71 75 61 6c 20  |pecified, equal |
000074d0  74 6f 20 6d 6f 64 65 20  32 37 20 61 73 73 75 6d  |to mode 27 assum|
000074e0  65 64 0a 20 2d 20 54 68  65 20 61 73 73 6f 63 69  |ed. - The associ|
000074f0  61 74 65 64 20 66 69 6c  65 20 3c 6e 61 6d 65 3e  |ated file <name>|
00007500  2b 20 28 66 69 6c 65 20  74 79 70 65 20 30 31 30  |+ (file type 010|
00007510  29 20 77 68 69 63 68 20  63 6f 6e 74 61 69 6e 73  |) which contains|
00007520  20 61 64 64 69 74 69 6f  6e 61 6c 0a 20 20 20 69  | additional.   i|
00007530  6e 66 6f 72 6d 61 74 69  6f 6e 20 69 73 20 69 67  |nformation is ig|
00007540  6e 6f 72 65 64 20 62 79  20 43 68 61 6e 67 65 46  |nored by ChangeF|
00007550  53 49 2e 0a 20 54 68 65  20 67 72 65 79 20 6c 65  |SI.. The grey le|
00007560  76 65 6c 73 20 6d 61 79  20 72 65 70 72 65 73 65  |vels may represe|
00007570  6e 74 20 69 6e 74 65 6e  73 69 74 79 20 69 6e 20  |nt intensity in |
00007580  76 61 72 69 6f 75 73 20  64 69 66 66 65 72 65 6e  |various differen|
00007590  74 20 77 61 76 65 20 62  61 6e 64 73 2e 20 42 79  |t wave bands. By|
000075a0  0a 20 6e 61 6d 69 6e 67  20 66 69 6c 65 73 20 22  |. naming files "|
000075b0  72 65 64 22 2c 20 22 67  72 65 65 6e 22 20 61 6e  |red", "green" an|
000075c0  64 20 22 62 6c 75 65 22  20 61 6e 64 20 68 61 6e  |d "blue" and han|
000075d0  64 69 6e 67 20 43 68 61  6e 67 65 46 53 49 20 74  |ding ChangeFSI t|
000075e0  68 65 20 64 69 72 65 63  74 6f 72 79 2c 0a 20 79  |he directory,. y|
000075f0  6f 75 20 63 61 6e 20 70  72 6f 64 75 63 65 20 61  |ou can produce a|
00007600  20 66 61 6c 73 65 20 63  6f 6c 6f 75 72 20 69 6d  | false colour im|
00007610  61 67 65 2e 20 48 6f 75  72 73 20 6f 66 20 65 78  |age. Hours of ex|
00007620  70 65 72 69 6d 65 6e 74  61 74 69 6f 6e 20 63 61  |perimentation ca|
00007630  6e 20 70 72 6f 64 75 63  65 0a 20 61 6e 20 61 6c  |n produce. an al|
00007640  6d 6f 73 74 20 72 65 61  73 6f 6e 61 62 6c 65 20  |most reasonable |
00007650  70 69 63 74 75 72 65 2e  2e 2e 0a 0a 54 68 65 20  |picture.....The |
00007660  57 69 6c 64 20 56 69 73  69 6f 6e 20 56 31 32 20  |Wild Vision V12 |
00007670  66 6f 72 6d 61 74 0a 20  54 68 69 73 20 70 72 6f  |format. This pro|
00007680  76 69 64 65 73 20 61 6e  20 75 6e 63 6f 6d 70 72  |vides an uncompr|
00007690  65 73 73 65 64 20 35 31  32 20 62 79 20 35 31 32  |essed 512 by 512|
000076a0  20 69 6d 61 67 65 20 77  69 74 68 20 32 35 36 20  | image with 256 |
000076b0  67 72 65 79 20 6c 65 76  65 6c 73 2e 0a 20 2b 20  |grey levels.. + |
000076c0  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 66 69  |Recognised by fi|
000076d0  6c 65 20 74 79 70 65 20  30 30 36 0a 20 2d 20 4e  |le type 006. - N|
000076e0  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
000076f0  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
00007700  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
00007710  0a 0a 54 68 65 20 57 69  6c 64 20 56 69 73 69 6f  |..The Wild Visio|
00007720  6e 20 56 39 20 61 6e 64  20 53 6e 61 70 53 68 6f  |n V9 and SnapSho|
00007730  74 20 66 6f 72 6d 61 74  73 0a 20 54 68 69 73 20  |t formats. This |
00007740  70 72 6f 76 69 64 65 73  20 61 6e 20 75 6e 63 6f  |provides an unco|
00007750  6d 70 72 65 73 73 65 64  20 35 31 32 20 62 79 20  |mpressed 512 by |
00007760  32 35 36 20 69 6d 61 67  65 20 77 69 74 68 20 34  |256 image with 4|
00007770  20 62 69 74 73 20 6f 66  20 72 65 64 2c 20 67 72  | bits of red, gr|
00007780  65 65 6e 0a 20 61 6e 64  20 62 6c 75 65 2c 20 70  |een. and blue, p|
00007790  69 78 65 6c 73 20 73 69  7a 65 64 20 31 3a 32 2e  |ixels sized 1:2.|
000077a0  0a 20 2b 20 52 65 63 6f  67 6e 69 73 65 64 20 62  |. + Recognised b|
000077b0  79 20 22 4d 65 72 63 53  6f 66 74 22 20 6f 72 20  |y "MercSoft" or |
000077c0  22 53 6e 61 70 53 68 6f  74 22 20 68 65 61 64 65  |"SnapShot" heade|
000077d0  72 0a 20 2b 20 4e 6f 20  66 69 6c 65 20 74 79 70  |r. + No file typ|
000077e0  65 20 6e 65 65 64 65 64  0a 0a 54 68 65 20 21 54  |e needed..The !T|
000077f0  72 61 6e 73 6c 61 74 6f  72 20 43 6c 65 61 72 20  |ranslator Clear |
00007800  66 6f 72 6d 61 74 0a 20  54 68 69 73 20 70 72 6f  |format. This pro|
00007810  76 69 64 65 73 20 31 2c  20 32 2c 20 34 2c 20 38  |vides 1, 2, 4, 8|
00007820  20 61 6e 64 20 32 34 20  62 69 74 73 20 70 65 72  | and 24 bits per|
00007830  20 70 69 78 65 6c 2e 0a  20 2b 20 52 65 63 6f 67  | pixel.. + Recog|
00007840  6e 69 73 65 64 20 62 79  20 66 69 6c 65 20 74 79  |nised by file ty|
00007850  70 65 20 36 39 30 0a 20  2d 20 75 6e 63 6f 6d 70  |pe 690. - uncomp|
00007860  72 65 73 73 65 64 2c 20  65 73 70 65 63 69 61 6c  |ressed, especial|
00007870  6c 79 20 66 6f 72 20 3c  38 20 62 69 74 73 20 70  |ly for <8 bits p|
00007880  65 72 20 70 69 78 65 6c  20 77 68 69 63 68 20 69  |er pixel which i|
00007890  73 20 72 65 63 6f 72 64  65 64 20 61 74 20 6f 6e  |s recorded at on|
000078a0  65 0a 20 20 20 62 79 74  65 20 70 65 72 20 70 69  |e.   byte per pi|
000078b0  78 65 6c 2e 0a 20 2d 20  4e 6f 20 72 65 73 6f 6c  |xel.. - No resol|
000078c0  75 74 69 6f 6e 20 73 70  65 63 69 66 69 65 64 2c  |ution specified,|
000078d0  20 65 71 75 61 6c 20 74  6f 20 6d 6f 64 65 20 32  | equal to mode 2|
000078e0  37 20 61 73 73 75 6d 65  64 0a 0a 54 68 65 20 41  |7 assumed..The A|
000078f0  74 61 72 69 20 53 54 20  22 44 65 67 61 73 22 20  |tari ST "Degas" |
00007900  66 6f 72 6d 61 74 0a 20  31 2c 20 32 20 6f 72 20  |format. 1, 2 or |
00007910  34 20 62 69 74 73 20 70  65 72 20 70 69 78 65 6c  |4 bits per pixel|
00007920  2c 20 63 6c 65 61 72 20  6f 72 20 72 75 6e 20 6c  |, clear or run l|
00007930  65 6e 67 74 68 20 65 6e  63 6f 64 65 64 2e 20 52  |ength encoded. R|
00007940  49 53 43 20 4f 53 20 66  69 6c 65 20 74 79 70 65  |ISC OS file type|
00007950  20 62 79 0a 20 4a 6f 68  6e 20 4b 6f 72 74 69 6e  | by. John Kortin|
00007960  6b 20 6f 66 20 21 54 72  61 6e 73 6c 61 74 6f 72  |k of !Translator|
00007970  2e 0a 20 2b 20 52 65 63  6f 67 6e 69 73 65 64 20  |.. + Recognised |
00007980  62 79 20 66 69 6c 65 20  74 79 70 65 20 36 39 31  |by file type 691|
00007990  0a 20 2d 20 4e 6f 20 64  6f 63 75 6d 65 6e 74 61  |. - No documenta|
000079a0  74 69 6f 6e 20 61 6e 64  20 6f 6e 6c 79 20 35 20  |tion and only 5 |
000079b0  69 6d 61 67 65 73 20 72  65 61 64 0a 20 2d 20 4e  |images read. - N|
000079c0  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
000079d0  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
000079e0  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
000079f0  0a 0a 3e 3e 20 41 6c 6c  20 74 68 65 20 66 69 6c  |..>> All the fil|
00007a00  65 20 66 6f 72 6d 61 74  73 20 73 6f 20 66 61 72  |e formats so far|
00007a10  20 68 61 76 65 20 62 65  65 6e 20 64 65 73 69 67  | have been desig|
00007a20  6e 65 64 20 6f 6e 20 52  49 53 43 20 4f 53 20 28  |ned on RISC OS (|
00007a30  6f 72 20 41 72 74 68 75  72 29 20 61 6e 64 0a 72  |or Arthur) and.r|
00007a40  65 63 6f 67 6e 69 74 69  6f 6e 20 6f 66 20 74 68  |ecognition of th|
00007a50  65 20 66 6f 72 6d 61 74  20 69 73 20 64 65 66 69  |e format is defi|
00007a60  6e 65 64 20 62 79 20 66  69 6c 65 20 74 79 70 65  |ned by file type|
00007a70  2c 20 74 68 65 20 66 69  6c 65 73 20 61 72 72 69  |, the files arri|
00007a80  76 65 20 6f 6e 20 52 49  53 43 0a 4f 53 20 66 6c  |ve on RISC.OS fl|
00007a90  6f 70 70 79 20 64 69 73  63 73 2c 20 61 6e 64 20  |oppy discs, and |
00007aa0  74 68 65 20 6f 72 69 67  69 6e 61 74 6f 72 73 20  |the originators |
00007ab0  6c 69 76 65 20 69 6e 20  74 68 65 20 73 61 6d 65  |live in the same|
00007ac0  20 74 69 6d 65 20 7a 6f  6e 65 2e 20 46 6f 72 20  | time zone. For |
00007ad0  74 68 65 0a 66 6f 6c 6c  6f 77 69 6e 67 20 66 6f  |the.following fo|
00007ae0  72 6d 61 74 73 20 6d 61  6e 79 20 6f 66 20 74 68  |rmats many of th|
00007af0  65 73 65 20 74 68 69 6e  67 73 20 61 72 65 20 6e  |ese things are n|
00007b00  6f 74 20 74 72 75 65 2e  2e 2e 20 57 68 69 63 68  |ot true... Which|
00007b10  20 6d 61 6b 65 73 20 69  74 20 6d 6f 72 65 0a 64  | makes it more.d|
00007b20  69 66 66 69 63 75 6c 74  20 74 6f 20 67 75 61 72  |ifficult to guar|
00007b30  61 6e 74 65 65 20 74 68  61 74 20 43 68 61 6e 67  |antee that Chang|
00007b40  65 46 53 49 20 77 69 6c  6c 20 62 65 20 61 62 6c  |eFSI will be abl|
00007b50  65 20 74 6f 20 72 65 61  64 20 74 68 65 20 66 69  |e to read the fi|
00007b60  6c 65 2e 0a 0a 54 68 65  20 4d 69 6c 6c 69 70 65  |le...The Millipe|
00007b70  64 65 20 50 72 69 73 6d  61 20 66 6f 72 6d 61 74  |de Prisma format|
00007b80  20 28 75 73 65 64 20 62  79 20 43 61 64 53 6f 66  | (used by CadSof|
00007b90  74 20 61 6c 73 6f 29 0a  20 54 68 65 20 4d 69 6c  |t also). The Mil|
00007ba0  6c 69 70 65 64 65 20 50  72 69 73 6d 61 20 33 20  |lipede Prisma 3 |
00007bb0  69 73 20 61 20 37 36 38  20 70 69 78 65 6c 73 20  |is a 768 pixels |
00007bc0  77 69 64 65 20 62 79 20  35 37 34 20 6c 69 6e 65  |wide by 574 line|
00007bd0  20 69 6e 74 65 72 6c 61  63 65 64 20 64 69 73 70  | interlaced disp|
00007be0  6c 61 79 0a 20 62 6f 61  72 64 20 66 6f 72 20 74  |lay. board for t|
00007bf0  68 65 20 41 72 63 68 69  6d 65 64 65 73 20 61 6e  |he Archimedes an|
00007c00  64 20 42 42 43 20 4d 69  63 72 6f 63 6f 6d 70 75  |d BBC Microcompu|
00007c10  74 65 72 2e 20 49 74 20  61 6c 6c 6f 77 73 20 75  |ter. It allows u|
00007c20  73 65 20 6f 66 20 32 35  36 0a 20 63 6f 6c 6f 75  |se of 256. colou|
00007c30  72 73 20 66 72 6f 6d 20  32 5e 32 34 2e 20 46 69  |rs from 2^24. Fi|
00007c40  6c 65 73 20 6d 61 79 20  62 65 20 73 74 6f 72 65  |les may be store|
00007c50  64 20 75 6e 63 6f 6d 70  72 65 73 73 65 64 20 28  |d uncompressed (|
00007c60  34 33 32 4b 42 79 74 65  73 21 29 20 6f 72 20 72  |432KBytes!) or r|
00007c70  75 6e 0a 20 6c 65 6e 67  74 68 20 65 6e 63 6f 64  |un. length encod|
00007c80  65 64 2e 20 4d 6f 72 65  20 64 65 74 61 69 6c 73  |ed. More details|
00007c90  20 66 72 6f 6d 20 43 61  64 53 6f 66 74 20 6f 72  | from CadSoft or|
00007ca0  20 4d 69 6c 6c 69 70 65  64 65 20 45 6c 65 63 74  | Millipede Elect|
00007cb0  72 6f 6e 69 63 20 47 72  61 70 68 69 63 73 2e 0a  |ronic Graphics..|
00007cc0  20 2b 20 52 65 63 6f 67  6e 69 73 65 64 20 62 79  | + Recognised by|
00007cd0  20 22 4d 49 4c 4c 49 50  45 44 45 22 20 61 74 20  | "MILLIPEDE" at |
00007ce0  6f 66 66 73 65 74 20 31  36 20 69 6e 20 74 68 65  |offset 16 in the|
00007cf0  20 66 69 6c 65 0a 20 2d  20 4e 6f 20 72 65 73 6f  | file. - No reso|
00007d00  6c 75 74 69 6f 6e 20 73  70 65 63 69 66 69 65 64  |lution specified|
00007d10  2c 20 65 71 75 61 6c 20  74 6f 20 6d 6f 64 65 20  |, equal to mode |
00007d20  32 37 20 61 73 73 75 6d  65 64 0a 20 2d 20 73 6c  |27 assumed. - sl|
00007d30  6f 77 69 73 68 20 74 6f  20 72 65 61 64 20 74 68  |owish to read th|
00007d40  65 20 63 6f 6d 70 72 65  73 73 65 64 20 66 6f 72  |e compressed for|
00007d50  6d 61 74 73 0a 20 2d 20  73 63 61 6c 69 6e 67 20  |mats. - scaling |
00007d60  74 68 65 20 70 69 63 74  75 72 65 20 75 73 69 6e  |the picture usin|
00007d70  67 20 3d 20 63 61 6e 20  62 65 20 70 6f 6f 72 20  |g = can be poor |
00007d80  73 69 6e 63 65 20 35 37  34 20 6c 69 6e 65 73 20  |since 574 lines |
00007d90  64 6f 6e 27 74 20 72 65  6c 61 74 65 20 76 65 72  |don't relate ver|
00007da0  79 0a 20 20 20 77 65 6c  6c 20 74 6f 20 35 31 32  |y.   well to 512|
00007db0  20 6f 72 20 32 35 36 2e  20 55 73 65 20 2d 69 6e  | or 256. Use -in|
00007dc0  66 6f 20 74 6f 20 64 69  73 70 6c 61 79 20 74 68  |fo to display th|
00007dd0  65 20 73 63 61 6c 65 20  72 61 74 69 6f 73 2e 0a  |e scale ratios..|
00007de0  0a 54 68 65 20 41 6c 64  75 73 2f 4d 69 63 72 6f  |.The Aldus/Micro|
00007df0  53 6f 66 74 20 54 49 46  46 20 66 6f 72 6d 61 74  |Soft TIFF format|
00007e00  20 28 61 6c 73 6f 20 66  69 6c 65 74 79 70 65 20  | (also filetype |
00007e10  46 46 30 20 69 73 20 61  73 73 69 67 6e 65 64 20  |FF0 is assigned |
00007e20  74 6f 20 54 49 46 46 29  0a 20 46 72 65 71 75 65  |to TIFF). Freque|
00007e30  6e 74 6c 79 20 75 73 65  64 20 62 79 20 73 63 61  |ntly used by sca|
00007e40  6e 6e 65 72 73 2c 20 54  49 46 46 20 69 73 20 61  |nners, TIFF is a|
00007e50  20 63 6f 6d 6d 6f 6e 20  69 6e 74 65 72 63 68 61  | common intercha|
00007e60  6e 67 65 20 66 6f 72 6d  61 74 20 66 6f 72 0a 20  |nge format for. |
00007e70  67 72 61 70 68 69 63 73  20 69 6d 61 67 65 73 20  |graphics images |
00007e80  6f 6e 20 74 68 65 20 4d  61 63 20 61 6e 64 20 50  |on the Mac and P|
00007e90  43 20 28 70 61 72 74 69  63 75 6c 61 72 6c 79 20  |C (particularly |
00007ea0  44 54 50 20 61 6e 64 20  57 69 6e 64 6f 77 73 29  |DTP and Windows)|
00007eb0  2e 20 49 74 0a 20 70 72  6f 76 69 64 65 73 20 61  |. It. provides a|
00007ec0  6e 20 61 72 62 69 74 72  61 72 79 20 6e 75 6d 62  |n arbitrary numb|
00007ed0  65 72 20 6f 66 20 62 69  74 73 20 70 65 72 20 70  |er of bits per p|
00007ee0  69 78 65 6c 2c 20 73 69  7a 65 20 65 74 63 20 75  |ixel, size etc u|
00007ef0  73 69 6e 67 20 61 20 6e  75 6d 65 72 69 63 20 74  |sing a numeric t|
00007f00  61 67 0a 20 73 63 68 65  6d 65 20 61 6c 6c 6f 77  |ag. scheme allow|
00007f10  69 6e 67 20 6e 65 77 20  69 6e 66 6f 72 6d 61 74  |ing new informat|
00007f20  69 6f 6e 20 74 6f 20 62  65 20 69 6e 74 72 6f 64  |ion to be introd|
00007f30  75 63 65 64 20 77 69 74  68 6f 75 74 20 75 70 73  |uced without ups|
00007f40  65 74 74 69 6e 67 20 65  78 69 73 74 69 6e 67 0a  |etting existing.|
00007f50  20 70 72 6f 67 72 61 6d  73 2e 20 54 68 65 20 66  | programs. The f|
00007f60  6f 72 6d 61 74 20 6d 61  79 20 62 65 20 63 6f 6d  |ormat may be com|
00007f70  70 72 65 73 73 65 64 20  28 69 6e 20 35 20 64 69  |pressed (in 5 di|
00007f80  66 66 65 72 65 6e 74 20  77 61 79 73 20 61 74 20  |fferent ways at |
00007f90  70 72 65 73 65 6e 74 29  2e 0a 20 44 65 74 61 69  |present).. Detai|
00007fa0  6c 73 20 66 72 6f 6d 20  41 6c 64 75 73 20 55 4b  |ls from Aldus UK|
00007fb0  2c 20 4d 69 63 72 6f 53  6f 66 74 2c 20 48 65 77  |, MicroSoft, Hew|
00007fc0  6c 65 74 74 20 50 61 63  6b 61 72 64 2e 2e 2e 0a  |lett Packard....|
00007fd0  20 2b 20 52 65 63 6f 67  6e 69 73 65 64 20 62 79  | + Recognised by|
00007fe0  20 66 69 6c 65 20 74 79  70 65 20 46 46 30 0a 20  | file type FF0. |
00007ff0  2b 20 52 65 63 6f 67 6e  69 73 65 64 20 62 79 20  |+ Recognised by |
00008000  22 49 49 22 20 70 6c 75  73 20 74 68 65 20 31 36  |"II" plus the 16|
00008010  20 62 69 74 20 6e 75 6d  62 65 72 20 34 32 20 61  | bit number 42 a|
00008020  74 20 74 68 65 20 73 74  61 72 74 20 6f 66 20 74  |t the start of t|
00008030  68 65 20 66 69 6c 65 20  66 6f 72 0a 20 20 20 6c  |he file for.   l|
00008040  69 74 74 6c 65 20 65 6e  64 69 61 6e 20 6d 61 63  |ittle endian mac|
00008050  68 69 6e 65 73 20 28 69  78 38 36 2c 20 41 52 4d  |hines (ix86, ARM|
00008060  2c 20 56 41 58 2e 2e 2e  29 0a 20 2b 20 52 65 63  |, VAX...). + Rec|
00008070  6f 67 6e 69 73 65 64 20  62 79 20 22 4d 4d 22 20  |ognised by "MM" |
00008080  70 6c 75 73 20 74 68 65  20 31 36 20 62 69 74 20  |plus the 16 bit |
00008090  6e 75 6d 62 65 72 20 34  32 20 61 74 20 74 68 65  |number 42 at the|
000080a0  20 73 74 61 72 74 20 6f  66 20 74 68 65 20 66 69  | start of the fi|
000080b0  6c 65 20 66 6f 72 0a 20  20 20 62 69 67 20 65 6e  |le for.   big en|
000080c0  64 69 61 6e 20 6d 61 63  68 69 6e 65 73 20 28 4d  |dian machines (M|
000080d0  36 38 30 78 30 2e 2e 2e  29 0a 20 2b 20 43 61 6e  |680x0...). + Can|
000080e0  20 72 65 61 64 20 50 61  63 6b 42 69 74 73 20 69  | read PackBits i|
000080f0  6d 61 67 65 73 20 61 6e  64 20 4c 5a 57 20 63 6f  |mages and LZW co|
00008100  6d 70 72 65 73 73 65 64  20 66 6f 72 6d 73 20 28  |mpressed forms (|
00008110  61 74 20 6c 65 61 73 74  20 74 68 65 20 33 20 69  |at least the 3 i|
00008120  74 73 0a 20 20 20 73 65  65 6e 20 73 6f 20 66 61  |ts.   seen so fa|
00008130  72 2e 2e 2e 29 0a 20 2d  20 43 61 6e 6e 6f 74 20  |r...). - Cannot |
00008140  72 65 61 64 20 70 72 65  64 69 63 74 6f 72 20 63  |read predictor c|
00008150  6f 6d 70 72 65 73 73 65  64 20 4c 5a 57 20 69 6d  |ompressed LZW im|
00008160  61 67 65 73 2e 0a 20 2d  20 53 6f 20 66 61 72 20  |ages.. - So far |
00008170  43 68 61 6e 67 65 46 53  49 20 68 61 73 20 6f 6e  |ChangeFSI has on|
00008180  6c 79 20 64 6f 6e 65 20  31 2c 20 34 2c 20 38 20  |ly done 1, 4, 8 |
00008190  61 6e 64 20 32 34 20 62  69 74 20 69 6d 61 67 65  |and 24 bit image|
000081a0  73 2e 0a 20 20 20 49 74  20 63 61 6e 27 74 20 72  |s..   It can't r|
000081b0  65 61 64 20 22 70 6c 61  6e 61 72 22 20 69 6d 61  |ead "planar" ima|
000081c0  67 65 73 20 6f 72 20 43  43 49 54 54 20 63 6f 6d  |ges or CCITT com|
000081d0  70 72 65 73 73 65 64 20  66 6f 72 6d 73 2e 0a 20  |pressed forms.. |
000081e0  2d 20 53 6f 6d 65 20 54  49 46 46 20 69 6d 61 67  |- Some TIFF imag|
000081f0  65 73 20 68 61 76 65 20  69 6e 63 6f 72 72 65 63  |es have incorrec|
00008200  74 20 70 69 78 65 6c 20  73 69 7a 65 73 3a 20 75  |t pixel sizes: u|
00008210  73 65 20 2d 6e 6f 73 69  7a 65 20 69 66 20 74 68  |se -nosize if th|
00008220  69 73 20 69 73 0a 20 20  20 74 72 75 65 2e 20 49  |is is.   true. I|
00008230  66 20 6e 6f 20 70 69 78  65 6c 20 73 69 7a 65 20  |f no pixel size |
00008240  69 73 20 73 70 65 63 69  66 69 65 64 2c 20 43 68  |is specified, Ch|
00008250  61 6e 67 65 46 53 49 20  61 73 73 75 6d 65 73 20  |angeFSI assumes |
00008260  6d 6f 64 65 20 32 37 20  73 69 7a 65 2e 0a 20 2b  |mode 27 size.. +|
00008270  20 54 49 46 46 20 69 73  20 61 20 74 72 61 64 65  | TIFF is a trade|
00008280  6d 61 72 6b 20 6f 66 20  41 6c 64 75 73 20 43 6f  |mark of Aldus Co|
00008290  72 70 6f 72 61 74 69 6f  6e 0a 0a 54 68 65 20 43  |rporation..The C|
000082a0  6f 6d 70 75 53 65 72 76  65 20 47 49 46 20 66 6f  |ompuServe GIF fo|
000082b0  72 6d 61 74 0a 20 55 73  65 64 20 66 6f 72 20 77  |rmat. Used for w|
000082c0  69 64 65 20 61 72 65 61  20 6e 65 74 77 6f 72 6b  |ide area network|
000082d0  20 74 72 61 6e 73 66 65  72 20 6f 66 20 69 6d 61  | transfer of ima|
000082e0  67 65 73 2e 20 49 74 20  70 72 6f 76 69 64 65 73  |ges. It provides|
000082f0  20 61 6e 20 4c 5a 57 0a  20 63 6f 6d 70 72 65 73  | an LZW. compres|
00008300  73 65 64 20 75 70 20 74  6f 20 32 35 36 20 63 6f  |sed up to 256 co|
00008310  6c 6f 75 72 73 20 66 72  6f 6d 20 32 5e 32 34 20  |lours from 2^24 |
00008320  61 72 62 69 74 72 61 72  79 20 73 69 7a 65 64 20  |arbitrary sized |
00008330  69 6d 61 67 65 2e 20 44  65 74 61 69 6c 73 20 66  |image. Details f|
00008340  72 6f 6d 0a 20 43 6f 6d  70 75 53 65 72 76 65 20  |rom. CompuServe |
00008350  28 55 53 41 29 20 5b 6f  72 20 75 73 65 6e 65 74  |(USA) [or usenet|
00008360  5d 0a 20 2b 20 52 65 63  6f 67 6e 69 73 65 64 20  |]. + Recognised |
00008370  62 79 20 22 47 49 46 38  37 61 22 20 61 74 20 74  |by "GIF87a" at t|
00008380  68 65 20 73 74 61 72 74  20 6f 66 20 74 68 65 20  |he start of the |
00008390  66 69 6c 65 0a 20 2b 20  4c 5a 57 20 63 6f 6d 70  |file. + LZW comp|
000083a0  72 65 73 73 69 6f 6e 20  69 73 20 65 66 66 69 63  |ression is effic|
000083b0  69 65 6e 74 20 65 76 65  6e 20 66 6f 72 20 64 69  |ient even for di|
000083c0  74 68 65 72 65 64 20 69  6d 61 67 65 73 0a 20 2b  |thered images. +|
000083d0  20 43 68 61 6e 67 65 46  53 49 20 63 61 6e 20 64  | ChangeFSI can d|
000083e0  65 63 6f 6d 70 72 65 73  73 20 4c 5a 57 20 71 75  |ecompress LZW qu|
000083f0  69 63 6b 6c 79 0a 20 2d  20 4e 6f 20 72 65 73 6f  |ickly. - No reso|
00008400  6c 75 74 69 6f 6e 20 73  70 65 63 69 66 69 65 64  |lution specified|
00008410  2c 20 65 71 75 61 6c 20  74 6f 20 6d 6f 64 65 20  |, equal to mode |
00008420  32 37 20 61 73 73 75 6d  65 64 0a 20 2d 20 6d 61  |27 assumed. - ma|
00008430  6e 79 20 6c 6f 77 20 71  75 61 6c 69 74 79 20 69  |ny low quality i|
00008440  6d 61 67 65 73 20 61 72  6f 75 6e 64 20 66 72 6f  |mages around fro|
00008450  6d 20 50 43 73 0a 0a 54  68 65 20 45 6c 65 63 74  |m PCs..The Elect|
00008460  72 6f 6e 69 63 20 41 72  74 73 20 49 46 46 20 49  |ronic Arts IFF I|
00008470  4c 42 4d 20 66 6f 72 6d  61 74 0a 20 50 72 6f 76  |LBM format. Prov|
00008480  69 64 65 73 20 61 6e 20  61 72 62 69 74 72 61 72  |ides an arbitrar|
00008490  79 20 73 69 7a 65 64 20  69 6d 61 67 65 20 77 69  |y sized image wi|
000084a0  74 68 20 75 70 20 74 6f  20 34 30 39 36 20 63 6f  |th up to 4096 co|
000084b0  6c 6f 75 72 73 20 73 6f  6d 65 74 69 6d 65 73 20  |lours sometimes |
000084c0  72 75 6e 0a 20 6c 65 6e  67 74 68 20 65 6e 63 6f  |run. length enco|
000084d0  64 65 64 2e 20 43 68 61  6e 67 65 46 53 49 20 75  |ded. ChangeFSI u|
000084e0  6e 64 65 72 73 74 61 6e  64 73 20 74 68 65 20 67  |nderstands the g|
000084f0  65 6e 65 72 69 63 20 66  6f 72 6d 61 74 20 61 6e  |eneric format an|
00008500  64 20 61 6c 73 6f 20 74  68 65 0a 20 73 70 65 63  |d also the. spec|
00008510  69 61 6c 20 41 6d 69 67  61 20 66 6f 72 6d 61 74  |ial Amiga format|
00008520  20 66 6f 72 20 22 48 41  4d 22 20 61 6e 64 20 22  | for "HAM" and "|
00008530  48 61 6c 66 2d 62 72 69  67 68 74 22 20 69 6d 61  |Half-bright" ima|
00008540  67 65 73 2e 0a 20 2b 20  52 65 63 6f 67 6e 69 73  |ges.. + Recognis|
00008550  65 64 20 62 79 20 22 46  4f 52 4d 22 20 61 73 20  |ed by "FORM" as |
00008560  74 68 65 20 66 69 72 73  74 20 66 6f 75 72 20 63  |the first four c|
00008570  68 61 72 61 63 74 65 72  73 20 61 6e 64 20 22 49  |haracters and "I|
00008580  4c 42 4d 22 20 61 73 0a  20 20 20 63 68 61 72 61  |LBM" as.   chara|
00008590  63 74 65 72 73 20 38 20  74 6f 20 31 31 0a 20 2d  |cters 8 to 11. -|
000085a0  20 4f 6e 6c 79 20 70 69  78 65 6c 20 61 73 70 65  | Only pixel aspe|
000085b0  63 74 20 72 61 74 69 6f  20 73 70 65 63 69 66 69  |ct ratio specifi|
000085c0  65 64 2c 20 6e 6f 74 20  69 74 73 20 73 69 7a 65  |ed, not its size|
000085d0  20 28 61 6e 64 20 74 68  65 6e 20 73 6f 6d 65 74  | (and then somet|
000085e0  69 6d 65 73 0a 20 20 20  69 6e 63 6f 72 72 65 63  |imes.   incorrec|
000085f0  74 6c 79 29 3a 20 75 73  65 20 2d 6e 6f 73 69 7a  |tly): use -nosiz|
00008600  65 20 2a 61 6e 64 2a 20  61 20 73 69 7a 65 20 63  |e *and* a size c|
00008610  68 61 6e 67 65 20 28 61  3a 62 29 20 69 66 20 69  |hange (a:b) if i|
00008620  74 73 20 77 72 6f 6e 67  0a 20 2d 20 69 6d 61 67  |ts wrong. - imag|
00008630  65 73 20 6f 66 74 65 6e  20 73 6d 61 6c 6c 0a 20  |es often small. |
00008640  2d 20 64 6f 65 73 6e 27  74 20 75 6e 64 65 72 73  |- doesn't unders|
00008650  74 61 6e 64 20 41 6d 69  67 61 20 22 68 69 72 65  |tand Amiga "hire|
00008660  73 22 0a 20 2d 20 63 61  6e 27 74 20 63 6f 6e 76  |s". - can't conv|
00008670  65 72 74 20 48 41 4d 20  70 69 63 74 75 72 65 73  |ert HAM pictures|
00008680  20 64 69 72 65 63 74 6c  79 20 74 6f 20 6d 6f 6e  | directly to mon|
00008690  6f 63 68 72 6f 6d 65 0a  0a 54 68 65 20 4d 69 63  |ochrome..The Mic|
000086a0  72 6f 53 6f 66 74 20 57  69 6e 64 6f 77 73 20 33  |roSoft Windows 3|
000086b0  20 2e 42 4d 50 20 66 6f  72 6d 61 74 0a 20 55 73  | .BMP format. Us|
000086c0  65 64 20 62 79 20 4d 69  63 72 6f 53 6f 66 74 20  |ed by MicroSoft |
000086d0  69 6e 20 57 69 6e 64 6f  77 73 20 33 20 61 6e 64  |in Windows 3 and|
000086e0  20 50 61 69 6e 74 42 72  75 73 68 20 66 6f 72 20  | PaintBrush for |
000086f0  57 69 6e 64 6f 77 73 20  33 2e 20 50 72 6f 76 69  |Windows 3. Provi|
00008700  64 65 73 20 61 6e 0a 20  61 72 62 69 74 72 61 72  |des an. arbitrar|
00008710  79 20 73 69 7a 65 64 20  69 6d 61 67 65 20 61 6e  |y sized image an|
00008720  64 20 31 2c 20 34 20 6f  72 20 38 20 62 69 74 73  |d 1, 4 or 8 bits|
00008730  20 70 65 72 20 70 69 78  65 6c 2e 20 55 6e 63 6f  | per pixel. Unco|
00008740  6d 70 72 65 73 73 65 64  2e 0a 20 2b 20 52 65 63  |mpressed.. + Rec|
00008750  6f 67 6e 69 73 65 64 20  62 79 20 22 42 4d 22 20  |ognised by "BM" |
00008760  61 73 20 74 68 65 20 66  69 72 73 74 20 74 77 6f  |as the first two|
00008770  20 63 68 61 72 61 63 74  65 72 73 0a 20 2d 20 4e  | characters. - N|
00008780  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
00008790  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
000087a0  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
000087b0  0a 20 2d 20 64 6f 63 75  6d 65 6e 74 61 74 69 6f  |. - documentatio|
000087c0  6e 20 6e 65 76 65 72 20  73 65 65 6e 20 2d 20 37  |n never seen - 7|
000087d0  20 66 69 6c 65 73 20 65  78 61 6d 69 6e 65 64 20  | files examined |
000087e0  61 6e 64 20 69 6e 74 65  6c 6c 69 67 65 6e 74 20  |and intelligent |
000087f0  67 75 65 73 73 65 73 20  6d 61 64 65 21 0a 0a 54  |guesses made!..T|
00008800  68 65 20 44 69 67 69 74  61 6c 20 52 65 73 65 61  |he Digital Resea|
00008810  72 63 68 20 47 45 4d 20  2e 49 4d 47 20 66 6f 72  |rch GEM .IMG for|
00008820  6d 61 74 0a 20 55 73 65  64 20 62 79 20 47 45 4d  |mat. Used by GEM|
00008830  20 28 61 6e 64 20 47 45  4d 20 50 61 69 6e 74 29  | (and GEM Paint)|
00008840  20 6f 6e 20 62 6f 74 68  20 50 43 20 61 6e 64 20  | on both PC and |
00008850  41 74 61 72 69 20 53 54  2e 20 50 72 6f 76 69 64  |Atari ST. Provid|
00008860  65 73 20 61 6e 20 61 72  62 69 74 72 61 72 79 0a  |es an arbitrary.|
00008870  20 73 69 7a 65 64 20 69  6d 61 67 65 20 61 6e 64  | sized image and|
00008880  20 6e 75 6d 62 65 72 20  6f 66 20 62 69 74 73 20  | number of bits |
00008890  70 65 72 20 70 69 78 65  6c 20 28 74 68 6f 75 67  |per pixel (thoug|
000088a0  68 20 69 74 73 20 6f 6e  6c 79 20 75 73 75 61 6c  |h its only usual|
000088b0  6c 79 20 75 73 65 64 20  77 69 74 68 0a 20 75 70  |ly used with. up|
000088c0  20 74 6f 20 35 20 62 69  74 73 20 70 65 72 20 70  | to 5 bits per p|
000088d0  69 78 65 6c 29 20 61 6e  64 20 70 69 78 65 6c 20  |ixel) and pixel |
000088e0  73 69 7a 65 2e 20 43 6f  6d 70 72 65 73 73 65 64  |size. Compressed|
000088f0  20 62 79 20 72 75 6e 20  6c 65 6e 67 74 68 20 65  | by run length e|
00008900  6e 63 6f 64 69 6e 67 0a  20 61 6e 64 20 6c 69 6e  |ncoding. and lin|
00008910  65 20 72 65 70 65 61 74  73 2e 0a 20 2d 20 52 65  |e repeats.. - Re|
00008920  63 6f 67 6e 69 73 65 64  20 62 79 20 30 30 20 30  |cognised by 00 0|
00008930  31 20 30 30 20 30 38 20  61 73 20 74 68 65 20 66  |1 00 08 as the f|
00008940  69 72 73 74 20 66 6f 75  72 20 62 79 74 65 73 20  |irst four bytes |
00008950  28 22 76 65 72 73 69 6f  6e 20 31 2c 20 68 65 61  |("version 1, hea|
00008960  64 65 72 0a 20 20 20 6c  65 6e 67 74 68 20 38 22  |der.   length 8"|
00008970  29 20 6f 72 20 62 79 20  22 49 4d 47 22 20 61 73  |) or by "IMG" as|
00008980  20 74 68 65 20 6e 61 6d  65 20 6f 66 20 74 68 65  | the name of the|
00008990  20 64 69 72 65 63 74 6f  72 79 20 74 68 65 20 66  | directory the f|
000089a0  69 6c 65 20 69 73 20 69  6e 2e 0a 20 2d 20 50 6c  |ile is in.. - Pl|
000089b0  61 6e 61 72 20 66 69 6c  65 20 66 6f 72 6d 61 74  |anar file format|
000089c0  20 73 6c 6f 77 20 74 6f  20 72 65 61 64 0a 20 2d  | slow to read. -|
000089d0  20 50 61 6c 65 74 74 65  20 6e 6f 74 20 73 70 65  | Palette not spe|
000089e0  63 69 66 69 65 64 3a 20  43 68 61 6e 67 65 46 53  |cified: ChangeFS|
000089f0  49 20 61 73 73 75 6d 65  73 20 6c 69 6e 65 61 72  |I assumes linear|
00008a00  20 73 68 61 64 65 73 20  6f 66 20 67 72 65 79 2e  | shades of grey.|
00008a10  20 59 6f 75 20 6d 69 67  68 74 0a 20 20 20 6e 65  | You might.   ne|
00008a20  65 64 20 74 6f 20 75 73  65 20 2d 69 6e 76 65 72  |ed to use -inver|
00008a30  74 20 69 66 20 74 68 65  20 69 6d 61 67 65 20 69  |t if the image i|
00008a40  73 20 61 20 6e 65 67 61  74 69 76 65 0a 20 2d 20  |s a negative. - |
00008a50  54 68 65 20 73 69 7a 65  20 6f 66 20 61 20 70 69  |The size of a pi|
00008a60  78 65 6c 20 69 73 20 73  70 65 63 69 66 69 65 64  |xel is specified|
00008a70  20 69 6e 20 6d 69 63 72  6f 6e 73 2e 20 54 68 65  | in microns. The|
00008a80  20 73 74 61 6e 64 61 72  64 20 52 49 53 43 20 4f  | standard RISC O|
00008a90  53 20 39 30 0a 20 20 20  70 69 78 65 6c 73 20 70  |S 90.   pixels p|
00008aa0  65 72 20 69 6e 63 68 20  74 72 61 6e 73 6c 61 74  |er inch translat|
00008ab0  65 73 20 74 6f 20 28 31  2f 39 30 2a 32 2e 35 34  |es to (1/90*2.54|
00008ac0  2a 31 30 2c 30 30 30 29  20 6d 69 63 72 6f 6e 73  |*10,000) microns|
00008ad0  20 2d 20 32 38 32 2e 20  28 75 73 65 0a 20 20 20  | - 282. (use.   |
00008ae0  2d 69 6e 66 6f 20 74 6f  20 67 65 74 20 69 6e 66  |-info to get inf|
00008af0  6f 72 6d 61 74 69 6f 6e  20 61 62 6f 75 74 20 74  |ormation about t|
00008b00  68 65 20 73 63 61 6c 69  6e 67 2c 20 2d 6e 6f 73  |he scaling, -nos|
00008b10  69 7a 65 20 74 6f 20 73  74 6f 70 20 69 74 29 0a  |ize to stop it).|
00008b20  20 2d 20 44 6f 63 75 6d  65 6e 74 61 74 69 6f 6e  | - Documentation|
00008b30  20 66 72 6f 6d 20 74 68  65 20 22 53 54 20 57 6f  | from the "ST Wo|
00008b40  72 6c 64 22 20 6d 61 67  61 7a 69 6e 65 27 73 20  |rld" magazine's |
00008b50  63 6c 69 6e 69 63 2e 0a  0a 41 6e 20 75 6e 6b 6e  |clinic...An unkn|
00008b60  6f 77 6e 20 50 43 20 2e  50 49 43 20 66 6f 72 6d  |own PC .PIC form|
00008b70  61 74 0a 20 55 73 65 64  20 66 6f 72 20 73 6f 6d  |at. Used for som|
00008b80  65 20 56 47 41 20 64 65  6d 6f 73 2c 20 74 68 65  |e VGA demos, the|
00008b90  20 66 6f 72 6d 61 74 20  70 72 6f 76 69 64 65 73  | format provides|
00008ba0  20 61 6e 20 75 6e 63 6f  6d 70 72 65 73 73 65 64  | an uncompressed|
00008bb0  20 33 32 30 20 62 79 20  32 30 30 20 62 79 0a 20  | 320 by 200 by. |
00008bc0  32 35 36 20 63 6f 6c 6f  75 72 20 28 66 72 6f 6d  |256 colour (from|
00008bd0  20 32 5e 32 34 29 20 56  47 41 20 73 63 72 65 65  | 2^24) VGA scree|
00008be0  6e 20 64 75 6d 70 2e 0a  20 2b 20 52 65 63 6f 67  |n dump.. + Recog|
00008bf0  6e 69 73 65 64 20 62 79  20 22 41 56 5f 56 4f 22  |nised by "AV_VO"|
00008c00  20 61 73 20 74 68 65 20  66 69 72 73 74 20 66 69  | as the first fi|
00008c10  76 65 20 62 79 74 65 73  20 69 6e 20 74 68 65 20  |ve bytes in the |
00008c20  66 69 6c 65 0a 20 2d 20  44 6f 63 75 6d 65 6e 74  |file. - Document|
00008c30  61 74 69 6f 6e 20 6e 65  76 65 72 20 73 65 65 6e  |ation never seen|
00008c40  0a 20 2d 20 50 69 78 65  6c 20 73 69 7a 65 20 61  |. - Pixel size a|
00008c50  73 73 75 6d 65 64 20 74  68 65 20 73 61 6d 65 20  |ssumed the same |
00008c60  61 73 20 4d 4f 44 45 20  31 33 20 28 34 35 20 70  |as MODE 13 (45 p|
00008c70  69 78 65 6c 73 20 70 65  72 20 69 6e 63 68 29 2e  |ixels per inch).|
00008c80  0a 0a 54 68 65 20 4d 61  63 50 61 69 6e 74 20 66  |..The MacPaint f|
00008c90  6f 72 6d 61 74 0a 20 50  72 6f 76 69 64 65 73 20  |ormat. Provides |
00008ca0  61 20 35 37 36 20 62 79  20 37 32 30 20 62 69 74  |a 576 by 720 bit|
00008cb0  6d 61 70 2c 20 72 75 6e  20 6c 65 6e 67 74 68 20  |map, run length |
00008cc0  63 6f 64 65 64 20 62 79  20 74 68 65 20 4d 61 63  |coded by the Mac|
00008cd0  27 73 20 22 50 61 63 6b  42 69 74 73 22 0a 20 61  |'s "PackBits". a|
00008ce0  6c 67 6f 72 69 74 68 6d  20 28 72 65 70 65 61 74  |lgorithm (repeat|
00008cf0  65 64 20 62 79 74 65 73  29 2e 0a 20 2d 20 52 65  |ed bytes).. - Re|
00008d00  63 6f 67 6e 69 73 65 64  20 62 79 20 22 50 4e 54  |cognised by "PNT|
00008d10  47 22 20 61 74 20 70 6f  73 69 74 69 6f 6e 20 36  |G" at position 6|
00008d20  35 20 69 6e 20 74 68 65  20 66 69 6c 65 2e 20 54  |5 in the file. T|
00008d30  68 69 73 20 6d 61 79 20  6f 6e 6c 79 20 72 65 6c  |his may only rel|
00008d40  61 74 65 20 74 6f 0a 20  20 20 66 69 6c 65 73 20  |ate to.   files |
00008d50  77 68 69 63 68 20 68 61  76 65 20 62 65 65 6e 20  |which have been |
00008d60  74 68 72 6f 75 67 68 20  61 20 70 72 6f 67 72 61  |through a progra|
00008d70  6d 20 63 61 6c 6c 65 64  20 22 4d 61 63 46 69 78  |m called "MacFix|
00008d80  22 2e 20 44 61 74 61 20  61 73 73 75 6d 65 64 20  |". Data assumed |
00008d90  74 6f 0a 20 20 20 73 74  61 72 74 20 61 74 20 70  |to.   start at p|
00008da0  6f 73 69 74 69 6f 6e 20  31 32 38 20 69 6e 20 74  |osition 128 in t|
00008db0  68 65 20 66 69 6c 65 2e  20 48 65 61 64 65 72 20  |he file. Header |
00008dc0  69 67 6e 6f 72 65 64 2e  0a 20 2d 20 4e 6f 20 72  |ignored.. - No r|
00008dd0  65 73 6f 6c 75 74 69 6f  6e 20 73 70 65 63 69 66  |esolution specif|
00008de0  69 65 64 2c 20 65 71 75  61 6c 20 74 6f 20 6d 6f  |ied, equal to mo|
00008df0  64 65 20 32 35 20 61 73  73 75 6d 65 64 0a 0a 54  |de 25 assumed..T|
00008e00  68 65 20 4d 61 63 20 50  49 43 54 32 20 66 6f 72  |he Mac PICT2 for|
00008e10  6d 61 74 20 28 50 49 43  54 20 65 78 74 65 6e 64  |mat (PICT extend|
00008e20  65 64 20 76 65 72 73 69  6f 6e 20 32 29 0a 20 50  |ed version 2). P|
00008e30  72 6f 76 69 64 65 73 20  61 6e 20 61 72 62 69 74  |rovides an arbit|
00008e40  61 72 79 20 73 69 7a 65  20 70 61 63 6b 65 64 20  |ary size packed |
00008e50  70 69 63 74 75 72 65 2c  20 72 75 6e 20 6c 65 6e  |picture, run len|
00008e60  67 74 68 20 63 6f 64 65  64 20 62 79 20 74 68 65  |gth coded by the|
00008e70  20 4d 61 63 27 73 0a 20  22 50 61 63 6b 42 69 74  | Mac's. "PackBit|
00008e80  73 22 20 61 6c 67 6f 72  69 74 68 6d 20 28 72 65  |s" algorithm (re|
00008e90  70 65 61 74 65 64 20 62  79 74 65 73 29 2e 0a 20  |peated bytes).. |
00008ea0  2b 20 52 65 63 6f 67 6e  69 73 65 64 20 62 79 20  |+ Recognised by |
00008eb0  6c 6f 6f 6b 69 6e 67 20  66 6f 72 20 74 68 65 20  |looking for the |
00008ec0  50 49 43 54 20 68 65 61  64 65 72 20 61 74 20 70  |PICT header at p|
00008ed0  6f 73 69 74 69 6f 6e 20  35 31 34 20 69 6e 20 74  |osition 514 in t|
00008ee0  68 65 20 66 69 6c 65 2e  0a 20 20 20 54 68 65 20  |he file..   The |
00008ef0  68 65 61 64 65 72 20 69  73 20 30 30 20 31 31 20  |header is 00 11 |
00008f00  30 32 20 46 46 20 30 43  20 30 30 20 46 46 20 46  |02 FF 0C 00 FF F|
00008f10  45 2e 0a 20 2d 20 44 6f  63 75 6d 65 6e 74 61 74  |E.. - Documentat|
00008f20  69 6f 6e 20 61 76 61 69  6c 61 62 6c 65 20 62 75  |ion available bu|
00008f30  74 20 6d 6f 73 74 6c 79  20 75 73 65 6c 65 73 73  |t mostly useless|
00008f40  20 28 69 74 20 61 73 73  75 6d 65 73 20 79 6f 75  | (it assumes you|
00008f50  20 61 72 65 20 61 62 6f  75 74 20 74 6f 0a 20 20  | are about to.  |
00008f60  20 63 61 6c 6c 20 51 75  69 63 6b 44 72 61 77 20  | call QuickDraw |
00008f70  72 6f 75 74 69 6e 65 73  20 2d 20 22 4e 6f 74 65  |routines - "Note|
00008f80  3a 20 66 6f 72 20 6d 61  78 69 6d 75 6d 20 73 61  |: for maximum sa|
00008f90  66 65 74 79 20 61 6e 64  20 63 6f 6e 76 65 6e 69  |fety and conveni|
00008fa0  65 6e 63 65 2c 20 6c 65  74 0a 20 20 20 51 75 69  |ence, let.   Qui|
00008fb0  63 6b 44 72 61 77 20 67  65 6e 65 72 61 74 65 20  |ckDraw generate |
00008fc0  61 6e 64 20 69 6e 74 65  72 70 72 65 74 20 79 6f  |and interpret yo|
00008fd0  75 72 20 70 69 63 74 75  72 65 73 2e 22 20 41 70  |ur pictures." Ap|
00008fe0  70 6c 65 20 66 61 69 6c  20 74 6f 20 64 65 73 63  |ple fail to desc|
00008ff0  72 69 62 65 0a 20 20 20  74 68 65 20 50 61 63 6b  |ribe.   the Pack|
00009000  42 69 74 73 20 61 6c 67  6f 72 69 74 68 6d 20 69  |Bits algorithm i|
00009010  6e 20 49 6e 73 69 64 65  20 4d 61 63 2e 2e 2e 29  |n Inside Mac...)|
00009020  0a 20 2d 20 50 49 43 54  20 69 73 20 74 68 65 20  |. - PICT is the |
00009030  6c 6f 6f 73 65 20 65 71  75 69 76 61 6c 65 6e 74  |loose equivalent|
00009040  20 6f 66 20 52 49 53 43  20 4f 53 20 44 72 61 77  | of RISC OS Draw|
00009050  20 66 69 6c 65 20 66 6f  72 6d 61 74 2c 20 62 75  | file format, bu|
00009060  74 20 77 69 74 68 6f 75  74 0a 20 20 20 74 68 65  |t without.   the|
00009070  20 65 78 70 6c 69 63 69  74 20 73 69 7a 69 6e 67  | explicit sizing|
00009080  20 6f 66 20 6f 62 6a 65  63 74 73 20 2d 20 66 6f  | of objects - fo|
00009090  72 20 50 49 43 54 2c 20  69 66 20 74 68 65 72 65  |r PICT, if there|
000090a0  20 69 73 20 61 6e 20 6f  62 6a 65 63 74 20 74 68  | is an object th|
000090b0  61 74 0a 20 20 20 79 6f  75 20 64 6f 6e 27 74 20  |at.   you don't |
000090c0  75 6e 64 65 72 73 74 61  6e 64 2c 20 74 68 65 72  |understand, ther|
000090d0  65 27 73 20 6e 6f 20 77  61 79 20 6f 66 20 73 6b  |e's no way of sk|
000090e0  69 70 70 69 6e 67 20 69  74 20 28 77 68 65 72 65  |ipping it (where|
000090f0  61 73 20 66 6f 72 20 44  72 61 77 2c 0a 20 20 20  |as for Draw,.   |
00009100  74 68 65 20 73 69 7a 65  20 6f 66 20 74 68 65 20  |the size of the |
00009110  6f 62 6a 65 63 74 20 69  73 20 73 70 65 63 69 66  |object is specif|
00009120  69 65 64 20 69 6e 20 61  6e 20 6f 62 6a 65 63 74  |ied in an object|
00009130  20 69 6e 64 65 70 2e 20  77 61 79 29 2e 20 41 70  | indep. way). Ap|
00009140  70 6c 65 0a 20 20 20 70  72 65 73 65 6e 74 20 61  |ple.   present a|
00009150  20 6c 61 72 67 65 20 74  61 62 6c 65 20 6f 66 20  | large table of |
00009160  74 68 65 20 73 69 7a 65  73 20 6f 66 20 74 68 65  |the sizes of the|
00009170  20 6f 62 6a 65 63 74 73  20 28 30 30 30 30 20 2d  | objects (0000 -|
00009180  20 46 46 46 46 29 20 77  68 69 63 68 20 69 73 0a  | FFFF) which is.|
00009190  20 20 20 6e 6f 74 20 69  6e 20 43 68 61 6e 67 65  |   not in Change|
000091a0  46 53 49 2e 20 43 6f 6e  73 65 71 75 65 6e 74 6c  |FSI. Consequentl|
000091b0  79 2c 20 69 66 20 43 68  61 6e 67 65 46 53 49 20  |y, if ChangeFSI |
000091c0  66 69 6e 64 73 20 61 6e  20 6f 62 6a 65 63 74 20  |finds an object |
000091d0  69 74 20 64 6f 65 73 6e  27 74 0a 20 20 20 6b 6e  |it doesn't.   kn|
000091e0  6f 77 20 61 62 6f 75 74  20 62 65 66 6f 72 65 20  |ow about before |
000091f0  74 68 65 20 70 69 63 74  75 72 65 2c 20 69 74 20  |the picture, it |
00009200  73 74 6f 70 73 2e 2e 2e  0a 20 2d 20 4f 6e 6c 79  |stops.... - Only|
00009210  20 50 61 63 6b 42 69 74  73 52 65 63 74 20 28 30  | PackBitsRect (0|
00009220  30 39 38 29 20 28 38 62  70 70 29 20 61 6e 64 20  |098) (8bpp) and |
00009230  44 69 72 65 63 74 42 69  74 73 52 65 63 74 20 28  |DirectBitsRect (|
00009240  30 30 39 41 29 20 28 32  34 2f 33 32 20 62 70 70  |009A) (24/32 bpp|
00009250  29 20 61 72 65 0a 20 20  20 61 6c 6c 6f 77 65 64  |) are.   allowed|
00009260  2e 0a 20 2b 20 43 68 61  6e 67 65 46 53 49 20 74  |.. + ChangeFSI t|
00009270  72 69 65 73 20 74 6f 20  73 6b 69 70 20 61 20 43  |ries to skip a C|
00009280  6c 69 70 20 28 30 30 30  31 29 20 72 65 67 69 6f  |lip (0001) regio|
00009290  6e 20 69 66 20 69 74 20  65 6e 63 6f 75 6e 74 65  |n if it encounte|
000092a0  72 73 20 69 74 2c 20 73  69 6e 63 65 20 69 74 0a  |rs it, since it.|
000092b0  20 20 20 69 73 20 68 61  72 64 20 74 6f 20 67 65  |   is hard to ge|
000092c0  74 20 74 68 65 20 4d 61  63 20 4f 53 20 74 6f 20  |t the Mac OS to |
000092d0  6d 61 6b 65 20 50 49 43  54 20 66 69 6c 65 73 20  |make PICT files |
000092e0  77 69 74 68 6f 75 74 20  61 20 63 6c 69 70 20 6f  |without a clip o|
000092f0  70 63 6f 64 65 20 69 6e  20 74 68 65 6d 2e 0a 20  |pcode in them.. |
00009300  2b 20 73 69 7a 65 20 6f  66 20 70 69 78 65 6c 20  |+ size of pixel |
00009310  73 70 65 63 69 66 69 65  64 2e 0a 20 2d 20 4f 6e  |specified.. - On|
00009320  6c 79 20 33 20 70 69 63  74 75 72 65 73 20 72 65  |ly 3 pictures re|
00009330  61 64 20 2d 20 73 69 6e  63 65 20 74 68 65 20 66  |ad - since the f|
00009340  6f 72 6d 61 74 20 69 73  20 76 65 72 79 20 63 6f  |ormat is very co|
00009350  6d 70 6c 69 63 61 74 65  64 20 28 65 2e 67 2e 20  |mplicated (e.g. |
00009360  74 68 65 20 73 69 7a 65  0a 20 20 20 6f 66 20 74  |the size.   of t|
00009370  68 69 6e 67 73 20 63 68  61 6e 67 65 20 69 66 20  |hings change if |
00009380  3e 32 35 30 20 72 6f 77  73 20 69 6e 20 74 68 65  |>250 rows in the|
00009390  20 70 69 63 74 75 72 65  21 29 20 74 68 69 73 20  | picture!) this |
000093a0  69 73 20 6e 6f 20 67 75  61 72 65 6e 74 65 65 20  |is no guarentee |
000093b0  74 68 61 74 0a 20 20 20  61 6e 79 74 68 69 6e 67  |that.   anything|
000093c0  20 65 6c 73 65 20 77 69  6c 6c 20 62 65 20 72 69  | else will be ri|
000093d0  67 68 74 2e 0a 0a 54 68  65 20 5a 53 6f 66 74 20  |ght...The ZSoft |
000093e0  2e 50 43 58 20 66 6f 72  6d 61 74 0a 20 55 73 65  |.PCX format. Use|
000093f0  64 20 62 79 20 50 43 20  50 61 69 6e 74 62 72 75  |d by PC Paintbru|
00009400  73 68 2e 20 55 73 75 61  6c 6c 79 20 61 20 34 20  |sh. Usually a 4 |
00009410  62 69 74 20 70 65 72 20  70 69 78 65 6c 20 69 6d  |bit per pixel im|
00009420  61 67 65 20 28 43 47 41  2c 20 45 47 41 2c 20 56  |age (CGA, EGA, V|
00009430  47 41 29 20 62 75 74 0a  20 63 61 6e 20 62 65 20  |GA) but. can be |
00009440  31 2d 38 20 62 69 74 73  20 70 65 72 20 70 69 78  |1-8 bits per pix|
00009450  65 6c 2e 0a 20 2d 20 52  65 63 6f 67 6e 69 73 65  |el.. - Recognise|
00009460  64 20 62 79 20 31 30 2c  5b 30 2c 32 2c 33 2c 34  |d by 10,[0,2,3,4|
00009470  2c 35 5d 2c 31 20 61 74  20 73 74 61 72 74 20 6f  |,5],1 at start o|
00009480  66 20 66 69 6c 65 2e 20  4f 72 20 62 79 20 6e 61  |f file. Or by na|
00009490  6d 65 20 50 43 58 2e 3c  66 6f 6f 3e 2e 20 4f 72  |me PCX.<foo>. Or|
000094a0  0a 20 20 20 62 79 20 74  79 70 65 20 26 36 39 37  |.   by type &697|
000094b0  2e 0a 20 2b 20 49 6e 74  65 6c 6c 69 67 65 6e 74  |.. + Intelligent|
000094c0  20 63 68 65 63 6b 20 66  6f 72 20 72 65 73 6f 6c  | check for resol|
000094d0  75 74 69 6f 6e 20 6f 66  20 74 68 65 20 44 41 43  |ution of the DAC|
000094e0  73 20 6f 6e 20 74 68 65  20 50 43 20 63 61 72 64  |s on the PC card|
000094f0  2e 20 55 73 65 20 2d 69  6e 66 6f 20 74 6f 0a 20  |. Use -info to. |
00009500  20 20 66 69 6e 64 20 6f  75 74 20 77 68 61 74 20  |  find out what |
00009510  43 68 61 6e 67 65 46 53  49 20 74 68 69 6e 6b 73  |ChangeFSI thinks|
00009520  20 69 74 20 69 73 2e 0a  20 2b 20 50 69 78 65 6c  | it is.. + Pixel|
00009530  20 73 69 7a 65 20 69 6e  66 6f 72 6d 61 74 69 6f  | size informatio|
00009540  6e 20 72 65 61 64 2e 20  59 6f 75 20 6d 61 79 20  |n read. You may |
00009550  6e 65 65 64 20 74 6f 20  73 74 6f 70 20 74 68 65  |need to stop the|
00009560  20 73 63 61 6c 69 6e 67  20 77 69 74 68 0a 20 20  | scaling with.  |
00009570  20 2d 6e 6f 73 69 7a 65  2c 20 73 69 6e 63 65 20  | -nosize, since |
00009580  69 74 73 20 6f 66 74 65  6e 20 77 72 6f 6e 67 2e  |its often wrong.|
00009590  0a 0a 54 68 65 20 52 49  58 20 53 6f 66 74 77 6f  |..The RIX Softwo|
000095a0  72 6b 73 20 43 6f 6c 6f  52 49 58 20 66 6f 72 6d  |rks ColoRIX form|
000095b0  61 74 0a 20 55 73 65 64  20 62 79 20 56 47 41 20  |at. Used by VGA |
000095c0  50 61 69 6e 74 2c 20 69  6d 61 67 65 20 65 78 74  |Paint, image ext|
000095d0  65 6e 73 69 6f 6e 20 2e  53 43 45 20 2e 2e 20 2e  |ension .SCE .. .|
000095e0  53 43 58 2e 20 34 20 6f  72 20 38 20 62 69 74 73  |SCX. 4 or 8 bits|
000095f0  20 70 65 72 20 70 69 78  65 6c 2e 0a 20 2d 20 52  | per pixel.. - R|
00009600  65 63 6f 67 6e 69 73 65  64 20 62 79 20 22 52 49  |ecognised by "RI|
00009610  58 33 22 20 61 74 20 73  74 61 72 74 20 6f 66 20  |X3" at start of |
00009620  66 69 6c 65 0a 20 2d 20  44 6f 63 75 6d 65 6e 74  |file. - Document|
00009630  61 74 69 6f 6e 20 6e 65  76 65 72 20 73 65 65 6e  |ation never seen|
00009640  0a 20 2d 20 4f 6e 6c 79  20 35 20 66 69 6c 65 73  |. - Only 5 files|
00009650  20 72 65 61 64 3a 20 43  68 61 6e 67 65 46 53 49  | read: ChangeFSI|
00009660  20 63 68 65 63 6b 73 20  74 6f 20 73 65 65 20 69  | checks to see i|
00009670  66 20 74 68 65 20 68 65  61 64 65 72 20 69 73 20  |f the header is |
00009680  74 68 65 20 73 61 6d 65  0a 20 20 20 61 73 20 74  |the same.   as t|
00009690  68 65 73 65 20 66 69 6c  65 73 20 61 6e 64 20 63  |hese files and c|
000096a0  6f 6d 70 6c 61 69 6e 73  20 6f 74 68 65 72 77 69  |omplains otherwi|
000096b0  73 65 2e 0a 20 2d 20 4e  6f 20 72 65 73 6f 6c 75  |se.. - No resolu|
000096c0  74 69 6f 6e 20 73 70 65  63 69 66 69 65 64 2c 20  |tion specified, |
000096d0  65 71 75 61 6c 20 74 6f  20 6d 6f 64 65 20 32 37  |equal to mode 27|
000096e0  20 61 73 73 75 6d 65 64  0a 0a 54 68 65 20 53 75  | assumed..The Su|
000096f0  6e 20 22 70 69 78 72 65  63 74 22 20 66 6f 72 6d  |n "pixrect" form|
00009700  61 74 0a 20 55 73 65 64  20 75 6e 64 65 72 20 53  |at. Used under S|
00009710  75 6e 4f 53 20 61 6e 64  20 61 6c 73 6f 20 75 6e  |unOS and also un|
00009720  64 65 72 20 58 31 31 2e  20 43 6f 6d 6d 6f 6e 6c  |der X11. Commonl|
00009730  79 20 31 20 6f 72 20 38  20 62 69 74 73 20 70 65  |y 1 or 8 bits pe|
00009740  72 20 70 69 78 65 6c 2c  20 62 75 74 20 75 70 0a  |r pixel, but up.|
00009750  20 74 6f 20 32 34 20 62  69 74 73 20 70 65 72 20  | to 24 bits per |
00009760  70 69 78 65 6c 20 63 61  6e 20 62 65 20 66 6f 75  |pixel can be fou|
00009770  6e 64 20 28 73 65 65 20  74 68 65 20 53 75 6e 20  |nd (see the Sun |
00009780  4e 65 57 53 20 72 65 6c  65 61 73 65 20 74 61 70  |NeWS release tap|
00009790  65 21 29 2e 0a 20 2b 20  52 65 63 6f 67 6e 69 73  |e!).. + Recognis|
000097a0  65 64 20 62 79 20 26 35  39 41 35 35 41 39 35 20  |ed by &59A55A95 |
000097b0  61 74 20 74 68 65 20 73  74 61 72 74 20 6f 66 20  |at the start of |
000097c0  74 68 65 20 66 69 6c 65  2e 0a 20 2d 20 4e 6f 20  |the file.. - No |
000097d0  72 65 73 6f 6c 75 74 69  6f 6e 20 73 70 65 63 69  |resolution speci|
000097e0  66 69 65 64 2c 20 65 71  75 61 6c 20 74 6f 20 6d  |fied, equal to m|
000097f0  6f 64 65 20 32 37 20 61  73 73 75 6d 65 64 0a 20  |ode 27 assumed. |
00009800  2d 20 53 75 6e 20 64 69  64 6e 27 74 20 73 70 65  |- Sun didn't spe|
00009810  63 69 66 79 20 74 68 65  20 70 69 78 65 6c 20 6f  |cify the pixel o|
00009820  72 64 65 72 69 6e 67 20  6f 66 20 32 34 20 62 69  |rdering of 24 bi|
00009830  74 20 70 65 72 20 70 69  78 65 6c 20 69 6d 61 67  |t per pixel imag|
00009840  65 73 3a 20 6d 61 6e 79  0a 20 20 20 61 73 73 75  |es: many.   assu|
00009850  6d 65 20 52 47 42 20 77  68 65 6e 20 69 74 20 77  |me RGB when it w|
00009860  61 73 20 61 63 74 75 61  6c 6c 79 20 42 47 52 2e  |as actually BGR.|
00009870  20 43 68 61 6e 67 65 20  62 79 74 65 20 26 31 37  | Change byte &17|
00009880  20 69 6e 20 74 68 65 20  53 75 6e 0a 20 20 20 72  | in the Sun.   r|
00009890  61 73 74 65 72 66 69 6c  65 20 62 65 74 77 65 65  |asterfile betwee|
000098a0  6e 20 31 20 61 6e 64 20  33 20 69 66 20 79 6f 75  |n 1 and 3 if you|
000098b0  20 68 61 76 65 20 61 20  70 72 6f 62 6c 65 6d 2e  | have a problem.|
000098c0  0a 0a 54 68 65 20 22 70  62 6d 22 20 27 70 6f 72  |..The "pbm" 'por|
000098d0  74 61 62 6c 65 20 62 69  74 6d 61 70 27 20 66 69  |table bitmap' fi|
000098e0  6c 65 20 66 6f 72 6d 61  74 0a 20 55 73 65 64 20  |le format. Used |
000098f0  62 79 20 74 68 65 20 22  50 42 4d 2d 50 4c 55 53  |by the "PBM-PLUS|
00009900  22 20 74 6f 6f 6c 6b 69  74 20 28 6d 61 69 6e 6c  |" toolkit (mainl|
00009910  79 20 55 6e 69 78 29 20  62 79 20 4a 65 66 20 50  |y Unix) by Jef P|
00009920  6f 73 6b 61 6e 7a 65 72  2e 20 31 2d 32 34 20 62  |oskanzer. 1-24 b|
00009930  69 74 73 0a 20 70 65 72  20 70 69 78 65 6c 20 28  |its. per pixel (|
00009940  6d 6f 72 65 20 63 61 6e  20 62 65 20 73 70 65 63  |more can be spec|
00009950  69 66 69 65 64 20 69 6e  20 74 68 65 20 66 6f 72  |ified in the for|
00009960  6d 61 74 20 62 75 74 20  43 68 61 6e 67 65 46 53  |mat but ChangeFS|
00009970  49 20 63 61 6e 6e 6f 74  20 72 65 61 64 0a 20 74  |I cannot read. t|
00009980  68 65 6d 29 2e 20 43 68  61 6e 67 65 46 53 49 20  |hem). ChangeFSI |
00009990  63 61 6e 20 6f 6e 6c 79  20 72 65 61 64 20 74 68  |can only read th|
000099a0  65 20 22 52 41 57 42 49  54 53 22 20 66 6f 72 6d  |e "RAWBITS" form|
000099b0  61 74 73 20 28 69 74 20  63 61 6e 20 77 72 69 74  |ats (it can writ|
000099c0  65 20 61 6c 6c 20 6f 66  0a 20 74 68 65 20 70 62  |e all of. the pb|
000099d0  6d 20 66 6f 72 6d 61 74  73 29 2e 0a 20 2b 20 52  |m formats).. + R|
000099e0  65 63 6f 67 6e 69 73 65  64 20 62 79 20 50 34 2f  |ecognised by P4/|
000099f0  50 35 2f 50 36 20 61 74  20 73 74 61 72 74 20 6f  |P5/P6 at start o|
00009a00  66 20 66 69 6c 65 2e 0a  20 2b 20 57 72 69 74 61  |f file.. + Writa|
00009a10  62 6c 65 20 62 79 20 43  68 61 6e 67 65 46 53 49  |ble by ChangeFSI|
00009a20  0a 20 2d 20 4e 6f 20 72  65 73 6f 6c 75 74 69 6f  |. - No resolutio|
00009a30  6e 20 73 70 65 63 69 66  69 65 64 2c 20 65 71 75  |n specified, equ|
00009a40  61 6c 20 74 6f 20 6d 6f  64 65 20 32 37 20 61 73  |al to mode 27 as|
00009a50  73 75 6d 65 64 0a 0a 54  68 65 20 55 4e 49 58 20  |sumed..The UNIX |
00009a60  22 72 6c 65 22 20 66 6f  72 6d 61 74 0a 20 55 73  |"rle" format. Us|
00009a70  65 64 20 62 79 20 61 20  70 72 6f 67 72 61 6d 20  |ed by a program |
00009a80  63 61 6c 6c 65 64 20 22  73 76 66 62 22 20 74 6f  |called "svfb" to|
00009a90  20 73 61 76 65 20 74 68  65 20 63 6f 6e 74 65 6e  | save the conten|
00009aa0  74 73 20 6f 66 20 6c 61  72 67 65 20 66 72 61 6d  |ts of large fram|
00009ab0  65 0a 20 62 75 66 66 65  72 73 2c 20 63 68 65 63  |e. buffers, chec|
00009ac0  6b 65 64 20 77 69 74 68  20 66 6f 75 72 20 69 6d  |ked with four im|
00009ad0  61 67 65 73 20 61 74 20  32 34 20 62 69 74 73 20  |ages at 24 bits |
00009ae0  70 65 72 20 70 69 78 65  6c 2e 0a 20 2b 20 52 65  |per pixel.. + Re|
00009af0  63 6f 67 6e 69 73 65 64  20 62 79 20 26 43 43 35  |cognised by &CC5|
00009b00  32 20 61 74 20 74 68 65  20 73 74 61 72 74 20 6f  |2 at the start o|
00009b10  66 20 74 68 65 20 66 69  6c 65 2e 0a 20 2d 20 4e  |f the file.. - N|
00009b20  6f 20 72 65 73 6f 6c 75  74 69 6f 6e 20 73 70 65  |o resolution spe|
00009b30  63 69 66 69 65 64 2c 20  65 71 75 61 6c 20 74 6f  |cified, equal to|
00009b40  20 6d 6f 64 65 20 32 37  20 61 73 73 75 6d 65 64  | mode 27 assumed|
00009b50  0a 0a 54 68 65 20 54 72  75 65 56 69 73 69 6f 6e  |..The TrueVision|
00009b60  20 54 61 72 67 61 20 66  6f 72 6d 61 74 0a 20 55  | Targa format. U|
00009b70  73 65 64 20 62 79 20 54  72 75 65 56 69 73 69 6f  |sed by TrueVisio|
00009b80  6e 20 66 6f 72 20 56 69  73 74 61 20 62 6f 61 72  |n for Vista boar|
00009b90  64 73 2e 20 55 70 20 74  6f 20 33 32 20 62 69 74  |ds. Up to 32 bit|
00009ba0  73 20 70 65 72 20 70 69  78 65 6c 2e 0a 20 2d 20  |s per pixel.. - |
00009bb0  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 73 75  |Recognised by su|
00009bc0  66 66 69 78 20 5f 54 47  41 20 6f 72 20 5f 56 44  |ffix _TGA or _VD|
00009bd0  41 20 6f 6e 20 74 68 65  20 6e 61 6d 65 2e 20 4f  |A on the name. O|
00009be0  72 20 62 79 20 74 79 70  65 20 26 36 39 64 2e 0a  |r by type &69d..|
00009bf0  20 2d 20 4f 6e 6c 79 20  75 6e 63 6f 6d 70 72 65  | - Only uncompre|
00009c00  73 73 65 64 20 66 6f 72  6d 61 74 73 20 72 65 61  |ssed formats rea|
00009c10  64 61 62 6c 65 2e 0a 20  2d 20 4f 6e 6c 79 20 38  |dable.. - Only 8|
00009c20  20 61 6e 64 20 31 36 20  62 69 74 20 70 65 72 20  | and 16 bit per |
00009c30  70 69 78 65 6c 20 66 6f  72 6d 61 74 73 20 74 65  |pixel formats te|
00009c40  73 74 65 64 2e 0a 0a 54  68 65 20 22 46 6c 65 78  |sted...The "Flex|
00009c50  69 62 6c 65 20 49 6d 61  67 65 20 54 72 61 6e 73  |ible Image Trans|
00009c60  70 6f 72 74 20 53 79 73  74 65 6d 22 20 28 46 49  |port System" (FI|
00009c70  54 53 29 20 66 6f 72 6d  61 74 0a 20 55 73 65 64  |TS) format. Used|
00009c80  20 66 6f 72 20 61 73 74  72 6f 6e 6f 6d 69 63 61  | for astronomica|
00009c90  6c 20 64 61 74 61 2e 20  55 70 20 74 6f 20 31 36  |l data. Up to 16|
00009ca0  20 62 69 74 73 20 70 65  72 20 70 69 78 65 6c 20  | bits per pixel |
00009cb0  63 6f 6d 70 6f 6e 65 6e  74 2e 0a 20 2b 20 52 65  |component.. + Re|
00009cc0  63 6f 67 6e 69 73 65 64  20 62 79 20 22 53 49 4d  |cognised by "SIM|
00009cd0  50 4c 45 22 20 61 74 20  74 68 65 20 73 74 61 72  |PLE" at the star|
00009ce0  74 20 6f 66 20 74 68 65  20 66 69 6c 65 2e 0a 20  |t of the file.. |
00009cf0  2d 20 4f 6e 6c 79 20 38  20 61 6e 64 20 31 36 20  |- Only 8 and 16 |
00009d00  62 69 74 20 70 65 72 20  70 69 78 65 6c 20 63 6f  |bit per pixel co|
00009d10  6d 70 6f 6e 65 6e 74 20  66 6f 72 6d 61 74 73 20  |mponent formats |
00009d20  74 65 73 74 65 64 2e 0a  20 2d 20 4f 6e 6c 79 20  |tested.. - Only |
00009d30  74 77 6f 20 66 69 6c 65  73 20 65 76 65 72 20 73  |two files ever s|
00009d40  65 65 6e 21 0a 20 2d 20  4e 6f 20 72 65 73 6f 6c  |een!. - No resol|
00009d50  75 74 69 6f 6e 20 73 70  65 63 69 66 69 65 64 2c  |ution specified,|
00009d60  20 65 71 75 61 6c 20 74  6f 20 6d 6f 64 65 20 32  | equal to mode 2|
00009d70  37 20 61 73 73 75 6d 65  64 0a 0a 54 68 65 20 49  |7 assumed..The I|
00009d80  72 6c 61 6d 20 69 6e 73  74 72 75 6d 65 6e 74 73  |rlam instruments|
00009d90  20 63 6f 6c 6f 75 72 20  73 63 61 6e 6e 65 72 20  | colour scanner |
00009da0  66 6f 72 6d 61 74 0a 20  32 34 20 62 69 74 20 70  |format. 24 bit p|
00009db0  65 72 20 70 69 78 65 6c  20 66 72 6f 6d 20 63 6f  |er pixel from co|
00009dc0  6c 6f 75 72 20 73 63 61  6e 6e 65 72 2e 0a 20 2b  |lour scanner.. +|
00009dd0  20 52 65 63 6f 67 6e 69  73 65 64 20 62 79 20 49  | Recognised by I|
00009de0  72 6c 61 6d 20 32 34 20  61 74 20 74 68 65 20 73  |rlam 24 at the s|
00009df0  74 61 72 74 20 6f 66 20  74 68 65 20 66 69 6c 65  |tart of the file|
00009e00  2e 0a 20 2b 20 57 72 69  74 61 62 6c 65 20 62 79  |.. + Writable by|
00009e10  20 43 68 61 6e 67 65 46  53 49 0a 20 2d 20 4e 6f  | ChangeFSI. - No|
00009e20  20 72 65 73 6f 6c 75 74  69 6f 6e 20 73 70 65 63  | resolution spec|
00009e30  69 66 69 65 64 2c 20 65  71 75 61 6c 20 74 6f 20  |ified, equal to |
00009e40  6d 6f 64 65 20 32 37 20  61 73 73 75 6d 65 64 0a  |mode 27 assumed.|
00009e50  20 2d 20 6d 61 79 20 6e  65 65 64 20 67 61 6d 6d  | - may need gamm|
00009e60  61 20 63 6f 72 72 65 63  74 69 6f 6e 0a 0a 54 68  |a correction..Th|
00009e70  65 20 49 72 6c 61 6d 20  69 6e 73 74 72 75 6d 65  |e Irlam instrume|
00009e80  6e 74 73 20 59 55 56 20  34 31 31 20 63 6f 6c 6f  |nts YUV 411 colo|
00009e90  75 72 20 76 69 64 65 6f  20 66 6f 72 6d 61 74 0a  |ur video format.|
00009ea0  20 37 20 62 69 74 73 20  59 2c 20 75 70 20 74 6f  | 7 bits Y, up to|
00009eb0  20 37 20 62 69 74 73 20  55 20 61 6e 64 20 56 2e  | 7 bits U and V.|
00009ec0  0a 20 2b 20 52 65 63 6f  67 6e 69 73 65 64 20 62  |. + Recognised b|
00009ed0  79 20 49 72 6c 61 6d 20  59 55 56 20 34 31 31 20  |y Irlam YUV 411 |
00009ee0  61 74 20 74 68 65 20 73  74 61 72 74 20 6f 66 20  |at the start of |
00009ef0  74 68 65 20 66 69 6c 65  0a 20 2d 20 6e 6f 20 72  |the file. - no r|
00009f00  65 73 6f 6c 75 74 69 6f  6e 20 73 70 65 63 69 66  |esolution specif|
00009f10  69 65 64 2c 20 65 71 75  61 6c 20 74 6f 20 6d 6f  |ied, equal to mo|
00009f20  64 65 20 32 37 20 61 73  73 75 6d 65 64 0a 0a 54  |de 27 assumed..T|
00009f30  68 65 20 4a 50 45 47 20  27 4a 46 49 46 27 20 46  |he JPEG 'JFIF' F|
00009f40  69 6c 65 20 49 6e 74 65  72 63 68 61 6e 67 65 20  |ile Interchange |
00009f50  46 6f 72 6d 61 74 0a 20  55 70 20 74 6f 20 32 34  |Format. Up to 24|
00009f60  20 62 69 74 73 20 52 2c  47 2c 42 2c 20 63 6f 6d  | bits R,G,B, com|
00009f70  70 72 65 73 73 65 64 20  62 79 20 74 68 65 20 4a  |pressed by the J|
00009f80  50 45 47 20 63 6f 6d 70  72 65 73 73 69 6f 6e 20  |PEG compression |
00009f90  73 79 73 74 65 6d 2e 0a  20 2b 20 52 65 63 6f 67  |system.. + Recog|
00009fa0  6e 69 73 65 64 20 62 79  20 4a 46 49 46 20 61 74  |nised by JFIF at|
00009fb0  20 70 6f 73 69 74 69 6f  6e 20 36 20 69 6e 20 74  | position 6 in t|
00009fc0  68 65 20 66 69 6c 65 20  28 79 6f 75 20 6d 61 79  |he file (you may|
00009fd0  20 68 61 76 65 20 74 6f  0a 20 20 20 63 75 74 20  | have to.   cut |
00009fe0  68 65 61 64 65 72 73 20  6f 66 66 20 66 69 6c 65  |headers off file|
00009ff0  73 2c 20 70 61 72 74 69  63 75 6c 61 72 6c 79 20  |s, particularly |
0000a000  69 66 20 74 68 65 79 20  61 72 65 20 66 72 6f 6d  |if they are from|
0000a010  20 4d 61 63 73 29 2e 0a  20 2b 20 4f 66 74 65 6e  | Macs).. + Often|
0000a020  20 68 69 67 68 6c 79 20  63 6f 6d 70 72 65 73 73  | highly compress|
0000a030  65 64 0a 20 2b 20 49 66  20 43 68 61 6e 67 65 46  |ed. + If ChangeF|
0000a040  53 49 24 43 61 63 68 65  20 69 73 20 6c 61 72 67  |SI$Cache is larg|
0000a050  65 20 65 6e 6f 75 67 68  20 28 62 69 67 67 65 72  |e enough (bigger|
0000a060  20 74 68 61 6e 20 74 68  65 20 66 69 6c 65 29 2c  | than the file),|
0000a070  20 74 68 65 6e 20 68 69  67 68 0a 20 20 20 73 70  | then high.   sp|
0000a080  65 65 64 20 72 6f 75 74  69 6e 65 73 20 61 72 65  |eed routines are|
0000a090  20 75 73 65 64 20 74 6f  20 64 65 63 6f 6d 70 72  | used to decompr|
0000a0a0  65 73 73 2e 20 4f 74 68  65 72 77 69 73 65 3a 0a  |ess. Otherwise:.|
0000a0b0  20 2d 20 43 68 61 6e 67  65 46 53 49 20 63 61 6c  | - ChangeFSI cal|
0000a0c0  6c 73 20 61 20 64 6a 70  65 67 20 72 6f 75 74 69  |ls a djpeg routi|
0000a0d0  6e 65 2e 20 54 68 69 73  20 63 61 6e 20 62 65 20  |ne. This can be |
0000a0e0  6f 6e 20 74 68 65 20 52  75 6e 24 50 61 74 68 2c  |on the Run$Path,|
0000a0f0  20 69 6d 70 6c 65 6d 65  6e 74 65 64 0a 20 20 20  | implemented.   |
0000a100  61 73 20 61 6e 20 41 6c  69 61 73 20 28 69 6e 20  |as an Alias (in |
0000a110  77 68 69 63 68 20 63 61  73 65 20 69 74 20 2a 6d  |which case it *m|
0000a120  75 73 74 2a 20 75 73 65  20 57 69 6d 70 54 61 73  |ust* use WimpTas|
0000a130  6b 20 74 6f 20 73 74 61  72 74 29 20 6f 72 20 66  |k to start) or f|
0000a140  6f 75 6e 64 0a 20 20 20  69 6e 73 69 64 65 20 43  |ound.   inside C|
0000a150  68 61 6e 67 65 46 53 49  24 44 69 72 20 69 66 20  |hangeFSI$Dir if |
0000a160  61 6c 6c 20 65 6c 73 65  20 66 61 69 6c 73 2e 20  |all else fails. |
0000a170  63 6a 70 65 67 20 28 74  68 65 20 63 6f 6d 70 72  |cjpeg (the compr|
0000a180  65 73 73 6f 72 29 20 69  73 20 61 6c 73 6f 0a 20  |essor) is also. |
0000a190  20 20 61 76 61 69 6c 61  62 6c 65 20 69 6e 73 69  |  available insi|
0000a1a0  64 65 20 43 68 61 6e 67  65 46 53 49 24 44 69 72  |de ChangeFSI$Dir|
0000a1b0  20 2d 20 79 6f 75 20 77  69 6c 6c 20 6e 65 65 64  | - you will need|
0000a1c0  20 74 6f 20 63 6f 6e 76  65 72 74 20 74 68 65 20  | to convert the |
0000a1d0  69 6d 61 67 65 20 74 6f  0a 20 20 20 50 36 20 66  |image to.   P6 f|
0000a1e0  6f 72 6d 61 74 20 62 65  66 6f 72 65 20 69 74 20  |ormat before it |
0000a1f0  63 61 6e 20 62 65 20 63  6f 6d 70 72 65 73 73 65  |can be compresse|
0000a200  64 2e 20 44 6a 70 65 67  20 61 6e 64 20 63 6a 70  |d. Djpeg and cjp|
0000a210  65 67 20 61 72 65 20 62  79 20 74 68 65 0a 20 20  |eg are by the.  |
0000a220  20 50 44 20 4a 50 45 47  20 67 72 6f 75 70 2e 0a  | PD JPEG group..|
0000a230  20 2d 20 2e 2e 2e 20 61  6e 64 20 74 68 65 72 65  | - ... and there|
0000a240  66 6f 72 65 20 73 6c 6f  77 2e 20 4e 65 65 64 73  |fore slow. Needs|
0000a250  20 61 20 6c 6f 74 20 6f  66 20 73 70 61 63 65 20  | a lot of space |
0000a260  69 6e 20 3c 57 69 6d 70  24 53 63 72 61 70 3e 2e  |in <Wimp$Scrap>.|
0000a270  0a 20 2d 20 6e 6f 20 72  65 73 6f 6c 75 74 69 6f  |. - no resolutio|
0000a280  6e 20 73 70 65 63 69 66  69 65 64 2c 20 65 71 75  |n specified, equ|
0000a290  61 6c 20 74 6f 20 6d 6f  64 65 20 32 37 20 61 73  |al to mode 27 as|
0000a2a0  73 75 6d 65 64 0a 0a 3e  3e 20 54 68 65 20 66 6f  |sumed..>> The fo|
0000a2b0  6c 6c 6f 77 69 6e 67 20  66 69 6c 65 20 66 6f 72  |llowing file for|
0000a2c0  6d 61 74 73 20 61 72 65  20 6f 6e 6c 79 20 72 65  |mats are only re|
0000a2d0  63 6f 67 6e 69 73 65 64  20 62 79 20 74 68 65 69  |cognised by thei|
0000a2e0  72 20 6e 61 6d 65 73 2e  0a 0a 41 6e 20 75 6e 6b  |r names...An unk|
0000a2f0  6e 6f 77 6e 20 50 43 20  2e 44 53 50 20 66 6f 72  |nown PC .DSP for|
0000a300  6d 61 74 0a 20 45 78 70  65 72 69 6d 65 6e 74 61  |mat. Experimenta|
0000a310  6c 6c 79 20 64 65 74 65  72 6d 69 6e 65 64 20 74  |lly determined t|
0000a320  68 61 74 20 69 74 20 68  6f 6c 64 73 20 61 20 36  |hat it holds a 6|
0000a330  34 30 20 62 79 20 33 35  30 20 45 47 41 20 70 69  |40 by 350 EGA pi|
0000a340  63 74 75 72 65 20 61 74  20 34 20 62 69 74 73 0a  |cture at 4 bits.|
0000a350  20 70 65 72 20 70 69 78  65 6c 2e 20 43 68 61 6e  | per pixel. Chan|
0000a360  67 65 46 53 49 20 22 6b  6e 6f 77 73 22 20 74 68  |geFSI "knows" th|
0000a370  65 20 64 65 66 61 75 6c  74 20 45 47 41 20 70 61  |e default EGA pa|
0000a380  6c 65 74 74 65 20 28 66  72 6f 6d 20 49 42 4d 20  |lette (from IBM |
0000a390  6c 69 74 65 72 61 74 75  72 65 29 2e 0a 20 2d 20  |literature).. - |
0000a3a0  52 65 63 6f 67 6e 69 73  65 64 20 62 79 20 62 65  |Recognised by be|
0000a3b0  69 6e 67 20 69 6e 20 61  20 64 69 72 65 63 74 6f  |ing in a directo|
0000a3c0  72 79 20 22 44 53 50 22  0a 20 2d 20 44 6f 63 75  |ry "DSP". - Docu|
0000a3d0  6d 65 6e 74 61 74 69 6f  6e 20 6e 65 76 65 72 20  |mentation never |
0000a3e0  73 65 65 6e 0a 20 2d 20  4e 6f 20 72 65 73 6f 6c  |seen. - No resol|
0000a3f0  75 74 69 6f 6e 20 73 70  65 63 69 66 69 65 64 2c  |ution specified,|
0000a400  20 65 71 75 61 6c 20 74  6f 20 6d 6f 64 65 20 32  | equal to mode 2|
0000a410  37 20 61 73 73 75 6d 65  64 0a 20 2d 20 4f 6e 6c  |7 assumed. - Onl|
0000a420  79 20 74 77 6f 20 65 78  61 6d 70 6c 65 73 20 72  |y two examples r|
0000a430  65 61 64 28 21 29 0a 0a  54 68 65 20 51 52 54 20  |ead(!)..The QRT |
0000a440  2e 72 61 77 20 66 6f 72  6d 61 74 0a 20 4f 75 74  |.raw format. Out|
0000a450  70 75 74 20 66 72 6f 6d  20 53 74 65 76 65 20 4b  |put from Steve K|
0000a460  6f 72 65 6e 27 73 20 70  75 62 6c 69 63 20 64 6f  |oren's public do|
0000a470  6d 61 69 6e 20 72 61 79  20 74 72 61 63 65 72 3a  |main ray tracer:|
0000a480  20 61 72 62 69 74 72 61  72 79 20 73 69 7a 65 20  | arbitrary size |
0000a490  69 6e 20 32 5e 32 34 0a  20 63 6f 6c 6f 75 72 73  |in 2^24. colours|
0000a4a0  2c 20 75 6e 63 6f 6d 70  72 65 73 73 65 64 2e 20  |, uncompressed. |
0000a4b0  44 6f 63 75 6d 65 6e 74  61 74 69 6f 6e 20 70 61  |Documentation pa|
0000a4c0  72 74 20 6f 66 20 51 52  54 2e 0a 20 2d 20 52 65  |rt of QRT.. - Re|
0000a4d0  63 6f 67 6e 69 73 65 64  20 62 79 20 74 68 65 20  |cognised by the |
0000a4e0  6e 61 6d 65 20 65 6e 64  69 6e 67 20 22 2e 52 61  |name ending ".Ra|
0000a4f0  77 22 2e 20 4f 72 20 62  79 20 74 79 70 65 20 26  |w". Or by type &|
0000a500  36 39 38 2e 0a 20 2d 20  4e 6f 20 72 65 73 6f 6c  |698.. - No resol|
0000a510  75 74 69 6f 6e 20 73 70  65 63 69 66 69 65 64 2c  |ution specified,|
0000a520  20 65 71 75 61 6c 20 74  6f 20 6d 6f 64 65 20 32  | equal to mode 2|
0000a530  37 20 61 73 73 75 6d 65  64 0a 0a 54 68 65 20 4d  |7 assumed..The M|
0000a540  54 56 20 70 69 63 2e 20  66 6f 72 6d 61 74 0a 20  |TV pic. format. |
0000a550  4f 75 74 70 75 74 20 66  72 6f 6d 20 4d 61 72 6b  |Output from Mark|
0000a560  20 54 65 72 72 65 6e 63  65 20 56 61 6e 64 65 57  | Terrence VandeW|
0000a570  65 74 74 65 72 69 6e 67  20 70 75 62 6c 69 63 20  |ettering public |
0000a580  64 6f 6d 61 69 6e 20 72  61 79 20 74 72 61 63 65  |domain ray trace|
0000a590  72 20 61 72 62 69 74 72  61 72 79 0a 20 73 69 7a  |r arbitrary. siz|
0000a5a0  65 20 69 6e 20 32 5e 32  34 20 63 6f 6c 6f 75 72  |e in 2^24 colour|
0000a5b0  73 2c 20 75 6e 63 6f 6d  70 72 65 73 73 65 64 2e  |s, uncompressed.|
0000a5c0  20 44 6f 63 75 6d 65 6e  74 61 74 69 6f 6e 20 70  | Documentation p|
0000a5d0  61 72 74 20 6f 66 20 4d  54 56 2e 20 41 6c 73 6f  |art of MTV. Also|
0000a5e0  20 75 73 65 64 20 62 79  0a 20 22 52 61 79 53 68  | used by. "RaySh|
0000a5f0  61 64 65 22 2e 0a 20 2d  20 52 65 63 6f 67 6e 69  |ade".. - Recogni|
0000a600  73 65 64 20 62 79 20 62  65 69 6e 67 20 69 6e 20  |sed by being in |
0000a610  61 20 64 69 72 65 63 74  6f 72 79 20 22 50 69 63  |a directory "Pic|
0000a620  2e 22 2e 20 4f 72 20 62  79 20 74 79 70 65 20 26  |.". Or by type &|
0000a630  36 39 39 2e 0a 20 2d 20  4e 6f 20 72 65 73 6f 6c  |699.. - No resol|
0000a640  75 74 69 6f 6e 20 73 70  65 63 69 66 69 65 64 2c  |ution specified,|
0000a650  20 65 71 75 61 6c 20 74  6f 20 6d 6f 64 65 20 32  | equal to mode 2|
0000a660  37 20 61 73 73 75 6d 65  64 0a 0a 54 68 65 20 52  |7 assumed..The R|
0000a670  54 20 69 6d 61 67 65 2e  20 66 6f 72 6d 61 74 0a  |T image. format.|
0000a680  20 4f 75 74 70 75 74 20  66 72 6f 6d 20 22 52 54  | Output from "RT|
0000a690  22 2c 20 61 20 70 72 69  76 61 74 65 20 72 61 79  |", a private ray|
0000a6a0  20 74 72 61 63 65 72 20  62 79 20 42 72 69 61 6e  | tracer by Brian|
0000a6b0  20 44 20 57 61 74 74 28  3f 29 20 61 72 62 69 74  | D Watt(?) arbit|
0000a6c0  72 61 72 79 20 73 69 7a  65 20 69 6e 0a 20 32 5e  |rary size in. 2^|
0000a6d0  32 34 20 63 6f 6c 6f 75  72 73 2c 20 72 75 6e 20  |24 colours, run |
0000a6e0  6c 65 6e 67 74 68 20 65  6e 63 6f 64 65 64 2e 0a  |length encoded..|
0000a6f0  20 2d 20 52 65 63 6f 67  6e 69 73 65 64 20 62 79  | - Recognised by|
0000a700  20 62 65 69 6e 67 20 69  6e 20 61 20 64 69 72 65  | being in a dire|
0000a710  63 74 6f 72 79 20 22 49  6d 61 67 65 2e 22 0a 20  |ctory "Image.". |
0000a720  2d 20 4e 6f 20 72 65 73  6f 6c 75 74 69 6f 6e 20  |- No resolution |
0000a730  73 70 65 63 69 66 69 65  64 2c 20 65 71 75 61 6c  |specified, equal|
0000a740  20 74 6f 20 6d 6f 64 65  20 32 37 20 61 73 73 75  | to mode 27 assu|
0000a750  6d 65 64 0a 0a 46 6f 72  20 6d 61 6e 79 20 6f 66  |med..For many of|
0000a760  20 74 68 65 73 65 20 66  6f 72 6d 61 74 73 2c 20  | these formats, |
0000a770  65 73 70 65 63 69 61 6c  6c 79 20 74 68 65 20 75  |especially the u|
0000a780  6e 63 6f 6d 70 72 65 73  73 65 64 20 6f 6e 65 73  |ncompressed ones|
0000a790  2c 20 73 65 74 74 69 6e  67 20 74 68 65 0a 76 61  |, setting the.va|
0000a7a0  72 69 61 62 6c 65 20 22  43 68 61 6e 67 65 46 53  |riable "ChangeFS|
0000a7b0  49 24 43 61 63 68 65 22  20 74 6f 20 74 68 65 20  |I$Cache" to the |
0000a7c0  6e 75 6d 62 65 72 20 6f  66 20 62 79 74 65 73 20  |number of bytes |
0000a7d0  6f 66 20 74 65 6d 70 6f  72 61 72 79 20 6d 65 6d  |of temporary mem|
0000a7e0  6f 72 79 20 79 6f 75 0a  77 69 73 68 20 74 68 65  |ory you.wish the|
0000a7f0  20 70 72 6f 67 72 61 6d  20 74 6f 20 75 73 65 20  | program to use |
0000a800  77 69 6c 6c 20 73 70 65  65 64 20 75 70 20 72 65  |will speed up re|
0000a810  61 64 69 6e 67 20 74 68  65 20 69 6e 66 6f 72 6d  |ading the inform|
0000a820  61 74 69 6f 6e 2e 20 54  68 65 20 64 65 66 61 75  |ation. The defau|
0000a830  6c 74 0a 69 73 20 34 39  31 35 32 20 62 79 74 65  |lt.is 49152 byte|
0000a840  73 2e 20 46 6f 72 20 65  78 61 6d 70 6c 65 20 22  |s. For example "|
0000a850  2a 73 65 74 20 43 68 61  6e 67 65 46 53 49 24 43  |*set ChangeFSI$C|
0000a860  61 63 68 65 20 38 30 6b  22 2e 20 46 6f 72 20 74  |ache 80k". For t|
0000a870  68 6f 73 65 20 77 6f 72  72 69 65 64 0a 61 62 6f  |hose worried.abo|
0000a880  75 74 20 73 70 65 65 64  2c 20 74 68 65 20 70 72  |ut speed, the pr|
0000a890  6f 67 72 61 6d 20 77 69  6c 6c 20 67 6f 20 66 61  |ogram will go fa|
0000a8a0  73 74 65 72 20 69 66 3a  0a 0a 20 2d 20 79 6f 75  |ster if:.. - you|
0000a8b0  20 75 73 65 20 2d 6e 6f  73 63 61 6c 65 20 61 6e  | use -noscale an|
0000a8c0  64 20 6b 65 65 70 20 31  3a 31 20 72 61 74 69 6f  |d keep 1:1 ratio|
0000a8d0  73 20 28 64 6f 6e 27 74  20 73 70 65 63 69 66 79  |s (don't specify|
0000a8e0  20 74 68 65 6d 29 0a 20  20 20 28 61 6c 74 68 6f  | them).   (altho|
0000a8f0  75 67 68 20 2d 6e 6f 73  69 7a 65 20 61 6e 64 20  |ugh -nosize and |
0000a900  31 3a 31 20 6f 72 20 31  3a 32 20 72 61 74 69 6f  |1:1 or 1:2 ratio|
0000a910  73 20 61 72 65 20 71 75  69 63 6b 2c 20 74 6f 6f  |s are quick, too|
0000a920  29 0a 20 2d 20 79 6f 75  20 64 6f 6e 27 74 20 6e  |). - you don't n|
0000a930  65 65 64 20 73 68 61 72  70 65 6e 69 6e 67 2c 20  |eed sharpening, |
0000a940  68 69 73 74 6f 67 72 61  6d 20 65 71 75 61 6c 69  |histogram equali|
0000a950  73 61 74 69 6f 6e 2c 20  72 61 6e 67 65 20 65 78  |sation, range ex|
0000a960  70 61 6e 73 69 6f 6e 0a  20 2d 20 79 6f 75 20 75  |pansion. - you u|
0000a970  73 65 20 6d 6f 6e 6f 63  68 72 6f 6d 65 20 28 65  |se monochrome (e|
0000a980  2e 67 2e 20 32 35 2c 20  32 36 2c 20 32 37 20 61  |.g. 25, 26, 27 a|
0000a990  6e 64 20 32 37 74 29 20  6d 6f 64 65 73 0a 0a 61  |nd 27t) modes..a|
0000a9a0  64 64 69 74 69 6f 6e 61  6c 6c 79 20 79 6f 75 20  |dditionally you |
0000a9b0  63 61 6e 20 64 69 73 61  62 6c 65 20 64 69 74 68  |can disable dith|
0000a9c0  65 72 69 6e 67 20 28 2d  6e 6f 64 69 74 68 65 72  |ering (-nodither|
0000a9d0  29 20 65 73 70 65 63 69  61 6c 6c 79 20 77 68 65  |) especially whe|
0000a9e0  6e 20 72 65 61 64 69 6e  67 0a 6d 6f 6e 6f 63 68  |n reading.monoch|
0000a9f0  72 6f 6d 65 20 73 6f 75  72 63 65 2e 0a 0a 59 6f  |rome source...Yo|
0000aa00  75 20 63 61 6e 20 61 76  6f 69 64 20 74 68 65 20  |u can avoid the |
0000aa10  70 72 6f 67 72 61 6d 20  63 68 61 6e 67 69 6e 67  |program changing|
0000aa20  20 6d 6f 64 65 20 62 79  20 70 75 74 74 69 6e 67  | mode by putting|
0000aa30  20 2d 6e 6f 6d 6f 64 65  20 6f 6e 20 74 68 65 20  | -nomode on the |
0000aa40  63 6f 6d 6d 61 6e 64 20  6c 69 6e 65 2e 0a 0a 56  |command line...V|
0000aa50  65 72 79 20 6c 61 72 67  65 20 6f 75 74 70 75 74  |ery large output|
0000aa60  20 66 69 6c 65 73 20 63  61 6e 20 62 65 20 62 75  | files can be bu|
0000aa70  69 6c 74 20 73 74 72 69  70 73 20 61 74 20 61 20  |ilt strips at a |
0000aa80  74 69 6d 65 20 61 6e 64  20 73 65 6e 74 20 64 69  |time and sent di|
0000aa90  72 65 63 74 6c 79 20 74  6f 20 64 69 73 6b 0a 75  |rectly to disk.u|
0000aaa0  73 69 6e 67 20 74 68 65  20 70 61 72 61 6d 65 74  |sing the paramet|
0000aab0  65 72 20 22 2d 6d 61 78  22 20 65 2e 67 3a 0a 0a  |er "-max" e.g:..|
0000aac0  20 20 43 68 61 6e 67 65  46 53 49 20 3c 69 6e 3e  |  ChangeFSI <in>|
0000aad0  20 3c 6f 75 74 3e 20 32  38 20 2d 6d 61 78 35 31  | <out> 28 -max51|
0000aae0  32 4b 0a 0a 77 69 6c 6c  20 63 6f 6e 76 65 72 74  |2K..will convert|
0000aaf0  20 74 68 65 20 66 69 6c  65 20 77 69 74 68 20 61  | the file with a|
0000ab00  20 6d 61 78 69 6d 75 6d  20 6f 66 20 35 31 32 4b  | maximum of 512K|
0000ab10  42 79 74 65 73 20 68 65  6c 64 20 69 6e 20 6d 65  |Bytes held in me|
0000ab20  6d 6f 72 79 2e 20 4f 70  74 69 6f 6e 73 20 32 35  |mory. Options 25|
0000ab30  74 2c 0a 2d 72 6f 74 61  74 65 20 61 6e 64 20 2d  |t,.-rotate and -|
0000ab40  76 66 6c 69 70 20 64 6f  6e 27 74 20 77 6f 72 6b  |vflip don't work|
0000ab50  20 77 68 65 6e 20 74 68  69 73 20 69 73 20 62 65  | when this is be|
0000ab60  69 6e 67 20 64 6f 6e 65  2e 0a 0a 57 6f 72 6b 20  |ing done...Work |
0000ab70  77 69 6c 6c 20 62 65 20  64 6f 6e 65 20 6f 6e 20  |will be done on |
0000ab80  6f 74 68 65 72 20 66 6f  72 6d 61 74 73 20 77 68  |other formats wh|
0000ab90  65 6e 20 61 6e 64 20 69  66 20 62 6f 74 68 20 69  |en and if both i|
0000aba0  6d 61 67 65 20 61 6e 64  20 64 6f 63 75 6d 65 6e  |mage and documen|
0000abb0  74 61 74 69 6f 6e 0a 61  72 72 69 76 65 20 6f 6e  |tation.arrive on|
0000abc0  20 6d 79 20 64 65 73 6b  2e 20 41 64 64 69 6e 67  | my desk. Adding|
0000abd0  20 61 20 6e 65 77 20 66  6f 72 6d 61 74 20 69 73  | a new format is|
0000abe0  20 61 20 6d 61 74 74 65  72 20 6f 66 20 28 61 29  | a matter of (a)|
0000abf0  20 70 75 74 74 69 6e 67  20 69 6e 20 61 75 74 6f  | putting in auto|
0000ac00  6d 61 74 69 63 0a 72 65  63 6f 67 6e 69 74 69 6f  |matic.recognitio|
0000ac10  6e 20 6f 66 20 74 68 65  20 66 6f 72 6d 61 74 20  |n of the format |
0000ac20  61 74 20 74 68 65 20 73  74 61 72 74 20 6f 66 20  |at the start of |
0000ac30  74 68 65 20 70 72 6f 67  72 61 6d 20 28 62 29 20  |the program (b) |
0000ac40  72 65 61 64 69 6e 67 20  74 68 65 20 73 69 7a 65  |reading the size|
0000ac50  20 6f 66 0a 74 68 65 20  69 6d 61 67 65 20 61 6e  | of.the image an|
0000ac60  64 20 74 68 65 20 63 6f  6c 6f 75 72 20 70 61 6c  |d the colour pal|
0000ac70  65 74 74 65 20 6d 61 70  70 69 6e 67 20 5b 69 6e  |ette mapping [in|
0000ac80  20 74 68 65 20 6e 65 78  74 20 73 65 63 74 69 6f  | the next sectio|
0000ac90  6e 20 6f 66 20 74 68 65  20 70 72 6f 67 72 61 6d  |n of the program|
0000aca0  5d 0a 28 63 29 20 77 72  69 74 69 6e 67 20 61 20  |].(c) writing a |
0000acb0  22 72 65 61 64 20 70 69  78 65 6c 20 72 6f 77 22  |"read pixel row"|
0000acc0  20 65 6c 65 6d 65 6e 74  20 69 6e 73 69 64 65 20  | element inside |
0000acd0  50 52 4f 43 69 70 72 6f  77 20 28 64 29 20 70 72  |PROCiprow (d) pr|
0000ace0  6f 76 69 64 69 6e 67 20  61 6e 20 65 6e 74 72 79  |oviding an entry|
0000acf0  0a 69 6e 20 50 52 4f 43  72 65 77 69 6e 64 2e 20  |.in PROCrewind. |
0000ad00  49 66 20 79 6f 75 20 77  72 69 74 65 20 61 20 6e  |If you write a n|
0000ad10  65 77 20 66 6f 72 6d 61  74 20 69 6e 74 65 72 66  |ew format interf|
0000ad20  61 63 65 2c 20 70 6c 65  61 73 65 20 73 65 6e 64  |ace, please send|
0000ad30  20 69 74 20 74 6f 20 6d  65 20 73 6f 0a 74 68 61  | it to me so.tha|
0000ad40  74 20 69 74 20 77 69 6c  6c 20 62 65 20 69 6e 63  |t it will be inc|
0000ad50  6c 75 64 65 64 20 69 6e  20 6c 61 74 65 72 20 76  |luded in later v|
0000ad60  65 72 73 69 6f 6e 73 2e  20 43 68 61 6e 67 65 46  |ersions. ChangeF|
0000ad70  53 49 20 68 61 73 20 61  6c 72 65 61 64 79 20 67  |SI has already g|
0000ad80  6f 74 20 63 6f 64 65 20  66 6f 72 0a 64 65 61 6c  |ot code for.deal|
0000ad90  69 6e 67 20 77 69 74 68  20 69 6d 61 67 65 73 20  |ing with images |
0000ada0  77 69 74 68 20 31 2c 20  32 2c 20 34 20 61 6e 64  |with 1, 2, 4 and|
0000adb0  20 38 20 62 69 74 73 20  70 65 72 20 70 69 78 65  | 8 bits per pixe|
0000adc0  6c 20 70 61 63 6b 65 64  20 69 6e 74 6f 20 62 79  |l packed into by|
0000add0  74 65 73 20 61 6e 64 20  66 6f 72 0a 69 6d 61 67  |tes and for.imag|
0000ade0  65 73 20 77 69 74 68 20  75 70 20 74 6f 20 38 20  |es with up to 8 |
0000adf0  62 69 74 20 70 6c 61 6e  65 73 2e 20 54 68 65 72  |bit planes. Ther|
0000ae00  65 20 69 73 20 73 75 70  70 6f 72 74 20 63 6f 64  |e is support cod|
0000ae10  65 20 66 6f 72 20 4c 5a  57 20 64 65 63 6f 6d 70  |e for LZW decomp|
0000ae20  72 65 73 73 69 6f 6e 20  61 6e 64 0a 4c 5a 57 20  |ression and.LZW |
0000ae30  64 65 63 6f 64 69 6e 67  2e 0a 0a 41 73 20 61 20  |decoding...As a |
0000ae40  73 70 65 63 69 61 6c 20  66 65 61 74 75 72 65 2c  |special feature,|
0000ae50  20 43 68 61 6e 67 65 46  53 49 20 77 69 6c 6c 20  | ChangeFSI will |
0000ae60  61 6c 73 6f 20 77 72 69  74 65 20 6f 75 74 20 32  |also write out 2|
0000ae70  35 36 20 67 72 65 79 20  6c 65 76 65 6c 20 66 69  |56 grey level fi|
0000ae80  6c 65 73 20 28 61 6c 74  65 72 0a 72 77 74 2c 20  |les (alter.rwt, |
0000ae90  67 77 74 20 61 6e 64 20  62 77 74 20 74 6f 20 67  |gwt and bwt to g|
0000aea0  65 74 20 32 35 36 20 6c  65 76 65 6c 20 63 6f 6c  |et 256 level col|
0000aeb0  6f 75 72 20 73 65 70 61  72 61 74 69 6f 6e 73 29  |our separations)|
0000aec0  20 69 6e 20 41 49 4d 20  66 6f 72 6d 61 74 2e 20  | in AIM format. |
0000aed0  54 68 69 73 20 69 73 0a  66 69 6c 65 20 74 79 70  |This is.file typ|
0000aee0  65 20 34 20 77 69 74 68  20 62 79 74 65 73 20 72  |e 4 with bytes r|
0000aef0  65 70 72 65 73 65 6e 74  69 6e 67 20 74 68 65 20  |epresenting the |
0000af00  67 72 65 79 20 6c 65 76  65 6c 2e 20 55 73 65 20  |grey level. Use |
0000af10  74 68 65 20 3d 20 6f 70  65 72 61 74 69 6f 6e 20  |the = operation |
0000af20  74 6f 0a 72 65 73 74 72  69 63 74 20 74 68 65 20  |to.restrict the |
0000af30  70 69 63 74 75 72 65 20  74 6f 20 32 35 36 78 32  |picture to 256x2|
0000af40  35 36 79 2c 20 6f 74 68  65 72 77 69 73 65 20 69  |56y, otherwise i|
0000af50  74 20 77 69 6c 6c 20 62  65 20 74 68 65 20 73 61  |t will be the sa|
0000af60  6d 65 20 73 69 7a 65 20  61 73 20 74 68 65 0a 69  |me size as the.i|
0000af70  6e 70 75 74 2e 20 53 70  65 63 69 66 79 20 22 61  |nput. Specify "a|
0000af80  69 6d 22 20 61 73 20 74  68 65 20 6d 6f 64 65 20  |im" as the mode |
0000af90  73 74 72 69 6e 67 20 74  6f 20 64 6f 20 74 68 69  |string to do thi|
0000afa0  73 2e 0a 0a 46 6f 72 20  70 6f 72 74 61 62 69 6c  |s...For portabil|
0000afb0  69 74 79 20 74 6f 20 6f  74 68 65 72 20 6d 61 63  |ity to other mac|
0000afc0  68 69 6e 65 73 2c 20 43  68 61 6e 67 65 46 53 49  |hines, ChangeFSI|
0000afd0  20 63 61 6e 20 77 72 69  74 65 20 6f 75 74 20 66  | can write out f|
0000afe0  69 6c 65 73 20 69 6e 20  22 70 62 6d 22 0a 66 6f  |iles in "pbm".fo|
0000aff0  72 6d 61 74 2e 20 54 68  65 72 65 20 61 72 65 20  |rmat. There are |
0000b000  33 20 74 79 70 65 73 20  6f 66 20 66 6f 72 6d 61  |3 types of forma|
0000b010  74 20 22 62 6c 61 63 6b  2f 77 68 69 74 65 22 20  |t "black/white" |
0000b020  28 70 62 6d 29 2c 20 22  67 72 65 79 22 20 28 70  |(pbm), "grey" (p|
0000b030  67 6d 29 20 61 6e 64 0a  22 63 6f 6c 6f 75 72 22  |gm) and."colour"|
0000b040  20 28 70 70 6d 29 20 77  69 74 68 20 70 75 72 65  | (ppm) with pure|
0000b050  20 41 53 43 49 49 20 61  6e 64 20 62 69 6e 61 72  | ASCII and binar|
0000b060  79 20 65 6e 63 6f 64 69  6e 67 73 20 6f 66 20 65  |y encodings of e|
0000b070  61 63 68 3a 0a 0a 41 53  43 49 49 20 20 20 20 20  |ach:..ASCII     |
0000b080  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000b090  20 20 20 20 20 20 20 20  20 20 20 20 20 20 42 69  |              Bi|
0000b0a0  6e 61 72 79 0a 70 31 20  20 20 20 20 20 20 20 22  |nary.p1        "|
0000b0b0  62 6c 61 63 6b 2f 77 68  69 74 65 22 20 28 6c 69  |black/white" (li|
0000b0c0  6b 65 20 6d 6f 64 65 20  31 38 29 20 20 70 34 20  |ke mode 18)  p4 |
0000b0d0  28 62 69 67 20 65 6e 64  69 61 6e 20 62 79 74 65  |(big endian byte|
0000b0e0  73 21 29 0a 70 32 20 20  20 20 20 20 20 20 22 67  |s!).p2        "g|
0000b0f0  72 65 79 22 20 28 6c 69  6b 65 20 6d 6f 64 65 20  |rey" (like mode |
0000b100  32 30 74 29 20 20 20 20  20 20 20 20 70 35 0a 70  |20t)        p5.p|
0000b110  33 20 20 20 20 20 20 20  20 22 74 72 75 65 20 63  |3        "true c|
0000b120  6f 6c 6f 75 72 22 20 20  20 20 20 20 20 20 20 20  |olour"          |
0000b130  20 20 20 20 20 20 20 70  36 0a 0a 46 69 6c 65 73  |       p6..Files|
0000b140  20 63 61 6e 20 62 65 20  72 65 61 64 20 77 69 74  | can be read wit|
0000b150  68 20 4a 65 66 20 50 6f  73 6b 61 6e 7a 65 72 27  |h Jef Poskanzer'|
0000b160  73 20 70 6f 72 74 61 62  6c 65 20 74 6f 6f 6c 6b  |s portable toolk|
0000b170  69 74 20 6f 6e 20 6f 74  68 65 72 20 6d 61 63 68  |it on other mach|
0000b180  69 6e 65 73 2e 20 54 68  65 0a 70 32 20 66 6f 72  |ines. The.p2 for|
0000b190  6d 61 74 20 69 73 20 65  61 73 69 6c 79 20 63 6f  |mat is easily co|
0000b1a0  6e 76 65 72 74 69 62 6c  65 20 62 79 20 70 72 6f  |nvertible by pro|
0000b1b0  67 72 61 6d 6d 65 72 73  3b 20 69 74 20 63 6f 6e  |grammers; it con|
0000b1c0  73 69 73 74 73 20 6f 66  3a 0a 0a 50 32 0a 23 20  |sists of:..P2.# |
0000b1d0  63 6f 6d 6d 65 6e 74 20  6c 69 6e 65 0a 78 73 69  |comment line.xsi|
0000b1e0  7a 65 20 79 73 69 7a 65  0a 6d 61 78 69 6d 75 6d  |ze ysize.maximum|
0000b1f0  5f 76 61 6c 75 65 0a 70  69 78 65 6c 5f 76 61 6c  |_value.pixel_val|
0000b200  75 65 20 3c 77 68 69 74  65 73 70 61 63 65 3e 20  |ue <whitespace> |
0000b210  70 69 78 65 6c 5f 76 61  6c 75 65 0a 0a 77 68 65  |pixel_value..whe|
0000b220  72 65 20 61 6c 6c 20 74  68 65 20 6e 75 6d 62 65  |re all the numbe|
0000b230  72 73 20 61 72 65 20 69  6e 20 64 65 63 69 6d 61  |rs are in decima|
0000b240  6c 20 28 41 53 43 49 49  29 2e 20 30 20 6d 65 61  |l (ASCII). 0 mea|
0000b250  6e 73 20 62 6c 61 63 6b  2c 20 6d 61 78 69 6d 75  |ns black, maximu|
0000b260  6d 5f 76 61 6c 75 65 20  28 3d 0a 31 35 29 20 6d  |m_value (=.15) m|
0000b270  65 61 6e 73 20 77 68 69  74 65 2e 20 54 68 65 20  |eans white. The |
0000b280  70 33 20 66 6f 72 6d 61  74 20 69 73 20 73 69 6d  |p3 format is sim|
0000b290  69 6c 61 72 20 77 69 74  68 20 72 2c 20 67 2c 20  |ilar with r, g, |
0000b2a0  62 20 74 72 69 70 6c 65  73 20 66 6f 72 20 65 61  |b triples for ea|
0000b2b0  63 68 20 70 69 78 65 6c  0a 76 61 6c 75 65 2e 20  |ch pixel.value. |
0000b2c0  54 68 65 20 6e 75 6d 62  65 72 20 6f 66 20 62 69  |The number of bi|
0000b2d0  74 73 20 70 65 72 20 63  6f 6d 70 6f 6e 65 6e 74  |ts per component|
0000b2e0  20 28 64 65 66 61 75 6c  74 20 38 29 20 63 61 6e  | (default 8) can|
0000b2f0  20 62 65 20 73 65 74 20  66 72 6f 6d 20 74 68 65  | be set from the|
0000b300  20 63 6f 6d 6d 61 6e 64  0a 6c 69 6e 65 20 77 69  | command.line wi|
0000b310  74 68 2c 20 66 6f 72 20  65 78 61 6d 70 6c 65 2c  |th, for example,|
0000b320  20 22 70 33 2c 34 22 20  66 6f 72 20 34 20 62 69  | "p3,4" for 4 bi|
0000b330  74 73 20 70 65 72 20 63  6f 6d 70 6f 6e 65 6e 74  |ts per component|
0000b340  2e 0a 0a 41 73 20 61 20  73 70 65 63 69 61 6c 20  |...As a special |
0000b350  70 61 63 6b 65 64 20 6f  75 74 70 75 74 20 66 6f  |packed output fo|
0000b360  72 6d 61 74 2c 20 22 50  31 35 22 20 68 61 73 20  |rmat, "P15" has |
0000b370  62 65 65 6e 20 69 6d 70  6c 65 6d 65 6e 74 65 64  |been implemented|
0000b380  2e 20 4f 75 74 70 75 74  20 69 73 20 62 69 6e 61  |. Output is bina|
0000b390  72 79 0a 70 69 78 65 6c  20 76 61 6c 75 65 73 2c  |ry.pixel values,|
0000b3a0  20 35 20 62 69 74 73 20  70 65 72 20 63 6f 6d 70  | 5 bits per comp|
0000b3b0  6f 6e 65 6e 74 2c 20 6c  69 74 74 6c 65 20 65 6e  |onent, little en|
0000b3c0  64 69 61 6e 20 52 47 42  20 6f 72 64 65 72 20 70  |dian RGB order p|
0000b3d0  61 63 6b 65 64 20 69 6e  74 6f 20 31 36 0a 62 69  |acked into 16.bi|
0000b3e0  74 73 2e 20 48 65 61 64  65 72 20 69 6e 66 6f 72  |ts. Header infor|
0000b3f0  6d 61 74 69 6f 6e 20 61  73 20 74 68 65 20 6f 74  |mation as the ot|
0000b400  68 65 72 20 70 20 66 6f  72 6d 61 74 73 2e 0a 0a  |her p formats...|
0000b410  46 69 6c 65 73 20 63 61  6e 20 62 65 20 77 72 69  |Files can be wri|
0000b420  74 74 65 6e 20 61 73 20  6e 65 77 20 52 49 53 43  |tten as new RISC|
0000b430  20 4f 53 20 73 70 72 69  74 65 73 20 75 73 69 6e  | OS sprites usin|
0000b440  67 20 53 31 36 20 61 6e  64 20 53 33 32 20 61 73  |g S16 and S32 as|
0000b450  20 74 68 65 20 66 6f 72  6d 61 74 73 2e 0a 54 68  | the formats..Th|
0000b460  65 20 78 20 61 6e 64 20  79 20 70 69 78 65 6c 73  |e x and y pixels|
0000b470  20 70 65 72 20 69 6e 63  68 20 61 72 65 20 67 69  | per inch are gi|
0000b480  76 65 6e 20 61 73 20 61  20 63 6f 6d 6d 61 20 73  |ven as a comma s|
0000b490  65 70 65 72 61 74 65 64  20 6c 69 73 74 20 2d 20  |eperated list - |
0000b4a0  61 20 31 36 20 62 69 74  20 6d 6f 64 65 0a 31 32  |a 16 bit mode.12|
0000b4b0  20 65 71 75 69 76 61 6c  65 6e 74 20 69 73 20 53  | equivalent is S|
0000b4c0  31 36 2c 39 30 2c 34 35  20 77 68 69 6c 65 20 61  |16,90,45 while a|
0000b4d0  20 33 32 20 62 69 74 20  6d 6f 64 65 20 32 38 20  | 32 bit mode 28 |
0000b4e0  65 71 75 69 76 61 6c 65  6e 74 20 69 73 20 53 33  |equivalent is S3|
0000b4f0  32 2c 39 30 2c 39 30 2e  0a 0a 43 68 61 6e 67 65  |2,90,90...Change|
0000b500  46 53 49 20 63 61 6e 20  77 72 69 74 65 20 49 72  |FSI can write Ir|
0000b510  6c 61 6d 20 66 6f 72 6d  61 74 20 69 6d 61 67 65  |lam format image|
0000b520  73 20 28 73 6f 6d 65 77  68 61 74 20 73 6c 6f 77  |s (somewhat slow|
0000b530  65 72 20 74 68 61 6e 20  70 36 20 69 6d 61 67 65  |er than p6 image|
0000b540  73 2e 2e 2e 29 2e 0a 0a  20 20 20 20 20 20 20 20  |s...)...        |
0000b550  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000b560  20 20 20 20 20 20 4f 75  74 70 75 74 20 73 75 6d  |      Output sum|
0000b570  6d 61 72 79 0a 20 20 20  20 20 20 20 20 20 20 20  |mary.           |
0000b580  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000b590  20 20 20 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 3d 3d  |   =============|
0000b5a0  3d 0a 0a 23 20 63 6f 6c  73 20 20 20 43 6f 6c 6f  |=..# cols   Colo|
0000b5b0  75 72 20 43 75 62 65 20  20 42 69 74 73 20 75 73  |ur Cube  Bits us|
0000b5c0  65 64 20 20 43 6f 6e 73  69 73 74 65 6e 74 20 48  |ed  Consistent H|
0000b5d0  75 65 20 20 44 65 73 6b  74 6f 70 20 50 61 6c 65  |ue  Desktop Pale|
0000b5e0  74 74 65 20 20 4d 6f 64  65 26 53 75 66 66 69 78  |tte  Mode&Suffix|
0000b5f0  0a 0a 32 5e 32 34 20 20  20 20 20 20 20 20 20 20  |..2^24          |
0000b600  20 20 59 20 20 20 20 20  20 20 20 20 32 34 20 20  |  Y         24  |
0000b610  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000b620  20 20 20 20 20 20 20 2d  20 20 20 20 20 20 20 20  |       -        |
0000b630  20 20 20 20 53 33 32 2c  20 70 33 20 6f 72 20 70  |    S32, p3 or p|
0000b640  36 20 6f 72 20 49 72 6c  61 6d 0a 32 5e 32 31 20  |6 or Irlam.2^21 |
0000b650  20 20 20 20 20 20 20 20  20 20 20 59 20 20 20 20  |           Y    |
0000b660  20 20 20 20 20 32 31 20  20 20 20 20 20 20 20 20  |     21         |
0000b670  20 20 59 20 20 20 20 20  20 20 20 20 20 20 20 20  |  Y             |
0000b680  2d 20 20 20 20 20 20 20  20 20 20 20 20 70 36 2c  |-            p6,|
0000b690  37 0a 32 5e 31 38 20 20  20 20 20 20 20 20 20 20  |7.2^18          |
0000b6a0  20 20 59 20 20 20 20 20  20 20 20 20 31 38 20 20  |  Y         18  |
0000b6b0  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000b6c0  20 20 20 20 20 20 20 2d  20 20 20 20 20 20 20 20  |       -        |
0000b6d0  20 20 20 20 70 36 2c 36  0a 32 5e 31 35 20 20 20  |    p6,6.2^15   |
0000b6e0  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000b6f0  20 20 20 31 35 20 20 20  20 20 20 20 20 20 20 20  |   15           |
0000b700  59 20 20 20 20 20 20 20  20 20 20 20 20 20 2d 20  |Y             - |
0000b710  20 20 20 20 20 20 20 20  20 20 20 53 31 36 2c 20  |           S16, |
0000b720  70 31 35 20 6f 72 20 70  36 2c 35 0a 32 5e 31 32  |p15 or p6,5.2^12|
0000b730  20 20 20 20 20 20 20 20  20 20 20 20 59 20 20 20  |            Y   |
0000b740  20 20 20 20 20 20 31 32  20 20 20 20 20 20 20 20  |      12        |
0000b750  20 20 20 59 20 20 20 20  20 20 20 20 20 20 20 20  |   Y            |
0000b760  20 2d 20 20 20 20 20 20  20 20 20 20 20 20 70 36  | -            p6|
0000b770  2c 34 0a 35 31 32 20 20  20 20 20 20 20 20 20 20  |,4.512          |
0000b780  20 20 20 59 20 20 20 20  20 20 20 20 20 20 39 20  |   Y          9 |
0000b790  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000b7a0  20 20 20 20 20 20 20 20  2d 20 20 20 20 20 20 20  |        -       |
0000b7b0  20 20 20 20 20 70 36 2c  33 0a 32 35 36 20 67 72  |     p6,3.256 gr|
0000b7c0  65 79 20 20 20 20 20 20  20 20 6e 20 20 20 20 20  |ey        n     |
0000b7d0  20 20 20 20 20 38 20 20  20 20 20 20 20 20 20 20  |     8          |
0000b7e0  20 59 20 20 20 20 20 20  20 20 20 20 20 20 20 2d  | Y             -|
0000b7f0  20 20 20 20 20 20 20 20  20 20 20 20 61 69 6d 0a  |            aim.|
0000b800  32 35 36 20 67 72 65 79  20 20 20 20 20 20 20 20  |256 grey        |
0000b810  6e 20 20 20 20 20 20 20  20 20 20 38 20 20 20 20  |n          8    |
0000b820  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000b830  20 20 20 20 20 2d 20 20  20 20 20 20 20 20 20 20  |     -          |
0000b840  20 20 32 38 64 0a 32 35  36 20 20 20 20 20 20 20  |  28d.256       |
0000b850  20 20 20 20 20 20 59 20  20 20 20 20 20 20 20 20  |      Y         |
0000b860  20 38 20 20 20 20 20 20  20 20 20 20 20 59 20 20  | 8           Y  |
0000b870  20 20 20 20 20 20 20 20  20 20 20 59 20 20 20 20  |           Y    |
0000b880  20 20 20 20 20 20 20 20  32 38 0a 32 35 36 20 20  |        28.256  |
0000b890  20 20 20 20 20 20 20 20  20 20 20 59 20 20 20 20  |           Y    |
0000b8a0  20 20 20 20 20 20 38 20  20 20 20 20 20 20 20 20  |      8         |
0000b8b0  20 20 59 20 20 20 20 20  20 20 20 20 20 20 20 20  |  Y             |
0000b8c0  59 20 20 20 20 20 20 20  20 20 20 20 20 32 38 72  |Y            28r|
0000b8d0  0a 31 36 20 67 72 65 79  20 20 20 20 20 20 20 20  |.16 grey        |
0000b8e0  20 6e 20 20 20 20 20 20  20 20 20 20 34 20 20 20  | n          4   |
0000b8f0  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000b900  20 20 20 20 20 20 6e 20  20 20 20 20 20 20 20 20  |      n         |
0000b910  20 20 20 32 37 74 0a 31  36 20 67 72 65 79 20 20  |   27t.16 grey  |
0000b920  20 20 20 20 20 20 20 6e  20 20 20 20 20 20 20 20  |       n        |
0000b930  20 20 34 20 20 20 20 20  20 20 20 20 20 20 59 20  |  4           Y |
0000b940  20 20 20 20 20 20 20 20  20 20 20 20 6e 20 20 20  |            n   |
0000b950  20 20 20 20 20 20 20 20  20 70 32 20 6f 72 20 70  |         p2 or p|
0000b960  35 0a 38 20 67 72 65 79  20 20 20 20 20 20 20 20  |5.8 grey        |
0000b970  20 20 6e 20 20 20 20 20  20 20 20 20 20 33 20 20  |  n          3  |
0000b980  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000b990  20 20 20 20 20 20 20 59  20 20 20 20 20 20 20 20  |       Y        |
0000b9a0  20 20 20 20 32 37 0a 31  36 20 20 20 20 20 20 20  |    27.16       |
0000b9b0  20 20 20 20 20 20 20 3f  20 20 20 20 20 20 20 20  |       ?        |
0000b9c0  20 20 34 20 20 20 20 20  20 20 20 20 20 20 3f 20  |  4           ? |
0000b9d0  20 20 20 20 20 20 20 20  20 20 20 20 59 20 20 20  |            Y   |
0000b9e0  20 20 20 20 20 20 20 20  20 32 37 72 0a 31 36 20  |         27r.16 |
0000b9f0  20 20 20 20 20 20 20 20  20 20 20 20 20 59 20 20  |             Y  |
0000ba00  20 20 20 20 20 20 20 20  33 20 20 20 20 20 20 20  |        3       |
0000ba10  20 20 20 20 59 20 20 20  20 20 20 20 20 20 20 20  |    Y           |
0000ba20  63 61 6e 20 62 65 20 20  20 20 20 20 20 20 20 32  |can be         2|
0000ba30  37 64 0a 34 20 67 72 65  79 20 20 20 20 20 20 20  |7d.4 grey       |
0000ba40  20 20 20 6e 20 20 20 20  20 20 20 20 20 20 32 20  |   n          2 |
0000ba50  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000ba60  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000ba70  20 20 20 20 20 32 36 0a  34 20 20 20 20 20 20 20  |     26.4       |
0000ba80  20 20 20 20 20 20 20 20  6e 20 20 20 20 20 20 20  |        n       |
0000ba90  20 20 20 32 20 20 20 20  20 20 20 20 20 20 20 6e  |   2           n|
0000baa0  20 20 20 20 20 20 20 20  20 20 20 20 20 6e 20 20  |             n  |
0000bab0  20 20 20 20 20 20 20 20  20 20 32 36 63 0a 34 20  |          26c.4 |
0000bac0  20 20 20 20 20 20 20 20  20 20 20 20 20 20 6e 20  |              n |
0000bad0  20 20 20 20 20 20 20 20  20 32 20 20 20 20 20 20  |         2      |
0000bae0  20 20 20 20 20 6e 20 20  20 20 20 20 20 20 20 20  |     n          |
0000baf0  20 20 20 6e 20 20 20 20  20 20 20 20 20 20 20 20  |   n            |
0000bb00  32 36 72 0a 32 20 28 62  6c 61 63 6b 2f 77 68 69  |26r.2 (black/whi|
0000bb10  74 65 29 20 6e 20 20 20  20 20 20 20 20 20 20 31  |te) n          1|
0000bb20  20 20 20 20 20 20 20 20  20 20 20 59 20 20 20 20  |           Y    |
0000bb30  20 20 20 20 20 20 20 20  20 59 20 20 20 20 20 20  |         Y      |
0000bb40  20 20 20 20 20 20 32 35  0a 32 20 28 62 6c 61 63  |      25.2 (blac|
0000bb50  6b 2f 77 68 69 74 65 29  20 6e 20 20 20 20 20 20  |k/white) n      |
0000bb60  20 20 20 20 31 20 20 20  20 20 20 20 20 20 20 20  |    1           |
0000bb70  59 20 20 20 20 20 20 20  20 20 20 20 20 20 59 20  |Y             Y |
0000bb80  20 20 20 20 20 20 20 20  20 20 20 32 35 63 2f 64  |           25c/d|
0000bb90  2f 74 0a 32 20 28 62 6c  61 63 6b 2f 77 68 69 74  |/t.2 (black/whit|
0000bba0  65 29 20 6e 20 20 20 20  20 20 20 20 20 20 31 20  |e) n          1 |
0000bbb0  20 20 20 20 20 20 20 20  20 20 59 20 20 20 20 20  |          Y     |
0000bbc0  20 20 20 20 20 20 20 20  59 20 20 20 20 20 20 20  |        Y       |
0000bbd0  20 20 20 20 20 70 31 20  6f 72 20 70 34 0a 0a 0a  |     p1 or p4...|
0000bbe0  43 68 61 6e 67 65 46 53  49 20 63 61 6e 20 62 65  |ChangeFSI can be|
0000bbf0  20 75 73 65 64 20 66 72  6f 6d 20 62 6f 74 68 20  | used from both |
0000bc00  74 68 65 20 64 65 73 6b  74 6f 70 20 66 72 6f 6e  |the desktop fron|
0000bc10  74 20 65 6e 64 20 61 6e  64 20 66 72 6f 6d 20 74  |t end and from t|
0000bc20  68 65 20 63 6f 6d 6d 61  6e 64 0a 6c 69 6e 65 2e  |he command.line.|
0000bc30  20 49 74 20 63 61 6e 20  61 6c 73 6f 20 62 65 20  | It can also be |
0000bc40  75 73 65 64 20 61 73 20  61 20 42 41 53 49 43 20  |used as a BASIC |
0000bc50  6c 69 62 72 61 72 79 20  66 75 6e 63 74 69 6f 6e  |library function|
0000bc60  3a 0a 4c 49 42 52 41 52  59 22 3c 43 68 61 6e 67  |:.LIBRARY"<Chang|
0000bc70  65 46 53 49 24 44 69 72  3e 2e 43 68 61 6e 67 65  |eFSI$Dir>.Change|
0000bc80  46 53 49 22 20 67 69 76  65 73 20 61 20 6e 65 77  |FSI" gives a new|
0000bc90  20 66 75 6e 63 74 69 6f  6e 2c 20 46 4e 43 68 61  | function, FNCha|
0000bca0  6e 67 65 46 53 49 20 74  6f 20 74 68 65 0a 42 41  |ngeFSI to the.BA|
0000bcb0  53 49 43 20 70 72 6f 67  72 61 6d 6d 65 72 2e 20  |SIC programmer. |
0000bcc0  54 68 69 73 20 66 75 6e  63 74 69 6f 6e 20 74 61  |This function ta|
0000bcd0  6b 65 73 3a 0a 20 20 41  24 3a 20 61 20 63 6f 6d  |kes:.  A$: a com|
0000bce0  6d 61 6e 64 20 6c 69 6e  65 20 61 72 67 75 6d 65  |mand line argume|
0000bcf0  6e 74 0a 20 20 73 70 72  69 74 65 61 72 65 61 25  |nt.  spritearea%|
0000bd00  3a 20 61 6e 20 61 64 64  72 65 73 73 20 6f 72 20  |: an address or |
0000bd10  2d 31 20 66 6f 72 20 74  68 65 20 73 70 72 69 74  |-1 for the sprit|
0000bd20  65 61 72 65 61 20 62 75  69 6c 74 20 62 79 20 43  |earea built by C|
0000bd30  68 61 6e 67 65 46 53 49  0a 20 20 77 6f 72 6b 73  |hangeFSI.  works|
0000bd40  70 61 63 65 25 3a 20 61  6e 20 61 64 64 72 65 73  |pace%: an addres|
0000bd50  73 20 6f 72 20 2d 31 20  66 6f 72 20 43 68 61 6e  |s or -1 for Chan|
0000bd60  67 65 46 53 49 27 73 20  6f 74 68 65 72 20 77 6f  |geFSI's other wo|
0000bd70  72 6b 73 70 61 63 65 0a  20 20 77 6f 72 6b 6c 69  |rkspace.  workli|
0000bd80  6d 69 74 25 3a 20 61 6e  20 61 64 64 72 65 73 73  |mit%: an address|
0000bd90  20 28 75 6e 75 73 65 64  20 69 66 20 77 6f 72 6b  | (unused if work|
0000bda0  73 70 61 63 65 25 3c 30  29 0a 20 20 66 61 73 74  |space%<0).  fast|
0000bdb0  25 3a 20 54 52 55 45 20  66 6f 72 20 4d 4f 44 45  |%: TRUE for MODE|
0000bdc0  20 30 20 73 65 6c 65 63  74 69 6f 6e 0a 49 74 20  | 0 selection.It |
0000bdd0  70 72 6f 64 75 63 65 73  20 61 6e 20 65 72 72 6f  |produces an erro|
0000bde0  72 20 28 74 6f 20 77 68  61 74 65 76 65 72 20 65  |r (to whatever e|
0000bdf0  72 72 6f 72 20 68 61 6e  64 6c 65 72 20 69 73 20  |rror handler is |
0000be00  70 72 65 73 65 6e 74 29  20 69 66 20 69 74 20 66  |present) if it f|
0000be10  61 69 6c 73 2e 20 49 66  0a 73 70 72 69 74 65 61  |ails. If.spritea|
0000be20  72 65 61 25 20 69 73 20  3c 30 20 69 74 20 77 69  |rea% is <0 it wi|
0000be30  6c 6c 20 73 61 76 65 20  74 68 65 20 73 70 72 69  |ll save the spri|
0000be40  74 65 20 74 6f 20 74 68  65 20 66 69 6c 65 20 67  |te to the file g|
0000be50  69 76 65 6e 20 69 6e 20  74 68 65 20 63 6f 6d 6d  |iven in the comm|
0000be60  61 6e 64 0a 73 74 72 69  6e 67 2c 20 6f 74 68 65  |and.string, othe|
0000be70  72 77 69 73 65 20 69 74  20 77 6f 6e 27 74 2e 20  |rwise it won't. |
0000be80  54 68 65 20 66 75 6e 63  74 69 6f 6e 20 46 4e 43  |The function FNC|
0000be90  68 61 6e 67 65 46 53 49  56 65 72 73 69 6f 6e 20  |hangeFSIVersion |
0000bea0  72 65 74 75 72 6e 73 20  74 68 65 20 76 65 72 73  |returns the vers|
0000beb0  69 6f 6e 0a 73 74 72 69  6e 67 20 6f 66 20 74 68  |ion.string of th|
0000bec0  65 20 6c 69 62 72 61 72  79 20 28 69 6e 20 74 68  |e library (in th|
0000bed0  65 20 69 6e 66 6f 20 62  6f 78 20 6f 66 20 74 68  |e info box of th|
0000bee0  65 20 64 65 73 6b 74 6f  70 20 61 70 70 6c 69 63  |e desktop applic|
0000bef0  61 74 69 6f 6e 29 2e 0a  0a 20 20 20 20 20 20 20  |ation)...       |
0000bf00  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000bf10  20 20 20 20 43 6f 6d 6d  61 6e 64 20 53 75 6d 6d  |    Command Summ|
0000bf20  61 72 79 0a 20 20 20 20  20 20 20 20 20 20 20 20  |ary.            |
0000bf30  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 3d  |               =|
0000bf40  3d 3d 3d 3d 3d 3d 3d 3d  3d 3d 3d 3d 3d 3d 0a 0a  |==============..|
0000bf50  2d 69 6e 66 6f 20 20 20  20 20 67 69 76 65 20 64  |-info     give d|
0000bf60  65 74 61 69 6c 73 0a 0a  2d 68 69 73 74 20 20 20  |etails..-hist   |
0000bf70  20 20 64 6f 6e 27 74 20  70 72 6f 63 65 73 73 20  |  don't process |
0000bf80  69 6d 61 67 65 2c 20 62  75 74 20 64 69 73 70 6c  |image, but displ|
0000bf90  61 79 20 68 69 73 74 6f  67 72 61 6d 20 6f 66 20  |ay histogram of |
0000bfa0  69 74 20 69 6e 73 74 65  61 64 0a 0a 2d 68 66 6c  |it instead..-hfl|
0000bfb0  69 70 20 20 20 20 68 6f  72 69 7a 6f 6e 74 61 6c  |ip    horizontal|
0000bfc0  6c 79 20 66 6c 69 70 20  74 68 65 20 69 6d 61 67  |ly flip the imag|
0000bfd0  65 0a 2d 76 66 6c 69 70  20 20 20 20 76 65 72 74  |e.-vflip    vert|
0000bfe0  69 63 61 6c 6c 79 20 66  6c 69 70 20 74 68 65 20  |ically flip the |
0000bff0  69 6d 61 67 65 0a 2d 72  6f 74 61 74 65 20 20 20  |image.-rotate   |
0000c000  72 6f 74 61 74 65 20 74  68 65 20 69 6d 61 67 65  |rotate the image|
0000c010  20 62 79 20 2b 39 30 20  64 65 67 72 65 65 73 20  | by +90 degrees |
0000c020  28 69 2e 65 2e 20 61 6e  74 69 2d 63 6c 6f 63 6b  |(i.e. anti-clock|
0000c030  77 69 73 65 29 0a 2d 72  6f 74 61 74 65 2d 20 20  |wise).-rotate-  |
0000c040  72 6f 74 61 74 65 20 74  68 65 20 69 6d 61 67 65  |rotate the image|
0000c050  20 62 79 20 2d 39 30 20  64 65 67 72 65 65 73 20  | by -90 degrees |
0000c060  28 69 2e 65 2e 20 63 6c  6f 63 6b 77 69 73 65 29  |(i.e. clockwise)|
0000c070  0a 2d 6d 61 78 20 20 20  20 20 20 73 65 74 20 74  |.-max      set t|
0000c080  68 65 20 6d 61 78 69 6d  75 6d 20 73 69 7a 65 20  |he maximum size |
0000c090  6f 66 20 74 68 65 20 69  6d 61 67 65 20 62 65 66  |of the image bef|
0000c0a0  6f 72 65 20 64 69 73 63  20 69 73 20 75 73 65 64  |ore disc is used|
0000c0b0  0a 0a 2d 6e 6f 73 63 61  6c 65 20 20 64 69 73 61  |..-noscale  disa|
0000c0c0  62 6c 65 20 61 75 74 6f  6d 61 74 69 63 20 70 69  |ble automatic pi|
0000c0d0  78 65 6c 20 73 69 7a 65  20 63 6f 72 72 65 63 74  |xel size correct|
0000c0e0  69 6f 6e 0a 2d 6e 6f 73  69 7a 65 20 20 20 64 69  |ion.-nosize   di|
0000c0f0  73 61 62 6c 65 20 61 75  74 6f 6d 61 74 69 63 20  |sable automatic |
0000c100  70 69 78 65 6c 20 73 69  7a 65 20 63 6f 72 72 65  |pixel size corre|
0000c110  63 74 69 6f 6e 20 66 6f  72 20 69 6e 70 75 74 20  |ction for input |
0000c120  70 69 78 65 6c 73 20 6f  6e 6c 79 0a 2d 6e 6f 64  |pixels only.-nod|
0000c130  69 74 68 65 72 20 64 69  73 61 62 6c 65 20 64 69  |ither disable di|
0000c140  74 68 65 72 69 6e 67 0a  2d 6e 6f 6d 6f 64 65 20  |thering.-nomode |
0000c150  20 20 64 6f 6e 27 74 20  63 68 61 6e 67 65 20 74  |  don't change t|
0000c160  6f 20 6d 6f 64 65 20 30  20 77 68 69 6c 65 20 70  |o mode 0 while p|
0000c170  72 6f 63 65 73 73 69 6e  67 20 74 68 65 20 70 69  |rocessing the pi|
0000c180  63 74 75 72 65 0a 2d 69  6e 76 65 72 74 20 20 20  |cture.-invert   |
0000c190  69 6e 76 65 72 74 20 63  6f 6c 6f 75 72 20 72 61  |invert colour ra|
0000c1a0  6e 67 65 20 6f 66 20 69  6d 61 67 65 0a 0a 2d 72  |nge of image..-r|
0000c1b0  61 6e 67 65 20 20 20 20  65 78 70 61 6e 64 20 69  |ange    expand i|
0000c1c0  6e 70 75 74 27 73 20 64  79 6e 61 6d 69 63 20 72  |nput's dynamic r|
0000c1d0  61 6e 67 65 20 74 6f 20  66 75 6c 6c 20 73 63 61  |ange to full sca|
0000c1e0  6c 65 0a 2d 65 71 75 61  6c 20 20 20 20 68 69 73  |le.-equal    his|
0000c1f0  74 6f 67 72 61 6d 20 65  71 75 61 6c 69 73 61 74  |togram equalisat|
0000c200  69 6f 6e 0a 2d 73 68 61  72 70 65 6e 20 20 64 69  |ion.-sharpen  di|
0000c210  67 69 74 61 6c 6c 79 20  73 68 61 72 70 65 6e 20  |gitally sharpen |
0000c220  74 68 65 20 70 69 63 74  75 72 65 0a 0a 2d 67 61  |the picture..-ga|
0000c230  6d 6d 61 20 20 20 20 73  65 74 20 67 61 6d 6d 61  |mma    set gamma|
0000c240  20 63 6f 72 72 65 63 74  69 6f 6e 0a 2d 62 6c 61  | correction.-bla|
0000c250  63 6b 20 20 20 20 63 6f  72 72 65 63 74 20 66 6f  |ck    correct fo|
0000c260  72 20 62 6c 61 63 6b 20  69 6e 6b 20 73 70 6f 74  |r black ink spot|
0000c270  20 73 69 7a 65 0a 2d 72  65 64 20 20 20 20 20 20  | size.-red      |
0000c280  63 68 61 6e 67 65 20 72  65 64 20 77 65 69 67 68  |change red weigh|
0000c290  74 20 66 6f 72 20 64 65  72 69 76 69 6e 67 20 6d  |t for deriving m|
0000c2a0  6f 6e 6f 63 68 72 6f 6d  65 20 6c 75 6d 69 6e 61  |onochrome lumina|
0000c2b0  6e 63 65 0a 2d 67 72 65  65 6e 20 20 20 20 63 68  |nce.-green    ch|
0000c2c0  61 6e 67 65 20 67 72 65  65 6e 20 77 65 69 67 68  |ange green weigh|
0000c2d0  74 20 66 6f 72 20 64 65  72 69 76 69 6e 67 20 6d  |t for deriving m|
0000c2e0  6f 6e 6f 63 68 72 6f 6d  65 20 6c 75 6d 69 6e 61  |onochrome lumina|
0000c2f0  6e 63 65 0a 2d 62 6c 75  65 20 20 20 20 20 63 68  |nce.-blue     ch|
0000c300  61 6e 67 65 20 62 6c 75  65 20 77 65 69 67 68 74  |ange blue weight|
0000c310  20 66 6f 72 20 64 65 72  69 76 69 6e 67 20 6d 6f  | for deriving mo|
0000c320  6e 6f 63 68 72 6f 6d 65  20 6c 75 6d 69 6e 61 6e  |nochrome luminan|
0000c330  63 65 0a 0a 2d 62 72 69  67 68 74 65 6e 20 68 6f  |ce..-brighten ho|
0000c340  72 72 65 6e 64 6f 75 73  20 68 61 63 6b 20 74 6f  |rrendous hack to|
0000c350  20 73 6c 69 67 68 74 6c  79 20 62 72 69 67 68 74  | slightly bright|
0000c360  65 6e 20 69 6d 61 67 65  73 3a 20 6d 61 79 20 63  |en images: may c|
0000c370  6f 6e 76 65 72 74 20 68  75 65 73 0a 20 20 20 20  |onvert hues.    |
0000c380  20 20 20 20 20 20 63 6c  6f 73 65 20 74 6f 20 77  |      close to w|
0000c390  68 69 74 65 20 74 6f 20  77 68 69 74 65 2e 20 28  |hite to white. (|
0000c3a0  49 74 20 63 61 75 73 65  73 20 74 68 65 20 6f 75  |It causes the ou|
0000c3b0  74 70 75 74 20 72 61 6e  67 65 20 30 2e 2e 31 35  |tput range 0..15|
0000c3c0  20 74 6f 0a 20 20 20 20  20 20 20 20 20 20 62 65  | to.          be|
0000c3d0  20 63 6f 6e 73 69 64 65  72 65 64 20 61 73 20 30  | considered as 0|
0000c3e0  2e 2e 28 31 35 2f 31 36  29 20 69 6e 73 74 65 61  |..(15/16) instea|
0000c3f0  64 20 6f 66 20 30 2e 2e  28 31 35 2f 31 35 29 29  |d of 0..(15/15))|
0000c400  2e 0a 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |...             |
0000c410  20 20 20 20 20 20 20 20  20 20 20 20 20 20 4d 6f  |              Mo|
0000c420  64 65 20 53 75 66 66 69  78 65 73 0a 20 20 20 20  |de Suffixes.    |
0000c430  20 20 20 20 20 20 20 20  20 20 20 20 20 20 20 20  |                |
0000c440  20 20 20 20 20 20 20 3d  3d 3d 3d 3d 3d 3d 3d 3d  |       =========|
0000c450  3d 3d 3d 3d 0a 0a 63 0a  20 20 31 20 62 69 74 20  |====..c.  1 bit |
0000c460  6d 6f 64 65 73 3a 20 75  73 65 20 63 6c 75 73 74  |modes: use clust|
0000c470  65 72 65 64 20 64 69 74  68 65 72 69 6e 67 20 77  |ered dithering w|
0000c480  69 74 68 20 34 78 34 20  63 65 6c 6c 0a 20 20 32  |ith 4x4 cell.  2|
0000c490  20 62 69 74 20 6d 6f 64  65 73 3a 20 75 73 65 20  | bit modes: use |
0000c4a0  74 68 65 20 66 6f 75 72  20 63 6f 6c 6f 75 72 73  |the four colours|
0000c4b0  20 22 62 6c 61 63 6b 22  2c 20 22 63 79 61 6e 22  | "black", "cyan"|
0000c4c0  2c 20 22 6d 61 67 65 6e  74 61 22 20 61 6e 64 20  |, "magenta" and |
0000c4d0  22 79 65 6c 6c 6f 77 22  0a 64 0a 20 20 31 20 62  |"yellow".d.  1 b|
0000c4e0  69 74 20 6d 6f 64 65 73  3a 20 75 73 65 20 63 6c  |it modes: use cl|
0000c4f0  75 73 74 65 72 65 64 20  64 69 74 68 65 72 69 6e  |ustered ditherin|
0000c500  67 20 77 69 74 68 20 32  78 32 20 63 65 6c 6c 0a  |g with 2x2 cell.|
0000c510  20 20 34 20 62 69 74 20  6d 6f 64 65 73 3a 20 75  |  4 bit modes: u|
0000c520  73 65 20 31 20 62 69 74  20 72 65 64 2c 20 31 20  |se 1 bit red, 1 |
0000c530  62 69 74 20 67 72 65 65  6e 2c 20 31 20 62 69 74  |bit green, 1 bit|
0000c540  20 62 6c 75 65 0a 20 20  38 20 62 69 74 20 6d 6f  | blue.  8 bit mo|
0000c550  64 65 73 3a 20 75 73 65  20 32 35 36 20 6c 65 76  |des: use 256 lev|
0000c560  65 6c 20 67 72 65 79 20  73 63 61 6c 65 0a 74 0a  |el grey scale.t.|
0000c570  20 20 31 20 62 69 74 20  6d 6f 64 65 73 3a 20 75  |  1 bit modes: u|
0000c580  73 65 20 63 6c 75 73 74  65 72 65 64 20 64 69 74  |se clustered dit|
0000c590  68 65 72 69 6e 67 20 77  69 74 68 20 33 78 33 20  |hering with 3x3 |
0000c5a0  63 65 6c 6c 0a 20 20 34  20 62 69 74 20 6d 6f 64  |cell.  4 bit mod|
0000c5b0  65 73 3a 20 31 36 20 6c  65 76 65 6c 20 67 72 65  |es: 16 level gre|
0000c5c0  79 20 73 63 61 6c 65 0a  72 0a 20 20 32 20 62 69  |y scale.r.  2 bi|
0000c5d0  74 20 6d 6f 64 65 73 3a  20 52 6f 67 65 72 20 57  |t modes: Roger W|
0000c5e0  69 6c 73 6f 6e 27 73 20  28 6d 65 29 20 63 6f 6c  |ilson's (me) col|
0000c5f0  6f 75 72 20 6d 61 74 63  68 69 6e 67 20 61 6c 67  |our matching alg|
0000c600  6f 72 69 74 68 6d 0a 20  20 34 20 62 69 74 20 6d  |orithm.  4 bit m|
0000c610  6f 64 65 73 3a 20 52 6f  67 65 72 20 57 69 6c 73  |odes: Roger Wils|
0000c620  6f 6e 27 73 20 28 6d 65  29 20 63 6f 6c 6f 75 72  |on's (me) colour|
0000c630  20 6d 61 74 63 68 69 6e  67 20 61 6c 67 6f 72 69  | matching algori|
0000c640  74 68 6d 0a 20 20 38 20  62 69 74 20 6d 6f 64 65  |thm.  8 bit mode|
0000c650  73 3a 20 52 6f 67 65 72  20 57 69 6c 73 6f 6e 27  |s: Roger Wilson'|
0000c660  73 20 28 6d 65 29 20 63  6f 6c 6f 75 72 20 6d 61  |s (me) colour ma|
0000c670  74 63 68 69 6e 67 20 61  6c 67 6f 72 69 74 68 6d  |tching algorithm|
0000c680  0a 2d 6e 6f 20 73 75 66  66 69 78 2d 0a 20 20 31  |.-no suffix-.  1|
0000c690  20 62 69 74 20 6d 6f 64  65 73 3a 20 62 2f 77 20  | bit modes: b/w |
0000c6a0  64 69 73 70 65 72 73 65  64 20 64 6f 74 20 64 69  |dispersed dot di|
0000c6b0  74 68 65 72 69 6e 67 0a  20 20 32 20 62 69 74 20  |thering.  2 bit |
0000c6c0  6d 6f 64 65 73 3a 20 34  20 6c 65 76 65 6c 20 67  |modes: 4 level g|
0000c6d0  72 65 79 20 73 63 61 6c  65 0a 20 20 34 20 62 69  |rey scale.  4 bi|
0000c6e0  74 20 6d 6f 64 65 73 3a  20 38 20 6c 65 76 65 6c  |t modes: 8 level|
0000c6f0  20 67 72 65 79 20 73 63  61 6c 65 0a 20 20 38 20  | grey scale.  8 |
0000c700  62 69 74 20 6d 6f 64 65  73 3a 20 4a 6f 68 6e 20  |bit modes: John |
0000c710  42 6f 77 6c 65 72 27 73  20 63 6f 6c 6f 75 72 20  |Bowler's colour |
0000c720  6d 61 74 63 68 69 6e 67  20 61 6c 67 6f 72 69 74  |matching algorit|
0000c730  68 6d 0a 20 20 20 20 20  20 20 20 20 20 20 20 20  |hm.             |
0000c740  20 20 28 64 65 66 61 75  6c 74 73 20 74 6f 20 27  |  (defaults to '|
0000c750  72 27 20 6d 6f 64 65 20  69 66 20 6e 6f 74 20 56  |r' mode if not V|
0000c760  49 44 43 31 20 63 6f 6d  70 61 74 69 62 6c 65 29  |IDC1 compatible)|
0000c770  0a 0a 43 6f 6c 6f 75 72  20 6d 61 74 63 68 69 6e  |..Colour matchin|
0000c780  67 20 69 73 20 64 6f 6e  65 20 69 6e 20 72 2c 20  |g is done in r, |
0000c790  67 2c 20 62 20 73 70 61  63 65 3a 20 74 68 65 20  |g, b space: the |
0000c7a0  6d 69 6e 69 6d 75 6d 20  64 69 73 74 61 6e 63 65  |minimum distance|
0000c7b0  20 62 65 74 77 65 65 6e  20 63 6f 6c 6f 75 72 73  | between colours|
0000c7c0  0a 69 73 20 74 68 65 20  73 71 75 61 72 65 20 72  |.is the square r|
0000c7d0  6f 6f 74 20 6f 66 3a 0a  20 20 20 64 65 6c 74 61  |oot of:.   delta|
0000c7e0  5f 72 5e 32 2a 72 6d 61  74 63 68 77 74 2b 64 65  |_r^2*rmatchwt+de|
0000c7f0  6c 74 61 5f 67 5e 32 2a  67 6d 61 74 63 68 77 74  |lta_g^2*gmatchwt|
0000c800  2b 64 65 6c 74 61 5f 62  5e 32 2a 62 6d 61 74 63  |+delta_b^2*bmatc|
0000c810  68 77 74 0a 43 68 61 6e  67 65 46 53 49 20 68 61  |hwt.ChangeFSI ha|
0000c820  73 20 68 61 72 64 20 77  69 72 65 64 20 77 65 69  |s hard wired wei|
0000c830  67 68 74 73 20 6f 66 20  33 2c 20 31 30 2c 20 31  |ghts of 3, 10, 1|
0000c840  20 72 65 73 70 65 63 74  69 76 65 6c 79 20 66 6f  | respectively fo|
0000c850  72 20 69 74 73 20 63 6f  6c 6f 75 72 0a 6d 61 74  |r its colour.mat|
0000c860  63 68 69 6e 67 20 61 6c  67 6f 72 69 74 68 6d 73  |ching algorithms|
0000c870  2e 20 4a 6f 68 6e 20 42  6f 77 6c 65 72 27 73 20  |. John Bowler's |
0000c880  61 6c 67 6f 72 69 74 68  6d 20 28 64 65 66 61 75  |algorithm (defau|
0000c890  6c 74 20 66 6f 72 20 52  49 53 43 20 4f 53 20 38  |lt for RISC OS 8|
0000c8a0  20 62 69 74 20 6d 6f 64  65 73 29 0a 61 6c 74 68  | bit modes).alth|
0000c8b0  6f 75 67 68 20 73 6f 6d  65 77 68 61 74 20 73 6c  |ough somewhat sl|
0000c8c0  6f 77 65 72 2c 20 69 73  20 66 61 73 74 20 65 6e  |ower, is fast en|
0000c8d0  6f 75 67 68 20 74 6f 20  68 61 76 65 20 72 65 70  |ough to have rep|
0000c8e0  6c 61 63 65 64 20 61 6c  6c 20 74 68 65 20 70 72  |laced all the pr|
0000c8f0  65 76 69 6f 75 73 0a 6d  65 74 68 6f 64 73 20 5b  |evious.methods [|
0000c900  41 53 49 44 45 20 69 74  20 67 69 76 65 73 20 70  |ASIDE it gives p|
0000c910  69 63 74 75 72 65 73 20  61 74 20 6c 65 61 73 74  |ictures at least|
0000c920  20 61 73 20 67 6f 6f 64  20 61 73 20 22 70 22 20  | as good as "p" |
0000c930  6d 6f 64 65 20 69 6e 20  70 72 65 20 41 75 67 20  |mode in pre Aug |
0000c940  39 31 0a 43 68 61 6e 67  65 46 53 49 27 73 5d 2e  |91.ChangeFSI's].|
0000c950  20 52 6f 67 65 72 20 57  69 6c 73 6f 6e 27 73 20  | Roger Wilson's |
0000c960  28 69 2e 65 2e 20 6d 79  29 20 63 6f 6c 6f 75 72  |(i.e. my) colour|
0000c970  20 6d 61 74 63 68 69 6e  67 20 61 6c 67 6f 72 69  | matching algori|
0000c980  74 68 6d 20 69 73 0a 72  65 63 6f 6d 6d 65 6e 64  |thm is.recommend|
0000c990  65 64 2c 20 61 6e 64 20  69 73 20 75 73 65 64 20  |ed, and is used |
0000c9a0  61 75 74 6f 6d 61 74 69  63 61 6c 6c 79 20 69 66  |automatically if|
0000c9b0  20 74 68 65 20 38 20 62  69 74 20 70 65 72 20 70  | the 8 bit per p|
0000c9c0  69 78 65 6c 20 6d 6f 64  65 20 64 6f 65 73 20 6e  |ixel mode does n|
0000c9d0  6f 74 0a 68 61 76 65 20  74 68 65 20 64 65 66 61  |ot.have the defa|
0000c9e0  75 6c 74 20 52 49 53 43  20 4f 53 20 63 6f 6c 6f  |ult RISC OS colo|
0000c9f0  75 72 20 73 65 74 2e 0a  0a 5b 4e 4f 54 45 3a 20  |ur set...[NOTE: |
0000ca00  74 68 61 6e 6b 73 20 61  72 65 20 64 75 65 20 74  |thanks are due t|
0000ca10  6f 20 53 74 65 76 65 20  47 72 65 65 6e 20 61 6e  |o Steve Green an|
0000ca20  64 20 74 68 65 20 42 42  43 20 61 6e 64 20 49 72  |d the BBC and Ir|
0000ca30  6c 61 6d 20 49 6e 73 74  72 75 6d 65 6e 74 73 20  |lam Instruments |
0000ca40  66 6f 72 20 74 68 65 0a  69 6e 74 65 72 6d 65 64  |for the.intermed|
0000ca50  69 61 74 65 20 73 79 73  74 65 6d 73 20 74 68 61  |iate systems tha|
0000ca60  74 20 6c 65 64 20 74 6f  20 4a 6f 68 6e 20 42 6f  |t led to John Bo|
0000ca70  77 6c 65 72 27 73 20 61  6e 64 20 6d 79 20 61 6c  |wler's and my al|
0000ca80  67 6f 72 69 74 68 6d 73  3a 20 75 6e 74 69 6c 20  |gorithms: until |
0000ca90  41 75 67 20 39 31 0a 43  68 61 6e 67 65 46 53 49  |Aug 91.ChangeFSI|
0000caa0  20 75 73 65 64 20 74 68  65 69 72 20 77 6f 72 6b  | used their work|
0000cab0  20 66 6f 72 20 69 74 73  20 22 50 72 65 63 69 73  | for its "Precis|
0000cac0  65 20 4d 61 74 63 68 69  6e 67 22 20 61 6c 67 6f  |e Matching" algo|
0000cad0  72 69 74 68 6d 2e 20 49  74 20 6e 6f 20 6c 6f 6e  |rithm. It no lon|
0000cae0  67 65 72 0a 75 73 65 73  20 61 6e 79 20 6f 66 20  |ger.uses any of |
0000caf0  74 68 65 69 72 20 63 6f  64 65 2c 20 62 75 74 20  |their code, but |
0000cb00  6f 77 65 73 20 61 20 64  65 62 74 20 66 6f 72 20  |owes a debt for |
0000cb10  6f 76 65 72 61 6c 6c 20  61 70 70 72 6f 61 63 68  |overall approach|
0000cb20  2e 20 41 20 73 6d 61 6c  6c 20 74 68 61 6e 6b 20  |. A small thank |
0000cb30  79 6f 75 0a 74 6f 20 53  70 65 6e 63 65 72 20 54  |you.to Spencer T|
0000cb40  68 6f 6d 61 73 20 66 6f  72 20 70 75 74 74 69 6e  |homas for puttin|
0000cb50  67 20 6d 65 20 6f 6e 20  74 68 65 20 74 72 61 63  |g me on the trac|
0000cb60  6b 20 77 68 69 63 68 20  6c 65 64 20 74 6f 20 6d  |k which led to m|
0000cb70  79 20 63 6f 6c 6f 75 72  20 6d 61 74 63 68 69 6e  |y colour matchin|
0000cb80  67 0a 73 79 73 74 65 6d  27 73 20 61 6c 67 6f 72  |g.system's algor|
0000cb90  69 74 68 6d 2e 5d 0a 0a  46 75 72 74 68 65 72 20  |ithm.]..Further |
0000cba0  69 6e 66 6f 72 6d 61 74  69 6f 6e 20 6f 6e 20 64  |information on d|
0000cbb0  69 74 68 65 72 69 6e 67  20 63 61 6e 20 62 65 20  |ithering can be |
0000cbc0  66 6f 75 6e 64 20 69 6e  20 22 44 69 67 69 74 61  |found in "Digita|
0000cbd0  6c 20 48 61 6c 66 74 6f  6e 69 6e 67 22 20 62 79  |l Halftoning" by|
0000cbe0  20 52 6f 62 65 72 74 0a  55 6c 69 63 68 6e 65 79  | Robert.Ulichney|
0000cbf0  20 70 75 62 6c 69 73 68  65 64 20 62 79 20 74 68  | published by th|
0000cc00  65 20 4d 49 54 20 50 72  65 73 73 2c 20 49 53 42  |e MIT Press, ISB|
0000cc10  4e 20 30 2d 32 36 32 2d  32 31 30 30 39 2d 36 2e  |N 0-262-21009-6.|
0000cc20  20 41 20 62 6f 6f 6b 20  77 68 69 63 68 20 49 20  | A book which I |
0000cc30  77 69 73 68 0a 49 27 64  20 68 61 64 20 77 68 65  |wish.I'd had whe|
0000cc40  6e 20 49 20 73 74 61 72  74 65 64 20 77 72 69 74  |n I started writ|
0000cc50  69 6e 67 20 74 68 65 20  70 72 6f 67 72 61 6d 2c  |ing the program,|
0000cc60  20 72 61 74 68 65 72 20  74 68 61 6e 20 61 66 74  | rather than aft|
0000cc70  65 72 20 69 74 20 77 61  73 20 6e 65 61 72 6c 79  |er it was nearly|
0000cc80  0a 66 69 6e 69 73 68 65  64 21 20 48 69 73 74 6f  |.finished! Histo|
0000cc90  67 72 61 6d 20 65 71 75  61 6c 69 73 61 74 69 6f  |gram equalisatio|
0000cca0  6e 20 69 73 20 69 6e 20  22 41 6c 67 6f 72 69 74  |n is in "Algorit|
0000ccb0  68 6d 73 20 66 6f 72 20  47 72 61 70 68 69 63 73  |hms for Graphics|
0000ccc0  20 61 6e 64 20 49 6d 61  67 65 0a 50 72 6f 63 65  | and Image.Proce|
0000ccd0  73 73 69 6e 67 22 20 62  79 20 54 68 65 6f 20 50  |ssing" by Theo P|
0000cce0  61 76 6c 69 64 69 73 20  70 75 62 6c 69 73 68 65  |avlidis publishe|
0000ccf0  64 20 62 79 20 43 6f 6d  70 75 74 65 72 20 53 63  |d by Computer Sc|
0000cd00  69 65 6e 63 65 20 50 72  65 73 73 2c 20 49 53 42  |ience Press, ISB|
0000cd10  4e 0a 30 2d 39 31 34 38  39 34 2d 36 35 2d 58 2e  |N.0-914894-65-X.|
0000cd20  0a                                                |.|
0000cd21