/ Fresh Fish 9 / FreshFishVol9-CD2.bin / bbs / docs / mui_autodocs-2.3.lha / MUI_Autodocs / Source / mui_bodychunk.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 6f 64 79 63 68 75 |\section|{Bodychu|
|00000010| 6e 6b 2e 6d 75 69 7d 0a | 0a 42 69 67 20 61 6e 64 |nk.mui}.|.Big and|
|00000020| 20 63 6f 6c 6f 72 66 75 | 6c 20 69 6d 61 67 65 73 | colorfu|l images|
|00000030| 20 28 65 2e 67 2e 20 41 | 62 6f 75 74 2d 4c 6f 67 | (e.g. A|bout-Log|
|00000040| 6f 73 29 20 75 73 75 61 | 6c 6c 79 20 74 61 6b 65 |os) usua|lly take|
|00000050| 20 6c 6f 74 73 0a 6f 66 | 20 73 70 61 63 65 20 77 | lots.of| space w|
|00000060| 68 65 6e 20 73 74 6f 72 | 65 64 20 69 6e 20 61 20 |hen stor|ed in a |
|00000070| 74 72 61 64 69 74 69 6f | 6e 61 6c 20 42 69 74 4d |traditio|nal BitM|
|00000080| 61 70 20 73 74 72 75 63 | 74 75 72 65 2e 20 54 6f |ap struc|ture. To|
|00000090| 0a 73 61 76 65 20 6d 65 | 6d 6f 72 79 2c 20 79 6f |.save me|mory, yo|
|000000a0| 75 20 63 61 6e 20 64 65 | 63 69 64 65 20 74 6f 20 |u can de|cide to |
|000000b0| 68 61 76 65 20 74 68 65 | 20 70 69 63 74 75 72 65 |have the| picture|
|000000c0| 20 63 6f 6d 70 72 65 73 | 73 65 64 0a 69 6e 20 79 | compres|sed.in y|
|000000d0| 6f 75 72 20 63 6f 64 65 | 20 61 6e 64 20 75 73 65 |our code| and use|
|000000e0| 20 74 68 65 20 42 6f 64 | 79 63 68 75 6e 6b 20 63 | the Bod|ychunk c|
|000000f0| 6c 61 73 73 20 69 6e 73 | 74 65 61 64 20 6f 66 20 |lass ins|tead of |
|00000100| 74 68 65 0a 42 69 74 6d | 61 70 20 63 6c 61 73 73 |the.Bitm|ap class|
|00000110| 20 66 6f 72 20 64 69 73 | 70 6c 61 79 69 6e 67 2e | for dis|playing.|
|00000120| 20 4d 55 49 20 77 69 6c | 6c 20 74 68 65 6e 20 61 | MUI wil|l then a|
|00000130| 75 74 6f 6d 61 74 69 63 | 61 6c 6c 79 0a 64 65 63 |utomatic|ally.dec|
|00000140| 6f 6d 70 72 65 73 73 20 | 79 6f 75 72 20 69 6d 61 |ompress |your ima|
|00000150| 67 65 20 77 68 65 6e 20 | 69 74 73 20 61 62 6f 75 |ge when |its abou|
|00000160| 74 20 74 6f 20 61 70 70 | 65 61 72 20 69 6e 20 61 |t to app|ear in a|
|00000170| 0a 77 69 6e 64 6f 77 2e | 0a 0a 53 69 6e 63 65 20 |.window.|..Since |
|00000180| 42 6f 64 79 63 68 75 6e | 6b 20 63 6c 61 73 73 20 |Bodychun|k class |
|00000190| 69 73 20 61 20 73 75 62 | 63 6c 61 73 73 20 6f 66 |is a sub|class of|
|000001a0| 20 42 69 74 6d 61 70 20 | 63 6c 61 73 73 2c 20 79 | Bitmap |class, y|
|000001b0| 6f 75 20 63 61 6e 0a 6f | 66 20 63 6f 75 72 73 65 |ou can.o|f course|
|000001c0| 20 75 73 65 20 61 6c 6c | 20 74 68 65 20 42 69 74 | use all| the Bit|
|000001d0| 6d 61 70 73 20 72 65 6d | 61 70 70 69 6e 67 20 61 |maps rem|apping a|
|000001e0| 6e 64 20 74 72 61 6e 73 | 70 61 72 65 6e 63 79 0a |nd trans|parency.|
|000001f0| 66 65 61 74 75 72 65 73 | 2e 0a 0a 5c 73 75 62 73 |features|...\subs|
|00000200| 65 63 74 69 6f 6e 5b 4d | 55 49 41 5c 5f 42 6f 64 |ection[M|UIA\_Bod|
|00000210| 79 63 68 75 6e 6b 5c 5f | 42 6f 64 79 5d 7b 4d 55 |ychunk\_|Body]{MU|
|00000220| 49 41 5c 5f 42 6f 64 79 | 63 68 75 6e 6b 5c 5f 42 |IA\_Body|chunk\_B|
|00000230| 6f 64 79 20 2d 2d 20 28 | 56 38 29 20 5b 49 53 47 |ody -- (|V8) [ISG|
|00000240| 5d 2c 20 55 42 59 54 45 | 20 24 5c 61 73 74 24 7d |], UBYTE| $\ast$}|
|00000250| 0a 0a 5c 73 75 62 73 75 | 62 73 65 63 74 69 6f 6e |..\subsu|bsection|
|00000260| 2a 7b 46 55 4e 43 54 49 | 4f 4e 7d 0a 53 70 65 63 |*{FUNCTI|ON}.Spec|
|00000270| 69 66 79 20 61 20 70 6f | 69 6e 74 65 72 20 74 6f |ify a po|inter to|
|00000280| 20 74 68 65 20 42 4f 44 | 59 20 64 61 74 61 20 6f | the BOD|Y data o|
|00000290| 66 20 79 6f 75 72 20 70 | 69 63 74 75 72 65 2e 20 |f your p|icture. |
|000002a0| 54 68 69 73 20 42 4f 44 | 59 0a 64 61 74 61 20 6d |This BOD|Y.data m|
|000002b0| 75 73 74 20 66 6f 6c 6c | 6f 77 20 6e 6f 72 6d 61 |ust foll|ow norma|
|000002c0| 6c 20 49 46 46 2f 49 4c | 42 4d 20 63 6f 6e 76 65 |l IFF/IL|BM conve|
|000002d0| 6e 74 69 6f 6e 73 2e 0a | 0a 59 6f 75 20 68 61 76 |ntions..|.You hav|
|000002e0| 65 20 74 6f 20 73 75 70 | 70 6c 79 20 4d 55 49 41 |e to sup|ply MUIA|
|000002f0| 5c 5f 42 69 74 6d 61 70 | 5c 5f 57 69 64 74 68 2c |\_Bitmap|\_Width,|
|00000300| 20 4d 55 49 41 5c 5f 42 | 69 74 6d 61 70 5c 5f 48 | MUIA\_B|itmap\_H|
|00000310| 65 69 67 68 74 20 61 6e | 64 0a 4d 55 49 41 5c 5f |eight an|d.MUIA\_|
|00000320| 42 6f 64 79 63 68 75 6e | 6b 5c 5f 44 65 70 74 68 |Bodychun|k\_Depth|
|00000330| 20 74 6f 20 64 65 73 63 | 72 69 62 65 20 74 68 65 | to desc|ribe the|
|00000340| 20 63 6f 6e 74 65 6e 74 | 73 20 6f 66 20 74 68 65 | content|s of the|
|00000350| 20 42 4f 44 59 0a 64 61 | 74 61 2c 20 6f 74 68 65 | BODY.da|ta, othe|
|00000360| 72 77 69 73 65 20 4d 55 | 49 20 77 69 6c 6c 20 66 |rwise MU|I will f|
|00000370| 61 69 6c 20 74 6f 20 64 | 65 63 6f 6d 70 72 65 73 |ail to d|ecompres|
|00000380| 73 20 69 74 2e 0a 0a 5c | 73 75 62 73 75 62 73 65 |s it...\|subsubse|
|00000390| 63 74 69 6f 6e 2a 7b 53 | 45 45 20 41 4c 53 4f 7d |ction*{S|EE ALSO}|
|000003a0| 0a 4d 55 49 41 5c 5f 42 | 6f 64 79 63 68 75 6e 6b |.MUIA\_B|odychunk|
|000003b0| 5c 5f 44 65 70 74 68 2c | 20 4d 55 49 41 5c 5f 42 |\_Depth,| MUIA\_B|
|000003c0| 6f 64 79 63 68 75 6e 6b | 5c 5f 43 6f 6d 70 72 65 |odychunk|\_Compre|
|000003d0| 73 73 69 6f 6e 2c 0a 4d | 55 49 41 5c 5f 42 6f 64 |ssion,.M|UIA\_Bod|
|000003e0| 79 63 68 75 6e 6b 5c 5f | 4d 61 73 6b 69 6e 67 0a |ychunk\_|Masking.|
|000003f0| 0a 5c 73 75 62 73 65 63 | 74 69 6f 6e 5b 4d 55 49 |.\subsec|tion[MUI|
|00000400| 41 5c 5f 42 6f 64 79 63 | 68 75 6e 6b 5c 5f 43 6f |A\_Bodyc|hunk\_Co|
|00000410| 6d 70 72 65 73 73 69 6f | 6e 5d 7b 4d 55 49 41 5c |mpressio|n]{MUIA\|
|00000420| 5f 42 6f 64 79 63 68 75 | 6e 6b 5c 5f 43 6f 6d 70 |_Bodychu|nk\_Comp|
|00000430| 72 65 73 73 69 6f 6e 20 | 2d 2d 20 28 56 38 29 20 |ression |-- (V8) |
|00000440| 5b 49 53 47 5d 2c 20 55 | 42 59 54 45 7d 0a 0a 5c |[ISG], U|BYTE}..\|
|00000450| 73 75 62 73 75 62 73 65 | 63 74 69 6f 6e 2a 7b 46 |subsubse|ction*{F|
|00000460| 55 4e 43 54 49 4f 4e 7d | 0a 4d 55 49 20 69 73 20 |UNCTION}|.MUI is |
|00000470| 61 62 6c 65 20 74 6f 20 | 75 6e 63 6f 6d 70 72 65 |able to |uncompre|
|00000480| 73 73 20 62 79 74 65 5c | 26 72 75 6e 20 63 6f 6d |ss byte\|&run com|
|00000490| 70 72 65 73 73 65 64 20 | 42 4f 44 59 20 63 68 75 |pressed |BODY chu|
|000004a0| 6e 6b 73 0a 61 75 74 6f | 6d 61 74 69 63 61 6c 6c |nks.auto|maticall|
|000004b0| 79 2e 20 49 66 20 79 6f | 75 72 20 64 61 74 61 20 |y. If yo|ur data |
|000004c0| 69 73 20 63 6f 6d 70 72 | 65 73 73 65 64 2c 20 79 |is compr|essed, y|
|000004d0| 6f 75 20 6d 75 73 74 0a | 73 75 70 70 6c 79 20 61 |ou must.|supply a|
|000004e0| 20 76 61 6c 75 65 20 6f | 66 20 63 6d 70 42 79 74 | value o|f cmpByt|
|000004f0| 65 52 75 6e 31 20 28 3d | 3d 31 29 20 66 6f 72 20 |eRun1 (=|=1) for |
|00000500| 74 68 69 73 20 74 61 67 | 2e 20 4f 74 68 65 72 0a |this tag|. Other.|
|00000510| 63 6f 6d 70 72 65 73 73 | 69 6f 6e 20 74 65 63 68 |compress|ion tech|
|00000520| 6e 69 71 75 65 73 20 61 | 72 65 20 6e 6f 74 20 73 |niques a|re not s|
|00000530| 75 70 70 6f 72 74 65 64 | 2e 0a 0a 4f 6d 69 74 74 |upported|...Omitt|
|00000540| 69 6e 67 20 74 68 69 73 | 20 74 61 67 20 6f 72 20 |ing this| tag or |
|00000550| 73 65 74 74 69 6e 67 20 | 69 74 20 74 6f 20 30 20 |setting |it to 0 |
|00000560| 69 6e 64 69 63 61 74 65 | 73 20 74 68 61 74 20 74 |indicate|s that t|
|00000570| 68 65 0a 42 4f 44 59 20 | 64 61 74 61 20 69 73 20 |he.BODY |data is |
|00000580| 75 6e 63 6f 6d 70 72 65 | 73 73 65 64 2e 20 55 73 |uncompre|ssed. Us|
|00000590| 69 6e 67 20 74 68 65 20 | 42 6f 64 79 63 68 75 6e |ing the |Bodychun|
|000005a0| 6b 20 63 6c 61 73 73 0a | 64 6f 65 73 6e 27 74 20 |k class.|doesn't |
|000005b0| 6d 61 6b 65 20 6d 75 63 | 68 20 73 65 6e 73 65 20 |make muc|h sense |
|000005c0| 69 6e 20 74 68 69 73 20 | 63 61 73 65 20 73 69 6e |in this |case sin|
|000005d0| 63 65 20 69 74 73 20 6d | 61 69 6e 0a 70 75 72 70 |ce its m|ain.purp|
|000005e0| 6f 73 65 20 69 73 20 74 | 6f 20 73 61 76 65 20 6d |ose is t|o save m|
|000005f0| 65 6d 6f 72 79 20 66 6f | 72 20 62 69 67 20 69 6d |emory fo|r big im|
|00000600| 61 67 65 73 2e 0a 0a 5c | 73 75 62 73 75 62 73 65 |ages...\|subsubse|
|00000610| 63 74 69 6f 6e 2a 7b 53 | 45 45 20 41 4c 53 4f 7d |ction*{S|EE ALSO}|
|00000620| 0a 4d 55 49 41 5c 5f 42 | 6f 64 79 63 68 75 6e 6b |.MUIA\_B|odychunk|
|00000630| 5c 5f 4d 61 73 6b 69 6e | 67 2c 20 4d 55 49 41 5c |\_Maskin|g, MUIA\|
|00000640| 5f 42 6f 64 79 63 68 75 | 6e 6b 5c 5f 42 6f 64 79 |_Bodychu|nk\_Body|
|00000650| 0a 0a 5c 73 75 62 73 65 | 63 74 69 6f 6e 5b 4d 55 |..\subse|ction[MU|
|00000660| 49 41 5c 5f 42 6f 64 79 | 63 68 75 6e 6b 5c 5f 44 |IA\_Body|chunk\_D|
|00000670| 65 70 74 68 5d 7b 4d 55 | 49 41 5c 5f 42 6f 64 79 |epth]{MU|IA\_Body|
|00000680| 63 68 75 6e 6b 5c 5f 44 | 65 70 74 68 20 2d 2d 20 |chunk\_D|epth -- |
|00000690| 28 56 38 29 20 5b 49 53 | 47 5d 2c 20 4c 4f 4e 47 |(V8) [IS|G], LONG|
|000006a0| 7d 0a 0a 5c 73 75 62 73 | 75 62 73 65 63 74 69 6f |}..\subs|ubsectio|
|000006b0| 6e 2a 7b 46 55 4e 43 54 | 49 4f 4e 7d 0a 53 70 65 |n*{FUNCT|ION}.Spe|
|000006c0| 63 69 66 79 20 74 68 65 | 20 64 65 70 74 68 20 6f |cify the| depth o|
|000006d0| 66 20 79 6f 75 72 20 70 | 69 63 74 75 72 65 20 68 |f your p|icture h|
|000006e0| 65 72 65 2e 20 54 68 69 | 73 20 74 61 67 20 69 73 |ere. Thi|s tag is|
|000006f0| 0a 72 65 71 75 69 72 65 | 64 20 66 6f 72 20 63 6f |.require|d for co|
|00000700| 72 72 65 63 74 20 42 4f | 44 59 20 63 68 75 6e 6b |rrect BO|DY chunk|
|00000710| 20 70 61 72 73 69 6e 67 | 2e 20 41 6c 73 6f 20 72 | parsing|. Also r|
|00000720| 65 6d 65 6d 62 65 72 0a | 74 6f 20 75 73 65 20 4d |emember.|to use M|
|00000730| 55 49 41 5c 5f 42 6f 64 | 79 63 68 75 6e 6b 5c 5f |UIA\_Bod|ychunk\_|
|00000740| 4d 61 73 6b 69 6e 67 20 | 69 66 20 79 6f 75 72 20 |Masking |if your |
|00000750| 42 4f 44 59 20 64 61 74 | 61 20 63 6f 6e 74 61 69 |BODY dat|a contai|
|00000760| 6e 73 0a 61 20 6d 61 73 | 6b 69 6e 67 20 62 69 74 |ns.a mas|king bit|
|00000770| 70 6c 61 6e 65 2e 0a 0a | 5c 73 75 62 73 75 62 73 |plane...|\subsubs|
|00000780| 65 63 74 69 6f 6e 2a 7b | 53 45 45 20 41 4c 53 4f |ection*{|SEE ALSO|
|00000790| 7d 0a 4d 55 49 41 5c 5f | 42 6f 64 79 63 68 75 6e |}.MUIA\_|Bodychun|
|000007a0| 6b 5c 5f 42 6f 64 79 2c | 20 4d 55 49 41 5c 5f 42 |k\_Body,| MUIA\_B|
|000007b0| 6f 64 79 63 68 75 6e 6b | 5c 5f 4d 61 73 6b 69 6e |odychunk|\_Maskin|
|000007c0| 67 0a 0a 5c 73 75 62 73 | 65 63 74 69 6f 6e 5b 4d |g..\subs|ection[M|
|000007d0| 55 49 41 5c 5f 42 6f 64 | 79 63 68 75 6e 6b 5c 5f |UIA\_Bod|ychunk\_|
|000007e0| 4d 61 73 6b 69 6e 67 5d | 7b 4d 55 49 41 5c 5f 42 |Masking]|{MUIA\_B|
|000007f0| 6f 64 79 63 68 75 6e 6b | 5c 5f 4d 61 73 6b 69 6e |odychunk|\_Maskin|
|00000800| 67 20 2d 2d 20 28 56 38 | 29 20 5b 49 53 47 5d 2c |g -- (V8|) [ISG],|
|00000810| 20 55 42 59 54 45 7d 0a | 0a 5c 73 75 62 73 75 62 | UBYTE}.|.\subsub|
|00000820| 73 65 63 74 69 6f 6e 2a | 7b 46 55 4e 43 54 49 4f |section*|{FUNCTIO|
|00000830| 4e 7d 0a 59 6f 75 20 6d | 75 73 74 20 69 6e 64 69 |N}.You m|ust indi|
|00000840| 63 61 74 65 20 69 66 20 | 79 6f 75 72 20 42 4f 44 |cate if |your BOD|
|00000850| 59 20 64 61 74 61 20 63 | 6f 6e 74 61 69 6e 73 20 |Y data c|ontains |
|00000860| 61 20 6d 61 73 6b 69 6e | 67 0a 70 6c 61 6e 65 2e |a maskin|g.plane.|
|00000870| 20 43 75 72 72 65 6e 74 | 6c 79 2c 20 4d 55 49 20 | Current|ly, MUI |
|00000880| 64 6f 65 73 20 6e 6f 74 | 20 75 73 65 20 74 68 69 |does not| use thi|
|00000890| 73 20 6d 61 73 6b 69 6e | 67 20 70 6c 61 6e 65 0a |s maskin|g plane.|
|000008a0| 66 6f 72 20 61 6e 79 20 | 70 75 72 70 6f 73 65 2c |for any |purpose,|
|000008b0| 20 62 75 74 20 74 68 69 | 73 20 61 74 74 72 69 62 | but thi|s attrib|
|000008c0| 75 74 65 20 69 73 20 72 | 65 71 75 69 72 65 64 20 |ute is r|equired |
|000008d0| 74 6f 0a 61 6c 6c 6f 77 | 20 63 6f 72 72 65 63 74 |to.allow| correct|
|000008e0| 20 70 61 72 73 69 6e 67 | 20 6f 66 20 74 68 65 20 | parsing| of the |
|000008f0| 42 4f 44 59 20 64 61 74 | 61 2e 0a 0a 5c 73 75 62 |BODY dat|a...\sub|
|00000900| 73 75 62 73 65 63 74 69 | 6f 6e 2a 7b 53 45 45 20 |subsecti|on*{SEE |
|00000910| 41 4c 53 4f 7d 0a 4d 55 | 49 41 5c 5f 42 6f 64 79 |ALSO}.MU|IA\_Body|
|00000920| 63 68 75 6e 6b 5c 5f 42 | 6f 64 79 2c 20 4d 55 49 |chunk\_B|ody, MUI|
|00000930| 41 5c 5f 42 6f 64 79 63 | 68 75 6e 6b 5c 5f 43 6f |A\_Bodyc|hunk\_Co|
|00000940| 6d 70 72 65 73 73 69 6f | 6e 0a 0a 0a 0a          |mpressio|n....   |
+--------+-------------------------+-------------------------+--------+--------+