home *** CD-ROM | disk | FTP | other *** search
/ MacWorld 2000 February / Macworld (2000-02).dmg / Updaters / WhiteCap 3.2.2.sea / WhiteCap 3.2.2 / WhiteCap Source / SJ SDK / Visual Plug-in White Paper < prev    next >
MacBinary  |  1999-07-20  |  12.3 KB  |  [TEXT/ttxt]

open in: MacOS 8.1     |     Win98     |     DOS

view JSON data     |     view as text

This file was processed as: MacBinary (archive/macBinary).

You can browse this item here: Visual Plug-in White Paper

ConfidenceProgramDetectionMatch TypeSupport
10% dexvert MacBinary (archive/macBinary) fallback Supported
1% dexvert Text File (text/txt) fallback Supported
100% file MacBinary II, inited, Tue Jul 20 13:10:07 1999, modified Tue Jul 20 13:10:07 1999, creator SimpleText, type ASCII, 10389 bytes "Visual Plug-in White Paper" , at 0x2915 1832 bytes resource default (weak)
99% file data default
74% TrID Macintosh plain text (MacBinary) default
25% TrID MacBinary 2 default (weak)
100% siegfried fmt/1762 MacBinary (II) default
100% lsar MacBinary default


id metadata
keyvalue
macFileType[TEXT]
macFileCreator[ttxt]



hex view
+--------+-------------------------+-------------------------+--------+--------+
|00000000| 00 1a 56 69 73 75 61 6c | 20 50 6c 75 67 2d 69 6e |..Visual| Plug-in|
|00000010| 20 57 68 69 74 65 20 50 | 61 70 65 72 00 00 00 00 | White P|aper....|
|00000020| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000030| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00000040| 00 54 45 58 54 74 74 78 | 74 01 00 00 00 00 00 00 |.TEXTttx|t.......|
|00000050| 00 00 00 00 00 28 95 00 | 00 07 28 b3 ba 5d ef b3 |.....(..|..(..]..|
|00000060| ba 5d ef 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |.]......|........|
|00000070| 00 00 00 00 00 00 00 00 | 00 00 81 81 cc 3c 00 00 |........|.....<..|
|00000080| 57 72 69 74 69 6e 67 20 | 56 69 73 75 61 6c 69 7a |Writing |Visualiz|
|00000090| 61 74 69 6f 6e 20 50 6c | 75 67 2d 69 6e 73 20 66 |ation Pl|ug-ins f|
|000000a0| 6f 72 20 53 6f 75 6e 64 | 4a 61 6d 0d 28 56 65 72 |or Sound|Jam.(Ver|
|000000b0| 73 69 6f 6e 20 31 2e 30 | 2e 31 2c 20 4a 75 6c 79 |sion 1.0|.1, July|
|000000c0| 20 32 30 2c 20 31 39 39 | 39 2c 20 4d 69 6b 65 20 | 20, 199|9, Mike |
|000000d0| 57 72 69 67 68 74 20 3c | 64 61 72 77 69 6e 40 6d |Wright <|darwin@m|
|000000e0| 62 61 79 2e 6e 65 74 29 | 0d 0d 53 6f 75 6e 64 4a |bay.net)|..SoundJ|
|000000f0| 61 6d 20 63 61 6e 20 6d | 61 6b 65 20 75 73 65 20 |am can m|ake use |
|00000100| 6f 66 20 73 65 76 65 72 | 61 6c 20 74 79 70 65 73 |of sever|al types|
|00000110| 20 6f 66 20 70 6c 75 67 | 2d 69 6e 73 2e 20 4f 6e | of plug|-ins. On|
|00000120| 65 20 6f 66 20 74 68 65 | 73 65 20 69 73 20 74 68 |e of the|se is th|
|00000130| 65 20 22 76 69 73 75 61 | 6c 69 7a 61 74 69 6f 6e |e "visua|lization|
|00000140| 22 20 70 6c 75 67 2d 69 | 6e 2e 20 41 20 76 69 73 |" plug-i|n. A vis|
|00000150| 75 61 6c 69 7a 61 74 69 | 6f 6e 20 70 6c 75 67 2d |ualizati|on plug-|
|00000160| 69 6e 20 69 73 20 70 72 | 6f 76 69 64 65 64 20 77 |in is pr|ovided w|
|00000170| 69 74 68 20 61 20 77 69 | 6e 64 6f 77 20 69 6e 20 |ith a wi|ndow in |
|00000180| 77 68 69 63 68 20 69 74 | 20 63 61 6e 20 64 72 61 |which it| can dra|
|00000190| 77 20 61 20 67 72 61 70 | 68 69 63 20 74 68 61 74 |w a grap|hic that|
|000001a0| 20 72 65 61 63 74 73 20 | 74 6f 20 74 68 65 20 6d | reacts |to the m|
|000001b0| 75 73 69 63 20 62 65 69 | 6e 67 20 70 6c 61 79 65 |usic bei|ng playe|
|000001c0| 64 20 62 79 20 53 6f 75 | 6e 64 4a 61 6d 2e 20 49 |d by Sou|ndJam. I|
|000001d0| 74 20 63 61 6e 20 61 6c | 73 6f 20 6d 6f 64 69 66 |t can al|so modif|
|000001e0| 79 20 74 68 65 20 6d 75 | 73 69 63 20 69 74 73 65 |y the mu|sic itse|
|000001f0| 6c 66 2e 20 41 20 76 69 | 73 75 61 6c 69 7a 61 74 |lf. A vi|sualizat|
|00000200| 69 6f 6e 20 70 6c 75 67 | 2d 69 6e 20 63 61 6e 20 |ion plug|-in can |
|00000210| 70 65 72 66 6f 72 6d 20 | 65 69 74 68 65 72 20 6f |perform |either o|
|00000220| 72 20 62 6f 74 68 20 6f | 66 20 74 68 65 73 65 20 |r both o|f these |
|00000230| 74 61 73 6b 73 2e 0d 0d | 54 68 69 73 20 64 6f 63 |tasks...|This doc|
|00000240| 75 6d 65 6e 74 20 65 78 | 70 6c 61 69 6e 73 20 68 |ument ex|plains h|
|00000250| 6f 77 20 61 20 76 69 73 | 75 61 6c 69 7a 61 74 69 |ow a vis|ualizati|
|00000260| 6f 6e 20 70 6c 75 67 2d | 69 6e 20 73 68 6f 75 6c |on plug-|in shoul|
|00000270| 64 20 69 6e 74 65 72 61 | 63 74 20 77 69 74 68 20 |d intera|ct with |
|00000280| 53 6f 75 6e 64 4a 61 6d | 2e 0d 0d 4c 69 6e 6b 65 |SoundJam|...Linke|
|00000290| 72 20 45 6e 74 72 79 20 | 50 6f 69 6e 74 73 0d 54 |r Entry |Points.T|
|000002a0| 68 65 20 4d 61 69 6e 20 | 65 6e 74 72 79 20 70 6f |he Main |entry po|
|000002b0| 69 6e 74 20 66 6f 72 20 | 74 68 65 20 6c 69 6e 6b |int for |the link|
|000002c0| 65 72 20 73 68 6f 75 6c | 64 20 62 65 20 22 6d 61 |er shoul|d be "ma|
|000002d0| 69 6e 22 20 28 77 69 74 | 68 6f 75 74 20 74 68 65 |in" (wit|hout the|
|000002e0| 20 71 75 6f 74 65 73 2c | 20 6f 66 20 63 6f 75 72 | quotes,| of cour|
|000002f0| 73 65 29 2e 20 54 68 65 | 20 6f 74 68 65 72 73 20 |se). The| others |
|00000300| 28 49 6e 69 74 61 6c 69 | 7a 61 74 69 6f 6e 20 61 |(Initali|zation a|
|00000310| 6e 64 20 54 65 72 6d 69 | 6e 61 74 69 6f 6e 29 20 |nd Termi|nation) |
|00000320| 73 68 6f 75 6c 64 20 62 | 65 20 62 6c 61 6e 6b 2e |should b|e blank.|
|00000330| 0d 0d 54 68 65 20 46 72 | 61 6d 65 77 6f 72 6b 20 |..The Fr|amework |
|00000340| 53 61 6d 70 6c 65 20 43 | 6f 64 65 0d 0d 41 20 73 |Sample C|ode..A s|
|00000350| 61 6d 70 6c 65 20 76 69 | 73 75 61 6c 69 7a 61 74 |ample vi|sualizat|
|00000360| 69 6f 6e 20 70 6c 75 67 | 2d 69 6e 2c 20 56 69 73 |ion plug|-in, Vis|
|00000370| 75 61 6c 20 46 72 61 6d | 65 77 6f 72 6b 20 50 6c |ual Fram|ework Pl|
|00000380| 75 67 2d 69 6e 2c 20 69 | 73 20 70 72 6f 76 69 64 |ug-in, i|s provid|
|00000390| 65 64 2c 20 61 6c 6f 6e | 67 20 77 69 74 68 20 73 |ed, alon|g with s|
|000003a0| 6f 75 72 63 65 20 63 6f | 64 65 2e 20 59 6f 75 20 |ource co|de. You |
|000003b0| 63 61 6e 20 75 73 65 20 | 74 68 69 73 20 63 6f 64 |can use |this cod|
|000003c0| 65 20 61 73 20 74 68 65 | 20 73 74 61 72 74 69 6e |e as the| startin|
|000003d0| 67 20 70 6f 69 6e 74 20 | 66 6f 72 20 79 6f 75 72 |g point |for your|
|000003e0| 20 6f 77 6e 20 76 69 73 | 75 61 6c 69 7a 61 74 69 | own vis|ualizati|
|000003f0| 6f 6e 20 70 6c 75 67 2d | 69 6e 2e 20 54 68 69 73 |on plug-|in. This|
|00000400| 20 63 6f 64 65 20 77 69 | 6c 6c 20 62 65 20 72 65 | code wi|ll be re|
|00000410| 66 65 72 72 65 64 20 74 | 6f 20 69 6e 20 74 68 65 |ferred t|o in the|
|00000420| 20 66 6f 6c 6c 6f 77 69 | 6e 67 20 65 78 70 6c 61 | followi|ng expla|
|00000430| 6e 61 74 69 6f 6e 73 2e | 20 49 74 20 69 6e 63 6c |nations.| It incl|
|00000440| 75 64 65 73 20 74 68 65 | 20 66 6f 6c 6c 6f 77 69 |udes the| followi|
|00000450| 6e 67 20 66 69 6c 65 73 | 3a 0d 0d 53 6f 75 6e 64 |ng files|:..Sound|
|00000460| 4a 61 6d 20 50 6c 75 67 | 2d 69 6e 20 41 50 49 20 |Jam Plug|-in API |
|00000470| 66 69 6c 65 73 3a 0d 09 | 53 6f 75 6e 64 4a 61 6d |files:..|SoundJam|
|00000480| 41 50 49 2e 63 20 2d 20 | 66 75 6e 63 74 69 6f 6e |API.c - |function|
|00000490| 73 20 66 6f 72 20 63 61 | 6c 6c 69 6e 67 20 53 6f |s for ca|lling So|
|000004a0| 75 6e 64 4a 61 6d 27 73 | 20 69 6e 74 65 72 6e 61 |undJam's| interna|
|000004b0| 6c 20 66 75 6e 63 74 69 | 6f 6e 73 0d 09 53 6f 75 |l functi|ons..Sou|
|000004c0| 6e 64 4a 61 6d 41 50 49 | 2e 68 20 2d 20 67 65 6e |ndJamAPI|.h - gen|
|000004d0| 65 72 61 6c 20 53 6f 75 | 6e 64 4a 61 6d 20 64 65 |eral Sou|ndJam de|
|000004e0| 66 69 6e 65 73 2c 20 74 | 79 70 65 64 65 66 73 2c |fines, t|ypedefs,|
|000004f0| 20 61 6e 64 20 66 75 6e | 63 74 69 6e 20 70 72 6f | and fun|ctin pro|
|00000500| 74 6f 74 79 70 65 73 0d | 09 56 69 73 75 61 6c 50 |totypes.|.VisualP|
|00000510| 6c 75 67 69 6e 2e 68 20 | 2d 20 64 65 66 69 6e 65 |lugin.h |- define|
|00000520| 73 20 61 6e 64 20 74 79 | 70 65 64 65 66 73 20 73 |s and ty|pedefs s|
|00000530| 70 65 63 69 66 69 63 20 | 74 6f 20 76 69 73 75 61 |pecific |to visua|
|00000540| 6c 69 7a 61 74 69 6f 6e | 20 70 6c 75 67 2d 69 6e |lization| plug-in|
|00000550| 73 0d 0d 46 72 61 6d 65 | 77 6f 72 6b 2d 73 70 65 |s..Frame|work-spe|
|00000560| 63 69 66 69 63 20 66 69 | 6c 65 73 3a 0d 09 56 69 |cific fi|les:..Vi|
|00000570| 73 46 72 61 6d 65 77 6f | 72 6b 2e 68 20 2d 20 64 |sFramewo|rk.h - d|
|00000580| 65 66 69 6e 65 73 2c 20 | 74 79 70 65 64 65 66 73 |efines, |typedefs|
|00000590| 2c 20 61 6e 64 20 66 75 | 6e 63 74 69 6f 6e 20 70 |, and fu|nction p|
|000005a0| 72 6f 74 6f 74 79 70 65 | 73 0d 09 56 69 73 46 72 |rototype|s..VisFr|
|000005b0| 61 6d 65 77 6f 72 6b 4d | 61 69 6e 2e 63 20 2d 20 |ameworkM|ain.c - |
|000005c0| 66 75 6e 63 74 69 6f 6e | 73 20 63 61 6c 6c 65 64 |function|s called|
|000005d0| 20 62 79 20 53 6f 75 6e | 64 4a 61 6d 0d 09 56 69 | by Soun|dJam..Vi|
|000005e0| 73 46 72 61 6d 65 77 6f | 72 6b 48 61 6e 64 6c 65 |sFramewo|rkHandle|
|000005f0| 72 73 2e 63 20 2d 20 68 | 61 6e 64 6c 65 72 20 66 |rs.c - h|andler f|
|00000600| 75 6e 63 74 69 6f 6e 73 | 20 66 6f 72 20 53 6f 75 |unctions| for Sou|
|00000610| 6e 64 4a 61 6d 20 6d 65 | 73 73 61 67 65 73 0d 09 |ndJam me|ssages..|
|00000620| 56 69 73 46 72 61 6d 65 | 77 6f 72 6b 52 6f 75 74 |VisFrame|workRout|
|00000630| 69 6e 65 73 2e 63 20 2d | 20 72 6f 75 74 69 6e 65 |ines.c -| routine|
|00000640| 73 20 63 61 6c 6c 65 64 | 20 62 79 20 76 61 72 69 |s called| by vari|
|00000650| 6f 75 73 20 68 61 6e 64 | 6c 65 72 20 66 75 6e 63 |ous hand|ler func|
|00000660| 74 69 6f 6e 73 0d 0d 45 | 61 63 68 20 66 75 6e 63 |tions..E|ach func|
|00000670| 74 69 6f 6e 20 68 61 73 | 20 61 20 66 61 69 72 6c |tion has| a fairl|
|00000680| 79 20 64 65 74 61 69 6c | 65 64 20 68 65 61 64 65 |y detail|ed heade|
|00000690| 72 20 74 68 61 74 20 65 | 78 70 6c 61 69 6e 73 20 |r that e|xplains |
|000006a0| 77 68 61 74 20 69 74 20 | 73 68 6f 75 6c 64 20 64 |what it |should d|
|000006b0| 6f 2c 20 77 68 61 74 20 | 74 68 65 20 66 69 65 6c |o, what |the fiel|
|000006c0| 64 73 20 6f 66 20 74 68 | 65 20 6d 65 73 73 61 67 |ds of th|e messag|
|000006d0| 65 73 20 61 72 65 2c 20 | 61 6e 64 20 74 68 69 6e |es are, |and thin|
|000006e0| 67 73 20 74 6f 20 77 61 | 74 63 68 20 66 6f 72 2e |gs to wa|tch for.|
|000006f0| 20 41 66 74 65 72 20 72 | 65 61 64 69 6e 67 20 74 | After r|eading t|
|00000700| 68 65 20 66 6f 6c 6c 6f | 77 69 6e 67 20 67 65 6e |he follo|wing gen|
|00000710| 65 72 61 6c 20 65 78 70 | 6c 61 6e 61 74 69 6f 6e |eral exp|lanation|
|00000720| 2c 20 77 65 20 73 75 67 | 67 65 73 74 20 74 68 61 |, we sug|gest tha|
|00000730| 74 20 79 6f 75 20 6c 6f | 6f 6b 20 61 74 20 74 68 |t you lo|ok at th|
|00000740| 65 20 76 61 72 69 6f 75 | 73 20 66 75 6e 63 74 69 |e variou|s functi|
|00000750| 6f 6e 73 20 69 6e 20 74 | 68 65 20 56 69 73 46 72 |ons in t|he VisFr|
|00000760| 61 6d 65 77 6f 72 6b 4d | 61 69 6e 2e 63 20 61 6e |ameworkM|ain.c an|
|00000770| 64 20 56 69 73 46 72 61 | 6d 65 77 6f 72 6b 48 61 |d VisFra|meworkHa|
|00000780| 6e 64 6c 65 72 73 2e 63 | 20 66 69 6c 65 73 2e 0d |ndlers.c| files..|
|00000790| 0d 52 65 67 69 73 74 65 | 72 69 6e 67 20 74 68 65 |.Registe|ring the|
|000007a0| 20 50 6c 75 67 2d 69 6e | 20 77 69 74 68 20 53 6f | Plug-in| with So|
|000007b0| 75 6e 64 4a 61 6d 0d 0d | 57 68 65 6e 20 53 6f 75 |undJam..|When Sou|
|000007c0| 6e 64 4a 61 6d 20 73 74 | 61 72 74 73 20 75 70 2c |ndJam st|arts up,|
|000007d0| 20 69 74 20 6c 6f 6f 6b | 73 20 69 6e 20 74 68 65 | it look|s in the|
|000007e0| 20 50 6c 75 67 69 6e 73 | 20 66 6f 6c 64 65 72 20 | Plugins| folder |
|000007f0| 66 6f 72 20 66 69 6c 65 | 73 20 77 69 74 68 20 61 |for file|s with a|
|00000800| 20 63 72 65 61 74 6f 72 | 20 6f 66 20 53 4a 41 4d | creator| of SJAM|
|00000810| 20 61 6e 64 20 61 20 74 | 79 70 65 20 6f 66 20 50 | and a t|ype of P|
|00000820| 4c 55 47 2e 20 49 74 20 | 74 68 65 6e 20 6c 6f 61 |LUG. It |then loa|
|00000830| 64 73 20 65 61 63 68 20 | 70 6c 75 67 2d 69 6e 20 |ds each |plug-in |
|00000840| 69 6e 20 74 75 72 6e 2c | 20 73 65 6e 64 69 6e 67 |in turn,| sending|
|00000850| 20 61 20 6d 65 73 73 61 | 67 65 20 74 6f 20 69 6e | a messa|ge to in|
|00000860| 69 74 69 61 74 65 20 72 | 65 67 69 73 74 72 61 74 |itiate r|egistrat|
|00000870| 69 6f 6e 20 6f 66 20 74 | 68 65 20 70 6c 75 67 2d |ion of t|he plug-|
|00000880| 69 6e 20 77 69 74 68 20 | 53 6f 75 6e 64 4a 61 6d |in with |SoundJam|
|00000890| 2e 0d 0d 54 68 65 20 66 | 69 72 73 74 20 74 69 6d |...The f|irst tim|
|000008a0| 65 20 53 6f 75 6e 64 4a | 61 6d 20 63 61 6c 6c 73 |e SoundJ|am calls|
|000008b0| 20 74 68 65 20 70 6c 75 | 67 2d 69 6e 2c 20 69 74 | the plu|g-in, it|
|000008c0| 20 70 61 73 73 65 73 20 | 74 68 65 20 66 6f 6c 6c | passes |the foll|
|000008d0| 6f 77 69 6e 67 20 70 61 | 72 61 6d 65 74 65 72 73 |owing pa|rameters|
|000008e0| 20 74 6f 20 6d 61 69 6e | 28 29 3a 0d 0d 09 6d 65 | to main|():...me|
|000008f0| 73 73 61 67 65 54 79 70 | 65 09 2d 20 6b 69 6e 64 |ssageTyp|e.- kind|
|00000900| 20 6f 66 20 6d 65 73 73 | 61 67 65 20 63 6f 6e 74 | of mess|age cont|
|00000910| 61 69 6e 65 64 20 69 6e | 20 74 68 65 20 6d 65 73 |ained in| the mes|
|00000920| 73 61 67 65 49 6e 66 6f | 20 73 74 72 75 63 74 0d |sageInfo| struct.|
|00000930| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000940| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 49 66 20 | | If |
|00000950| 74 68 69 73 20 69 73 20 | 6b 50 6c 75 67 69 6e 49 |this is |kPluginI|
|00000960| 6e 69 74 69 61 6c 69 7a | 65 4d 65 73 73 61 67 65 |nitializ|eMessage|
|00000970| 20 28 53 6f 75 6e 64 4a | 61 6d 41 50 49 2e 68 29 | (SoundJ|amAPI.h)|
|00000980| 2c 20 77 65 0d 20 20 20 | 20 20 20 20 20 20 20 20 |, we. | |
|00000990| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000009a0| 20 20 72 65 67 69 73 74 | 65 72 20 74 68 65 20 70 | regist|er the p|
|000009b0| 6c 75 67 2d 69 6e 20 62 | 79 20 66 69 6c 6c 69 6e |lug-in b|y fillin|
|000009c0| 67 20 69 6e 20 61 20 76 | 61 72 69 61 62 6c 65 20 |g in a v|ariable |
|000009d0| 6f 66 20 74 79 70 65 0d | 20 20 20 20 20 20 20 20 |of type.| |
|000009e0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|000009f0| 20 20 20 20 20 50 6c 61 | 79 65 72 4d 65 73 73 61 | Pla|yerMessa|
|00000a00| 67 65 49 6e 66 6f 20 28 | 53 6f 75 6e 64 4a 61 6d |geInfo (|SoundJam|
|00000a10| 41 50 49 2e 68 29 20 61 | 6e 64 20 70 61 73 73 69 |API.h) a|nd passi|
|00000a20| 6e 67 20 69 74 20 62 61 | 63 6b 20 74 6f 0d 20 20 |ng it ba|ck to. |
|00000a30| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000a40| 20 20 20 20 20 20 20 20 | 20 20 20 53 6f 75 6e 64 | | Sound|
|00000a50| 4a 61 6d 20 62 79 20 61 | 20 63 61 6c 6c 20 74 6f |Jam by a| call to|
|00000a60| 20 74 68 65 20 50 6c 61 | 79 65 72 52 65 67 69 73 | the Pla|yerRegis|
|00000a70| 74 65 72 56 69 73 75 61 | 6c 50 6c 75 67 69 6e 28 |terVisua|lPlugin(|
|00000a80| 29 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |). | |
|00000a90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 66 | | f|
|00000aa0| 75 6e 63 74 69 6f 6e 20 | 28 53 6f 75 6e 64 4a 61 |unction |(SoundJa|
|00000ab0| 6d 41 50 49 2e 63 29 2e | 0d 0d 09 6d 65 73 73 61 |mAPI.c).|...messa|
|00000ac0| 67 65 49 6e 66 6f 09 2d | 09 70 6f 69 6e 74 65 72 |geInfo.-|.pointer|
|00000ad0| 20 74 6f 20 61 20 50 6c | 75 67 69 6e 4d 65 73 73 | to a Pl|uginMess|
|00000ae0| 61 67 65 49 6e 66 6f 20 | 73 74 72 75 63 74 20 28 |ageInfo |struct (|
|00000af0| 53 6f 75 6e 64 4a 61 6d | 41 50 49 2e 68 29 0d 20 |SoundJam|API.h). |
|00000b00| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000b10| 20 20 20 20 20 20 20 20 | 20 20 20 20 54 68 69 73 | | This|
|00000b20| 20 77 69 6c 6c 20 63 6f | 6e 74 61 69 6e 20 61 20 | will co|ntain a |
|00000b30| 73 74 72 75 63 74 20 6f | 66 20 74 79 70 65 20 50 |struct o|f type P|
|00000b40| 6c 75 67 69 6e 49 6e 69 | 74 4d 65 73 73 61 67 65 |luginIni|tMessage|
|00000b50| 0d 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |. | |
|00000b60| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 28 53 | | (S|
|00000b70| 6f 75 6e 64 4a 61 6d 41 | 50 49 2e 68 29 2e 20 54 |oundJamA|PI.h). T|
|00000b80| 68 69 73 20 63 6f 6e 74 | 61 69 6e 73 20 69 6e 70 |his cont|ains inp|
|00000b90| 75 74 20 66 69 65 6c 64 | 73 20 66 6f 72 20 74 68 |ut field|s for th|
|00000ba0| 65 20 76 65 72 73 69 6f | 6e 0d 09 09 09 09 09 09 |e versio|n.......|
|00000bb0| 09 09 09 09 09 09 09 09 | 20 6f 66 20 53 6f 75 6e |........| of Soun|
|00000bc0| 64 4a 61 6d 2c 20 61 6c | 6f 6e 67 20 77 69 74 68 |dJam, al|ong with|
|00000bd0| 20 61 6e 20 61 70 70 43 | 6f 6f 6b 69 65 20 61 6e | an appC|ookie an|
|00000be0| 64 20 61 20 70 6c 61 79 | 65 72 50 72 6f 63 0d 20 |d a play|erProc. |
|00000bf0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000c00| 20 20 20 20 20 20 20 20 | 20 20 20 20 74 68 61 74 | | that|
|00000c10| 20 61 72 65 20 70 61 73 | 73 65 64 20 62 61 63 6b | are pas|sed back|
|00000c20| 20 74 6f 20 53 6f 75 6e | 64 4a 61 6d 20 69 6e 20 | to Soun|dJam in |
|00000c30| 74 68 65 20 63 61 6c 6c | 20 74 6f 20 74 68 65 0d |the call| to the.|
|00000c40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000c50| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 50 6c 61 | | Pla|
|00000c60| 79 65 72 52 65 67 69 73 | 74 65 72 56 69 73 75 61 |yerRegis|terVisua|
|00000c70| 6c 50 6c 75 67 69 6e 28 | 29 20 66 75 6e 63 74 69 |lPlugin(|) functi|
|00000c80| 6f 6e 2e 20 54 68 65 20 | 61 70 70 43 6f 6f 6b 69 |on. The |appCooki|
|00000c90| 65 0d 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |e. | |
|00000ca0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 66 | | f|
|00000cb0| 69 65 6c 64 20 69 73 20 | 75 73 65 64 20 74 6f 20 |ield is |used to |
|00000cc0| 69 64 65 6e 74 69 66 79 | 20 74 68 65 20 70 6c 75 |identify| the plu|
|00000cd0| 67 2d 69 6e 2c 20 61 6e | 64 20 74 68 65 20 70 6c |g-in, an|d the pl|
|00000ce0| 61 79 65 72 50 72 6f 63 | 0d 20 20 20 20 20 20 20 |ayerProc|. |
|00000cf0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000d00| 20 20 20 20 20 20 66 69 | 65 6c 64 20 63 6f 6e 74 | fi|eld cont|
|00000d10| 61 69 6e 73 20 61 20 70 | 6f 69 6e 74 65 72 20 74 |ains a p|ointer t|
|00000d20| 6f 20 74 68 65 20 70 6c | 75 67 2d 69 6e 20 69 6e |o the pl|ug-in in|
|00000d30| 20 6d 65 6d 6f 72 79 2e | 0d 20 20 20 20 20 20 20 | memory.|. |
|00000d40| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000d50| 20 20 20 20 20 20 54 68 | 65 20 50 6c 75 67 69 6e | Th|e Plugin|
|00000d60| 49 6e 69 74 4d 65 73 73 | 61 67 65 20 73 74 72 75 |InitMess|age stru|
|00000d70| 63 74 20 61 6c 73 6f 20 | 63 6f 6e 74 61 69 6e 73 |ct also |contains|
|00000d80| 20 6f 75 74 70 75 74 0d | 20 20 20 20 20 20 20 20 | output.| |
|00000d90| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000da0| 20 20 20 20 20 66 69 65 | 6c 64 73 20 66 6f 72 20 | fie|lds for |
|00000db0| 6f 70 74 69 6f 6e 73 2c | 20 61 6e 64 20 61 20 72 |options,| and a r|
|00000dc0| 65 66 63 6f 6e 20 66 6f | 72 20 73 74 6f 72 69 6e |efcon fo|r storin|
|00000dd0| 67 20 74 68 65 20 70 6c | 75 67 2d 69 6e 27 73 0d |g the pl|ug-in's.|
|00000de0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 | | |
|00000df0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 6f 77 6e | | own|
|00000e00| 20 67 6c 6f 62 61 6c 20 | 64 61 74 61 2e 0d 0d 09 | global |data....|
|00000e10| 72 65 66 63 6f 6e 09 09 | 09 09 09 09 09 2d 09 73 |refcon..|.....-.s|
|00000e20| 74 6f 72 65 64 20 70 6c | 75 67 2d 69 6e 20 67 6c |tored pl|ug-in gl|
|00000e30| 6f 62 61 6c 20 64 61 74 | 61 0d 0d 54 68 65 20 6d |obal dat|a..The m|
|00000e40| 61 69 6e 28 29 20 66 75 | 6e 63 74 69 6f 6e 20 69 |ain() fu|nction i|
|00000e50| 73 20 65 78 70 65 63 74 | 65 64 20 74 6f 20 72 65 |s expect|ed to re|
|00000e60| 74 75 72 6e 20 61 20 76 | 61 6c 75 65 20 6f 66 20 |turn a v|alue of |
|00000e70| 74 79 70 65 20 4f 53 53 | 74 61 74 75 73 2c 20 73 |type OSS|tatus, s|
|00000e80| 6f 20 69 74 20 73 68 6f | 75 6c 64 20 6c 6f 6f 6b |o it sho|uld look|
|00000e90| 20 6c 69 6b 65 20 74 68 | 69 73 3a 0d 4f 53 53 74 | like th|is:.OSSt|
|00000ea0| 61 74 75 73 20 6d 61 69 | 6e 20 28 4f 53 54 79 70 |atus mai|n (OSTyp|
|00000eb0| 65 20 6d 65 73 73 61 67 | 65 54 79 70 65 2c 50 6c |e messag|eType,Pl|
|00000ec0| 75 67 69 6e 4d 65 73 73 | 61 67 65 49 6e 66 6f 20 |uginMess|ageInfo |
|00000ed0| 2a 6d 65 73 73 61 67 65 | 49 6e 66 6f 2c 76 6f 69 |*message|Info,voi|
|00000ee0| 64 20 2a 72 65 66 63 6f | 6e 29 2e 20 53 65 65 20 |d *refco|n). See |
|00000ef0| 74 68 65 20 6d 61 69 6e | 28 29 20 66 75 6e 63 74 |the main|() funct|
|00000f00| 69 6f 6e 20 69 6e 20 56 | 69 73 46 72 61 6d 65 77 |ion in V|isFramew|
|00000f10| 6f 72 6b 4d 61 69 6e 2e | 63 20 66 6f 72 20 61 6e |orkMain.|c for an|
|00000f20| 20 65 78 61 6d 70 6c 65 | 20 6f 66 20 68 6f 77 20 | example| of how |
|00000f30| 74 6f 20 72 65 67 69 73 | 74 65 72 20 61 20 70 6c |to regis|ter a pl|
|00000f40| 75 67 2d 69 6e 20 77 69 | 74 68 20 53 6f 75 6e 64 |ug-in wi|th Sound|
|00000f50| 4a 61 6d 2e 20 4e 6f 74 | 65 20 74 68 61 74 20 6e |Jam. Not|e that n|
|00000f60| 6f 74 20 61 6c 6c 20 74 | 68 65 20 66 69 65 6c 64 |ot all t|he field|
|00000f70| 73 20 6f 66 20 65 76 65 | 72 79 20 73 74 72 75 63 |s of eve|ry struc|
|00000f80| 74 20 61 72 65 20 75 73 | 65 64 20 61 74 20 74 68 |t are us|ed at th|
|00000f90| 69 73 20 74 69 6d 65 2e | 0d 0d 54 68 65 20 73 74 |is time.|..The st|
|00000fa0| 72 75 63 74 75 72 65 20 | 6f 66 20 74 68 65 20 6d |ructure |of the m|
|00000fb0| 61 69 6e 28 29 20 66 75 | 6e 63 74 69 6f 6e 20 69 |ain() fu|nction i|
|00000fc0| 6e 20 56 69 73 46 72 61 | 6d 65 77 6f 72 6b 4d 61 |n VisFra|meworkMa|
|00000fd0| 69 6e 2e 63 20 73 68 6f | 75 6c 64 6e 27 74 20 72 |in.c sho|uldn't r|
|00000fe0| 65 71 75 69 72 65 20 61 | 6e 79 20 63 68 61 6e 67 |equire a|ny chang|
|00000ff0| 65 73 20 74 6f 20 61 64 | 61 70 74 20 69 74 20 74 |es to ad|apt it t|
|00001000| 6f 20 61 6e 79 20 6e 65 | 77 20 76 69 73 75 61 6c |o any ne|w visual|
|00001010| 20 70 6c 75 67 2d 69 6e | 2e 20 4a 75 73 74 20 63 | plug-in|. Just c|
|00001020| 68 61 6e 67 65 20 74 68 | 65 20 61 63 74 75 61 6c |hange th|e actual|
|00001030| 20 64 61 74 61 20 62 65 | 69 6e 67 20 70 6c 75 67 | data be|ing plug|
|00001040| 67 65 64 20 69 6e 74 6f | 20 74 68 65 20 66 69 65 |ged into| the fie|
|00001050| 6c 64 73 20 6f 66 20 70 | 6c 61 79 65 72 4d 65 73 |lds of p|layerMes|
|00001060| 73 61 67 65 49 6e 66 6f | 2e 75 2e 72 65 67 69 73 |sageInfo|.u.regis|
|00001070| 74 65 72 56 69 73 75 61 | 6c 50 6c 75 67 69 6e 4d |terVisua|lPluginM|
|00001080| 65 73 73 61 67 65 20 74 | 6f 20 72 65 66 6c 65 63 |essage t|o reflec|
|00001090| 74 20 74 68 65 20 72 65 | 71 75 69 72 65 6d 65 6e |t the re|quiremen|
|000010a0| 74 73 20 6f 66 20 79 6f | 75 72 20 70 6c 75 67 2d |ts of yo|ur plug-|
|000010b0| 69 6e 2e 0d 0d 48 6f 77 | 20 53 6f 75 6e 64 4a 61 |in...How| SoundJa|
|000010c0| 6d 20 43 61 6c 6c 73 20 | 74 68 65 20 50 6c 75 67 |m Calls |the Plug|
|000010d0| 2d 69 6e 0d 0d 54 68 65 | 20 2e 68 61 6e 64 6c 65 |-in..The| .handle|
|000010e0| 72 20 66 69 65 6c 64 20 | 6f 66 20 74 68 65 20 50 |r field |of the P|
|000010f0| 6c 61 79 65 72 4d 65 73 | 73 61 67 65 49 6e 66 6f |layerMes|sageInfo|
|00001100| 20 73 74 72 75 63 74 20 | 69 73 20 75 73 65 64 20 | struct |is used |
|00001110| 74 6f 20 70 61 73 73 20 | 61 20 70 6f 69 6e 74 65 |to pass |a pointe|
|00001120| 72 20 74 6f 20 74 68 65 | 20 70 6c 75 67 2d 69 6e |r to the| plug-in|
|00001130| 20 66 75 6e 63 74 69 6f | 6e 20 74 68 61 74 20 77 | functio|n that w|
|00001140| 69 6c 6c 20 68 61 6e 64 | 6c 65 20 69 6e 63 6f 6d |ill hand|le incom|
|00001150| 69 6e 67 20 6d 65 73 73 | 61 67 65 73 20 66 72 6f |ing mess|ages fro|
|00001160| 6d 20 53 6f 75 6e 64 4a | 61 6d 2e 20 49 6e 20 74 |m SoundJ|am. In t|
|00001170| 68 65 20 73 61 6d 70 6c | 65 20 63 6f 64 65 2c 20 |he sampl|e code, |
|00001180| 74 68 69 73 20 66 75 6e | 63 74 69 6f 6e 20 69 73 |this fun|ction is|
|00001190| 20 63 61 6c 6c 65 64 20 | 56 69 73 48 61 6e 64 6c | called |VisHandl|
|000011a0| 65 72 28 29 2c 20 61 6e | 64 20 69 74 20 63 61 6e |er(), an|d it can|
|000011b0| 20 62 65 20 66 6f 75 6e | 64 20 69 6e 20 56 69 73 | be foun|d in Vis|
|000011c0| 46 72 61 6d 65 77 6f 72 | 6b 4d 61 69 6e 2e 63 2e |Framewor|kMain.c.|
|000011d0| 20 20 49 74 20 73 68 6f | 75 6c 64 20 6c 6f 6f 6b | It sho|uld look|
|000011e0| 20 6c 69 6b 65 20 74 68 | 69 73 3a 0d 0d 4f 53 53 | like th|is:..OSS|
|000011f0| 74 61 74 75 73 20 56 69 | 73 48 61 6e 64 6c 65 72 |tatus Vi|sHandler|
|00001200| 20 28 4f 53 54 79 70 65 | 20 6d 65 73 73 61 67 65 | (OSType| message|
|00001210| 54 79 70 65 2c 56 69 73 | 75 61 6c 50 6c 75 67 69 |Type,Vis|ualPlugi|
|00001220| 6e 4d 65 73 73 61 67 65 | 49 6e 66 6f 20 2a 6d 65 |nMessage|Info *me|
|00001230| 73 73 61 67 65 49 6e 66 | 6f 2c 76 6f 69 64 20 2a |ssageInf|o,void *|
|00001240| 72 65 66 63 6f 6e 29 0d | 0d 54 68 65 20 6d 65 73 |refcon).|.The mes|
|00001250| 73 61 67 65 54 79 70 65 | 20 61 6e 64 20 72 65 66 |sageType| and ref|
|00001260| 63 6f 6e 20 70 61 72 61 | 6d 73 20 61 72 65 20 74 |con para|ms are t|
|00001270| 68 65 20 73 61 6d 65 20 | 61 73 20 74 68 6f 73 65 |he same |as those|
|00001280| 20 66 6f 72 20 74 68 65 | 20 6d 61 69 6e 28 29 20 | for the| main() |
|00001290| 66 75 6e 63 74 69 6f 6e | 2e 20 54 68 65 20 6d 65 |function|. The me|
|000012a0| 73 73 61 67 65 49 6e 66 | 6f 20 70 61 72 61 6d 20 |ssageInf|o param |
|000012b0| 28 56 69 73 75 61 6c 50 | 6c 75 67 69 6e 2e 68 29 |(VisualP|lugin.h)|
|000012c0| 20 63 6f 6e 74 61 69 6e | 73 20 66 69 65 6c 64 73 | contain|s fields|
|000012d0| 20 74 68 61 74 20 61 72 | 65 20 73 70 65 63 69 66 | that ar|e specif|
|000012e0| 69 63 20 74 6f 20 76 69 | 73 75 61 6c 20 70 6c 75 |ic to vi|sual plu|
|000012f0| 67 69 6e 73 2e 20 54 68 | 65 20 56 69 73 75 61 6c |gins. Th|e Visual|
|00001300| 50 6c 75 67 69 6e 4d 65 | 73 73 61 67 65 49 6e 66 |PluginMe|ssageInf|
|00001310| 6f 20 73 74 72 75 63 74 | 20 69 73 20 61 20 75 6e |o struct| is a un|
|00001320| 69 6f 6e 20 6f 66 20 61 | 20 76 61 72 69 65 74 79 |ion of a| variety|
|00001330| 20 6f 66 20 73 74 72 75 | 63 74 73 2e 20 54 68 65 | of stru|cts. The|
|00001340| 20 6d 65 73 73 61 67 65 | 54 79 70 65 20 70 61 72 | message|Type par|
|00001350| 61 6d 20 69 73 20 74 68 | 65 20 6b 65 79 20 74 6f |am is th|e key to|
|00001360| 20 77 68 69 63 68 20 6f | 66 20 74 68 65 73 65 20 | which o|f these |
|00001370| 73 74 72 75 63 74 73 20 | 68 61 73 20 62 65 65 6e |structs |has been|
|00001380| 20 69 6e 63 6c 75 64 65 | 64 2e 20 54 68 65 73 65 | include|d. These|
|00001390| 20 73 74 72 75 63 74 73 | 20 61 6e 64 20 74 68 65 | structs| and the|
|000013a0| 20 63 6f 72 72 65 73 70 | 6f 6e 64 69 6e 67 20 6d | corresp|onding m|
|000013b0| 65 73 73 61 67 65 54 79 | 70 65 20 63 6f 6e 73 74 |essageTy|pe const|
|000013c0| 61 6e 74 73 20 61 72 65 | 20 61 6c 6c 20 64 65 66 |ants are| all def|
|000013d0| 69 6e 65 64 20 69 6e 20 | 56 69 73 75 61 6c 50 6c |ined in |VisualPl|
|000013e0| 75 67 69 6e 2e 68 2e 0d | 0d 4c 69 6b 65 20 74 68 |ugin.h..|.Like th|
|000013f0| 65 20 6d 61 69 6e 28 29 | 20 66 75 6e 63 74 69 6f |e main()| functio|
|00001400| 6e 2c 20 74 68 65 20 56 | 69 73 48 61 6e 64 6c 65 |n, the V|isHandle|
|00001410| 72 28 29 20 66 75 6e 63 | 74 69 6f 6e 20 69 73 20 |r() func|tion is |
|00001420| 64 65 73 69 67 6e 65 64 | 20 74 6f 20 77 6f 72 6b |designed| to work|
|00001430| 20 66 6f 72 20 61 6e 79 | 20 76 69 73 75 61 6c 69 | for any| visuali|
|00001440| 7a 61 74 69 6f 6e 20 70 | 6c 75 67 2d 69 6e 20 77 |zation p|lug-in w|
|00001450| 69 74 68 20 6f 6e 6c 79 | 20 6d 69 6e 69 6d 61 6c |ith only| minimal|
|00001460| 20 63 68 61 6e 67 65 73 | 2e 20 49 74 20 63 61 6c | changes|. It cal|
|00001470| 6c 73 20 61 20 64 69 66 | 66 65 72 65 6e 74 20 68 |ls a dif|ferent h|
|00001480| 61 6e 64 6c 65 72 20 66 | 75 6e 63 74 69 6f 6e 20 |andler f|unction |
|00001490| 66 6f 72 20 65 61 63 68 | 20 6f 66 20 74 68 65 20 |for each| of the |
|000014a0| 70 6f 73 73 69 62 6c 65 | 20 53 6f 75 6e 64 4a 61 |possible| SoundJa|
|000014b0| 6d 20 6d 65 73 73 61 67 | 65 73 2c 20 62 61 73 65 |m messag|es, base|
|000014c0| 64 20 6f 6e 20 74 68 65 | 20 6d 65 73 73 61 67 65 |d on the| message|
|000014d0| 54 79 70 65 20 70 61 72 | 61 6d 2e 20 49 66 20 74 |Type par|am. If t|
|000014e0| 68 65 20 6d 65 73 73 61 | 67 65 49 6e 66 6f 20 70 |he messa|geInfo p|
|000014f0| 61 72 61 6d 20 69 73 20 | 72 65 6c 65 76 61 6e 74 |aram is |relevant|
|00001500| 20 74 6f 20 74 68 65 20 | 70 61 72 74 69 63 75 6c | to the |particul|
|00001510| 61 72 20 6d 65 73 73 61 | 67 65 2c 20 69 74 20 70 |ar messa|ge, it p|
|00001520| 61 73 73 65 73 20 69 74 | 20 74 6f 20 74 68 65 20 |asses it| to the |
|00001530| 68 61 6e 64 6c 65 72 3b | 20 6f 74 68 65 72 77 69 |handler;| otherwi|
|00001540| 73 65 2c 20 69 74 20 64 | 6f 65 73 20 6e 6f 74 2e |se, it d|oes not.|
|00001550| 0d 0d 49 6e 20 74 68 65 | 20 73 61 6d 70 6c 65 20 |..In the| sample |
|00001560| 63 6f 64 65 2c 20 77 65 | 20 68 61 76 65 20 64 65 |code, we| have de|
|00001570| 63 6c 61 72 65 64 20 61 | 20 73 74 72 75 63 74 20 |clared a| struct |
|00001580| 6f 66 20 74 79 70 65 20 | 56 69 73 48 61 6e 64 6c |of type |VisHandl|
|00001590| 65 72 44 61 74 61 20 28 | 56 69 73 46 72 61 6d 65 |erData (|VisFrame|
|000015a0| 77 6f 72 6b 2e 68 29 20 | 74 6f 20 68 6f 6c 64 20 |work.h) |to hold |
|000015b0| 61 6c 6c 20 6f 66 20 6f | 75 72 20 67 6c 6f 62 61 |all of o|ur globa|
|000015c0| 6c 20 64 61 74 61 2e 20 | 54 68 69 73 20 69 73 20 |l data. |This is |
|000015d0| 74 68 65 20 64 61 74 61 | 20 74 68 61 74 20 77 65 |the data| that we|
|000015e0| 20 77 61 6e 74 20 74 6f | 20 63 6f 6e 74 69 6e 75 | want to| continu|
|000015f0| 65 20 74 6f 20 68 61 76 | 65 20 61 63 63 65 73 73 |e to hav|e access|
|00001600| 20 74 6f 20 66 72 6f 6d | 20 6f 6e 65 20 63 61 6c | to from| one cal|
|00001610| 6c 20 74 6f 20 74 68 65 | 20 6e 65 78 74 2e 20 54 |l to the| next. T|
|00001620| 68 65 20 56 69 73 48 61 | 6e 64 6c 65 72 28 29 20 |he VisHa|ndler() |
|00001630| 66 75 6e 63 74 69 6f 6e | 20 63 6f 6e 74 61 69 6e |function| contain|
|00001640| 73 20 61 20 56 69 73 48 | 61 6e 64 6c 65 72 44 61 |s a VisH|andlerDa|
|00001650| 74 61 20 70 6f 69 6e 74 | 65 72 20 77 68 69 63 68 |ta point|er which|
|00001660| 20 69 73 20 73 65 74 20 | 74 6f 20 74 68 65 20 20 | is set |to the |
|00001670| 72 65 66 63 6f 6e 20 70 | 61 72 61 6d 2e 20 54 68 |refcon p|aram. Th|
|00001680| 69 73 20 70 6f 69 6e 74 | 65 72 2c 20 77 68 69 63 |is point|er, whic|
|00001690| 68 20 69 73 20 70 61 73 | 73 65 64 20 74 6f 20 65 |h is pas|sed to e|
|000016a0| 61 63 68 20 6f 66 20 74 | 68 65 20 68 61 6e 64 6c |ach of t|he handl|
|000016b0| 65 72 20 66 75 6e 63 74 | 69 6f 6e 73 2c 20 77 69 |er funct|ions, wi|
|000016c0| 6c 6c 20 62 65 20 6e 69 | 6c 20 74 68 65 20 66 69 |ll be ni|l the fi|
|000016d0| 72 73 74 20 74 69 6d 65 | 20 74 68 65 20 56 69 73 |rst time| the Vis|
|000016e0| 48 61 6e 64 6c 65 72 28 | 29 20 66 75 6e 63 74 69 |Handler(|) functi|
|000016f0| 6f 6e 20 69 73 20 63 61 | 6c 6c 65 64 20 62 79 20 |on is ca|lled by |
|00001700| 53 6f 75 6e 64 4a 61 6d | 2c 20 73 6f 20 74 68 65 |SoundJam|, so the|
|00001710| 20 48 61 6e 64 6c 65 49 | 6e 69 74 69 61 6c 69 7a | HandleI|nitializ|
|00001720| 65 4d 65 73 73 61 67 65 | 28 29 20 66 75 6e 63 74 |eMessage|() funct|
|00001730| 69 6f 6e 20 28 56 69 73 | 46 72 61 6d 65 77 6f 72 |ion (Vis|Framewor|
|00001740| 6b 48 61 6e 64 6c 65 72 | 73 2e 63 29 20 6d 75 73 |kHandler|s.c) mus|
|00001750| 74 20 69 6e 69 74 69 61 | 6c 69 7a 65 20 69 74 2e |t initia|lize it.|
|00001760| 20 54 68 65 6e 2c 20 65 | 61 63 68 20 6d 65 73 73 | Then, e|ach mess|
|00001770| 61 67 65 20 68 61 6e 64 | 6c 65 72 20 77 69 6c 6c |age hand|ler will|
|00001780| 20 66 69 6c 6c 20 69 6e | 20 61 6e 79 20 72 65 6c | fill in| any rel|
|00001790| 65 76 61 6e 74 20 66 69 | 65 6c 64 73 2e 20 59 6f |evant fi|elds. Yo|
|000017a0| 75 20 73 68 6f 75 6c 64 | 20 6d 6f 64 69 66 79 20 |u should| modify |
|000017b0| 74 68 65 20 56 69 73 48 | 61 6e 64 6c 65 72 44 61 |the VisH|andlerDa|
|000017c0| 74 61 20 73 74 72 75 63 | 74 20 62 79 20 61 64 64 |ta struc|t by add|
|000017d0| 69 6e 67 20 66 69 65 6c | 64 73 20 74 6f 20 63 6f |ing fiel|ds to co|
|000017e0| 6e 74 61 69 6e 20 74 68 | 65 20 64 61 74 61 20 74 |ntain th|e data t|
|000017f0| 68 61 74 20 77 69 6c 6c | 20 62 65 20 6e 65 65 64 |hat will| be need|
|00001800| 65 64 20 62 79 20 79 6f | 75 72 20 70 6c 75 67 2d |ed by yo|ur plug-|
|00001810| 69 6e 2e 0d 0d 48 61 6e | 64 6c 69 6e 67 20 4d 65 |in...Han|dling Me|
|00001820| 73 73 61 67 65 73 20 66 | 72 6f 6d 20 53 6f 75 6e |ssages f|rom Soun|
|00001830| 64 4a 61 6d 0d 0d 53 6f | 75 6e 64 4a 61 6d 20 77 |dJam..So|undJam w|
|00001840| 69 6c 6c 20 73 65 6e 64 | 20 61 20 76 61 72 69 65 |ill send| a varie|
|00001850| 74 79 20 6f 66 20 6d 65 | 73 73 61 67 65 73 20 74 |ty of me|ssages t|
|00001860| 6f 20 79 6f 75 72 20 70 | 6c 75 67 2d 69 6e 2e 20 |o your p|lug-in. |
|00001870| 53 6f 6d 65 2c 20 6c 69 | 6b 65 20 74 68 65 20 6b |Some, li|ke the k|
|00001880| 56 69 73 75 61 6c 50 6c | 75 67 69 6e 49 6e 69 74 |VisualPl|uginInit|
|00001890| 69 61 6c 69 7a 65 4d 65 | 73 73 61 67 65 20 61 6e |ializeMe|ssage an|
|000018a0| 64 20 6b 56 69 73 75 61 | 6c 50 6c 75 67 69 6e 43 |d kVisua|lPluginC|
|000018b0| 6c 65 61 6e 75 70 4d 65 | 73 73 61 67 65 20 6d 65 |leanupMe|ssage me|
|000018c0| 73 73 61 67 65 73 20 77 | 69 6c 6c 20 74 65 6c 6c |ssages w|ill tell|
|000018d0| 20 74 68 65 20 70 6c 75 | 67 2d 69 6e 20 74 68 61 | the plu|g-in tha|
|000018e0| 74 20 69 74 20 69 73 20 | 74 69 6d 65 20 74 6f 20 |t it is |time to |
|000018f0| 73 74 61 72 74 20 75 70 | 20 6f 72 20 74 6f 20 73 |start up| or to s|
|00001900| 68 75 74 20 64 6f 77 6e | 2e 20 4f 74 68 65 72 73 |hut down|. Others|
|00001910| 20 77 69 6c 6c 20 74 65 | 6c 6c 20 69 74 20 74 68 | will te|ll it th|
|00001920| 61 74 20 61 20 74 72 61 | 63 6b 20 68 61 73 20 73 |at a tra|ck has s|
|00001930| 74 61 72 74 65 64 20 70 | 6c 61 79 69 6e 67 2c 20 |tarted p|laying, |
|00001940| 73 74 6f 70 70 65 64 20 | 70 6c 61 79 69 6e 67 2c |stopped |playing,|
|00001950| 20 70 61 75 73 65 64 2c | 20 65 74 63 2e 20 54 68 | paused,| etc. Th|
|00001960| 65 72 65 20 69 73 20 61 | 6c 73 6f 20 61 20 6d 65 |ere is a|lso a me|
|00001970| 73 73 61 67 65 20 66 6f | 72 20 70 61 73 73 69 6e |ssage fo|r passin|
|00001980| 67 20 6d 6f 75 73 65 20 | 63 6c 69 63 6b 20 61 6e |g mouse |click an|
|00001990| 64 20 6b 65 79 73 74 72 | 6f 6b 65 20 65 76 65 6e |d keystr|oke even|
|000019a0| 74 73 20 74 68 61 74 20 | 6d 61 79 20 62 65 20 68 |ts that |may be h|
|000019b0| 61 6e 64 6c 65 64 20 62 | 79 20 74 68 65 20 70 6c |andled b|y the pl|
|000019c0| 75 67 2d 69 6e 2e 20 54 | 68 65 20 64 65 74 61 69 |ug-in. T|he detai|
|000019d0| 6c 73 20 6f 66 20 65 61 | 63 68 20 6d 65 73 73 61 |ls of ea|ch messa|
|000019e0| 67 65 20 63 61 6e 20 62 | 65 20 75 6e 64 65 72 73 |ge can b|e unders|
|000019f0| 74 6f 6f 64 20 62 79 20 | 6c 6f 6f 6b 69 6e 67 20 |tood by |looking |
|00001a00| 66 69 72 73 74 20 61 74 | 20 74 68 65 20 56 69 73 |first at| the Vis|
|00001a10| 48 61 6e 64 6c 65 72 28 | 29 20 66 75 6e 63 74 69 |Handler(|) functi|
|00001a20| 6f 6e 20 69 6e 20 56 69 | 73 46 72 61 6d 65 77 6f |on in Vi|sFramewo|
|00001a30| 72 6b 4d 61 69 6e 2e 63 | 20 61 6e 64 20 74 68 65 |rkMain.c| and the|
|00001a40| 6e 20 61 74 20 74 68 65 | 20 69 6e 64 69 76 69 64 |n at the| individ|
|00001a50| 75 61 6c 20 68 61 6e 64 | 6c 65 72 20 66 75 6e 63 |ual hand|ler func|
|00001a60| 74 69 6f 6e 73 20 69 6e | 20 56 69 73 46 72 61 6d |tions in| VisFram|
|00001a70| 65 77 6f 72 6b 48 61 6e | 64 6c 65 72 73 2e 63 2c |eworkHan|dlers.c,|
|00001a80| 20 61 6c 6c 20 6f 66 20 | 77 68 69 63 68 20 61 72 | all of |which ar|
|00001a90| 65 20 70 72 65 74 74 79 | 20 77 65 6c 6c 20 63 6f |e pretty| well co|
|00001aa0| 6d 6d 65 6e 74 65 64 2e | 0d 0d 44 72 61 77 69 6e |mmented.|..Drawin|
|00001ab0| 67 20 69 6e 20 52 65 73 | 70 6f 6e 73 65 20 74 6f |g in Res|ponse to|
|00001ac0| 20 74 68 65 20 53 6f 75 | 6e 64 20 44 61 74 61 0d | the Sou|nd Data.|
|00001ad0| 0d 57 68 65 6e 20 69 74 | 27 73 20 74 69 6d 65 20 |.When it|'s time |
|00001ae0| 66 6f 72 20 74 68 65 20 | 76 69 73 75 61 6c 20 70 |for the |visual p|
|00001af0| 6c 75 67 2d 69 6e 20 74 | 6f 20 61 63 74 75 61 6c |lug-in t|o actual|
|00001b00| 6c 79 20 64 6f 20 73 6f | 6d 65 20 64 72 61 77 69 |ly do so|me drawi|
|00001b10| 6e 67 2c 20 53 6f 75 6e | 64 4a 61 6d 20 77 69 6c |ng, Soun|dJam wil|
|00001b20| 6c 20 73 65 6e 64 20 61 | 20 6d 65 73 73 61 67 65 |l send a| message|
|00001b30| 54 79 70 65 20 6f 66 20 | 6b 56 69 73 75 61 6c 50 |Type of |kVisualP|
|00001b40| 6c 75 67 69 6e 52 65 6e | 64 65 72 4d 65 73 73 61 |luginRen|derMessa|
|00001b50| 67 65 2c 20 61 6e 64 20 | 6d 65 73 73 61 67 65 49 |ge, and |messageI|
|00001b60| 6e 66 6f 20 77 69 6c 6c | 20 63 6f 6e 74 61 69 6e |nfo will| contain|
|00001b70| 20 61 20 56 69 73 75 61 | 6c 50 6c 75 67 69 6e 52 | a Visua|lPluginR|
|00001b80| 65 6e 64 65 72 4d 65 73 | 73 61 67 65 20 73 74 72 |enderMes|sage str|
|00001b90| 75 63 74 2c 20 77 68 69 | 63 68 20 63 6f 6e 73 69 |uct, whi|ch consi|
|00001ba0| 73 74 73 20 6f 66 20 61 | 20 74 69 6d 65 53 74 61 |sts of a| timeSta|
|00001bb0| 6d 70 20 66 69 65 6c 64 | 20 61 6e 64 20 61 20 72 |mp field| and a r|
|00001bc0| 65 6e 64 65 72 44 61 74 | 61 20 66 69 65 6c 64 2e |enderDat|a field.|
|00001bd0| 20 54 68 65 20 72 65 6e | 64 65 72 44 61 74 61 20 | The ren|derData |
|00001be0| 66 69 65 6c 64 20 69 73 | 20 61 20 73 74 72 75 63 |field is| a struc|
|00001bf0| 74 20 6f 66 20 74 79 70 | 65 20 52 65 6e 64 65 72 |t of typ|e Render|
|00001c00| 56 69 73 75 61 6c 44 61 | 74 61 2c 20 77 68 69 63 |VisualDa|ta, whic|
|00001c10| 68 20 68 61 73 20 66 6f | 75 72 20 66 69 65 6c 64 |h has fo|ur field|
|00001c20| 73 20 28 73 65 65 20 56 | 69 73 75 61 6c 50 6c 75 |s (see V|isualPlu|
|00001c30| 67 69 6e 2e 68 29 3a 0d | 0d 77 61 76 65 66 6f 72 |gin.h):.|.wavefor|
|00001c40| 6d 20 64 61 74 61 3a 20 | 54 68 69 73 20 69 73 20 |m data: |This is |
|00001c50| 72 61 77 20 73 6f 75 6e | 64 20 64 61 74 61 2e 0d |raw soun|d data..|
|00001c60| 20 20 55 49 6e 74 38 20 | 20 6e 75 6d 57 61 76 65 | UInt8 | numWave|
|00001c70| 66 6f 72 6d 43 68 61 6e | 6e 65 6c 73 20 2d 20 6e |formChan|nels - n|
|00001c80| 75 6d 62 65 72 20 6f 66 | 20 77 61 76 65 66 6f 72 |umber of| wavefor|
|00001c90| 6d 20 63 68 61 6e 6e 65 | 6c 73 0d 20 20 55 49 6e |m channe|ls. UIn|
|00001ca0| 74 38 20 20 77 61 76 65 | 66 6f 72 6d 44 61 74 61 |t8 wave|formData|
|00001cb0| 5b 32 5d 5b 35 31 32 5d | 20 2d 20 74 77 6f 20 63 |[2][512]| - two c|
|00001cc0| 68 61 6e 6e 65 6c 73 2c | 20 65 61 63 68 20 77 69 |hannels,| each wi|
|00001cd0| 74 68 20 35 31 32 20 62 | 79 74 65 73 20 6f 66 20 |th 512 b|ytes of |
|00001ce0| 77 61 76 65 66 6f 72 6d | 20 64 61 74 61 0d 09 0d |waveform| data...|
|00001cf0| 73 70 65 63 74 72 75 6d | 20 64 61 74 61 3a 20 54 |spectrum| data: T|
|00001d00| 68 69 73 20 69 73 20 73 | 6f 75 6e 64 20 64 61 74 |his is s|ound dat|
|00001d10| 61 20 70 72 6f 63 65 73 | 73 65 64 20 69 6e 74 6f |a proces|sed into|
|00001d20| 20 66 72 65 71 75 65 6e | 63 79 20 64 61 74 61 2e | frequen|cy data.|
|00001d30| 0d 09 55 49 6e 74 38 20 | 20 6e 75 6d 53 70 65 63 |..UInt8 | numSpec|
|00001d40| 74 72 75 6d 43 68 61 6e | 6e 65 6c 73 20 2d 20 6e |trumChan|nels - n|
|00001d50| 75 6d 62 65 72 20 6f 66 | 20 73 70 65 63 74 72 75 |umber of| spectru|
|00001d60| 6d 20 63 68 61 6e 6e 65 | 6c 73 0d 09 55 49 6e 74 |m channe|ls..UInt|
|00001d70| 38 20 20 73 70 65 63 74 | 72 75 6d 44 61 74 61 5b |8 spect|rumData[|
|00001d80| 32 5d 5b 35 31 32 5d 20 | 2d 20 74 77 6f 20 63 68 |2][512] |- two ch|
|00001d90| 61 6e 6e 65 6c 73 2c 20 | 65 61 63 68 20 77 69 74 |annels, |each wit|
|00001da0| 68 20 35 31 32 20 62 79 | 74 65 73 20 6f 66 20 73 |h 512 by|tes of s|
|00001db0| 70 65 63 74 72 75 6d 20 | 64 61 74 61 0d 0d 54 68 |pectrum |data..Th|
|00001dc0| 65 20 56 69 73 75 61 6c | 20 46 72 61 6d 65 77 6f |e Visual| Framewo|
|00001dd0| 72 6b 20 50 6c 75 67 2d | 69 6e 20 73 61 6d 70 6c |rk Plug-|in sampl|
|00001de0| 65 20 70 6c 75 67 2d 69 | 6e 20 75 73 65 73 20 6f |e plug-i|n uses o|
|00001df0| 6e 6c 79 20 6f 6e 65 20 | 63 68 61 6e 6e 65 6c 20 |nly one |channel |
|00001e00| 6f 66 20 73 70 65 63 74 | 72 75 6d 20 64 61 74 61 |of spect|rum data|
|00001e10| 2e 20 49 74 20 75 73 65 | 73 20 74 68 69 73 20 64 |. It use|s this d|
|00001e20| 61 74 61 20 74 6f 20 63 | 72 65 61 74 65 20 73 65 |ata to c|reate se|
|00001e30| 76 65 72 61 6c 20 73 69 | 6d 70 6c 65 20 64 69 73 |veral si|mple dis|
|00001e40| 70 6c 61 79 73 2e 0d 0d | 4d 6f 64 69 66 79 69 6e |plays...|Modifyin|
|00001e50| 67 20 74 68 65 20 53 6f | 75 6e 64 20 44 61 74 61 |g the So|und Data|
|00001e60| 0d 0d 49 6e 20 6f 72 64 | 65 72 20 74 6f 20 72 65 |..In ord|er to re|
|00001e70| 63 65 69 76 65 20 73 6f | 75 6e 64 20 73 61 6d 70 |ceive so|und samp|
|00001e80| 6c 65 73 2c 20 79 6f 75 | 20 77 69 6c 6c 20 68 61 |les, you| will ha|
|00001e90| 76 65 20 74 6f 20 73 65 | 74 20 74 68 65 20 6b 56 |ve to se|t the kV|
|00001ea0| 69 73 75 61 6c 57 61 6e | 74 73 54 6f 50 72 6f 63 |isualWan|tsToProc|
|00001eb0| 65 73 73 53 61 6d 70 6c | 65 73 20 6f 70 74 69 6f |essSampl|es optio|
|00001ec0| 6e 20 69 6e 20 6d 61 69 | 6e 28 29 20 28 56 69 73 |n in mai|n() (Vis|
|00001ed0| 46 72 61 6d 65 77 6f 72 | 6b 4d 61 69 6e 2e 63 29 |Framewor|kMain.c)|
|00001ee0| 2e 20 54 68 65 6e 20 53 | 6f 75 6e 64 4a 61 6d 20 |. Then S|oundJam |
|00001ef0| 77 69 6c 6c 20 70 65 72 | 69 6f 64 69 63 61 6c 6c |will per|iodicall|
|00001f00| 79 20 73 65 6e 64 20 79 | 6f 75 20 61 20 70 72 6f |y send y|ou a pro|
|00001f10| 63 65 73 73 53 61 6d 70 | 6c 65 73 20 6d 65 73 73 |cessSamp|les mess|
|00001f20| 61 67 65 20 63 6f 6e 74 | 61 69 6e 69 6e 67 20 56 |age cont|aining V|
|00001f30| 69 73 75 61 6c 50 6c 75 | 67 69 6e 50 72 6f 63 65 |isualPlu|ginProce|
|00001f40| 73 73 53 61 6d 70 6c 65 | 73 4d 65 73 73 61 67 65 |ssSample|sMessage|
|00001f50| 20 73 74 72 75 63 74 20 | 28 56 69 73 75 61 6c 50 | struct |(VisualP|
|00001f60| 6c 75 67 69 6e 2e 68 29 | 2e 20 54 68 69 73 20 73 |lugin.h)|. This s|
|00001f70| 74 72 75 63 74 20 69 6e | 63 6c 75 64 65 73 20 61 |truct in|cludes a|
|00001f80| 20 70 6f 69 6e 74 65 72 | 20 74 6f 20 61 20 73 61 | pointer| to a sa|
|00001f90| 6d 70 6c 65 42 75 66 66 | 65 72 2e 20 54 68 69 73 |mpleBuff|er. This|
|00001fa0| 20 69 73 20 74 68 65 20 | 73 6f 75 6e 64 20 64 61 | is the |sound da|
|00001fb0| 74 61 20 74 68 61 74 20 | 68 61 73 20 6e 6f 74 20 |ta that |has not |
|00001fc0| 79 65 74 20 62 65 65 6e | 20 70 6c 61 79 65 64 2c |yet been| played,|
|00001fd0| 20 73 6f 20 77 68 61 74 | 65 76 65 72 20 69 73 20 | so what|ever is |
|00001fe0| 64 6f 6e 65 20 74 6f 20 | 69 74 20 77 69 6c 6c 20 |done to |it will |
|00001ff0| 62 65 20 68 65 61 72 64 | 20 77 68 65 6e 20 74 68 |be heard| when th|
|00002000| 65 20 73 6f 75 6e 64 20 | 69 73 20 70 6c 61 79 65 |e sound |is playe|
|00002010| 64 2e 0d 0d 54 68 65 20 | 55 73 65 72 20 49 6e 74 |d...The |User Int|
|00002020| 65 72 66 61 63 65 0d 0d | 45 76 65 6e 20 69 66 20 |erface..|Even if |
|00002030| 79 6f 75 72 20 70 6c 75 | 67 69 6e 20 64 6f 65 73 |your plu|gin does|
|00002040| 20 6e 6f 74 20 63 72 65 | 61 74 65 20 61 20 76 69 | not cre|ate a vi|
|00002050| 73 75 61 6c 20 64 69 73 | 70 6c 61 79 2c 20 69 74 |sual dis|play, it|
|00002060| 20 73 68 6f 75 6c 64 20 | 75 73 65 20 74 68 65 20 | should |use the |
|00002070| 70 6c 75 67 2d 69 6e 20 | 77 69 6e 64 6f 77 20 74 |plug-in |window t|
|00002080| 6f 20 70 72 6f 76 69 64 | 65 20 61 20 75 73 65 72 |o provid|e a user|
|00002090| 20 69 6e 74 65 72 66 61 | 63 65 2e 20 53 6f 75 6e | interfa|ce. Soun|
|000020a0| 64 4a 61 6d 20 77 69 6c | 6c 20 70 61 73 73 20 6d |dJam wil|l pass m|
|000020b0| 6f 75 73 65 20 63 6c 69 | 63 6b 20 61 6e 64 20 6b |ouse cli|ck and k|
|000020c0| 65 79 73 74 72 6f 6b 65 | 20 65 76 65 6e 74 73 20 |eystroke| events |
|000020d0| 74 68 61 74 20 6f 63 63 | 75 72 20 69 6e 20 74 68 |that occ|ur in th|
|000020e0| 65 20 70 6c 75 67 2d 69 | 6e 20 77 69 6e 64 6f 77 |e plug-i|n window|
|000020f0| 20 74 6f 20 74 68 65 20 | 70 6c 75 67 2d 69 6e 2e | to the |plug-in.|
|00002100| 20 54 68 65 20 73 61 6d | 70 6c 65 20 70 6c 75 67 | The sam|ple plug|
|00002110| 2d 69 6e 20 69 6e 63 6c | 75 64 65 73 20 61 20 70 |-in incl|udes a p|
|00002120| 6f 70 2d 75 70 20 6d 65 | 6e 75 20 74 68 61 74 20 |op-up me|nu that |
|00002130| 69 73 20 62 72 6f 75 67 | 68 74 20 75 70 20 69 6e |is broug|ht up in|
|00002140| 20 72 65 73 70 6f 6e 73 | 65 20 74 6f 20 61 20 63 | respons|e to a c|
|00002150| 6c 69 63 6b 20 69 6e 20 | 74 68 65 20 70 6c 75 67 |lick in |the plug|
|00002160| 2d 69 6e 20 77 69 6e 64 | 6f 77 20 28 56 69 73 46 |-in wind|ow (VisF|
|00002170| 72 61 6d 65 77 6f 72 6b | 52 6f 75 74 69 6e 65 73 |ramework|Routines|
|00002180| 2e 63 29 2e 0d 0d 53 61 | 76 69 6e 67 20 50 72 65 |.c)...Sa|ving Pre|
|00002190| 66 65 72 65 6e 63 65 73 | 0d 0d 50 6c 75 67 2d 69 |ferences|..Plug-i|
|000021a0| 6e 73 20 63 61 6e 20 68 | 61 76 65 20 53 6f 75 6e |ns can h|ave Soun|
|000021b0| 64 4a 61 6d 20 73 61 76 | 65 20 61 6e 64 20 72 65 |dJam sav|e and re|
|000021c0| 73 74 6f 72 65 20 70 72 | 65 66 65 72 65 6e 63 65 |store pr|eference|
|000021d0| 20 64 61 74 61 20 76 69 | 61 20 74 68 65 20 50 6c | data vi|a the Pl|
|000021e0| 61 79 65 72 53 65 74 50 | 6c 75 67 69 6e 44 61 74 |ayerSetP|luginDat|
|000021f0| 61 28 29 20 61 6e 64 20 | 50 6c 61 79 65 72 47 65 |a() and |PlayerGe|
|00002200| 74 50 6c 75 67 69 6e 44 | 61 74 61 28 29 20 66 75 |tPluginD|ata() fu|
|00002210| 6e 63 74 69 6f 6e 73 20 | 28 53 6f 75 6e 64 4a 61 |nctions |(SoundJa|
|00002220| 6d 41 50 49 2e 63 29 2e | 0d 0d 54 68 65 20 56 69 |mAPI.c).|..The Vi|
|00002230| 73 75 61 6c 20 46 72 61 | 6d 65 77 6f 72 6b 20 50 |sual Fra|mework P|
|00002240| 6c 75 67 2d 69 6e 20 73 | 61 6d 70 6c 65 20 70 6c |lug-in s|ample pl|
|00002250| 75 67 2d 69 6e 20 63 61 | 6c 6c 73 20 50 6c 61 79 |ug-in ca|lls Play|
|00002260| 65 72 53 65 74 50 6c 75 | 67 69 6e 44 61 74 61 28 |erSetPlu|ginData(|
|00002270| 29 20 74 6f 20 73 61 76 | 65 20 74 68 65 20 63 6f |) to sav|e the co|
|00002280| 6c 6f 72 20 6d 6f 64 65 | 20 61 6e 64 20 64 72 61 |lor mode| and dra|
|00002290| 77 69 6e 67 20 6d 6f 64 | 65 20 74 68 61 74 20 61 |wing mod|e that a|
|000022a0| 72 65 20 69 6e 20 65 66 | 66 65 63 74 20 77 68 65 |re in ef|fect whe|
|000022b0| 6e 20 69 74 20 73 68 75 | 74 73 20 64 6f 77 6e 2c |n it shu|ts down,|
|000022c0| 20 61 6e 64 20 72 65 73 | 74 6f 72 65 73 20 74 68 | and res|tores th|
|000022d0| 65 6d 20 74 68 65 20 6e | 65 78 74 20 74 69 6d 65 |em the n|ext time|
|000022e0| 20 69 74 20 73 74 61 72 | 74 73 20 75 70 20 62 79 | it star|ts up by|
|000022f0| 20 63 61 6c 6c 69 6e 67 | 20 50 6c 61 79 65 72 47 | calling| PlayerG|
|00002300| 65 74 50 6c 75 67 69 6e | 44 61 74 61 28 29 2e 0d |etPlugin|Data()..|
|00002310| 0d 45 72 72 6f 72 20 48 | 61 6e 64 6c 69 6e 67 0d |.Error H|andling.|
|00002320| 0d 54 68 65 20 70 6c 75 | 67 2d 69 6e 20 73 68 6f |.The plu|g-in sho|
|00002330| 75 6c 64 20 74 65 73 74 | 20 66 6f 72 20 65 72 72 |uld test| for err|
|00002340| 6f 72 20 63 6f 6e 64 69 | 74 69 6f 6e 73 20 6c 69 |or condi|tions li|
|00002350| 6b 65 20 61 6e 79 20 6f | 74 68 65 72 20 61 70 70 |ke any o|ther app|
|00002360| 6c 69 63 61 74 69 6f 6e | 2e 20 49 66 20 61 20 66 |lication|. If a f|
|00002370| 61 74 61 6c 20 65 72 72 | 6f 72 20 6f 63 63 75 72 |atal err|or occur|
|00002380| 73 2c 20 69 74 20 73 68 | 6f 75 6c 64 20 62 65 20 |s, it sh|ould be |
|00002390| 70 61 73 73 65 64 20 62 | 61 63 6b 20 64 6f 77 6e |passed b|ack down|
|000023a0| 20 74 68 65 20 6c 69 6e | 65 20 74 6f 20 74 68 65 | the lin|e to the|
|000023b0| 20 56 69 73 48 61 6e 64 | 6c 65 72 28 29 20 66 75 | VisHand|ler() fu|
|000023c0| 6e 63 74 69 6f 6e 2c 20 | 77 68 69 63 68 20 77 69 |nction, |which wi|
|000023d0| 6c 6c 20 70 61 73 73 20 | 69 74 20 62 61 63 6b 20 |ll pass |it back |
|000023e0| 74 6f 20 53 6f 75 6e 64 | 4a 61 6d 2e 0d 0d 54 68 |to Sound|Jam...Th|
|000023f0| 69 6e 67 73 20 74 6f 20 | 57 61 74 63 68 20 46 6f |ings to |Watch Fo|
|00002400| 72 0d 0d 49 74 20 69 73 | 20 65 73 70 65 63 69 61 |r..It is| especia|
|00002410| 6c 6c 79 20 69 6d 70 6f | 72 74 61 6e 74 20 74 68 |lly impo|rtant th|
|00002420| 61 74 20 65 61 63 68 20 | 70 6c 75 67 2d 69 6e 20 |at each |plug-in |
|00002430| 73 68 6f 75 6c 64 20 64 | 69 73 70 6f 73 65 20 6f |should d|ispose o|
|00002440| 66 20 61 6e 79 20 6d 65 | 6d 6f 72 79 20 74 68 61 |f any me|mory tha|
|00002450| 74 20 69 74 20 61 6c 6c | 6f 63 61 74 65 73 2e 20 |t it all|ocates. |
|00002460| 54 68 69 73 20 69 73 20 | 65 73 70 65 63 69 61 6c |This is |especial|
|00002470| 6c 79 20 74 72 75 65 20 | 6f 66 20 64 72 61 77 69 |ly true |of drawi|
|00002480| 6e 67 20 6d 65 6d 6f 72 | 79 20 74 68 61 74 20 69 |ng memor|y that i|
|00002490| 73 20 61 6c 6c 6f 63 61 | 74 65 64 20 65 61 63 68 |s alloca|ted each|
|000024a0| 20 74 69 6d 65 20 74 68 | 65 20 70 6c 75 67 2d 69 | time th|e plug-i|
|000024b0| 6e 20 72 65 63 65 69 76 | 65 73 20 61 20 6d 65 73 |n receiv|es a mes|
|000024c0| 73 61 67 65 54 79 70 65 | 20 6f 66 20 6b 56 69 73 |sageType| of kVis|
|000024d0| 75 61 6c 50 6c 75 67 69 | 6e 45 6e 61 62 6c 65 4d |ualPlugi|nEnableM|
|000024e0| 65 73 73 61 67 65 2e 20 | 41 20 70 6c 75 67 2d 69 |essage. |A plug-i|
|000024f0| 6e 20 6d 61 79 20 62 65 | 20 65 6e 61 62 6c 65 64 |n may be| enabled|
|00002500| 20 61 6e 64 20 64 69 73 | 61 62 6c 65 64 20 6d 61 | and dis|abled ma|
|00002510| 6e 79 20 74 69 6d 65 73 | 2c 20 61 6e 64 20 66 61 |ny times|, and fa|
|00002520| 69 6c 69 6e 67 20 74 6f | 20 64 69 73 70 6f 73 65 |iling to| dispose|
|00002530| 20 6f 66 20 61 6c 6c 6f | 63 61 74 65 64 20 6d 65 | of allo|cated me|
|00002540| 6d 6f 72 79 20 61 66 74 | 65 72 20 72 65 63 65 69 |mory aft|er recei|
|00002550| 76 69 6e 67 20 61 20 6d | 65 73 73 61 67 65 54 79 |ving a m|essageTy|
|00002560| 70 65 20 6f 66 20 6b 56 | 69 73 75 61 6c 50 6c 75 |pe of kV|isualPlu|
|00002570| 67 69 6e 44 69 73 61 62 | 6c 65 4d 65 73 73 61 67 |ginDisab|leMessag|
|00002580| 65 20 63 6f 75 6c 64 20 | 72 65 73 75 6c 74 20 69 |e could |result i|
|00002590| 6e 20 61 20 73 65 76 65 | 72 65 20 6d 65 6d 6f 72 |n a seve|re memor|
|000025a0| 79 20 6c 65 61 6b 2e 20 | 4f 66 20 63 6f 75 72 73 |y leak. |Of cours|
|000025b0| 65 2c 20 61 6c 6c 20 61 | 6c 6c 6f 63 61 74 65 64 |e, all a|llocated|
|000025c0| 20 6d 65 6d 6f 72 79 20 | 73 68 6f 75 6c 64 20 62 | memory |should b|
|000025d0| 65 20 64 69 73 70 6f 73 | 65 64 20 6f 66 20 6f 6e |e dispos|ed of on|
|000025e0| 20 72 65 63 65 69 76 69 | 6e 67 20 61 20 6d 65 73 | receivi|ng a mes|
|000025f0| 73 61 67 65 54 79 70 65 | 20 6f 66 20 6b 56 69 73 |sageType| of kVis|
|00002600| 75 61 6c 50 6c 75 67 69 | 6e 43 6c 65 61 6e 75 70 |ualPlugi|nCleanup|
|00002610| 4d 65 73 73 61 67 65 2e | 0d 0d 49 74 27 73 20 61 |Message.|..It's a|
|00002620| 6c 73 6f 20 61 20 67 6f | 6f 64 20 69 64 65 61 20 |lso a go|od idea |
|00002630| 74 6f 20 75 73 65 20 74 | 65 6d 70 6f 72 61 72 79 |to use t|emporary|
|00002640| 20 6d 65 6d 6f 72 79 20 | 77 68 65 6e 65 76 65 72 | memory |whenever|
|00002650| 20 70 6f 73 73 69 62 6c | 65 2e 0d 0d 44 72 61 77 | possibl|e...Draw|
|00002660| 69 6e 67 20 73 68 6f 75 | 6c 64 2c 20 6e 61 74 75 |ing shou|ld, natu|
|00002670| 72 61 6c 6c 79 2c 20 62 | 65 20 64 6f 6e 65 20 61 |rally, b|e done a|
|00002680| 73 20 65 66 66 69 63 69 | 65 6e 74 6c 79 20 61 73 |s effici|ently as|
|00002690| 20 70 6f 73 73 69 62 6c | 65 2e 20 49 66 20 61 20 | possibl|e. If a |
|000026a0| 64 72 61 77 69 6e 67 20 | 72 6f 75 74 69 6e 65 20 |drawing |routine |
|000026b0| 74 61 6b 65 73 20 6d 6f | 72 65 20 74 69 6d 65 20 |takes mo|re time |
|000026c0| 74 68 61 6e 20 69 73 20 | 61 6c 6c 6f 63 61 74 65 |than is |allocate|
|000026d0| 64 20 74 6f 20 69 74 2c | 20 69 74 20 63 61 6e 20 |d to it,| it can |
|000026e0| 69 6e 74 65 72 66 65 72 | 65 20 77 69 74 68 20 70 |interfer|e with p|
|000026f0| 6c 61 79 69 6e 67 20 74 | 68 65 20 6d 75 73 69 63 |laying t|he music|
|00002700| 20 61 6e 64 20 63 61 6e | 20 6d 61 6b 65 20 69 74 | and can| make it|
|00002710| 20 64 69 66 66 69 63 75 | 6c 74 2d 2d 6f 72 20 65 | difficu|lt--or e|
|00002720| 76 65 6e 20 69 6d 70 6f | 73 73 69 62 6c 65 2d 2d |ven impo|ssible--|
|00002730| 66 6f 72 20 74 68 65 20 | 61 70 70 6c 69 63 61 74 |for the |applicat|
|00002740| 69 6f 6e 20 74 6f 20 72 | 65 63 65 69 76 65 20 65 |ion to r|eceive e|
|00002750| 76 65 6e 74 73 2e 20 49 | 66 20 79 6f 75 72 20 70 |vents. I|f your p|
|00002760| 6c 75 67 2d 69 6e 20 68 | 61 73 20 61 20 72 65 73 |lug-in h|as a res|
|00002770| 69 7a 65 61 62 6c 65 20 | 20 77 69 6e 64 6f 77 2c |izeable | window,|
|00002780| 20 62 65 20 73 75 72 65 | 20 74 6f 20 74 65 73 74 | be sure| to test|
|00002790| 20 69 74 20 77 69 74 68 | 20 74 68 65 20 77 69 6e | it with| the win|
|000027a0| 64 6f 77 20 73 65 74 20 | 61 73 20 6c 61 72 67 65 |dow set |as large|
|000027b0| 20 61 73 20 70 6f 73 73 | 69 62 6c 65 2c 20 73 69 | as poss|ible, si|
|000027c0| 6e 63 65 20 64 72 61 77 | 69 6e 67 20 61 20 6c 61 |nce draw|ing a la|
|000027d0| 72 67 65 20 69 6d 61 67 | 65 20 6d 61 79 20 74 61 |rge imag|e may ta|
|000027e0| 6b 65 20 6c 6f 6e 67 65 | 72 20 74 68 61 6e 20 64 |ke longe|r than d|
|000027f0| 72 61 77 69 6e 67 20 61 | 20 73 6d 61 6c 6c 20 6f |rawing a| small o|
|00002800| 6e 65 2e 0d 0d 42 65 20 | 73 75 72 65 20 74 6f 20 |ne...Be |sure to |
|00002810| 72 65 74 75 72 6e 20 61 | 6e 20 65 72 72 6f 72 20 |return a|n error |
|00002820| 6f 74 68 65 72 20 74 68 | 61 6e 20 6e 6f 45 72 72 |other th|an noErr|
|00002830| 20 28 65 2e 67 2e 2c 20 | 70 61 72 61 6d 45 72 72 | (e.g., |paramErr|
|00002840| 29 20 77 68 65 6e 65 76 | 65 72 20 79 6f 75 20 72 |) whenev|er you r|
|00002850| 65 63 65 69 76 65 20 61 | 20 6b 65 79 44 6f 77 6e |eceive a| keyDown|
|00002860| 20 65 76 65 6e 74 20 74 | 68 61 74 20 79 6f 75 20 | event t|hat you |
|00002870| 64 6f 20 6e 6f 74 20 68 | 61 6e 64 6c 65 2c 20 69 |do not h|andle, i|
|00002880| 6e 20 6f 72 64 65 72 20 | 74 6f 20 61 76 6f 69 64 |n order |to avoid|
|00002890| 20 73 77 61 6c 6c 6f 77 | 69 6e 67 20 6b 65 79 73 | swallow|ing keys|
|000028a0| 74 72 6f 6b 65 73 20 74 | 68 61 74 20 53 6f 75 6e |trokes t|hat Soun|
|000028b0| 64 4a 61 6d 20 6d 61 79 | 20 72 65 61 63 74 20 74 |dJam may| react t|
|000028c0| 6f 2e 0d 0d 44 6f 6e 27 | 74 20 73 65 74 20 74 68 |o...Don'|t set th|
|000028d0| 65 20 6d 69 6e 69 6d 75 | 6d 20 77 69 6e 64 6f 77 |e minimu|m window|
|000028e0| 20 73 69 7a 65 20 74 6f | 6f 20 73 6d 61 6c 6c 20 | size to|o small |
|000028f0| 66 6f 72 20 73 63 72 6f | 6c 6c 20 62 61 72 73 20 |for scro|ll bars |
|00002900| 74 6f 20 62 65 20 64 72 | 61 77 6e 20 70 72 6f 70 |to be dr|awn prop|
|00002910| 65 72 6c 79 2e 00 00 00 | 00 00 00 00 00 00 00 00 |erly....|........|
|00002920| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002930| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002940| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002950| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002960| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002970| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002980| 00 00 01 00 00 00 06 f6 | 00 00 05 f6 00 00 00 32 |........|.......2|
|00002990| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000029a0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000029b0| 1a 56 69 73 75 61 6c 20 | 50 6c 75 67 2d 69 6e 20 |.Visual |Plug-in |
|000029c0| 57 68 69 74 65 20 50 61 | 70 65 72 69 6f 6e 31 31 |White Pa|perion11|
|000029d0| 00 00 54 45 58 54 74 74 | 78 74 01 00 00 00 00 00 |..TEXTtt|xt......|
|000029e0| 00 00 00 00 00 00 00 00 | 00 00 80 00 00 00 00 00 |........|........|
|000029f0| 00 00 b3 a2 4f e6 00 00 | 28 95 00 00 07 28 00 00 |....O...|(....(..|
|00002a00| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a10| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a20| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a30| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a40| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a50| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a60| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a70| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|00002a80| 00 00 05 f2 00 4c 00 00 | 00 00 00 13 00 0e 00 03 |.....L..|........|
|00002a90| 01 00 00 0e 00 00 00 00 | 00 00 00 00 00 2b 00 10 |........|.....+..|
|00002aa0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002ab0| 02 0b 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002ac0| 00 00 00 00 02 1e 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002ad0| 00 00 00 00 00 00 00 00 | 02 b2 00 10 00 0c 00 03 |........|........|
|00002ae0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 02 cb 00 10 |........|........|
|00002af0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002b00| 03 db 00 10 00 0c 00 03 | 04 00 00 0c 00 00 00 00 |........|........|
|00002b10| 00 00 00 00 03 f6 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002b20| 00 00 00 00 00 00 00 00 | 04 d3 00 10 00 0c 00 03 |........|........|
|00002b30| 04 00 00 0c 00 00 00 00 | 00 00 00 00 04 ec 00 10 |........|........|
|00002b40| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002b50| 07 11 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002b60| 00 00 00 00 07 36 00 10 | 00 0c 00 03 00 00 00 0c |.....6..|........|
|00002b70| 00 00 00 00 00 00 00 00 | 08 6e 00 10 00 0c 00 03 |........|.n......|
|00002b80| 01 00 00 0c 00 00 00 00 | 00 00 00 00 08 79 00 10 |........|.....y..|
|00002b90| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002ba0| 08 9d 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002bb0| 00 00 00 00 08 a8 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002bc0| 00 00 00 00 00 00 00 00 | 0a 3b 00 10 00 0c 00 03 |........|.;......|
|00002bd0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 0a 46 00 10 |........|.....F..|
|00002be0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002bf0| 0d 90 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002c00| 00 00 00 00 0d 96 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002c10| 00 00 00 00 00 00 00 00 | 0e 25 00 10 00 0c 00 03 |........|.%......|
|00002c20| 01 00 00 0c 00 00 00 00 | 00 00 00 00 0e 29 00 10 |........|.....)..|
|00002c30| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002c40| 0e 32 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |.2......|........|
|00002c50| 00 00 00 00 0e 3d 00 10 | 00 0c 00 03 00 00 00 0c |.....=..|........|
|00002c60| 00 00 00 00 00 00 00 00 | 0e 50 00 10 00 0c 00 03 |........|.P......|
|00002c70| 01 00 00 0c 00 00 00 00 | 00 00 00 00 0e 5c 00 10 |........|.....\..|
|00002c80| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002c90| 0e 62 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |.b......|........|
|00002ca0| 00 00 00 00 0e 69 00 10 | 00 0c 00 03 00 00 00 0c |.....i..|........|
|00002cb0| 00 00 00 00 00 00 00 00 | 10 35 00 10 00 0c 00 03 |........|.5......|
|00002cc0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 10 53 00 10 |........|.....S..|
|00002cd0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002ce0| 11 89 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002cf0| 00 00 00 00 11 94 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002d00| 00 00 00 00 00 00 00 00 | 11 ad 00 10 00 0c 00 03 |........|........|
|00002d10| 01 00 00 0c 00 00 00 00 | 00 00 00 00 11 b9 00 10 |........|........|
|00002d20| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002d30| 11 bf 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002d40| 00 00 00 00 11 c6 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002d50| 00 00 00 00 00 00 00 00 | 11 cd 00 10 00 0c 00 03 |........|........|
|00002d60| 01 00 00 0c 00 00 00 00 | 00 00 00 00 11 d8 00 10 |........|........|
|00002d70| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002d80| 11 dd 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002d90| 00 00 00 00 11 e3 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002da0| 00 00 00 00 00 00 00 00 | 12 1e 00 10 00 0c 00 03 |........|........|
|00002db0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 12 29 00 10 |........|.....)..|
|00002dc0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002dd0| 12 c1 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002de0| 00 00 00 00 12 cc 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002df0| 00 00 00 00 00 00 00 00 | 13 2f 00 10 00 0c 00 03 |........|./......|
|00002e00| 01 00 00 0c 00 00 00 00 | 00 00 00 00 13 3a 00 10 |........|.....:..|
|00002e10| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002e20| 14 49 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |.I......|........|
|00002e30| 00 00 00 00 14 54 00 10 | 00 0c 00 03 00 00 00 0c |.....T..|........|
|00002e40| 00 00 00 00 00 00 00 00 | 14 63 00 10 00 0c 00 03 |........|.c......|
|00002e50| 01 00 00 0c 00 00 00 00 | 00 00 00 00 14 6e 00 10 |........|.....n..|
|00002e60| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002e70| 15 f0 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002e80| 00 00 00 00 15 f6 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002e90| 00 00 00 00 00 00 00 00 | 17 95 00 10 00 0c 00 03 |........|........|
|00002ea0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 17 b4 00 10 |........|........|
|00002eb0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002ec0| 1a 2a 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |.*......|........|
|00002ed0| 00 00 00 00 1a 4f 00 10 | 00 0c 00 03 00 00 00 0c |.....O..|........|
|00002ee0| 00 00 00 00 00 00 00 00 | 1a a9 00 10 00 0c 00 03 |........|........|
|00002ef0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 1a b4 00 10 |........|........|
|00002f00| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002f10| 1a d8 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002f20| 00 00 00 00 1a e3 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002f30| 00 00 00 00 00 00 00 00 | 1b b9 00 10 00 0c 00 03 |........|........|
|00002f40| 04 00 00 0c 00 00 00 00 | 00 00 00 00 1b c6 00 10 |........|........|
|00002f50| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002f60| 1c 70 00 10 00 0c 00 03 | 04 00 00 0c 00 00 00 00 |.p......|........|
|00002f70| 00 00 00 00 1c 7d 00 10 | 00 0c 00 03 00 00 00 0c |.....}..|........|
|00002f80| 00 00 00 00 00 00 00 00 | 1d c8 00 10 00 0c 00 03 |........|........|
|00002f90| 01 00 00 0c 00 00 00 00 | 00 00 00 00 1d e0 00 10 |........|........|
|00002fa0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00002fb0| 1f 94 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |........|........|
|00002fc0| 00 00 00 00 1f a6 00 10 | 00 0c 00 03 00 00 00 0c |........|........|
|00002fd0| 00 00 00 00 00 00 00 00 | 21 06 00 10 00 0c 00 03 |........|!.......|
|00002fe0| 01 00 00 0c 00 00 00 00 | 00 00 00 00 21 18 00 10 |........|....!...|
|00002ff0| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00003000| 22 91 00 10 00 0c 00 03 | 01 00 00 0c 00 00 00 00 |".......|........|
|00003010| 00 00 00 00 22 9f 00 10 | 00 0c 00 03 00 00 00 0c |...."...|........|
|00003020| 00 00 00 00 00 00 00 00 | 23 6e 00 10 00 0c 00 03 |........|#n......|
|00003030| 01 00 00 0c 00 00 00 00 | 00 00 00 00 23 81 00 10 |........|....#...|
|00003040| 00 0c 00 03 00 00 00 0c | 00 00 00 00 00 00 00 00 |........|........|
|00003050| 26 93 00 10 00 0c 00 03 | 04 00 00 0c 00 00 00 00 |&.......|........|
|00003060| 00 00 00 00 26 96 00 10 | 00 0c 00 03 00 00 00 0c |....&...|........|
|00003070| 00 00 00 00 00 00 00 00 | 01 00 00 00 06 f6 00 00 |........|........|
|00003080| 05 f6 00 00 00 32 05 67 | 5b 28 3b 20 00 00 00 1c |.....2.g|[(; ....|
|00003090| 00 32 00 00 73 74 79 6c | 00 00 00 0a 00 80 ff ff |.2..styl|........|
|000030a0| 00 00 00 00 05 67 c7 04 | 00 00 00 00 00 00 00 00 |.....g..|........|
|000030b0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000030c0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000030d0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000030e0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
|000030f0| 00 00 00 00 00 00 00 00 | 00 00 00 00 00 00 00 00 |........|........|
+--------+-------------------------+-------------------------+--------+--------+