/ BCI NET 2 / BCI NET 2.iso / archives / programming / libraries / mui23_autodocs.lha / MUI23_Autodocs / Source / mui_bitmap.tex

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 69 74 6d 61 70 2e |\section|{Bitmap.|
|00000010| 6d 75 69 7d 0a 0a 54 68 | 65 20 42 69 74 6d 61 70 |mui}..Th|e Bitmap|
|00000020| 20 63 6c 61 73 73 20 61 | 6c 6c 6f 77 73 20 69 6e | class a|llows in|
|00000030| 63 6c 75 64 69 6e 67 20 | 73 65 6c 66 2d 6d 61 64 |cluding |self-mad|
|00000040| 65 20 69 6d 61 67 65 20 | 64 61 74 61 20 69 6e 20 |e image |data in |
|00000050| 4d 55 49 0a 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |MUI.appl|ications|
|00000060| 2e 20 55 73 75 61 6c 6c | 79 2c 20 69 6d 61 67 65 |. Usuall|y, image|
|00000070| 20 63 6c 61 73 73 20 77 | 61 73 20 69 6e 74 65 6e | class w|as inten|
|00000080| 64 65 64 20 74 6f 20 62 | 65 20 75 73 65 64 20 66 |ded to b|e used f|
|00000090| 6f 72 0a 74 68 69 73 20 | 70 75 72 70 6f 73 65 20 |or.this |purpose |
|000000a0| 62 75 74 20 75 6e 66 6f | 72 74 75 6e 61 74 65 6c |but unfo|rtunatel|
|000000b0| 79 2c 20 69 74 73 20 64 | 65 73 69 67 6e 20 77 61 |y, its d|esign wa|
|000000c0| 73 20 6e 6f 74 20 76 65 | 72 79 20 75 73 65 66 75 |s not ve|ry usefu|
|000000d0| 6c 2e 0a 0a 49 6e 20 69 | 74 73 20 6d 6f 73 74 20 |l...In i|ts most |
|000000e0| 73 69 6d 70 6c 65 20 75 | 73 61 67 65 2c 20 42 69 |simple u|sage, Bi|
|000000f0| 74 6d 61 70 20 63 6c 61 | 73 73 20 6a 75 73 74 20 |tmap cla|ss just |
|00000100| 64 69 73 70 6c 61 79 20 | 61 20 67 69 76 65 6e 0a |display |a given.|
|00000110| 42 69 74 4d 61 70 2e 20 | 48 6f 77 65 76 65 72 2c |BitMap. |However,|
|00000120| 20 79 6f 75 20 63 61 6e | 20 61 6c 73 6f 20 74 65 | you can| also te|
|00000130| 6c 6c 20 69 74 20 74 6f | 20 64 6f 20 61 75 74 6f |ll it to| do auto|
|00000140| 6d 61 74 69 63 20 63 6f | 6c 6f 72 0a 72 65 6d 61 |matic co|lor.rema|
|00000150| 70 70 69 6e 67 20 74 6f | 20 6d 61 74 63 68 20 74 |pping to| match t|
|00000160| 68 65 20 63 75 72 72 65 | 6e 74 20 64 69 73 70 6c |he curre|nt displ|
|00000170| 61 79 20 63 6f 6e 74 65 | 78 74 20 61 6e 64 20 79 |ay conte|xt and y|
|00000180| 6f 75 20 63 61 6e 0a 64 | 65 66 69 6e 65 20 61 20 |ou can.d|efine a |
|00000190| 74 72 61 6e 73 70 61 72 | 65 6e 74 20 63 6f 6c 6f |transpar|ent colo|
|000001a0| 72 20 74 6f 20 6d 61 6b | 65 20 74 68 65 20 42 69 |r to mak|e the Bi|
|000001b0| 74 4d 61 70 20 61 70 70 | 65 61 72 20 6f 6e 20 61 |tMap app|ear on a|
|000001c0| 6e 79 0a 62 61 63 6b 67 | 72 6f 75 6e 64 2e 0a 0a |ny.backg|round...|
|000001d0| 5c 73 75 62 73 65 63 74 | 69 6f 6e 5b 4d 55 49 41 |\subsect|ion[MUIA|
|000001e0| 5c 5f 42 69 74 6d 61 70 | 5c 5f 42 69 74 6d 61 70 |\_Bitmap|\_Bitmap|
|000001f0| 5d 7b 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |]{MUIA\_|Bitmap\_|
|00000200| 42 69 74 6d 61 70 20 2d | 2d 20 28 56 38 29 20 5b |Bitmap -|- (V8) [|
|00000210| 49 53 47 5d 2c 20 73 74 | 72 75 63 74 20 42 69 74 |ISG], st|ruct Bit|
|00000220| 4d 61 70 20 24 5c 61 73 | 74 24 7d 0a 0a 5c 73 75 |Map $\as|t$}..\su|
|00000230| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 46 55 4e |bsubsect|ion*{FUN|
|00000240| 43 54 49 4f 4e 7d 0a 54 | 68 69 73 20 61 74 74 72 |CTION}.T|his attr|
|00000250| 69 62 75 74 65 20 73 70 | 65 63 69 66 69 65 73 20 |ibute sp|ecifies |
|00000260| 61 20 70 6f 69 6e 74 65 | 72 20 74 6f 20 61 20 73 |a pointe|r to a s|
|00000270| 74 72 75 63 74 20 42 69 | 74 4d 61 70 2e 20 4e 6f |truct Bi|tMap. No|
|00000280| 74 65 0a 74 68 61 74 20 | 73 70 65 63 69 66 79 69 |te.that |specifyi|
|00000290| 6e 67 20 6f 6e 6c 79 20 | 61 20 42 69 74 4d 61 70 |ng only |a BitMap|
|000002a0| 20 69 73 6e 27 74 20 65 | 6e 6f 75 67 68 2c 20 79 | isn't e|nough, y|
|000002b0| 6f 75 20 68 61 76 65 20 | 74 6f 20 74 65 6c 6c 0a |ou have |to tell.|
|000002c0| 4d 55 49 20 61 62 6f 75 | 74 20 74 68 65 20 70 69 |MUI abou|t the pi|
|000002d0| 78 65 6c 20 77 69 64 74 | 68 20 61 6e 64 20 68 65 |xel widt|h and he|
|000002e0| 69 67 68 74 20 77 69 74 | 68 20 4d 55 49 41 5c 5f |ight wit|h MUIA\_|
|000002f0| 42 69 74 6d 61 70 5c 5f | 57 69 64 74 68 0a 61 6e |Bitmap\_|Width.an|
|00000300| 64 20 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |d MUIA\_|Bitmap\_|
|00000310| 48 65 69 67 68 74 20 74 | 6f 6f 2e 0a 0a 5c 73 75 |Height t|oo...\su|
|00000320| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 53 45 45 |bsubsect|ion*{SEE|
|00000330| 20 41 4c 53 4f 7d 0a 4d | 55 49 41 5c 5f 42 69 74 | ALSO}.M|UIA\_Bit|
|00000340| 6d 61 70 5c 5f 57 69 64 | 74 68 2c 20 4d 55 49 41 |map\_Wid|th, MUIA|
|00000350| 5c 5f 42 69 74 6d 61 70 | 5c 5f 48 65 69 67 68 74 |\_Bitmap|\_Height|
|00000360| 2c 20 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |, MUIA\_|Bitmap\_|
|00000370| 54 72 61 6e 73 70 61 72 | 65 6e 74 2c 0a 4d 55 49 |Transpar|ent,.MUI|
|00000380| 41 5c 5f 42 69 74 6d 61 | 70 5c 5f 53 6f 75 72 63 |A\_Bitma|p\_Sourc|
|00000390| 65 43 6f 6c 6f 72 73 2c | 20 4d 55 49 41 5c 5f 42 |eColors,| MUIA\_B|
|000003a0| 69 74 6d 61 70 5c 5f 4d | 61 70 70 69 6e 67 54 61 |itmap\_M|appingTa|
|000003b0| 62 6c 65 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |ble..\su|bsection|
|000003c0| 5b 4d 55 49 41 5c 5f 42 | 69 74 6d 61 70 5c 5f 48 |[MUIA\_B|itmap\_H|
|000003d0| 65 69 67 68 74 5d 7b 4d | 55 49 41 5c 5f 42 69 74 |eight]{M|UIA\_Bit|
|000003e0| 6d 61 70 5c 5f 48 65 69 | 67 68 74 20 2d 2d 20 28 |map\_Hei|ght -- (|
|000003f0| 56 38 29 20 5b 49 53 47 | 5d 2c 20 4c 4f 4e 47 7d |V8) [ISG|], LONG}|
|00000400| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00000410| 2a 7b 46 55 4e 43 54 49 | 4f 4e 7d 0a 44 65 66 69 |*{FUNCTI|ON}.Defi|
|00000420| 6e 65 20 74 68 65 20 70 | 69 78 65 6c 20 68 65 69 |ne the p|ixel hei|
|00000430| 67 68 74 20 6f 66 20 74 | 68 65 20 42 69 74 4d 61 |ght of t|he BitMa|
|00000440| 70 2e 0a 0a 5c 73 75 62 | 73 75 62 73 65 63 74 69 |p...\sub|subsecti|
|00000450| 6f 6e 2a 7b 4e 4f 54 45 | 7d 0a 42 79 20 64 65 66 |on*{NOTE|}.By def|
|00000460| 61 75 6c 74 2c 20 74 68 | 65 20 62 69 74 6d 61 70 |ault, th|e bitmap|
|00000470| 20 6f 62 6a 65 63 74 20 | 68 61 73 20 61 20 6d 69 | object |has a mi|
|00000480| 6e 69 6d 75 6d 20 73 69 | 7a 65 20 6f 66 0a 31 20 |nimum si|ze of.1 |
|00000490| 70 69 78 65 6c 20 61 6e | 64 20 61 6e 20 75 6e 6c |pixel an|d an unl|
|000004a0| 69 6d 69 74 65 64 20 6d | 61 78 69 75 6d 20 73 69 |imited m|axium si|
|000004b0| 7a 65 2e 20 49 66 20 74 | 68 65 20 73 70 61 63 65 |ze. If t|he space|
|000004c0| 20 69 73 0a 74 6f 6f 20 | 73 6d 61 6c 6c 20 74 6f | is.too |small to|
|000004d0| 20 68 6f 6c 64 20 79 6f | 75 72 20 42 69 74 4d 61 | hold yo|ur BitMa|
|000004e0| 70 2c 20 69 74 20 77 69 | 6c 6c 20 62 65 20 63 6c |p, it wi|ll be cl|
|000004f0| 69 70 70 65 64 2e 0a 55 | 73 75 61 6c 6c 79 2c 20 |ipped..U|sually, |
|00000500| 79 6f 75 20 77 69 6c 6c | 20 75 73 65 20 4d 55 49 |you will| use MUI|
|00000510| 41 5c 5f 46 69 78 57 69 | 64 74 68 20 61 6e 64 20 |A\_FixWi|dth and |
|00000520| 4d 55 49 41 5c 5f 46 69 | 78 48 65 69 67 68 74 0a |MUIA\_Fi|xHeight.|
|00000530| 77 69 74 68 20 42 69 74 | 4d 61 70 20 6f 62 6a 65 |with Bit|Map obje|
|00000540| 63 74 73 20 74 6f 20 6d | 61 6b 65 20 74 68 65 6d |cts to m|ake them|
|00000550| 20 61 6c 77 61 79 73 20 | 65 78 61 63 74 6c 79 20 | always |exactly |
|00000560| 61 73 20 62 69 67 20 61 | 73 0a 74 68 65 20 62 69 |as big a|s.the bi|
|00000570| 74 6d 61 70 2e 0a 0a 5c | 73 75 62 73 75 62 73 65 |tmap...\|subsubse|
|00000580| 63 74 69 6f 6e 2a 7b 53 | 45 45 20 41 4c 53 4f 7d |ction*{S|EE ALSO}|
|00000590| 0a 4d 55 49 41 5c 5f 42 | 69 74 6d 61 70 5c 5f 42 |.MUIA\_B|itmap\_B|
|000005a0| 69 74 6d 61 70 2c 20 4d | 55 49 41 5c 5f 42 69 74 |itmap, M|UIA\_Bit|
|000005b0| 6d 61 70 5c 5f 57 69 64 | 74 68 2c 20 4d 55 49 41 |map\_Wid|th, MUIA|
|000005c0| 5c 5f 42 69 74 6d 61 70 | 5c 5f 54 72 61 6e 73 70 |\_Bitmap|\_Transp|
|000005d0| 61 72 65 6e 74 2c 0a 4d | 55 49 41 5c 5f 42 69 74 |arent,.M|UIA\_Bit|
|000005e0| 6d 61 70 5c 5f 53 6f 75 | 72 63 65 43 6f 6c 6f 72 |map\_Sou|rceColor|
|000005f0| 73 2c 20 4d 55 49 41 5c | 5f 42 69 74 6d 61 70 5c |s, MUIA\|_Bitmap\|
|00000600| 5f 4d 61 70 70 69 6e 67 | 54 61 62 6c 65 0a 0a 5c |_Mapping|Table..\|
|00000610| 73 75 62 73 65 63 74 69 | 6f 6e 5b 4d 55 49 41 5c |subsecti|on[MUIA\|
|00000620| 5f 42 69 74 6d 61 70 5c | 5f 4d 61 70 70 69 6e 67 |_Bitmap\|_Mapping|
|00000630| 54 61 62 6c 65 5d 7b 4d | 55 49 41 5c 5f 42 69 74 |Table]{M|UIA\_Bit|
|00000640| 6d 61 70 5c 5f 4d 61 70 | 70 69 6e 67 54 61 62 6c |map\_Map|pingTabl|
|00000650| 65 20 2d 2d 20 28 56 38 | 29 20 5b 49 53 47 5d 2c |e -- (V8|) [ISG],|
|00000660| 20 55 42 59 54 45 20 24 | 5c 61 73 74 24 7d 0a 0a | UBYTE $|\ast$}..|
|00000670| 5c 73 75 62 73 75 62 73 | 65 63 74 69 6f 6e 2a 7b |\subsubs|ection*{|
|00000680| 46 55 4e 43 54 49 4f 4e | 7d 0a 41 64 64 72 65 73 |FUNCTION|}.Addres|
|00000690| 73 20 6f 66 20 61 6e 20 | 61 72 72 61 79 20 6f 66 |s of an |array of|
|000006a0| 20 55 42 59 54 45 73 2c | 20 6f 6e 65 20 66 6f 72 | UBYTEs,| one for|
|000006b0| 20 65 61 63 68 20 63 6f | 6c 6f 72 20 6f 66 20 74 | each co|lor of t|
|000006c0| 68 65 0a 73 6f 75 72 63 | 65 20 42 69 74 4d 61 70 |he.sourc|e BitMap|
|000006d0| 2e 20 4d 55 49 20 77 69 | 6c 6c 20 72 65 6d 61 70 |. MUI wi|ll remap|
|000006e0| 20 74 68 65 20 42 69 74 | 4d 61 70 20 61 63 63 6f | the Bit|Map acco|
|000006f0| 72 64 69 6e 67 20 74 6f | 20 74 68 65 0a 63 6f 6e |rding to| the.con|
|00000700| 74 65 6e 74 73 20 6f 66 | 20 74 68 65 20 61 72 72 |tents of| the arr|
|00000710| 61 79 2e 0a 0a 53 69 6e | 63 65 20 4d 55 49 20 61 |ay...Sin|ce MUI a|
|00000720| 70 70 6c 69 63 61 74 69 | 6f 6e 73 20 75 73 75 61 |pplicati|ons usua|
|00000730| 6c 6c 79 20 64 6f 6e 27 | 74 20 6b 6e 6f 77 20 61 |lly don'|t know a|
|00000740| 62 6f 75 74 20 74 68 65 | 69 72 0a 64 69 73 70 6c |bout the|ir.displ|
|00000750| 61 79 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 2c 20 |ay envir|onment, |
|00000760| 74 68 69 73 20 74 61 67 | 20 69 73 20 72 61 72 65 |this tag| is rare|
|00000770| 6c 79 20 75 73 65 64 2e | 20 49 6e 73 74 65 61 64 |ly used.| Instead|
|00000780| 2c 0a 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |,.MUIA\_|Bitmap\_|
|00000790| 53 6f 75 72 63 65 43 6f | 6c 6f 72 73 20 63 61 6e |SourceCo|lors can|
|000007a0| 20 62 65 20 75 73 65 64 | 20 74 6f 20 61 6c 6c 6f | be used| to allo|
|000007b0| 77 20 63 6f 6e 74 65 78 | 74 0a 73 65 6e 73 69 74 |w contex|t.sensit|
|000007c0| 69 76 65 20 63 6f 6c 6f | 72 20 72 65 6d 61 70 70 |ive colo|r remapp|
|000007d0| 69 6e 67 2e 0a 0a 5c 73 | 75 62 73 75 62 73 65 63 |ing...\s|ubsubsec|
|000007e0| 74 69 6f 6e 2a 7b 53 45 | 45 20 41 4c 53 4f 7d 0a |tion*{SE|E ALSO}.|
|000007f0| 4d 55 49 41 5c 5f 42 69 | 74 6d 61 70 5c 5f 42 69 |MUIA\_Bi|tmap\_Bi|
|00000800| 74 6d 61 70 2c 20 4d 55 | 49 41 5c 5f 42 69 74 6d |tmap, MU|IA\_Bitm|
|00000810| 61 70 5c 5f 48 65 69 67 | 68 74 2c 20 4d 55 49 41 |ap\_Heig|ht, MUIA|
|00000820| 5c 5f 42 69 74 6d 61 70 | 5c 5f 57 69 64 74 68 2c |\_Bitmap|\_Width,|
|00000830| 0a 4d 55 49 41 5c 5f 42 | 69 74 6d 61 70 5c 5f 54 |.MUIA\_B|itmap\_T|
|00000840| 72 61 6e 73 70 61 72 65 | 6e 74 0a 0a 5c 73 75 62 |ranspare|nt..\sub|
|00000850| 73 65 63 74 69 6f 6e 5b | 4d 55 49 41 5c 5f 42 69 |section[|MUIA\_Bi|
|00000860| 74 6d 61 70 5c 5f 53 6f | 75 72 63 65 43 6f 6c 6f |tmap\_So|urceColo|
|00000870| 72 73 5d 7b 4d 55 49 41 | 5c 5f 42 69 74 6d 61 70 |rs]{MUIA|\_Bitmap|
|00000880| 5c 5f 53 6f 75 72 63 65 | 43 6f 6c 6f 72 73 20 2d |\_Source|Colors -|
|00000890| 2d 20 28 56 38 29 20 5b | 49 53 47 5d 2c 20 55 4c |- (V8) [|ISG], UL|
|000008a0| 4f 4e 47 20 24 5c 61 73 | 74 24 7d 0a 0a 5c 73 75 |ONG $\as|t$}..\su|
|000008b0| 62 73 75 62 73 65 63 74 | 69 6f 6e 2a 7b 46 55 4e |bsubsect|ion*{FUN|
|000008c0| 43 54 49 4f 4e 7d 0a 54 | 68 69 73 20 61 74 74 72 |CTION}.T|his attr|
|000008d0| 69 62 75 74 65 20 64 65 | 66 69 6e 65 73 20 74 68 |ibute de|fines th|
|000008e0| 65 20 63 6f 6c 6f 72 20 | 70 61 6c 65 74 74 65 20 |e color |palette |
|000008f0| 6f 66 20 74 68 65 20 73 | 6f 75 72 63 65 0a 42 69 |of the s|ource.Bi|
|00000900| 74 4d 61 70 2e 20 49 66 | 20 73 70 65 63 69 66 69 |tMap. If| specifi|
|00000910| 65 64 2c 20 4d 55 49 20 | 77 69 6c 6c 20 74 72 79 |ed, MUI |will try|
|00000920| 20 74 6f 20 6c 6f 63 61 | 74 65 20 74 68 65 73 65 | to loca|te these|
|00000930| 20 63 6f 6c 6f 72 73 0a | 6f 6e 20 74 68 65 20 63 | colors.|on the c|
|00000940| 75 72 72 65 6e 74 20 73 | 63 72 65 65 6e 20 61 6e |urrent s|creen an|
|00000950| 64 20 72 65 6d 61 70 20 | 74 68 65 20 42 69 74 4d |d remap |the BitM|
|00000960| 61 70 20 61 63 63 6f 72 | 64 69 6e 67 6c 79 2e 0a |ap accor|dingly..|
|00000970| 0a 59 6f 75 20 63 61 6e | 20 65 2e 67 2e 20 73 70 |.You can| e.g. sp|
|00000980| 65 63 69 66 79 20 73 6f | 6d 65 20 67 72 65 61 74 |ecify so|me great|
|00000990| 20 6c 6f 6f 6b 69 6e 67 | 20 38 2d 63 6f 6c 6f 72 | looking| 8-color|
|000009a0| 20 69 6d 61 67 65 73 0a | 66 6f 72 20 73 65 76 65 | images.|for seve|
|000009b0| 72 61 6c 20 62 75 74 74 | 6f 6e 73 20 6f 66 20 79 |ral butt|ons of y|
|000009c0| 6f 75 72 20 61 70 70 6c | 69 63 61 74 69 6f 6e 20 |our appl|ication |
|000009d0| 61 6e 64 20 4d 55 49 20 | 77 69 6c 6c 0a 65 6e 73 |and MUI |will.ens|
|000009e0| 75 72 65 20 74 68 65 79 | 20 6c 6f 6f 6b 20 66 69 |ure they| look fi|
|000009f0| 6e 65 20 65 76 65 6e 20 | 6f 6e 20 34 2d 63 6f 6c |ne even |on 4-col|
|00000a00| 6f 72 20 73 63 72 65 65 | 6e 73 20 6f 72 20 6f 6e |or scree|ns or on|
|00000a10| 0a 73 63 72 65 65 6e 73 | 20 77 69 74 68 20 63 6f |.screens| with co|
|00000a20| 6d 70 6c 65 74 65 6c 79 | 20 64 69 66 66 65 72 65 |mpletely| differe|
|00000a30| 6e 74 20 63 6f 6c 6f 72 | 73 2e 0a 0a 57 68 65 6e |nt color|s...When|
|00000a40| 20 72 75 6e 6e 69 6e 67 | 20 4b 69 63 6b 73 74 61 | running| Kicksta|
|00000a50| 72 74 20 56 33 39 20 6f | 72 20 68 69 67 68 65 72 |rt V39 o|r higher|
|00000a60| 2c 20 4d 55 49 20 77 69 | 6c 6c 20 75 73 65 0a 4f |, MUI wi|ll use.O|
|00000a70| 62 74 61 69 6e 42 65 73 | 74 50 65 6e 28 29 20 74 |btainBes|tPen() t|
|00000a80| 6f 20 66 69 6e 64 20 6f | 72 20 63 72 65 61 74 65 |o find o|r create|
|00000a90| 20 79 6f 75 72 20 63 6f | 6c 6f 72 73 2e 0a 42 65 | your co|lors..Be|
|00000aa0| 6c 6f 77 20 56 33 39 2c | 20 61 20 73 69 6d 70 6c |low V39,| a simpl|
|00000ab0| 65 20 63 6f 6c 6f 72 2d | 6d 61 70 20 73 65 61 72 |e color-|map sear|
|00000ac0| 63 68 20 69 73 20 70 65 | 72 66 6f 72 6d 65 64 0a |ch is pe|rformed.|
|00000ad0| 74 6f 20 66 69 6e 64 20 | 74 68 65 20 62 65 73 74 |to find |the best|
|00000ae0| 20 6d 61 74 63 68 69 6e | 67 20 65 6e 74 72 79 2c | matchin|g entry,|
|00000af0| 20 62 75 74 20 6e 6f 20 | 63 6f 6c 6f 72 73 20 77 | but no |colors w|
|00000b00| 69 6c 6c 0a 62 65 20 63 | 68 61 6e 67 65 64 2e 0a |ill.be c|hanged..|
|00000b10| 0a 54 68 65 20 73 6f 75 | 72 63 65 20 70 61 6c 65 |.The sou|rce pale|
|00000b20| 74 74 65 20 69 73 20 73 | 70 65 63 69 66 69 65 64 |tte is s|pecified|
|00000b30| 20 77 69 74 68 20 61 6e | 20 61 72 72 61 79 20 6f | with an| array o|
|00000b40| 66 0a 55 4c 4f 4e 47 73 | 2c 20 74 68 72 65 65 20 |f.ULONGs|, three |
|00000b50| 65 6e 74 72 69 65 73 20 | 70 65 72 20 63 6f 6c 6f |entries |per colo|
|00000b60| 72 2c 20 33 32 62 69 74 | 73 20 70 65 72 20 67 75 |r, 32bit|s per gu|
|00000b70| 6e 2e 0a 0a 5c 73 75 62 | 73 75 62 73 65 63 74 69 |n...\sub|subsecti|
|00000b80| 6f 6e 2a 7b 45 58 41 4d | 50 4c 45 7d 0a 5c 73 6d |on*{EXAM|PLE}.\sm|
|00000b90| 61 6c 6c 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |all.\beg|in{verba|
|00000ba0| 74 69 6d 7d 0a 2f 2a 20 | 4d 61 67 69 63 57 42 2d |tim}./* |MagicWB-|
|00000bb0| 6c 69 6b 65 20 70 61 6c | 65 74 74 65 20 66 6f 72 |like pal|ette for|
|00000bc0| 20 61 6e 20 38 2d 63 6f | 6c 6f 72 20 69 6d 61 67 | an 8-co|lor imag|
|00000bd0| 65 20 2a 2f 0a 0a 63 6f | 6e 73 74 20 55 4c 4f 4e |e */..co|nst ULON|
|00000be0| 47 20 61 62 6f 75 74 6c | 6f 67 6f 5f 63 6f 6c 6f |G aboutl|ogo_colo|
|00000bf0| 72 73 5b 32 34 5d 20 3d | 0a 7b 0a 20 20 20 30 78 |rs[24] =|.{.   0x|
|00000c00| 61 61 61 61 61 61 61 61 | 2c 30 78 61 61 61 61 61 |aaaaaaaa|,0xaaaaa|
|00000c10| 61 61 61 2c 30 78 61 30 | 61 30 61 30 61 30 2c 0a |aaa,0xa0|a0a0a0,.|
|00000c20| 20 20 20 30 78 30 30 30 | 30 30 30 30 30 2c 30 78 |   0x000|00000,0x|
|00000c30| 30 30 30 30 30 30 30 30 | 2c 30 78 30 30 30 30 30 |00000000|,0x00000|
|00000c40| 30 30 30 2c 0a 20 20 20 | 30 78 66 66 66 66 66 66 |000,.   |0xffffff|
|00000c50| 66 66 2c 30 78 66 66 66 | 66 66 66 66 66 2c 30 78 |ff,0xfff|fffff,0x|
|00000c60| 66 66 66 66 66 66 66 66 | 2c 0a 20 20 20 30 78 36 |ffffffff|,.   0x6|
|00000c70| 36 36 36 36 36 36 36 2c | 30 78 38 38 38 38 38 38 |6666666,|0x888888|
|00000c80| 38 38 2c 30 78 62 62 62 | 62 62 62 62 62 2c 0a 20 |88,0xbbb|bbbbb,. |
|00000c90| 20 20 30 78 39 39 39 39 | 39 39 39 39 2c 30 78 39 |  0x9999|9999,0x9|
|00000ca0| 39 39 39 39 39 39 39 2c | 30 78 39 39 39 39 39 39 |9999999,|0x999999|
|00000cb0| 39 39 2c 0a 20 20 20 30 | 78 62 62 62 62 62 62 62 |99,.   0|xbbbbbbb|
|00000cc0| 62 2c 30 78 62 62 62 62 | 62 62 62 62 2c 30 78 62 |b,0xbbbb|bbbb,0xb|
|00000cd0| 62 62 62 62 62 62 62 2c | 0a 20 20 20 30 78 62 62 |bbbbbbb,|.   0xbb|
|00000ce0| 62 62 62 62 62 62 2c 30 | 78 61 61 61 61 61 61 61 |bbbbbb,0|xaaaaaaa|
|00000cf0| 61 2c 30 78 39 39 39 39 | 39 39 39 39 2c 0a 20 20 |a,0x9999|9999,.  |
|00000d00| 20 30 78 66 66 66 66 66 | 66 66 66 2c 30 78 62 62 | 0xfffff|fff,0xbb|
|00000d10| 62 62 62 62 62 62 2c 30 | 78 61 61 61 61 61 61 61 |bbbbbb,0|xaaaaaaa|
|00000d20| 61 0a 7d 3b 0a 0a 0a 5c | 65 6e 64 7b 76 65 72 62 |a.};...\|end{verb|
|00000d30| 61 74 69 6d 7d 0a 5c 6e | 6f 72 6d 61 6c 73 69 7a |atim}.\n|ormalsiz|
|00000d40| 65 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |e.\subsu|bsection|
|00000d50| 2a 7b 53 45 45 20 41 4c | 53 4f 7d 0a 4d 55 49 41 |*{SEE AL|SO}.MUIA|
|00000d60| 5c 5f 42 69 74 6d 61 70 | 5c 5f 42 69 74 6d 61 70 |\_Bitmap|\_Bitmap|
|00000d70| 2c 20 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |, MUIA\_|Bitmap\_|
|00000d80| 48 65 69 67 68 74 2c 20 | 4d 55 49 41 5c 5f 42 69 |Height, |MUIA\_Bi|
|00000d90| 74 6d 61 70 5c 5f 57 69 | 64 74 68 2c 0a 4d 55 49 |tmap\_Wi|dth,.MUI|
|00000da0| 41 5c 5f 42 69 74 6d 61 | 70 5c 5f 4d 61 70 70 69 |A\_Bitma|p\_Mappi|
|00000db0| 6e 67 54 61 62 6c 65 2c | 20 4d 55 49 41 5c 5f 42 |ngTable,| MUIA\_B|
|00000dc0| 69 74 6d 61 70 5c 5f 4d | 61 70 70 69 6e 67 54 61 |itmap\_M|appingTa|
|00000dd0| 62 6c 65 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |ble..\su|bsection|
|00000de0| 5b 4d 55 49 41 5c 5f 42 | 69 74 6d 61 70 5c 5f 54 |[MUIA\_B|itmap\_T|
|00000df0| 72 61 6e 73 70 61 72 65 | 6e 74 5d 7b 4d 55 49 41 |ranspare|nt]{MUIA|
|00000e00| 5c 5f 42 69 74 6d 61 70 | 5c 5f 54 72 61 6e 73 70 |\_Bitmap|\_Transp|
|00000e10| 61 72 65 6e 74 20 2d 2d | 20 28 56 38 29 20 5b 49 |arent --| (V8) [I|
|00000e20| 53 47 5d 2c 20 4c 4f 4e | 47 7d 0a 0a 5c 73 75 62 |SG], LON|G}..\sub|
|00000e30| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 46 55 4e 43 |subsecti|on*{FUNC|
|00000e40| 54 49 4f 4e 7d 0a 49 66 | 20 73 70 65 63 69 66 69 |TION}.If| specifi|
|00000e50| 65 64 2c 20 4d 55 49 20 | 77 69 6c 6c 20 63 6f 6e |ed, MUI |will con|
|00000e60| 73 69 64 65 72 20 74 68 | 69 73 20 63 6f 6c 6f 72 |sider th|is color|
|00000e70| 20 6f 66 20 74 68 65 20 | 42 69 74 4d 61 70 0a 74 | of the |BitMap.t|
|00000e80| 6f 20 62 65 20 74 72 61 | 6e 73 70 61 72 65 6e 74 |o be tra|nsparent|
|00000e90| 2e 20 41 20 6d 61 73 6b | 20 70 6c 61 6e 65 20 77 |. A mask| plane w|
|00000ea0| 69 6c 6c 20 62 65 20 67 | 65 6e 65 72 61 74 65 64 |ill be g|enerated|
|00000eb0| 20 61 6e 64 0a 75 73 65 | 64 20 66 6f 72 20 62 6c | and.use|d for bl|
|00000ec0| 69 74 74 69 6e 67 2c 20 | 74 68 65 20 62 61 63 6b |itting, |the back|
|00000ed0| 67 72 6f 75 6e 64 20 77 | 69 6c 6c 20 73 68 69 6e |ground w|ill shin|
|00000ee0| 65 20 74 68 72 6f 75 67 | 68 2e 0a 0a 5c 73 75 62 |e throug|h...\sub|
|00000ef0| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 53 45 45 20 |subsecti|on*{SEE |
|00000f00| 41 4c 53 4f 7d 0a 4d 55 | 49 41 5c 5f 42 69 74 6d |ALSO}.MU|IA\_Bitm|
|00000f10| 61 70 5c 5f 42 69 74 6d | 61 70 2c 20 4d 55 49 41 |ap\_Bitm|ap, MUIA|
|00000f20| 5c 5f 42 69 74 6d 61 70 | 5c 5f 48 65 69 67 68 74 |\_Bitmap|\_Height|
|00000f30| 2c 20 4d 55 49 41 5c 5f | 42 69 74 6d 61 70 5c 5f |, MUIA\_|Bitmap\_|
|00000f40| 57 69 64 74 68 2c 0a 4d | 55 49 41 5c 5f 42 69 74 |Width,.M|UIA\_Bit|
|00000f50| 6d 61 70 5c 5f 53 6f 75 | 72 63 65 43 6f 6c 6f 72 |map\_Sou|rceColor|
|00000f60| 73 2c 20 4d 55 49 41 5c | 5f 42 69 74 6d 61 70 5c |s, MUIA\|_Bitmap\|
|00000f70| 5f 4d 61 70 70 69 6e 67 | 54 61 62 6c 65 0a 0a 5c |_Mapping|Table..\|
|00000f80| 73 75 62 73 65 63 74 69 | 6f 6e 5b 4d 55 49 41 5c |subsecti|on[MUIA\|
|00000f90| 5f 42 69 74 6d 61 70 5c | 5f 57 69 64 74 68 5d 7b |_Bitmap\|_Width]{|
|00000fa0| 4d 55 49 41 5c 5f 42 69 | 74 6d 61 70 5c 5f 57 69 |MUIA\_Bi|tmap\_Wi|
|00000fb0| 64 74 68 20 2d 2d 20 28 | 56 38 29 20 5b 49 53 47 |dth -- (|V8) [ISG|
|00000fc0| 5d 2c 20 4c 4f 4e 47 7d | 0a 0a 5c 73 75 62 73 75 |], LONG}|..\subsu|
|00000fd0| 62 73 65 63 74 69 6f 6e | 2a 7b 46 55 4e 43 54 49 |bsection|*{FUNCTI|
|00000fe0| 4f 4e 7d 0a 44 65 66 69 | 6e 65 20 74 68 65 20 70 |ON}.Defi|ne the p|
|00000ff0| 69 78 65 6c 20 77 69 64 | 74 68 20 6f 66 20 74 68 |ixel wid|th of th|
|00001000| 65 20 42 69 74 4d 61 70 | 2e 0a 0a 5c 73 75 62 73 |e BitMap|...\subs|
|00001010| 75 62 73 65 63 74 69 6f | 6e 2a 7b 4e 4f 54 45 7d |ubsectio|n*{NOTE}|
|00001020| 0a 42 79 20 64 65 66 61 | 75 6c 74 2c 20 74 68 65 |.By defa|ult, the|
|00001030| 20 62 69 74 6d 61 70 20 | 6f 62 6a 65 63 74 20 68 | bitmap |object h|
|00001040| 61 73 20 61 20 6d 69 6e | 69 6d 75 6d 20 73 69 7a |as a min|imum siz|
|00001050| 65 20 6f 66 0a 31 20 70 | 69 78 65 6c 20 61 6e 64 |e of.1 p|ixel and|
|00001060| 20 61 6e 20 75 6e 6c 69 | 6d 69 74 65 64 20 6d 61 | an unli|mited ma|
|00001070| 78 69 75 6d 20 73 69 7a | 65 2e 20 49 66 20 74 68 |xium siz|e. If th|
|00001080| 65 20 73 70 61 63 65 20 | 69 73 0a 74 6f 6f 20 73 |e space |is.too s|
|00001090| 6d 61 6c 6c 20 74 6f 20 | 68 6f 6c 64 20 79 6f 75 |mall to |hold you|
|000010a0| 72 20 42 69 74 4d 61 70 | 2c 20 69 74 20 77 69 6c |r BitMap|, it wil|
|000010b0| 6c 20 62 65 20 63 6c 69 | 70 70 65 64 2e 0a 55 73 |l be cli|pped..Us|
|000010c0| 75 61 6c 6c 79 2c 20 79 | 6f 75 20 77 69 6c 6c 20 |ually, y|ou will |
|000010d0| 75 73 65 20 4d 55 49 41 | 5c 5f 46 69 78 57 69 64 |use MUIA|\_FixWid|
|000010e0| 74 68 20 61 6e 64 20 4d | 55 49 41 5c 5f 46 69 78 |th and M|UIA\_Fix|
|000010f0| 48 65 69 67 68 74 0a 77 | 69 74 68 20 42 69 74 4d |Height.w|ith BitM|
|00001100| 61 70 20 6f 62 6a 65 63 | 74 73 20 74 6f 20 6d 61 |ap objec|ts to ma|
|00001110| 6b 65 20 74 68 65 6d 20 | 61 6c 77 61 79 73 20 65 |ke them |always e|
|00001120| 78 61 63 74 6c 79 20 61 | 73 20 62 69 67 20 61 73 |xactly a|s big as|
|00001130| 0a 74 68 65 20 62 69 74 | 6d 61 70 2e 0a 0a 5c 73 |.the bit|map...\s|
|00001140| 75 62 73 75 62 73 65 63 | 74 69 6f 6e 2a 7b 53 45 |ubsubsec|tion*{SE|
|00001150| 45 20 41 4c 53 4f 7d 0a | 4d 55 49 41 5c 5f 42 69 |E ALSO}.|MUIA\_Bi|
|00001160| 74 6d 61 70 5c 5f 42 69 | 74 6d 61 70 2c 20 4d 55 |tmap\_Bi|tmap, MU|
|00001170| 49 41 5c 5f 42 69 74 6d | 61 70 5c 5f 48 65 69 67 |IA\_Bitm|ap\_Heig|
|00001180| 68 74 2c 20 4d 55 49 41 | 5c 5f 42 69 74 6d 61 70 |ht, MUIA|\_Bitmap|
|00001190| 5c 5f 54 72 61 6e 73 70 | 61 72 65 6e 74 2c 0a 4d |\_Transp|arent,.M|
|000011a0| 55 49 41 5c 5f 42 69 74 | 6d 61 70 5c 5f 53 6f 75 |UIA\_Bit|map\_Sou|
|000011b0| 72 63 65 43 6f 6c 6f 72 | 73 2c 20 4d 55 49 41 5c |rceColor|s, MUIA\|
|000011c0| 5f 42 69 74 6d 61 70 5c | 5f 4d 61 70 70 69 6e 67 |_Bitmap\|_Mapping|
|000011d0| 54 61 62 6c 65 0a 0a 0a | 0a                      |Table...|.       |
+--------+-------------------------+-------------------------+--------+--------+