/ Enigma Amiga Life 106 / EnigmaAmiga106CD.iso / software / sviluppo / ahisrc / docs / ahidev.texinfo

< prev

next >

MacOS 8.1

Win98

DOS

browse contents

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 69 6e 70 75 74 20 74 | 6d 70 2d 69 73 6f 2e 73 |\input t|mp-iso.s|
|00000010| 74 79 0a 5c 69 6e 70 75 | 74 20 74 65 78 69 6e 66 |ty.\inpu|t texinf|
|00000020| 6f 20 20 20 20 20 20 20 | 20 20 20 20 20 20 40 63 |o       |      @c|
|00000030| 20 2d 2a 2d 74 65 78 69 | 6e 66 6f 2d 2a 2d 0a 40 | -*-texi|nfo-*-.@|
|00000040| 63 20 25 2a 2a 2a 73 74 | 61 72 74 20 6f 66 20 68 |c %***st|art of h|
|00000050| 65 61 64 65 72 0a 40 73 | 65 74 66 69 6c 65 6e 61 |eader.@s|etfilena|
|00000060| 6d 65 20 61 68 69 64 65 | 76 2e 69 6e 66 6f 0a 40 |me ahide|v.info.@|
|00000070| 73 65 74 74 69 74 6c 65 | 20 40 73 63 7b 41 68 69 |settitle| @sc{Ahi|
|00000080| 7d 20 44 65 76 65 6c 6f | 70 65 72 73 27 73 20 47 |} Develo|pers's G|
|00000090| 75 69 64 65 0a 40 73 65 | 74 63 68 61 70 74 65 72 |uide.@se|tchapter|
|000000a0| 6e 65 77 70 61 67 65 20 | 6f 64 64 0a 40 69 66 74 |newpage |odd.@ift|
|000000b0| 65 78 0a 40 61 66 6f 75 | 72 70 61 70 65 72 0a 40 |ex.@afou|rpaper.@|
|000000c0| 65 6e 64 20 69 66 74 65 | 78 0a 40 63 20 25 2a 2a |end ifte|x.@c %**|
|000000d0| 2a 65 6e 64 20 6f 66 20 | 68 65 61 64 65 72 0a 0a |*end of |header..|
|000000e0| 40 63 20 2a 2a 2a 20 56 | 61 72 69 61 62 6c 65 73 |@c *** V|ariables|
|000000f0| 20 2a 2a 2a 0a 0a 40 63 | 20 53 65 74 20 61 68 69 | ***..@c| Set ahi|
|00000100| 76 65 72 20 61 6e 64 20 | 64 6f 63 76 65 72 20 74 |ver and |docver t|
|00000110| 6f 20 63 75 72 72 65 6e | 74 20 72 65 6c 65 61 73 |o curren|t releas|
|00000120| 65 20 76 65 72 73 69 6f | 6e 0a 40 69 6e 63 6c 75 |e versio|n.@inclu|
|00000130| 64 65 20 61 68 69 64 65 | 76 2e 76 65 72 0a 0a 0a |de ahide|v.ver...|
|00000140| 40 63 20 50 61 72 74 20 | 32 3a 20 53 75 6d 6d 61 |@c Part |2: Summa|
|00000150| 72 79 20 44 65 73 63 72 | 69 70 74 69 6f 6e 20 61 |ry Descr|iption a|
|00000160| 6e 64 20 43 6f 70 79 72 | 69 67 68 74 0a 40 63 20 |nd Copyr|ight.@c |
|00000170| af af af af af af af af | af af af af af af af af |........|........|
|00000180| af af af af af af af af | af af af af af af af af |........|........|
|00000190| af af af af af af af af | af 0a 0a 40 69 66 69 6e |........|...@ifin|
|000001a0| 66 6f 0a 54 68 69 73 20 | 66 69 6c 65 20 64 6f 63 |fo.This |file doc|
|000001b0| 75 6d 65 6e 74 73 20 41 | 48 49 20 76 65 72 73 69 |uments A|HI versi|
|000001c0| 6f 6e 20 40 76 61 6c 75 | 65 7b 61 68 69 76 65 72 |on @valu|e{ahiver|
|000001d0| 7d 2c 20 61 20 68 61 72 | 64 77 61 72 65 20 69 6e |}, a har|dware in|
|000001e0| 64 65 70 65 6e 64 65 6e | 74 0a 61 75 64 69 6f 20 |dependen|t.audio |
|000001f0| 73 75 62 73 79 73 74 65 | 6d 20 66 6f 72 20 41 6d |subsyste|m for Am|
|00000200| 69 67 61 2e 20 54 68 65 | 20 76 65 72 73 69 6f 6e |iga. The| version|
|00000210| 20 6e 75 6d 62 65 72 20 | 6f 66 20 74 68 69 73 20 | number |of this |
|00000220| 64 6f 63 75 6d 65 6e 74 | 20 69 73 0a 40 76 61 6c |document| is.@val|
|00000230| 75 65 7b 64 6f 63 76 65 | 72 7d 2e 0a 0a 43 6f 70 |ue{docve|r}...Cop|
|00000240| 79 72 69 67 68 74 20 40 | 63 6f 70 79 72 69 67 68 |yright @|copyrigh|
|00000250| 74 7b 7d 20 31 39 39 34 | 2d 31 39 39 39 20 4d 61 |t{} 1994|-1999 Ma|
|00000260| 72 74 69 6e 20 42 6c 6f | 6d 2e 20 54 68 69 73 20 |rtin Blo|m. This |
|00000270| 70 75 62 6c 69 63 61 74 | 69 6f 6e 20 6d 61 79 20 |publicat|ion may |
|00000280| 6e 6f 74 0a 62 65 20 6d | 6f 64 69 66 69 65 64 20 |not.be m|odified |
|00000290| 69 6e 20 61 6e 79 20 77 | 61 79 2c 20 69 6e 63 6c |in any w|ay, incl|
|000002a0| 75 64 69 6e 67 20 74 72 | 61 6e 73 6c 61 74 69 6f |uding tr|anslatio|
|000002b0| 6e 2c 20 77 69 74 68 6f | 75 74 20 70 72 69 6f 72 |n, witho|ut prior|
|000002c0| 20 63 6f 6e 73 65 6e 74 | 2c 20 69 6e 0a 77 72 69 | consent|, in.wri|
|000002d0| 74 69 6e 67 2c 20 62 79 | 20 74 68 65 20 61 75 74 |ting, by| the aut|
|000002e0| 68 6f 72 2e 0a 0a 50 65 | 72 6d 69 73 73 69 6f 6e |hor...Pe|rmission|
|000002f0| 20 69 73 20 67 72 61 6e | 74 65 64 20 74 6f 20 6d | is gran|ted to m|
|00000300| 61 6b 65 20 61 6e 64 20 | 64 69 73 74 72 69 62 75 |ake and |distribu|
|00000310| 74 65 20 76 65 72 62 61 | 74 69 6d 20 63 6f 70 69 |te verba|tim copi|
|00000320| 65 73 20 6f 66 20 74 68 | 69 73 0a 6d 61 6e 75 61 |es of th|is.manua|
|00000330| 6c 20 70 72 6f 76 69 64 | 65 64 20 74 68 65 20 63 |l provid|ed the c|
|00000340| 6f 70 79 72 69 67 68 74 | 20 6e 6f 74 69 63 65 20 |opyright| notice |
|00000350| 61 6e 64 20 74 68 69 73 | 20 70 65 72 6d 69 73 73 |and this| permiss|
|00000360| 69 6f 6e 20 6e 6f 74 69 | 63 65 20 61 72 65 0a 70 |ion noti|ce are.p|
|00000370| 72 65 73 65 72 76 65 64 | 20 6f 6e 20 61 6c 6c 20 |reserved| on all |
|00000380| 63 6f 70 69 65 73 2e 0a | 0a 40 73 63 7b 54 68 69 |copies..|.@sc{Thi|
|00000390| 73 20 70 75 62 6c 69 63 | 61 74 69 6f 6e 20 69 73 |s public|ation is|
|000003a0| 20 70 72 6f 76 69 64 65 | 64 20 62 79 20 74 68 65 | provide|d by the|
|000003b0| 20 61 75 74 68 6f 72 20 | 60 60 61 73 20 69 73 27 | author |``as is'|
|000003c0| 27 20 61 6e 64 20 61 6e | 79 20 65 78 70 72 65 73 |' and an|y expres|
|000003d0| 73 0a 6f 72 20 69 6d 70 | 6c 69 65 64 20 77 61 72 |s.or imp|lied war|
|000003e0| 72 61 6e 74 69 65 73 2c | 20 69 6e 63 6c 75 64 69 |ranties,| includi|
|000003f0| 6e 67 2c 20 62 75 74 20 | 6e 6f 74 20 6c 69 6d 69 |ng, but |not limi|
|00000400| 74 65 64 20 74 6f 2c 20 | 74 68 65 20 69 6d 70 6c |ted to, |the impl|
|00000410| 69 65 64 0a 77 61 72 72 | 61 6e 74 69 65 73 20 6f |ied.warr|anties o|
|00000420| 66 20 6d 65 72 63 68 61 | 6e 74 61 62 69 6c 69 74 |f mercha|ntabilit|
|00000430| 79 20 61 6e 64 20 66 69 | 74 6e 65 73 73 20 66 6f |y and fi|tness fo|
|00000440| 72 20 61 20 70 61 72 74 | 69 63 75 6c 61 72 20 70 |r a part|icular p|
|00000450| 75 72 70 6f 73 65 20 61 | 72 65 0a 64 69 73 63 6c |urpose a|re.discl|
|00000460| 61 69 6d 65 64 2e 20 20 | 49 6e 20 6e 6f 20 65 76 |aimed.  |In no ev|
|00000470| 65 6e 74 20 73 68 61 6c | 6c 20 74 68 65 20 61 75 |ent shal|l the au|
|00000480| 74 68 6f 72 20 62 65 20 | 6c 69 61 62 6c 65 20 66 |thor be |liable f|
|00000490| 6f 72 20 61 6e 79 20 64 | 69 72 65 63 74 2c 0a 69 |or any d|irect,.i|
|000004a0| 6e 64 69 72 65 63 74 2c | 20 69 6e 63 69 64 65 6e |ndirect,| inciden|
|000004b0| 74 61 6c 2c 20 73 70 65 | 63 69 61 6c 2c 20 65 78 |tal, spe|cial, ex|
|000004c0| 65 6d 70 6c 61 72 79 2c | 20 6f 72 20 63 6f 6e 73 |emplary,| or cons|
|000004d0| 65 71 75 65 6e 74 69 61 | 6c 20 64 61 6d 61 67 65 |equentia|l damage|
|000004e0| 73 0a 28 69 6e 63 6c 75 | 64 69 6e 67 2c 20 62 75 |s.(inclu|ding, bu|
|000004f0| 74 20 6e 6f 74 20 6c 69 | 6d 69 74 65 64 20 74 6f |t not li|mited to|
|00000500| 2c 20 70 72 6f 63 75 72 | 65 6d 65 6e 74 20 6f 66 |, procur|ement of|
|00000510| 20 73 75 62 73 74 69 74 | 75 74 65 20 67 6f 6f 64 | substit|ute good|
|00000520| 73 20 6f 72 0a 73 65 72 | 76 69 63 65 73 3b 20 6c |s or.ser|vices; l|
|00000530| 6f 73 73 20 6f 66 20 75 | 73 65 2c 20 64 61 74 61 |oss of u|se, data|
|00000540| 2c 20 6f 72 20 70 72 6f | 66 69 74 73 3b 20 6f 72 |, or pro|fits; or|
|00000550| 20 62 75 73 69 6e 65 73 | 73 20 69 6e 74 65 72 72 | busines|s interr|
|00000560| 75 70 74 69 6f 6e 29 0a | 68 6f 77 65 76 65 72 20 |uption).|however |
|00000570| 63 61 75 73 65 64 20 61 | 6e 64 20 6f 6e 20 61 6e |caused a|nd on an|
|00000580| 79 20 74 68 65 6f 72 79 | 20 6f 66 20 6c 69 61 62 |y theory| of liab|
|00000590| 69 6c 69 74 79 2c 20 77 | 68 65 74 68 65 72 20 69 |ility, w|hether i|
|000005a0| 6e 20 63 6f 6e 74 72 61 | 63 74 2c 0a 73 74 72 69 |n contra|ct,.stri|
|000005b0| 63 74 20 6c 69 61 62 69 | 6c 69 74 79 2c 20 6f 72 |ct liabi|lity, or|
|000005c0| 20 74 6f 72 74 20 28 69 | 6e 63 6c 75 64 69 6e 67 | tort (i|ncluding|
|000005d0| 20 6e 65 67 6c 69 67 65 | 6e 63 65 20 6f 72 20 6f | neglige|nce or o|
|000005e0| 74 68 65 72 77 69 73 65 | 29 20 61 72 69 73 69 6e |therwise|) arisin|
|000005f0| 67 20 69 6e 0a 61 6e 79 | 20 77 61 79 20 6f 75 74 |g in.any| way out|
|00000600| 20 6f 66 20 74 68 65 20 | 75 73 65 20 6f 66 20 74 | of the |use of t|
|00000610| 68 69 73 20 70 75 62 6c | 69 63 61 74 69 6f 6e 2c |his publ|ication,|
|00000620| 20 65 76 65 6e 20 69 66 | 20 61 64 76 69 73 65 64 | even if| advised|
|00000630| 20 6f 66 20 74 68 65 0a | 70 6f 73 73 69 62 69 6c | of the.|possibil|
|00000640| 69 74 79 20 6f 66 20 73 | 75 63 68 20 64 61 6d 61 |ity of s|uch dama|
|00000650| 67 65 2e 7d 0a 0a 40 65 | 78 61 6d 70 6c 65 0a 0a |ge.}..@e|xample..|
|00000660| 24 49 64 3a 20 61 68 69 | 64 65 76 2e 74 65 78 69 |$Id: ahi|dev.texi|
|00000670| 6e 66 6f 2c 76 20 34 2e | 31 31 20 31 39 39 39 2f |nfo,v 4.|11 1999/|
|00000680| 30 33 2f 32 38 20 32 32 | 3a 33 32 3a 34 36 20 6c |03/28 22|:32:46 l|
|00000690| 63 73 20 45 78 70 20 24 | 0a 24 4c 6f 67 3a 20 61 |cs Exp $|.$Log: a|
|000006a0| 68 69 64 65 76 2e 74 65 | 78 69 6e 66 6f 2c 76 20 |hidev.te|xinfo,v |
|000006b0| 24 0a 52 65 76 69 73 69 | 6f 6e 20 34 2e 31 31 20 |$.Revisi|on 4.11 |
|000006c0| 20 31 39 39 39 2f 30 33 | 2f 32 38 20 32 32 3a 33 | 1999/03|/28 22:3|
|000006d0| 32 3a 34 36 20 20 6c 63 | 73 0a 41 48 49 20 69 73 |2:46  lc|s.AHI is|
|000006e0| 20 6e 6f 77 20 47 50 4c | 2f 4c 47 50 4c 20 73 6f | now GPL|/LGPL so|
|000006f0| 66 74 77 61 72 65 2e 0a | 4d 61 6b 65 20 74 61 72 |ftware..|Make tar|
|00000700| 67 65 74 20 62 69 6e 64 | 69 73 74 20 77 6f 72 6b |get bind|ist work|
|00000710| 20 63 6f 72 72 65 63 74 | 6c 79 20 77 68 65 6e 20 | correct|ly when |
|00000720| 75 73 69 6e 67 20 61 20 | 73 65 70 61 72 61 74 65 |using a |separate|
|00000730| 20 62 75 69 6c 64 20 64 | 69 72 65 63 74 6f 72 79 | build d|irectory|
|00000740| 2e 0a 53 6d 61 6c 6c 20 | 66 69 72 73 74 20 73 74 |..Small |first st|
|00000750| 65 70 73 20 74 6f 77 61 | 72 64 73 20 61 20 57 61 |eps towa|rds a Wa|
|00000760| 72 70 4f 53 20 50 50 43 | 20 76 65 72 73 69 6f 6e |rpOS PPC| version|
|00000770| 2e 0a 0a 52 65 76 69 73 | 69 6f 6e 20 34 2e 31 30 |...Revis|ion 4.10|
|00000780| 20 20 31 39 39 39 2f 30 | 31 2f 31 30 20 31 39 3a |  1999/0|1/10 19:|
|00000790| 32 37 3a 34 36 20 20 6c | 63 73 0a 54 68 65 20 6d |27:46  l|cs.The m|
|000007a0| 6f 76 65 20 74 6f 20 47 | 4e 55 20 6d 61 6b 65 20 |ove to G|NU make |
|000007b0| 69 73 20 64 6f 6e 65 2e | 0a 0a 52 65 76 69 73 69 |is done.|..Revisi|
|000007c0| 6f 6e 20 34 2e 39 20 20 | 31 39 39 39 2f 30 31 2f |on 4.9  |1999/01/|
|000007d0| 31 30 20 31 36 3a 30 37 | 3a 35 36 20 20 6c 63 73 |10 16:07|:56  lcs|
|000007e0| 0a 4d 6f 76 65 64 20 74 | 6f 20 47 4e 55 20 6d 61 |.Moved t|o GNU ma|
|000007f0| 6b 65 20 28 73 74 69 6c | 6c 20 6d 6f 76 69 6e 67 |ke (stil|l moving|
|00000800| 2e 2e 2e 29 0a 0a 52 65 | 76 69 73 69 6f 6e 20 34 |...)..Re|vision 4|
|00000810| 2e 38 20 20 31 39 39 38 | 2f 30 31 2f 31 38 20 31 |.8  1998|/01/18 1|
|00000820| 39 3a 35 30 3a 34 32 20 | 20 6c 63 73 0a 49 20 68 |9:50:42 | lcs.I h|
|00000830| 61 76 65 20 6e 6f 20 69 | 64 65 61 2e 0a 0a 52 65 |ave no i|dea...Re|
|00000840| 76 69 73 69 6f 6e 20 34 | 2e 37 20 20 31 39 39 37 |vision 4|.7  1997|
|00000850| 2f 31 30 2f 32 31 20 30 | 31 3a 33 33 3a 34 30 20 |/10/21 0|1:33:40 |
|00000860| 20 6c 63 73 0a 54 68 65 | 20 76 65 72 73 69 6f 6e | lcs.The| version|
|00000870| 20 6e 75 6d 62 65 72 20 | 69 73 20 6e 6f 77 20 74 | number |is now t|
|00000880| 68 65 20 41 48 49 20 72 | 65 6c 65 61 73 65 20 76 |he AHI r|elease v|
|00000890| 65 72 73 69 6f 6e 2c 20 | 6e 6f 74 20 74 68 65 20 |ersion, |not the |
|000008a0| 64 6f 63 75 6d 65 6e 74 | 73 20 76 65 72 73 69 6f |document|s versio|
|000008b0| 6e 2e 0a 0a 52 65 76 69 | 73 69 6f 6e 20 34 2e 36 |n...Revi|sion 4.6|
|000008c0| 20 20 31 39 39 37 2f 30 | 38 2f 32 31 20 30 31 3a |  1997/0|8/21 01:|
|000008d0| 31 31 3a 33 30 20 20 6c | 63 73 0a 41 64 64 65 64 |11:30  l|cs.Added|
|000008e0| 20 64 65 73 63 72 69 70 | 74 69 6f 6e 20 6f 66 20 | descrip|tion of |
|000008f0| 74 68 65 20 73 61 6d 6c | 65 20 66 6f 72 6d 61 74 |the saml|e format|
|00000900| 73 20 41 48 49 5f 4c 6f | 61 64 53 6f 75 6e 64 28 |s AHI_Lo|adSound(|
|00000910| 29 20 75 6e 64 65 72 73 | 74 61 6e 64 73 0a 0a 52 |) unders|tands..R|
|00000920| 65 76 69 73 69 6f 6e 20 | 34 2e 35 20 20 31 39 39 |evision |4.5  199|
|00000930| 37 2f 30 38 2f 31 30 20 | 31 35 3a 33 38 3a 35 37 |7/08/10 |15:38:57|
|00000940| 20 20 6c 63 73 0a 41 64 | 64 65 64 20 40 40 61 68 |  lcs.Ad|ded @@ah|
|00000950| 69 20 6d 61 63 72 6f 21 | 0a 41 64 64 65 64 20 6e |i macro!|.Added n|
|00000960| 6f 74 65 20 61 62 6f 75 | 74 20 4c 6f 61 64 53 6f |ote abou|t LoadSo|
|00000970| 75 6e 64 3a 69 6e 67 20 | 74 68 65 20 6d 6f 73 74 |und:ing |the most|
|00000980| 20 69 6d 70 6f 72 74 61 | 6e 74 20 73 6f 75 6e 64 | importa|nt sound|
|00000990| 73 20 66 69 72 73 74 0a | 0a 52 65 76 69 73 69 6f |s first.|.Revisio|
|000009a0| 6e 20 34 2e 34 20 20 31 | 39 39 37 2f 30 37 2f 32 |n 4.4  1|997/07/2|
|000009b0| 37 20 30 30 3a 31 33 3a | 33 32 20 20 6c 63 73 0a |7 00:13:|32  lcs.|
|000009c0| 46 69 78 65 64 20 61 20 | 6d 69 73 74 79 70 65 69 |Fixed a |mistypei|
|000009d0| 6e 67 3a 20 77 61 73 20 | 53 65 74 46 72 65 71 28 |ng: was |SetFreq(|
|000009e0| 29 20 69 6e 73 74 65 61 | 64 20 6f 66 20 41 48 49 |) instea|d of AHI|
|000009f0| 5f 53 65 74 46 72 65 71 | 28 29 2e 0a 0a 52 65 76 |_SetFreq|()...Rev|
|00000a00| 69 73 69 6f 6e 20 34 2e | 33 20 20 31 39 39 37 2f |ision 4.|3  1997/|
|00000a10| 30 37 2f 31 35 20 30 30 | 3a 35 30 3a 34 30 20 20 |07/15 00|:50:40  |
|00000a20| 6c 63 73 0a 54 68 69 73 | 20 69 73 20 74 68 65 20 |lcs.This| is the |
|00000a30| 73 65 63 6f 6e 64 20 62 | 75 67 66 69 78 20 72 65 |second b|ugfix re|
|00000a40| 6c 65 61 73 65 20 6f 66 | 20 41 48 49 20 34 2e 0a |lease of| AHI 4..|
|00000a50| 0a 52 65 76 69 73 69 6f | 6e 20 34 2e 32 20 20 31 |.Revisio|n 4.2  1|
|00000a60| 39 39 37 2f 30 35 2f 31 | 31 20 31 32 3a 33 38 3a |997/05/1|1 12:38:|
|00000a70| 33 39 20 20 6c 63 73 0a | 41 64 64 65 64 20 6e 6f |39  lcs.|Added no|
|00000a80| 74 65 20 61 62 6f 75 74 | 20 75 6e 72 6f 6c 6c 69 |te about| unrolli|
|00000a90| 6e 67 20 73 68 6f 72 74 | 20 73 6f 75 6e 64 73 2e |ng short| sounds.|
|00000aa0| 0a 0a 52 65 76 69 73 69 | 6f 6e 20 34 2e 31 20 20 |..Revisi|on 4.1  |
|00000ab0| 31 39 39 37 2f 30 35 2f | 30 34 20 31 35 3a 35 32 |1997/05/|04 15:52|
|00000ac0| 3a 31 35 20 20 6c 63 73 | 0a 49 6e 69 74 69 61 6c |:15  lcs|.Initial|
|00000ad0| 20 72 65 76 69 73 69 6f | 6e 2e 0a 0a 40 65 6e 64 | revisio|n...@end|
|00000ae0| 20 65 78 61 6d 70 6c 65 | 0a 0a 40 65 6e 64 20 69 | example|..@end i|
|00000af0| 66 69 6e 66 6f 0a 0a 40 | 63 20 50 61 72 74 20 33 |finfo..@|c Part 3|
|00000b00| 3a 20 54 69 74 6c 65 70 | 61 67 65 20 61 6e 64 20 |: Titlep|age and |
|00000b10| 43 6f 70 79 72 69 67 68 | 74 0a 40 63 20 af af af |Copyrigh|t.@c ...|
|00000b20| af af af af af af af af | af af af af af af af af |........|........|
|00000b30| af af af af af af af af | af af af af 0a 0a 40 74 |........|......@t|
|00000b40| 69 74 6c 65 70 61 67 65 | 0a 40 74 69 74 6c 65 20 |itlepage|.@title |
|00000b50| 41 48 49 0a 40 73 75 62 | 74 69 74 6c 65 20 48 61 |AHI.@sub|title Ha|
|00000b60| 72 64 77 61 72 65 20 69 | 6e 64 65 70 65 6e 64 65 |rdware i|ndepende|
|00000b70| 6e 74 20 61 75 64 69 6f | 20 66 6f 72 20 41 6d 69 |nt audio| for Ami|
|00000b80| 67 61 0a 40 73 75 62 74 | 69 74 6c 65 20 41 48 49 |ga.@subt|itle AHI|
|00000b90| 20 44 65 76 65 6c 6f 70 | 65 72 27 73 20 47 75 69 | Develop|er's Gui|
|00000ba0| 64 65 20 66 6f 72 20 41 | 48 49 20 76 65 72 73 69 |de for A|HI versi|
|00000bb0| 6f 6e 20 40 76 61 6c 75 | 65 7b 61 68 69 76 65 72 |on @valu|e{ahiver|
|00000bc0| 7d 0a 40 73 75 62 74 69 | 74 6c 65 20 44 6f 63 75 |}.@subti|tle Docu|
|00000bd0| 6d 65 6e 74 20 76 65 72 | 73 69 6f 6e 20 40 76 61 |ment ver|sion @va|
|00000be0| 6c 75 65 7b 64 6f 63 76 | 65 72 7d 0a 40 61 75 74 |lue{docv|er}.@aut|
|00000bf0| 68 6f 72 20 4d 61 72 74 | 69 6e 20 27 4c 65 76 69 |hor Mart|in 'Levi|
|00000c00| 74 69 63 75 73 27 20 42 | 6c 6f 6d 0a 0a 40 70 61 |ticus' B|lom..@pa|
|00000c10| 67 65 0a 0a 40 76 73 6b | 69 70 20 30 70 74 20 70 |ge..@vsk|ip 0pt p|
|00000c20| 6c 75 73 20 31 66 69 6c | 6c 6c 0a 0a 43 6f 70 79 |lus 1fil|ll..Copy|
|00000c30| 72 69 67 68 74 20 40 63 | 6f 70 79 72 69 67 68 74 |right @c|opyright|
|00000c40| 7b 7d 20 31 39 39 34 2d | 31 39 39 39 20 4d 61 72 |{} 1994-|1999 Mar|
|00000c50| 74 69 6e 20 42 6c 6f 6d | 2e 20 54 68 69 73 20 70 |tin Blom|. This p|
|00000c60| 75 62 6c 69 63 61 74 69 | 6f 6e 20 6d 61 79 20 6e |ublicati|on may n|
|00000c70| 6f 74 0a 62 65 20 6d 6f | 64 69 66 69 65 64 20 69 |ot.be mo|dified i|
|00000c80| 6e 20 61 6e 79 20 77 61 | 79 2c 20 69 6e 63 6c 75 |n any wa|y, inclu|
|00000c90| 64 69 6e 67 20 74 72 61 | 6e 73 6c 61 74 69 6f 6e |ding tra|nslation|
|00000ca0| 2c 20 77 69 74 68 6f 75 | 74 20 70 72 69 6f 72 20 |, withou|t prior |
|00000cb0| 63 6f 6e 73 65 6e 74 2c | 20 69 6e 0a 77 72 69 74 |consent,| in.writ|
|00000cc0| 69 6e 67 2c 20 62 79 20 | 74 68 65 20 61 75 74 68 |ing, by |the auth|
|00000cd0| 6f 72 2e 0a 0a 50 65 72 | 6d 69 73 73 69 6f 6e 20 |or...Per|mission |
|00000ce0| 69 73 20 67 72 61 6e 74 | 65 64 20 74 6f 20 6d 61 |is grant|ed to ma|
|00000cf0| 6b 65 20 61 6e 64 20 64 | 69 73 74 72 69 62 75 74 |ke and d|istribut|
|00000d00| 65 20 76 65 72 62 61 74 | 69 6d 20 63 6f 70 69 65 |e verbat|im copie|
|00000d10| 73 20 6f 66 20 74 68 69 | 73 0a 6d 61 6e 75 61 6c |s of thi|s.manual|
|00000d20| 20 70 72 6f 76 69 64 65 | 64 20 74 68 65 20 63 6f | provide|d the co|
|00000d30| 70 79 72 69 67 68 74 20 | 6e 6f 74 69 63 65 20 61 |pyright |notice a|
|00000d40| 6e 64 20 74 68 69 73 20 | 70 65 72 6d 69 73 73 69 |nd this |permissi|
|00000d50| 6f 6e 20 6e 6f 74 69 63 | 65 20 61 72 65 0a 70 72 |on notic|e are.pr|
|00000d60| 65 73 65 72 76 65 64 20 | 6f 6e 20 61 6c 6c 20 63 |eserved |on all c|
|00000d70| 6f 70 69 65 73 2e 0a 0a | 40 73 63 7b 54 68 69 73 |opies...|@sc{This|
|00000d80| 20 70 75 62 6c 69 63 61 | 74 69 6f 6e 20 69 73 20 | publica|tion is |
|00000d90| 70 72 6f 76 69 64 65 64 | 20 62 79 20 74 68 65 20 |provided| by the |
|00000da0| 61 75 74 68 6f 72 20 60 | 60 61 73 20 69 73 27 27 |author `|`as is''|
|00000db0| 20 61 6e 64 20 61 6e 79 | 20 65 78 70 72 65 73 73 | and any| express|
|00000dc0| 0a 6f 72 20 69 6d 70 6c | 69 65 64 20 77 61 72 72 |.or impl|ied warr|
|00000dd0| 61 6e 74 69 65 73 2c 20 | 69 6e 63 6c 75 64 69 6e |anties, |includin|
|00000de0| 67 2c 20 62 75 74 20 6e | 6f 74 20 6c 69 6d 69 74 |g, but n|ot limit|
|00000df0| 65 64 20 74 6f 2c 20 74 | 68 65 20 69 6d 70 6c 69 |ed to, t|he impli|
|00000e00| 65 64 0a 77 61 72 72 61 | 6e 74 69 65 73 20 6f 66 |ed.warra|nties of|
|00000e10| 20 6d 65 72 63 68 61 6e | 74 61 62 69 6c 69 74 79 | merchan|tability|
|00000e20| 20 61 6e 64 20 66 69 74 | 6e 65 73 73 20 66 6f 72 | and fit|ness for|
|00000e30| 20 61 20 70 61 72 74 69 | 63 75 6c 61 72 20 70 75 | a parti|cular pu|
|00000e40| 72 70 6f 73 65 20 61 72 | 65 0a 64 69 73 63 6c 61 |rpose ar|e.discla|
|00000e50| 69 6d 65 64 2e 20 20 49 | 6e 20 6e 6f 20 65 76 65 |imed.  I|n no eve|
|00000e60| 6e 74 20 73 68 61 6c 6c | 20 74 68 65 20 61 75 74 |nt shall| the aut|
|00000e70| 68 6f 72 20 62 65 20 6c | 69 61 62 6c 65 20 66 6f |hor be l|iable fo|
|00000e80| 72 20 61 6e 79 20 64 69 | 72 65 63 74 2c 0a 69 6e |r any di|rect,.in|
|00000e90| 64 69 72 65 63 74 2c 20 | 69 6e 63 69 64 65 6e 74 |direct, |incident|
|00000ea0| 61 6c 2c 20 73 70 65 63 | 69 61 6c 2c 20 65 78 65 |al, spec|ial, exe|
|00000eb0| 6d 70 6c 61 72 79 2c 20 | 6f 72 20 63 6f 6e 73 65 |mplary, |or conse|
|00000ec0| 71 75 65 6e 74 69 61 6c | 20 64 61 6d 61 67 65 73 |quential| damages|
|00000ed0| 0a 28 69 6e 63 6c 75 64 | 69 6e 67 2c 20 62 75 74 |.(includ|ing, but|
|00000ee0| 20 6e 6f 74 20 6c 69 6d | 69 74 65 64 20 74 6f 2c | not lim|ited to,|
|00000ef0| 20 70 72 6f 63 75 72 65 | 6d 65 6e 74 20 6f 66 20 | procure|ment of |
|00000f00| 73 75 62 73 74 69 74 75 | 74 65 20 67 6f 6f 64 73 |substitu|te goods|
|00000f10| 20 6f 72 0a 73 65 72 76 | 69 63 65 73 3b 20 6c 6f | or.serv|ices; lo|
|00000f20| 73 73 20 6f 66 20 75 73 | 65 2c 20 64 61 74 61 2c |ss of us|e, data,|
|00000f30| 20 6f 72 20 70 72 6f 66 | 69 74 73 3b 20 6f 72 20 | or prof|its; or |
|00000f40| 62 75 73 69 6e 65 73 73 | 20 69 6e 74 65 72 72 75 |business| interru|
|00000f50| 70 74 69 6f 6e 29 0a 68 | 6f 77 65 76 65 72 20 63 |ption).h|owever c|
|00000f60| 61 75 73 65 64 20 61 6e | 64 20 6f 6e 20 61 6e 79 |aused an|d on any|
|00000f70| 20 74 68 65 6f 72 79 20 | 6f 66 20 6c 69 61 62 69 | theory |of liabi|
|00000f80| 6c 69 74 79 2c 20 77 68 | 65 74 68 65 72 20 69 6e |lity, wh|ether in|
|00000f90| 20 63 6f 6e 74 72 61 63 | 74 2c 0a 73 74 72 69 63 | contrac|t,.stric|
|00000fa0| 74 20 6c 69 61 62 69 6c | 69 74 79 2c 20 6f 72 20 |t liabil|ity, or |
|00000fb0| 74 6f 72 74 20 28 69 6e | 63 6c 75 64 69 6e 67 20 |tort (in|cluding |
|00000fc0| 6e 65 67 6c 69 67 65 6e | 63 65 20 6f 72 20 6f 74 |negligen|ce or ot|
|00000fd0| 68 65 72 77 69 73 65 29 | 20 61 72 69 73 69 6e 67 |herwise)| arising|
|00000fe0| 20 69 6e 0a 61 6e 79 20 | 77 61 79 20 6f 75 74 20 | in.any |way out |
|00000ff0| 6f 66 20 74 68 65 20 75 | 73 65 20 6f 66 20 74 68 |of the u|se of th|
|00001000| 69 73 20 70 75 62 6c 69 | 63 61 74 69 6f 6e 2c 20 |is publi|cation, |
|00001010| 65 76 65 6e 20 69 66 20 | 61 64 76 69 73 65 64 20 |even if |advised |
|00001020| 6f 66 20 74 68 65 0a 70 | 6f 73 73 69 62 69 6c 69 |of the.p|ossibili|
|00001030| 74 79 20 6f 66 20 73 75 | 63 68 20 64 61 6d 61 67 |ty of su|ch damag|
|00001040| 65 2e 7d 0a 0a 40 65 6e | 64 20 74 69 74 6c 65 70 |e.}..@en|d titlep|
|00001050| 61 67 65 0a 0a 0a 40 63 | 20 50 61 72 74 20 34 3a |age...@c| Part 4:|
|00001060| 20 60 54 6f 70 27 20 4e | 6f 64 65 20 61 6e 64 20 | `Top' N|ode and |
|00001070| 4d 61 73 74 65 72 20 4d | 65 6e 75 0a 40 63 20 af |Master M|enu.@c .|
|00001080| af af af af af af af af | af af af af af af af af |........|........|
|00001090| af af af af af af af af | af af af af af af af af |........|........|
|000010a0| af 0a 0a 40 6e 6f 64 65 | 20 20 20 20 54 6f 70 2c |...@node|    Top,|
|000010b0| 20 4f 76 65 72 76 69 65 | 77 2c 20 28 64 69 72 29 | Overvie|w, (dir)|
|000010c0| 2c 20 28 64 69 72 29 0a | 0a 40 69 66 69 6e 66 6f |, (dir).|.@ifinfo|
|000010d0| 0a 0a 40 6d 61 6a 6f 72 | 68 65 61 64 69 6e 67 20 |..@major|heading |
|000010e0| 40 73 63 7b 41 68 69 7d | 20 44 65 76 65 6c 6f 70 |@sc{Ahi}| Develop|
|000010f0| 65 72 27 73 20 47 75 69 | 64 65 0a 0a 46 6f 72 20 |er's Gui|de..For |
|00001100| 40 73 63 7b 41 68 69 7d | 20 76 65 72 73 69 6f 6e |@sc{Ahi}| version|
|00001110| 20 40 76 61 6c 75 65 7b | 61 68 69 76 65 72 7d 2e | @value{|ahiver}.|
|00001120| 20 44 6f 63 75 6d 65 6e | 74 20 76 65 72 73 69 6f | Documen|t versio|
|00001130| 6e 20 40 76 61 6c 75 65 | 7b 64 6f 63 76 65 72 7d |n @value|{docver}|
|00001140| 2e 0a 0a 43 6f 70 79 72 | 69 67 68 74 20 40 63 6f |...Copyr|ight @co|
|00001150| 70 79 72 69 67 68 74 7b | 7d 20 31 39 39 34 2d 31 |pyright{|} 1994-1|
|00001160| 39 39 39 20 4d 61 72 74 | 69 6e 20 42 6c 6f 6d 0a |999 Mart|in Blom.|
|00001170| 0a 54 68 65 20 6c 61 74 | 65 73 74 20 72 65 6c 65 |.The lat|est rele|
|00001180| 61 73 65 20 6f 66 20 40 | 73 63 7b 41 68 69 7d 20 |ase of @|sc{Ahi} |
|00001190| 63 61 6e 20 61 6c 77 61 | 79 73 20 62 65 20 66 6f |can alwa|ys be fo|
|000011a0| 75 6e 64 20 61 74 0a 40 | 75 72 6c 7b 68 74 74 70 |und at.@|url{http|
|000011b0| 3a 2f 2f 77 77 77 2e 6c | 79 73 61 74 6f 72 2e 6c |://www.l|ysator.l|
|000011c0| 69 75 2e 73 65 2f 7e 6c | 63 73 2f 61 68 69 2e 68 |iu.se/~l|cs/ahi.h|
|000011d0| 74 6d 6c 7d 2e 20 0a 0a | 40 6d 65 6e 75 0a 2a 20 |tml}. ..|@menu.* |
|000011e0| 4f 76 65 72 76 69 65 77 | 3a 3a 20 20 20 20 20 20 |Overview|::      |
|000011f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 42 72 |        |      Br|
|00001200| 69 65 66 20 69 6e 74 72 | 6f 64 75 63 74 69 6f 6e |ief intr|oduction|
|00001210| 0a 2a 20 44 69 73 74 72 | 69 62 75 74 69 6f 6e 3a |.* Distr|ibution:|
|00001220| 3a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |:       |        |
|00001230| 20 57 68 61 74 20 79 6f | 75 20 61 72 65 20 61 6c | What yo|u are al|
|00001240| 6c 6f 77 65 64 20 74 6f | 20 64 6f 20 61 6e 64 20 |lowed to| do and |
|00001250| 6e 6f 74 0a 2a 20 54 68 | 65 20 41 75 74 68 6f 72 |not.* Th|e Author|
|00001260| 3a 3a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |::      |        |
|00001270| 20 20 20 20 57 68 6f 20 | 64 65 73 69 67 6e 65 64 |    Who |designed|
|00001280| 20 69 74 3f 0a 0a 2a 20 | 44 65 66 69 6e 69 74 69 | it?..* |Definiti|
|00001290| 6f 6e 73 3a 3a 20 20 20 | 20 20 20 20 20 20 20 20 |ons::   |        |
|000012a0| 20 20 20 20 20 20 54 65 | 72 6d 73 20 75 73 65 64 |      Te|rms used|
|000012b0| 20 69 6e 20 74 68 69 73 | 20 64 6f 63 75 6d 65 6e | in this| documen|
|000012c0| 74 0a 2a 20 46 75 6e 63 | 74 69 6f 6e 20 49 6e 74 |t.* Func|tion Int|
|000012d0| 65 72 66 61 63 65 3a 3a | 20 20 20 20 20 20 20 20 |erface::|        |
|000012e0| 20 20 54 68 65 20 6c 6f | 77 2d 6c 65 76 65 6c 20 |  The lo|w-level |
|000012f0| 41 50 49 0a 2a 20 44 65 | 76 69 63 65 20 49 6e 74 |API.* De|vice Int|
|00001300| 65 72 66 61 63 65 3a 3a | 20 20 20 20 20 20 20 20 |erface::|        |
|00001310| 20 20 20 20 54 68 65 20 | 68 69 67 68 2d 6c 65 76 |    The |high-lev|
|00001320| 65 6c 20 41 50 49 0a 2a | 20 44 61 74 61 20 54 79 |el API.*| Data Ty|
|00001330| 70 65 73 20 41 6e 64 20 | 53 74 72 75 63 74 75 72 |pes And |Structur|
|00001340| 65 73 3a 3a 20 20 20 54 | 68 65 20 73 74 72 75 63 |es::   T|he struc|
|00001350| 74 75 72 65 73 20 65 78 | 70 6c 61 69 6e 65 64 0a |tures ex|plained.|
|00001360| 0a 2a 20 43 6f 6e 63 65 | 70 74 20 49 6e 64 65 78 |.* Conce|pt Index|
|00001370| 3a 3a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |::      |        |
|00001380| 20 43 6f 6e 63 65 70 74 | 20 49 6e 64 65 78 0a 2a | Concept| Index.*|
|00001390| 20 44 61 74 61 20 54 79 | 70 65 20 49 6e 64 65 78 | Data Ty|pe Index|
|000013a0| 3a 3a 20 20 20 20 20 20 | 20 20 20 20 20 20 20 44 |::      |       D|
|000013b0| 61 74 61 20 54 79 70 65 | 20 49 6e 64 65 78 0a 2a |ata Type| Index.*|
|000013c0| 20 46 75 6e 63 74 69 6f | 6e 20 49 6e 64 65 78 3a | Functio|n Index:|
|000013d0| 3a 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 46 |:       |       F|
|000013e0| 75 6e 63 74 69 6f 6e 20 | 49 6e 64 65 78 0a 2a 20 |unction |Index.* |
|000013f0| 56 61 72 69 61 62 6c 65 | 20 49 6e 64 65 78 3a 3a |Variable| Index::|
|00001400| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 56 61 |        |      Va|
|00001410| 72 69 61 62 6c 65 20 49 | 6e 64 65 78 0a 0a 20 2d |riable I|ndex.. -|
|00001420| 2d 2d 20 54 68 65 20 44 | 65 74 61 69 6c 65 64 20 |-- The D|etailed |
|00001430| 4e 6f 64 65 20 4c 69 73 | 74 69 6e 67 20 2d 2d 2d |Node Lis|ting ---|
|00001440| 0a 0a 46 75 6e 63 74 69 | 6f 6e 20 49 6e 74 65 72 |..Functi|on Inter|
|00001450| 66 61 63 65 0a 0a 2a 20 | 47 75 69 64 65 6c 69 6e |face..* |Guidelin|
|00001460| 65 73 3a 3a 20 20 20 20 | 20 20 20 20 20 20 20 20 |es::    |        |
|00001470| 20 20 20 20 20 20 0a 2a | 20 4f 70 65 6e 69 6e 67 |      .*| Opening|
|00001480| 20 41 6e 64 20 43 6c 6f | 73 69 6e 67 20 61 68 69 | And Clo|sing ahi|
|00001490| 2e 64 65 76 69 63 65 20 | 46 6f 72 20 4c 6f 77 2d |.device |For Low-|
|000014a0| 6c 65 76 65 6c 20 41 63 | 63 65 73 73 3a 3a 20 20 |level Ac|cess::  |
|000014b0| 0a 2a 20 4f 62 74 61 69 | 6e 69 6e 67 20 54 68 65 |.* Obtai|ning The|
|000014c0| 20 48 61 72 64 77 61 72 | 65 3a 3a 20 20 20 20 20 | Hardwar|e::     |
|000014d0| 20 0a 2a 20 44 65 63 6c | 61 72 69 6e 67 20 53 6f | .* Decl|aring So|
|000014e0| 75 6e 64 73 3a 3a 20 20 | 20 20 20 20 20 20 20 20 |unds::  |        |
|000014f0| 20 20 0a 2a 20 4d 61 6b | 69 6e 67 20 4e 6f 69 73 |  .* Mak|ing Nois|
|00001500| 65 3a 3a 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |e::     |        |
|00001510| 20 20 20 0a 0a 44 65 76 | 69 63 65 20 49 6e 74 65 |   ..Dev|ice Inte|
|00001520| 72 66 61 63 65 0a 0a 2a | 20 4f 70 65 6e 69 6e 67 |rface..*| Opening|
|00001530| 20 41 6e 64 20 43 6c 6f | 73 69 6e 67 20 61 68 69 | And Clo|sing ahi|
|00001540| 2e 64 65 76 69 63 65 20 | 46 6f 72 20 48 69 67 68 |.device |For High|
|00001550| 2d 6c 65 76 65 6c 20 41 | 63 63 65 73 73 3a 3a 20 |-level A|ccess:: |
|00001560| 20 0a 2a 20 52 65 61 64 | 69 6e 67 20 46 72 6f 6d | .* Read|ing From|
|00001570| 20 54 68 65 20 44 65 76 | 69 63 65 3a 3a 20 20 20 | The Dev|ice::   |
|00001580| 20 20 0a 2a 20 57 72 69 | 74 69 6e 67 20 54 6f 20 |  .* Wri|ting To |
|00001590| 54 68 65 20 44 65 76 69 | 63 65 3a 3a 20 20 20 20 |The Devi|ce::    |
|000015a0| 20 20 20 0a 0a 44 61 74 | 61 20 54 79 70 65 73 20 |   ..Dat|a Types |
|000015b0| 41 6e 64 20 53 74 72 75 | 63 74 75 72 65 73 0a 0a |And Stru|ctures..|
|000015c0| 2a 20 44 61 74 61 20 54 | 79 70 65 73 3a 3a 20 20 |* Data T|ypes::  |
|000015d0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|000015e0| 0a 2a 20 53 74 72 75 63 | 74 75 72 65 73 3a 3a 20 |.* Struc|tures:: |
|000015f0| 20 20 20 20 20 20 20 20 | 20 20 20 20 20 20 20 20 |        |        |
|00001600| 20 0a 40 65 6e 64 20 6d | 65 6e 75 0a 0a 40 65 6e | .@end m|enu..@en|
|00001610| 64 20 69 66 69 6e 66 6f | 0a 0a 0a 40 63 20 50 61 |d ifinfo|...@c Pa|
|00001620| 72 74 20 35 3a 20 20 54 | 68 65 20 42 6f 64 79 20 |rt 5:  T|he Body |
|00001630| 6f 66 20 74 68 65 20 44 | 6f 63 75 6d 65 6e 74 0a |of the D|ocument.|
|00001640| 40 63 20 af af af af af | af af af af af af af af |@c .....|........|
|00001650| af af af af af af af af | af af af af af af af af |........|........|
|00001660| af af af af 0a 0a 0a 40 | 63 20 2a 2a 2a 2a 2a 2a |.......@|c ******|
|00001670| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001680| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001690| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000016a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000016b0| 2a 0a 40 63 20 2a 2a 2a | 2a 20 4f 76 65 72 76 69 |*.@c ***|* Overvi|
|000016c0| 65 77 20 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |ew *****|********|
|000016d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000016e0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000016f0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 0a 40 63 20 |********|****.@c |
|00001700| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001710| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001720| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001730| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001740| 2a 2a 2a 2a 2a 2a 2a 0a | 0a 40 6e 6f 64 65 20 4f |*******.|.@node O|
|00001750| 76 65 72 76 69 65 77 2c | 20 44 69 73 74 72 69 62 |verview,| Distrib|
|00001760| 75 74 69 6f 6e 2c 20 54 | 6f 70 2c 20 54 6f 70 0a |ution, T|op, Top.|
|00001770| 40 63 6f 6d 6d 65 6e 74 | 20 20 6e 6f 64 65 2d 6e |@comment|  node-n|
|00001780| 61 6d 65 2c 20 20 6e 65 | 78 74 2c 20 20 70 72 65 |ame,  ne|xt,  pre|
|00001790| 76 69 6f 75 73 2c 20 20 | 75 70 0a 40 63 68 61 70 |vious,  |up.@chap|
|000017a0| 74 65 72 20 4f 76 65 72 | 76 69 65 77 0a 0a 40 63 |ter Over|view..@c|
|000017b0| 69 6e 64 65 78 20 4f 76 | 65 72 76 69 65 77 0a 0a |index Ov|erview..|
|000017c0| 54 68 69 73 20 64 6f 63 | 75 6d 65 6e 74 20 77 61 |This doc|ument wa|
|000017d0| 73 20 77 72 69 74 74 65 | 6e 20 69 6e 20 6f 72 64 |s writte|n in ord|
|000017e0| 65 72 20 74 6f 20 6d 61 | 6b 65 20 69 74 20 65 61 |er to ma|ke it ea|
|000017f0| 73 69 65 72 20 66 6f 72 | 20 64 65 76 65 6c 6f 70 |sier for| develop|
|00001800| 65 72 73 20 74 6f 0a 75 | 6e 64 65 72 73 74 61 6e |ers to.u|nderstan|
|00001810| 64 20 61 6e 64 20 75 73 | 65 20 40 73 63 7b 41 68 |d and us|e @sc{Ah|
|00001820| 69 7d 20 69 6e 20 74 68 | 65 69 72 20 6f 77 6e 20 |i} in th|eir own |
|00001830| 70 72 6f 64 75 63 74 69 | 6f 6e 73 2c 20 61 6e 64 |producti|ons, and|
|00001840| 20 77 72 69 74 65 20 53 | 6f 66 74 77 61 72 65 0a | write S|oftware.|
|00001850| 54 68 61 74 20 57 6f 72 | 6b 73 28 54 4d 29 2e 0a |That Wor|ks(TM)..|
|00001860| 0a 40 63 6f 64 65 7b 61 | 68 69 2e 64 65 76 69 63 |.@code{a|hi.devic|
|00001870| 65 7d 20 68 61 73 20 74 | 77 6f 20 64 69 66 66 65 |e} has t|wo diffe|
|00001880| 72 65 6e 74 20 41 50 49 | 27 73 3b 20 6f 6e 65 20 |rent API|'s; one |
|00001890| 6c 69 62 72 61 72 79 2d | 6c 69 6b 65 20 66 75 6e |library-|like fun|
|000018a0| 63 74 69 6f 6e 0a 69 6e | 74 65 72 66 61 63 65 20 |ction.in|terface |
|000018b0| 28 6c 6f 77 2d 6c 65 76 | 65 6c 29 2c 20 61 6e 64 |(low-lev|el), and|
|000018c0| 20 6f 6e 65 20 60 60 6e | 6f 72 6d 61 6c 27 27 20 | one ``n|ormal'' |
|000018d0| 64 65 76 69 63 65 20 69 | 6e 74 65 72 66 61 63 65 |device i|nterface|
|000018e0| 20 28 68 69 67 68 2d 6c | 65 76 65 6c 29 2e 0a 45 | (high-l|evel)..E|
|000018f0| 61 63 68 20 6f 66 20 74 | 68 65 6d 20 73 65 72 76 |ach of t|hem serv|
|00001900| 65 73 20 64 69 66 66 65 | 72 65 6e 74 20 70 75 72 |es diffe|rent pur|
|00001910| 70 6f 73 65 73 2e 20 20 | 54 68 65 20 6c 6f 77 2d |poses.  |The low-|
|00001920| 6c 65 76 65 6c 20 69 6e | 74 65 72 66 61 63 65 20 |level in|terface |
|00001930| 69 73 0a 74 61 72 67 65 | 74 69 6e 67 20 6d 75 73 |is.targe|ting mus|
|00001940| 69 63 20 70 6c 61 79 65 | 72 73 2c 20 67 61 6d 65 |ic playe|rs, game|
|00001950| 73 20 61 6e 64 20 72 65 | 61 6c 2d 74 69 6d 65 20 |s and re|al-time |
|00001960| 61 70 70 6c 69 63 61 74 | 69 6f 6e 73 2e 20 54 68 |applicat|ions. Th|
|00001970| 65 20 68 69 67 68 2d 6c | 65 76 65 6c 0a 69 6e 74 |e high-l|evel.int|
|00001980| 65 72 66 61 63 65 20 69 | 73 20 74 61 72 67 65 74 |erface i|s target|
|00001990| 69 6e 67 20 61 70 70 6c | 69 63 61 74 69 6f 6e 73 |ing appl|ications|
|000019a0| 20 74 68 61 74 20 6a 75 | 73 74 20 77 61 6e 74 20 | that ju|st want |
|000019b0| 74 6f 20 68 61 76 65 20 | 61 20 73 61 6d 70 6c 65 |to have |a sample|
|000019c0| 20 70 6c 61 79 65 64 2c | 0a 70 6c 61 79 20 61 75 | played,|.play au|
|000019d0| 64 69 6f 20 73 74 72 65 | 61 6d 73 20 6f 72 20 72 |dio stre|ams or r|
|000019e0| 65 63 6f 72 64 20 73 61 | 6d 70 6c 65 73 20 61 73 |ecord sa|mples as|
|000019f0| 20 65 61 73 69 6c 79 20 | 61 73 20 70 6f 73 73 69 | easily |as possi|
|00001a00| 62 6c 65 2e 0a 0a 41 73 | 20 77 69 74 68 20 65 76 |ble...As| with ev|
|00001a10| 65 72 79 74 68 69 6e 67 | 20 65 6c 73 65 2c 20 69 |erything| else, i|
|00001a20| 74 20 69 73 20 69 6d 70 | 6f 72 74 61 6e 74 20 74 |t is imp|ortant t|
|00001a30| 68 61 74 20 79 6f 75 20 | 63 68 6f 73 65 20 74 68 |hat you |chose th|
|00001a40| 65 20 72 69 67 68 74 20 | 74 6f 6f 6c 20 66 6f 72 |e right |tool for|
|00001a50| 0a 74 68 65 20 6a 6f 62 | 2d 2d 2d 79 6f 75 27 6c |.the job|---you'l|
|00001a60| 6c 20 6f 6e 6c 79 20 67 | 65 74 20 66 72 75 73 74 |l only g|et frust|
|00001a70| 72 61 74 65 64 20 6f 74 | 68 65 72 77 69 73 65 2e |rated ot|herwise.|
|00001a80| 0a 0a 4e 6f 74 20 65 76 | 65 72 79 74 68 69 6e 67 |..Not ev|erything|
|00001a90| 20 61 62 6f 75 74 20 40 | 73 63 7b 41 68 69 7d 20 | about @|sc{Ahi} |
|00001aa0| 69 73 20 64 6f 63 75 6d | 65 6e 74 65 64 20 68 65 |is docum|ented he|
|00001ab0| 72 65 3b 20 66 6f 72 20 | 6d 6f 72 65 20 69 6e 66 |re; for |more inf|
|00001ac0| 6f 72 6d 61 74 69 6f 6e | 2c 20 73 65 65 0a 40 63 |ormation|, see.@c|
|00001ad0| 69 74 65 7b 40 73 63 7b | 41 68 69 7d 20 55 73 65 |ite{@sc{|Ahi} Use|
|00001ae0| 72 27 73 20 47 75 69 64 | 65 7d 20 61 6e 64 20 74 |r's Guid|e} and t|
|00001af0| 68 65 20 61 75 74 6f 64 | 6f 63 73 2e 0a 0a 0a 40 |he autod|ocs....@|
|00001b00| 63 20 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |c ******|********|
|00001b10| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b20| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b30| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b40| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 40 63 20 2a 2a 2a |********|*.@c ***|
|00001b50| 2a 20 44 69 73 74 72 69 | 62 75 74 69 6f 6e 20 2a |* Distri|bution *|
|00001b60| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b70| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b80| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001b90| 2a 2a 2a 2a 0a 40 63 20 | 2a 2a 2a 2a 2a 2a 2a 2a |****.@c |********|
|00001ba0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001bb0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001bc0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00001bd0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 0a |********|*******.|
|00001be0| 0a 40 6e 6f 64 65 20 20 | 44 69 73 74 72 69 62 75 |.@node  |Distribu|
|00001bf0| 74 69 6f 6e 2c 20 54 68 | 65 20 41 75 74 68 6f 72 |tion, Th|e Author|
|00001c00| 2c 20 4f 76 65 72 76 69 | 65 77 2c 20 54 6f 70 0a |, Overvi|ew, Top.|
|00001c10| 40 63 6f 6d 6d 65 6e 74 | 20 20 6e 6f 64 65 2d 6e |@comment|  node-n|
|00001c20| 61 6d 65 2c 20 20 6e 65 | 78 74 2c 20 20 70 72 65 |ame,  ne|xt,  pre|
|00001c30| 76 69 6f 75 73 2c 20 20 | 75 70 0a 40 63 68 61 70 |vious,  |up.@chap|
|00001c40| 74 65 72 20 44 69 73 74 | 72 69 62 75 74 69 6f 6e |ter Dist|ribution|
|00001c50| 0a 0a 40 63 69 6e 64 65 | 78 20 44 69 73 74 72 69 |..@cinde|x Distri|
|00001c60| 62 75 74 69 6f 6e 0a 40 | 63 69 6e 64 65 78 20 44 |bution.@|cindex D|
|00001c70| 69 73 63 6c 61 69 6d 65 | 72 0a 40 63 69 6e 64 65 |isclaime|r.@cinde|
|00001c80| 78 20 4c 69 63 65 6e 73 | 65 0a 40 63 69 6e 64 65 |x Licens|e.@cinde|
|00001c90| 78 20 4c 65 67 61 6c 20 | 6e 6f 6e 73 65 6e 73 65 |x Legal |nonsense|
|00001ca0| 0a 40 63 69 6e 64 65 78 | 20 53 6f 66 74 77 61 72 |.@cindex| Softwar|
|00001cb0| 65 20 6c 69 63 65 6e 73 | 65 0a 40 63 69 6e 64 65 |e licens|e.@cinde|
|00001cc0| 78 20 43 6f 70 79 72 69 | 67 68 74 0a 0a 43 6f 70 |x Copyri|ght..Cop|
|00001cd0| 79 72 69 67 68 74 20 40 | 63 6f 70 79 72 69 67 68 |yright @|copyrigh|
|00001ce0| 74 7b 7d 20 31 39 39 34 | 2d 31 39 39 39 20 4d 61 |t{} 1994|-1999 Ma|
|00001cf0| 72 74 69 6e 20 42 6c 6f | 6d 0a 0a 40 73 63 7b 41 |rtin Blo|m..@sc{A|
|00001d00| 68 69 7d 20 69 73 20 61 | 76 61 69 6c 61 62 6c 65 |hi} is a|vailable|
|00001d10| 20 61 73 20 40 64 66 6e | 7b 66 72 65 65 77 61 72 | as @dfn|{freewar|
|00001d20| 65 7d 2e 20 20 54 68 61 | 74 20 69 73 2c 20 69 74 |e}.  Tha|t is, it|
|00001d30| 20 6d 61 79 20 62 65 20 | 66 72 65 65 6c 79 0a 64 | may be |freely.d|
|00001d40| 69 73 74 72 69 62 75 74 | 65 64 20 69 6e 20 75 6e |istribut|ed in un|
|00001d50| 6d 6f 64 69 66 69 65 64 | 20 66 6f 72 6d 20 77 69 |modified| form wi|
|00001d60| 74 68 20 6e 6f 20 63 68 | 61 6e 67 65 73 20 77 68 |th no ch|anges wh|
|00001d70| 61 74 20 73 6f 20 65 76 | 65 72 2c 20 62 75 74 20 |at so ev|er, but |
|00001d80| 79 6f 75 20 6d 61 79 0a | 6e 6f 74 20 63 68 61 72 |you may.|not char|
|00001d90| 67 65 20 6d 6f 72 65 20 | 74 68 61 6e 20 61 20 6e |ge more |than a n|
|00001da0| 6f 6d 69 6e 61 6c 20 66 | 65 65 20 63 6f 76 65 72 |ominal f|ee cover|
|00001db0| 69 6e 67 20 64 69 73 74 | 72 69 62 75 74 69 6f 6e |ing dist|ribution|
|00001dc0| 20 63 6f 73 74 73 2e 20 | 48 6f 77 65 76 65 72 2c | costs. |However,|
|00001dd0| 0a 64 6f 6e 61 74 69 6f | 6e 73 20 61 72 65 20 77 |.donatio|ns are w|
|00001de0| 65 6c 63 6f 6d 65 20 28 | 73 65 65 20 40 63 69 74 |elcome (|see @cit|
|00001df0| 65 7b 40 73 63 7b 41 68 | 69 7d 20 55 73 65 72 27 |e{@sc{Ah|i} User'|
|00001e00| 73 20 47 75 69 64 65 7d | 29 2e 0a 0a 49 66 20 79 |s Guide}|)...If y|
|00001e10| 6f 75 20 75 73 65 20 74 | 68 69 73 20 73 6f 66 74 |ou use t|his soft|
|00001e20| 77 61 72 65 20 69 6e 20 | 61 20 63 6f 6d 6d 65 72 |ware in |a commer|
|00001e30| 63 69 61 6c 20 6f 72 20 | 73 68 61 72 65 77 61 72 |cial or |sharewar|
|00001e40| 65 20 70 72 6f 64 75 63 | 74 2c 20 70 6c 65 61 73 |e produc|t, pleas|
|00001e50| 65 0a 63 6f 6e 73 69 64 | 65 72 20 67 69 76 69 6e |e.consid|er givin|
|00001e60| 67 20 74 68 65 20 61 75 | 74 68 6f 72 20 28 40 70 |g the au|thor (@p|
|00001e70| 78 72 65 66 7b 54 68 65 | 20 41 75 74 68 6f 72 7d |xref{The| Author}|
|00001e80| 29 2d 2d 2d 61 6e 64 20 | 70 72 65 66 65 72 61 62 |)---and |preferab|
|00001e90| 6c 79 20 65 61 63 68 20 | 6f 6e 65 0a 6f 66 20 74 |ly each |one.of t|
|00001ea0| 68 65 20 63 6f 6e 74 72 | 69 62 75 74 6f 72 73 20 |he contr|ibutors |
|00001eb0| 74 6f 6f 20 28 73 65 65 | 20 40 63 69 74 65 7b 40 |too (see| @cite{@|
|00001ec0| 73 63 7b 41 68 69 7d 20 | 55 73 65 72 27 73 20 47 |sc{Ahi} |User's G|
|00001ed0| 75 69 64 65 7d 29 2d 2d | 2d 61 6e 20 6f 72 69 67 |uide})--|-an orig|
|00001ee0| 69 6e 61 6c 20 6f 72 0a | 72 65 67 69 73 74 65 72 |inal or.|register|
|00001ef0| 65 64 20 76 65 72 73 69 | 6f 6e 20 6f 66 20 79 6f |ed versi|on of yo|
|00001f00| 75 72 20 77 6f 72 6b 2e | 20 20 53 68 6f 75 6c 64 |ur work.|  Should|
|00001f10| 20 79 6f 75 20 77 61 6e | 74 20 74 6f 20 64 69 73 | you wan|t to dis|
|00001f20| 74 72 69 62 75 74 65 20 | 74 68 65 20 40 73 63 7b |tribute |the @sc{|
|00001f30| 41 68 69 7d 0a 73 6f 66 | 74 77 61 72 65 20 77 69 |Ahi}.sof|tware wi|
|00001f40| 74 68 20 79 6f 75 72 20 | 6f 77 6e 20 70 72 6f 64 |th your |own prod|
|00001f50| 75 63 74 2c 20 74 68 65 | 72 65 20 69 73 20 72 65 |uct, the|re is re|
|00001f60| 61 6c 6c 79 20 6e 6f 74 | 68 69 6e 67 20 74 6f 20 |ally not|hing to |
|00001f70| 63 6f 6e 73 69 64 65 72 | 2c 20 69 73 20 69 74 3f |consider|, is it?|
|00001f80| 0a 0a 49 66 20 79 6f 75 | 20 77 69 73 68 20 74 6f |..If you| wish to|
|00001f90| 20 64 69 73 74 72 69 62 | 75 74 65 20 74 68 69 73 | distrib|ute this|
|00001fa0| 20 73 6f 66 74 77 61 72 | 65 20 77 69 74 68 20 61 | softwar|e with a|
|00001fb0| 20 68 61 72 64 77 61 72 | 65 20 70 72 6f 64 75 63 | hardwar|e produc|
|00001fc0| 74 2c 20 63 6f 6e 74 61 | 63 74 0a 74 68 65 20 61 |t, conta|ct.the a|
|00001fd0| 75 74 68 6f 72 20 28 40 | 70 78 72 65 66 7b 54 68 |uthor (@|pxref{Th|
|00001fe0| 65 20 41 75 74 68 6f 72 | 7d 29 2e 20 20 44 69 73 |e Author|}).  Dis|
|00001ff0| 74 72 69 62 75 74 69 6f | 6e 20 6f 66 20 40 73 63 |tributio|n of @sc|
|00002000| 7b 41 68 69 7d 20 77 69 | 74 68 20 68 61 72 64 77 |{Ahi} wi|th hardw|
|00002010| 61 72 65 0a 70 72 6f 64 | 75 63 74 73 20 69 73 20 |are.prod|ucts is |
|00002020| 40 65 6d 70 68 7b 6e 6f | 74 7d 20 66 72 65 65 2e |@emph{no|t} free.|
|00002030| 0a 0a 40 73 63 7b 54 68 | 69 73 20 73 6f 66 74 77 |..@sc{Th|is softw|
|00002040| 61 72 65 20 69 73 20 70 | 72 6f 76 69 64 65 64 20 |are is p|rovided |
|00002050| 62 79 20 74 68 65 20 61 | 75 74 68 6f 72 20 61 6e |by the a|uthor an|
|00002060| 64 20 63 6f 6e 74 72 69 | 62 75 74 6f 72 73 20 60 |d contri|butors `|
|00002070| 60 61 73 20 69 73 27 27 | 20 61 6e 64 20 61 6e 79 |`as is''| and any|
|00002080| 0a 65 78 70 72 65 73 73 | 20 6f 72 20 69 6d 70 6c |.express| or impl|
|00002090| 69 65 64 20 77 61 72 72 | 61 6e 74 69 65 73 2c 20 |ied warr|anties, |
|000020a0| 69 6e 63 6c 75 64 69 6e | 67 2c 20 62 75 74 20 6e |includin|g, but n|
|000020b0| 6f 74 20 6c 69 6d 69 74 | 65 64 20 74 6f 2c 20 74 |ot limit|ed to, t|
|000020c0| 68 65 20 69 6d 70 6c 69 | 65 64 0a 77 61 72 72 61 |he impli|ed.warra|
|000020d0| 6e 74 69 65 73 20 6f 66 | 20 6d 65 72 63 68 61 6e |nties of| merchan|
|000020e0| 74 61 62 69 6c 69 74 79 | 20 61 6e 64 20 66 69 74 |tability| and fit|
|000020f0| 6e 65 73 73 20 66 6f 72 | 20 61 20 70 61 72 74 69 |ness for| a parti|
|00002100| 63 75 6c 61 72 20 70 75 | 72 70 6f 73 65 20 61 72 |cular pu|rpose ar|
|00002110| 65 0a 64 69 73 63 6c 61 | 69 6d 65 64 2e 20 20 49 |e.discla|imed.  I|
|00002120| 6e 20 6e 6f 20 65 76 65 | 6e 74 20 73 68 61 6c 6c |n no eve|nt shall|
|00002130| 20 74 68 65 20 61 75 74 | 68 6f 72 20 6f 72 20 63 | the aut|hor or c|
|00002140| 6f 6e 74 72 69 62 75 74 | 6f 72 73 20 62 65 20 6c |ontribut|ors be l|
|00002150| 69 61 62 6c 65 20 66 6f | 72 20 61 6e 79 0a 64 69 |iable fo|r any.di|
|00002160| 72 65 63 74 2c 20 69 6e | 64 69 72 65 63 74 2c 20 |rect, in|direct, |
|00002170| 69 6e 63 69 64 65 6e 74 | 61 6c 2c 20 73 70 65 63 |incident|al, spec|
|00002180| 69 61 6c 2c 20 65 78 65 | 6d 70 6c 61 72 79 2c 20 |ial, exe|mplary, |
|00002190| 6f 72 20 63 6f 6e 73 65 | 71 75 65 6e 74 69 61 6c |or conse|quential|
|000021a0| 20 64 61 6d 61 67 65 73 | 0a 28 69 6e 63 6c 75 64 | damages|.(includ|
|000021b0| 69 6e 67 2c 20 62 75 74 | 20 6e 6f 74 20 6c 69 6d |ing, but| not lim|
|000021c0| 69 74 65 64 20 74 6f 2c | 20 70 72 6f 63 75 72 65 |ited to,| procure|
|000021d0| 6d 65 6e 74 20 6f 66 20 | 73 75 62 73 74 69 74 75 |ment of |substitu|
|000021e0| 74 65 20 67 6f 6f 64 73 | 20 6f 72 0a 73 65 72 76 |te goods| or.serv|
|000021f0| 69 63 65 73 3b 20 6c 6f | 73 73 20 6f 66 20 75 73 |ices; lo|ss of us|
|00002200| 65 2c 20 64 61 74 61 2c | 20 6f 72 20 70 72 6f 66 |e, data,| or prof|
|00002210| 69 74 73 3b 20 6f 72 20 | 62 75 73 69 6e 65 73 73 |its; or |business|
|00002220| 20 69 6e 74 65 72 72 75 | 70 74 69 6f 6e 29 20 68 | interru|ption) h|
|00002230| 6f 77 65 76 65 72 0a 63 | 61 75 73 65 64 20 61 6e |owever.c|aused an|
|00002240| 64 20 6f 6e 20 61 6e 79 | 20 74 68 65 6f 72 79 20 |d on any| theory |
|00002250| 6f 66 20 6c 69 61 62 69 | 6c 69 74 79 2c 20 77 68 |of liabi|lity, wh|
|00002260| 65 74 68 65 72 20 69 6e | 20 63 6f 6e 74 72 61 63 |ether in| contrac|
|00002270| 74 2c 20 73 74 72 69 63 | 74 0a 6c 69 61 62 69 6c |t, stric|t.liabil|
|00002280| 69 74 79 2c 20 6f 72 20 | 74 6f 72 74 20 28 69 6e |ity, or |tort (in|
|00002290| 63 6c 75 64 69 6e 67 20 | 6e 65 67 6c 69 67 65 6e |cluding |negligen|
|000022a0| 63 65 20 6f 72 20 6f 74 | 68 65 72 77 69 73 65 29 |ce or ot|herwise)|
|000022b0| 20 61 72 69 73 69 6e 67 | 20 69 6e 20 61 6e 79 20 | arising| in any |
|000022c0| 77 61 79 0a 6f 75 74 20 | 6f 66 20 74 68 65 20 75 |way.out |of the u|
|000022d0| 73 65 20 6f 66 20 74 68 | 69 73 20 73 6f 66 74 77 |se of th|is softw|
|000022e0| 61 72 65 2c 20 65 76 65 | 6e 20 69 66 20 61 64 76 |are, eve|n if adv|
|000022f0| 69 73 65 64 20 6f 66 20 | 74 68 65 20 70 6f 73 73 |ised of |the poss|
|00002300| 69 62 69 6c 69 74 79 20 | 6f 66 20 73 75 63 68 0a |ibility |of such.|
|00002310| 64 61 6d 61 67 65 2e 7d | 0a 0a 0a 0a 40 63 20 2a |damage.}|....@c *|
|00002320| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002330| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002340| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002350| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002360| 2a 2a 2a 2a 2a 2a 0a 40 | 63 20 2a 2a 2a 2a 20 54 |******.@|c **** T|
|00002370| 68 65 20 41 75 74 68 6f | 72 20 2a 2a 2a 2a 2a 2a |he Autho|r ******|
|00002380| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002390| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000023a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000023b0| 2a 0a 40 63 20 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |*.@c ***|********|
|000023c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000023d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000023e0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000023f0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 0a 0a 40 6e |********|****..@n|
|00002400| 6f 64 65 20 20 54 68 65 | 20 41 75 74 68 6f 72 2c |ode  The| Author,|
|00002410| 20 44 65 66 69 6e 69 74 | 69 6f 6e 73 2c 20 44 69 | Definit|ions, Di|
|00002420| 73 74 72 69 62 75 74 69 | 6f 6e 2c 20 54 6f 70 0a |stributi|on, Top.|
|00002430| 40 63 6f 6d 6d 65 6e 74 | 20 20 6e 6f 64 65 2d 6e |@comment|  node-n|
|00002440| 61 6d 65 2c 20 20 6e 65 | 78 74 2c 20 20 70 72 65 |ame,  ne|xt,  pre|
|00002450| 76 69 6f 75 73 2c 20 20 | 75 70 0a 40 63 68 61 70 |vious,  |up.@chap|
|00002460| 74 65 72 20 54 68 65 20 | 41 75 74 68 6f 72 0a 0a |ter The |Author..|
|00002470| 40 63 69 6e 64 65 78 20 | 54 68 65 20 41 75 74 68 |@cindex |The Auth|
|00002480| 6f 72 0a 40 63 69 6e 64 | 65 78 20 41 75 74 68 6f |or.@cind|ex Autho|
|00002490| 72 20 6f 66 20 40 73 63 | 7b 41 68 69 7d 0a 0a 54 |r of @sc|{Ahi}..T|
|000024a0| 68 65 20 61 75 74 68 6f | 72 20 63 61 6e 20 62 65 |he autho|r can be|
|000024b0| 20 72 65 61 63 68 65 64 | 20 61 74 20 74 68 65 20 | reached| at the |
|000024c0| 66 6f 6c 6c 6f 77 69 6e | 67 20 61 64 64 72 65 73 |followin|g addres|
|000024d0| 73 65 73 3a 0a 0a 40 74 | 61 62 6c 65 20 40 61 73 |ses:..@t|able @as|
|000024e0| 69 73 0a 0a 40 69 74 65 | 6d 20 45 6c 65 63 74 72 |is..@ite|m Electr|
|000024f0| 6f 6e 69 63 20 6d 61 69 | 6c 0a 40 65 6d 61 69 6c |onic mai|l.@email|
|00002500| 7b 6d 61 72 74 69 6e 40 | 40 62 6c 6f 6d 2e 6f 72 |{martin@|@blom.or|
|00002510| 67 7d 0a 0a 40 69 74 65 | 6d 20 53 74 61 6e 64 61 |g}..@ite|m Standa|
|00002520| 72 64 20 6d 61 69 6c 0a | 20 20 4d 61 72 74 69 6e |rd mail.|  Martin|
|00002530| 20 42 6c 6f 6d 0a 40 2a | 41 6c 73 e4 74 74 65 72 | Blom.@*|Als.tter|
|00002540| 73 67 61 74 61 6e 20 31 | 35 41 3a 32 34 0a 40 2a |sgatan 1|5A:24.@*|
|00002550| 53 45 2d 35 38 34 20 33 | 35 20 4c 69 6e 6b f6 70 |SE-584 3|5 Link.p|
|00002560| 69 6e 67 0a 40 2a 53 57 | 45 44 45 4e 0a 0a 40 69 |ing.@*SW|EDEN..@i|
|00002570| 74 65 6d 20 57 6f 72 6c | 64 2d 57 69 64 65 20 57 |tem Worl|d-Wide W|
|00002580| 65 62 0a 40 75 72 6c 7b | 68 74 74 70 3a 2f 2f 6d |eb.@url{|http://m|
|00002590| 61 72 74 69 6e 2e 62 6c | 6f 6d 2e 6f 72 67 7d 0a |artin.bl|om.org}.|
|000025a0| 0a 40 65 6e 64 20 74 61 | 62 6c 65 0a 0a 0a 40 63 |.@end ta|ble...@c|
|000025b0| 20 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a | *******|********|
|000025c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000025d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000025e0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000025f0| 2a 2a 2a 2a 2a 2a 2a 2a | 0a 40 63 20 2a 2a 2a 2a |********|.@c ****|
|00002600| 20 44 65 66 69 6e 69 74 | 69 6f 6e 73 20 20 2a 2a | Definit|ions  **|
|00002610| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002620| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002630| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002640| 2a 2a 2a 0a 40 63 20 2a | 2a 2a 2a 2a 2a 2a 2a 2a |***.@c *|********|
|00002650| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002660| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002670| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002680| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 0a 0a |********|******..|
|00002690| 40 6e 6f 64 65 20 44 65 | 66 69 6e 69 74 69 6f 6e |@node De|finition|
|000026a0| 73 2c 20 46 75 6e 63 74 | 69 6f 6e 20 49 6e 74 65 |s, Funct|ion Inte|
|000026b0| 72 66 61 63 65 2c 20 54 | 68 65 20 41 75 74 68 6f |rface, T|he Autho|
|000026c0| 72 2c 20 54 6f 70 0a 40 | 63 6f 6d 6d 65 6e 74 20 |r, Top.@|comment |
|000026d0| 20 6e 6f 64 65 2d 6e 61 | 6d 65 2c 20 20 6e 65 78 | node-na|me,  nex|
|000026e0| 74 2c 20 20 70 72 65 76 | 69 6f 75 73 2c 20 20 75 |t,  prev|ious,  u|
|000026f0| 70 0a 40 63 68 61 70 74 | 65 72 20 44 65 66 69 6e |p.@chapt|er Defin|
|00002700| 69 74 69 6f 6e 73 0a 0a | 40 63 69 6e 64 65 78 20 |itions..|@cindex |
|00002710| 44 65 66 69 6e 69 74 69 | 6f 6e 73 0a 0a 46 6f 6c |Definiti|ons..Fol|
|00002720| 6c 6f 77 69 6e 67 20 61 | 72 65 20 73 6f 6d 65 20 |lowing a|re some |
|00002730| 67 65 6e 65 72 61 6c 20 | 64 65 66 69 6e 69 74 69 |general |definiti|
|00002740| 6f 6e 73 20 6f 66 20 74 | 65 72 6d 73 20 74 68 61 |ons of t|erms tha|
|00002750| 74 20 61 72 65 20 75 73 | 65 64 20 69 6e 20 74 68 |t are us|ed in th|
|00002760| 69 73 0a 64 6f 63 75 6d | 65 6e 74 2e 0a 0a 40 74 |is.docum|ent...@t|
|00002770| 61 62 6c 65 20 40 64 66 | 6e 0a 0a 40 63 69 6e 64 |able @df|n..@cind|
|00002780| 65 78 20 53 61 6d 70 6c | 65 0a 0a 40 69 74 65 6d |ex Sampl|e..@item|
|00002790| 20 53 61 6d 70 6c 65 0a | 41 20 73 61 6d 70 6c 65 | Sample.|A sample|
|000027a0| 20 69 73 20 6f 6e 65 20 | 62 69 6e 61 72 79 20 6e | is one |binary n|
|000027b0| 75 6d 62 65 72 2c 20 72 | 65 70 72 65 73 65 6e 74 |umber, r|epresent|
|000027c0| 69 6e 67 20 74 68 65 20 | 61 6d 70 6c 69 74 75 64 |ing the |amplitud|
|000027d0| 65 20 61 74 20 61 20 66 | 69 78 65 64 20 70 6f 69 |e at a f|ixed poi|
|000027e0| 6e 74 0a 69 6e 20 74 69 | 6d 65 2e 20 20 41 20 73 |nt.in ti|me.  A s|
|000027f0| 61 6d 70 6c 65 20 69 73 | 20 6f 66 74 65 6e 20 73 |ample is| often s|
|00002800| 74 6f 72 65 64 20 61 73 | 20 61 6e 20 38 20 62 69 |tored as| an 8 bi|
|00002810| 74 20 73 69 67 6e 65 64 | 20 69 6e 74 65 67 65 72 |t signed| integer|
|00002820| 2c 20 61 20 31 36 20 62 | 69 74 0a 73 69 67 6e 65 |, a 16 b|it.signe|
|00002830| 64 20 69 6e 74 65 67 65 | 72 2c 20 61 20 33 32 20 |d intege|r, a 32 |
|00002840| 62 69 74 20 66 6c 6f 61 | 74 69 6e 67 20 70 6f 69 |bit floa|ting poi|
|00002850| 6e 74 20 6e 75 6d 62 65 | 72 20 65 74 63 2e 20 20 |nt numbe|r etc.  |
|00002860| 40 73 63 7b 41 68 69 7d | 20 6f 6e 6c 79 0a 73 75 |@sc{Ahi}| only.su|
|00002870| 70 70 6f 72 74 73 20 69 | 6e 74 65 67 65 72 73 2e |pports i|ntegers.|
|00002880| 0a 0a 40 63 69 6e 64 65 | 78 20 53 61 6d 70 6c 65 |..@cinde|x Sample|
|00002890| 20 66 72 61 6d 65 0a 0a | 40 69 74 65 6d 20 53 61 | frame..|@item Sa|
|000028a0| 6d 70 6c 65 20 66 72 61 | 6d 65 0a 49 6e 20 6d 6f |mple fra|me.In mo|
|000028b0| 6e 6f 20 65 6e 76 69 72 | 6f 6e 6d 65 6e 74 73 2c |no envir|onments,|
|000028c0| 20 61 20 73 61 6d 70 6c | 65 20 66 72 61 6d 65 20 | a sampl|e frame |
|000028d0| 69 73 20 74 68 65 20 73 | 61 6d 65 20 61 73 20 61 |is the s|ame as a|
|000028e0| 20 73 61 6d 70 6c 65 2e | 20 20 49 6e 20 73 74 65 | sample.|  In ste|
|000028f0| 72 65 6f 0a 65 6e 76 69 | 72 6f 6e 6d 65 6e 74 73 |reo.envi|ronments|
|00002900| 2c 20 61 20 73 61 6d 70 | 6c 65 20 66 72 61 6d 65 |, a samp|le frame|
|00002910| 20 69 73 20 61 20 74 75 | 70 6c 65 20 6f 66 20 74 | is a tu|ple of t|
|00002920| 77 6f 20 73 61 6d 70 6c | 65 73 2e 20 20 54 68 65 |wo sampl|es.  The|
|00002930| 20 66 69 72 73 74 20 6d | 65 6d 62 65 72 0a 69 73 | first m|ember.is|
|00002940| 20 66 6f 72 20 74 68 65 | 20 6c 65 66 74 20 63 68 | for the| left ch|
|00002950| 61 6e 6e 65 6c 2c 20 74 | 68 65 20 73 65 63 6f 6e |annel, t|he secon|
|00002960| 64 20 66 6f 72 20 74 68 | 65 20 72 69 67 68 74 2e |d for th|e right.|
|00002970| 0a 0a 40 63 69 6e 64 65 | 78 20 53 6f 75 6e 64 0a |..@cinde|x Sound.|
|00002980| 0a 40 69 74 65 6d 20 53 | 6f 75 6e 64 0a 4d 61 6e |.@item S|ound.Man|
|00002990| 79 20 73 61 6d 70 6c 65 | 20 66 72 61 6d 65 73 20 |y sample| frames |
|000029a0| 73 74 6f 72 65 64 20 69 | 6e 20 73 65 71 75 65 6e |stored i|n sequen|
|000029b0| 63 65 20 61 73 20 61 6e | 20 61 72 72 61 79 20 63 |ce as an| array c|
|000029c0| 61 6e 20 62 65 20 63 61 | 6c 6c 65 64 20 61 20 73 |an be ca|lled a s|
|000029d0| 6f 75 6e 64 2e 20 20 41 | 0a 73 6f 75 6e 64 20 69 |ound.  A|.sound i|
|000029e0| 73 2c 20 68 6f 77 65 76 | 65 72 2c 20 6e 6f 74 20 |s, howev|er, not |
|000029f0| 6c 69 6d 69 74 65 64 20 | 74 6f 20 62 65 69 6e 67 |limited |to being|
|00002a00| 20 66 6f 72 6d 65 64 20 | 62 79 20 73 61 6d 70 6c | formed |by sampl|
|00002a10| 65 73 2c 20 69 74 20 63 | 61 6e 20 61 6c 73 6f 20 |es, it c|an also |
|00002a20| 62 65 0a 70 61 72 61 6d | 65 74 65 72 73 20 74 6f |be.param|eters to|
|00002a30| 20 61 6e 20 61 6e 61 6c | 6f 67 20 73 79 6e 74 68 | an anal|og synth|
|00002a40| 20 6f 72 20 61 20 4d 49 | 44 49 20 69 6e 73 74 72 | or a MI|DI instr|
|00002a50| 75 6d 65 6e 74 2c 20 6f | 72 20 62 65 20 77 68 69 |ument, o|r be whi|
|00002a60| 74 65 20 6e 6f 69 73 65 | 2e 0a 40 73 63 7b 41 68 |te noise|..@sc{Ah|
|00002a70| 69 7d 20 6f 6e 6c 79 20 | 73 75 70 70 6f 72 74 73 |i} only |supports|
|00002a80| 20 73 6f 75 6e 64 73 20 | 66 6f 72 6d 65 64 20 62 | sounds |formed b|
|00002a90| 79 20 73 61 6d 70 6c 65 | 73 2e 0a 0a 40 65 6e 64 |y sample|s...@end|
|00002aa0| 20 74 61 62 6c 65 0a 0a | 0a 40 63 20 2a 2a 2a 2a | table..|.@c ****|
|00002ab0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002ac0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002ad0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002ae0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002af0| 2a 2a 2a 0a 40 63 20 2a | 2a 2a 2a 2a 2a 2a 2a 2a |***.@c *|********|
|00002b00| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002b10| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002b20| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002b30| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 0a 40 |********|******.@|
|00002b40| 63 20 2a 2a 2a 2a 20 46 | 75 6e 63 74 69 6f 6e 20 |c **** F|unction |
|00002b50| 49 6e 74 65 72 66 61 63 | 65 20 2a 2a 2a 2a 2a 2a |Interfac|e ******|
|00002b60| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002b70| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002b80| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 40 63 20 2a 2a 2a |********|*.@c ***|
|00002b90| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002ba0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002bb0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002bc0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002bd0| 2a 2a 2a 2a 0a 40 63 20 | 2a 2a 2a 2a 2a 2a 2a 2a |****.@c |********|
|00002be0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002bf0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002c00| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00002c10| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 0a |********|*******.|
|00002c20| 0a 40 6e 6f 64 65 20 46 | 75 6e 63 74 69 6f 6e 20 |.@node F|unction |
|00002c30| 49 6e 74 65 72 66 61 63 | 65 2c 20 44 65 76 69 63 |Interfac|e, Devic|
|00002c40| 65 20 49 6e 74 65 72 66 | 61 63 65 2c 20 44 65 66 |e Interf|ace, Def|
|00002c50| 69 6e 69 74 69 6f 6e 73 | 2c 20 54 6f 70 0a 40 63 |initions|, Top.@c|
|00002c60| 6f 6d 6d 65 6e 74 20 20 | 6e 6f 64 65 2d 6e 61 6d |omment  |node-nam|
|00002c70| 65 2c 20 20 6e 65 78 74 | 2c 20 20 70 72 65 76 69 |e,  next|,  previ|
|00002c80| 6f 75 73 2c 20 20 75 70 | 0a 40 63 68 61 70 74 65 |ous,  up|.@chapte|
|00002c90| 72 20 46 75 6e 63 74 69 | 6f 6e 20 49 6e 74 65 72 |r Functi|on Inter|
|00002ca0| 66 61 63 65 0a 0a 40 63 | 69 6e 64 65 78 20 46 75 |face..@c|index Fu|
|00002cb0| 6e 63 74 69 6f 6e 20 49 | 6e 74 65 72 66 61 63 65 |nction I|nterface|
|00002cc0| 0a 0a 20 54 68 65 20 64 | 65 76 69 63 65 20 68 61 |.. The d|evice ha|
|00002cd0| 73 2c 20 69 6e 20 61 64 | 64 69 74 69 6f 6e 20 74 |s, in ad|dition t|
|00002ce0| 6f 20 74 68 65 20 75 73 | 75 61 6c 20 49 2f 4f 20 |o the us|ual I/O |
|00002cf0| 72 65 71 75 65 73 74 20 | 70 72 6f 74 6f 63 6f 6c |request |protocol|
|00002d00| 2c 20 61 20 73 65 74 20 | 6f 66 0a 66 75 6e 63 74 |, a set |of.funct|
|00002d10| 69 6f 6e 73 20 74 68 61 | 74 20 61 6c 6c 6f 77 73 |ions tha|t allows|
|00002d20| 20 74 68 65 20 70 72 6f | 67 72 61 6d 6d 65 72 20 | the pro|grammer |
|00002d30| 74 6f 20 67 61 69 6e 20 | 66 75 6c 6c 20 63 6f 6e |to gain |full con|
|00002d40| 74 72 6f 6c 20 28 61 74 | 20 6c 65 61 73 74 20 61 |trol (at| least a|
|00002d50| 73 20 6d 75 63 68 0a 61 | 73 20 70 6f 73 73 69 62 |s much.a|s possib|
|00002d60| 6c 65 20 77 69 74 68 20 | 64 65 76 69 63 65 20 69 |le with |device i|
|00002d70| 6e 64 65 70 65 6e 64 65 | 6e 63 65 29 20 6f 76 65 |ndepende|nce) ove|
|00002d80| 72 20 74 68 65 20 61 75 | 64 69 6f 20 68 61 72 64 |r the au|dio hard|
|00002d90| 77 61 72 65 2e 20 20 54 | 68 65 0a 61 64 76 61 6e |ware.  T|he.advan|
|00002da0| 74 61 67 65 73 20 61 72 | 65 20 6c 6f 77 20 6f 76 |tages ar|e low ov|
|00002db0| 65 72 68 65 61 64 20 61 | 6e 64 20 6d 75 63 68 20 |erhead a|nd much |
|00002dc0| 6d 6f 72 65 20 61 64 76 | 61 6e 63 65 64 20 63 6f |more adv|anced co|
|00002dd0| 6e 74 72 6f 6c 20 6f 76 | 65 72 20 74 68 65 20 70 |ntrol ov|er the p|
|00002de0| 6c 61 79 69 6e 67 0a 73 | 6f 75 6e 64 73 2e 20 20 |laying.s|ounds.  |
|00002df0| 54 68 65 20 64 69 73 61 | 64 76 61 6e 74 61 67 65 |The disa|dvantage|
|00002e00| 73 20 61 72 65 20 67 72 | 65 61 74 65 72 20 63 6f |s are gr|eater co|
|00002e10| 6d 70 6c 65 78 69 74 79 | 20 61 6e 64 20 6f 6e 6c |mplexity| and onl|
|00002e20| 79 20 6f 6e 65 20 75 73 | 65 72 20 70 65 72 0a 73 |y one us|er per.s|
|00002e30| 6f 75 6e 64 20 63 61 72 | 64 2e 0a 0a 40 63 69 6e |ound car|d...@cin|
|00002e40| 64 65 78 20 4d 75 73 69 | 63 2c 20 67 61 6d 65 73 |dex Musi|c, games|
|00002e50| 0a 40 63 69 6e 64 65 78 | 20 53 6f 75 6e 64 20 65 |.@cindex| Sound e|
|00002e60| 66 66 65 63 74 73 2c 20 | 67 61 6d 65 73 0a 40 63 |ffects, |games.@c|
|00002e70| 69 6e 64 65 78 20 47 61 | 6d 65 73 2c 20 6d 75 73 |index Ga|mes, mus|
|00002e80| 69 63 0a 40 63 69 6e 64 | 65 78 20 47 61 6d 65 73 |ic.@cind|ex Games|
|00002e90| 2c 20 73 6f 75 6e 64 20 | 65 66 66 65 63 74 73 0a |, sound |effects.|
|00002ea0| 40 63 69 6e 64 65 78 20 | 52 65 61 6c 74 69 6d 65 |@cindex |Realtime|
|00002eb0| 20 65 66 66 65 63 74 73 | 0a 40 63 69 6e 64 65 78 | effects|.@cindex|
|00002ec0| 20 52 65 63 6f 72 64 69 | 6e 67 2c 20 68 69 67 68 | Recordi|ng, high|
|00002ed0| 20 71 75 61 6c 69 74 79 | 0a 0a 20 49 66 20 79 6f | quality|.. If yo|
|00002ee0| 75 20 77 61 6e 74 20 74 | 6f 20 70 6c 61 79 20 6d |u want t|o play m|
|00002ef0| 75 73 69 63 20 6f 72 20 | 73 6f 75 6e 64 20 65 66 |usic or |sound ef|
|00002f00| 66 65 63 74 73 20 66 6f | 72 20 61 20 67 61 6d 65 |fects fo|r a game|
|00002f10| 2c 20 72 65 63 6f 72 64 | 20 69 6e 20 68 69 67 68 |, record| in high|
|00002f20| 0a 71 75 61 6c 69 74 79 | 20 6f 72 20 77 61 6e 74 |.quality| or want|
|00002f30| 20 74 6f 20 64 6f 20 72 | 65 61 6c 74 69 6d 65 20 | to do r|ealtime |
|00002f40| 65 66 66 65 63 74 73 2c | 20 74 68 69 73 20 69 73 |effects,| this is|
|00002f50| 20 74 68 65 20 41 50 49 | 20 74 6f 20 75 73 65 2e | the API| to use.|
|00002f60| 0a 0a 0a 0a 40 6d 65 6e | 75 0a 2a 20 47 75 69 64 |....@men|u.* Guid|
|00002f70| 65 6c 69 6e 65 73 3a 3a | 20 20 20 20 20 20 20 20 |elines::|        |
|00002f80| 20 20 20 20 20 20 20 20 | 20 20 0a 2a 20 4f 70 65 |        |  .* Ope|
|00002f90| 6e 69 6e 67 20 41 6e 64 | 20 43 6c 6f 73 69 6e 67 |ning And| Closing|
|00002fa0| 20 61 68 69 2e 64 65 76 | 69 63 65 20 46 6f 72 20 | ahi.dev|ice For |
|00002fb0| 4c 6f 77 2d 6c 65 76 65 | 6c 20 41 63 63 65 73 73 |Low-leve|l Access|
|00002fc0| 3a 3a 20 20 0a 2a 20 4f | 62 74 61 69 6e 69 6e 67 |::  .* O|btaining|
|00002fd0| 20 54 68 65 20 48 61 72 | 64 77 61 72 65 3a 3a 20 | The Har|dware:: |
|00002fe0| 20 20 20 20 20 0a 2a 20 | 44 65 63 6c 61 72 69 6e |     .* |Declarin|
|00002ff0| 67 20 53 6f 75 6e 64 73 | 3a 3a 20 20 20 20 20 20 |g Sounds|::      |
|00003000| 20 20 20 20 20 20 0a 2a | 20 4d 61 6b 69 6e 67 20 |      .*| Making |
|00003010| 4e 6f 69 73 65 3a 3a 20 | 20 20 20 20 20 20 20 20 |Noise:: |        |
|00003020| 20 20 20 20 20 20 20 0a | 40 65 6e 64 20 6d 65 6e |       .|@end men|
|00003030| 75 0a 0a 0a 40 63 20 2a | 2a 2a 2a 2a 2a 2a 2a 2a |u...@c *|********|
|00003040| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003050| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003060| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003070| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 0a 40 |********|******.@|
|00003080| 63 20 2a 2a 2a 2a 20 47 | 75 69 64 65 6c 69 6e 65 |c **** G|uideline|
|00003090| 73 20 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |s ******|********|
|000030a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000030b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000030c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 40 63 20 2a 2a 2a |********|*.@c ***|
|000030d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000030e0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000030f0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003100| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003110| 2a 2a 2a 2a 0a 0a 40 6e | 6f 64 65 20 47 75 69 64 |****..@n|ode Guid|
|00003120| 65 6c 69 6e 65 73 2c 20 | 4f 70 65 6e 69 6e 67 20 |elines, |Opening |
|00003130| 41 6e 64 20 43 6c 6f 73 | 69 6e 67 20 61 68 69 2e |And Clos|ing ahi.|
|00003140| 64 65 76 69 63 65 20 46 | 6f 72 20 4c 6f 77 2d 6c |device F|or Low-l|
|00003150| 65 76 65 6c 20 41 63 63 | 65 73 73 2c 20 46 75 6e |evel Acc|ess, Fun|
|00003160| 63 74 69 6f 6e 20 49 6e | 74 65 72 66 61 63 65 2c |ction In|terface,|
|00003170| 20 46 75 6e 63 74 69 6f | 6e 20 49 6e 74 65 72 66 | Functio|n Interf|
|00003180| 61 63 65 0a 40 63 6f 6d | 6d 65 6e 74 20 20 6e 6f |ace.@com|ment  no|
|00003190| 64 65 2d 6e 61 6d 65 2c | 20 20 6e 65 78 74 2c 20 |de-name,|  next, |
|000031a0| 20 70 72 65 76 69 6f 75 | 73 2c 20 20 75 70 0a 40 | previou|s,  up.@|
|000031b0| 73 65 63 74 69 6f 6e 20 | 47 75 69 64 65 6c 69 6e |section |Guidelin|
|000031c0| 65 73 0a 0a 40 63 69 6e | 64 65 78 20 47 75 69 64 |es..@cin|dex Guid|
|000031d0| 65 6c 69 6e 65 73 0a 40 | 63 69 6e 64 65 78 20 50 |elines.@|cindex P|
|000031e0| 72 6f 67 72 61 6d 6d 69 | 6e 67 20 67 75 69 64 65 |rogrammi|ng guide|
|000031f0| 6c 69 6e 65 73 0a 0a 0a | 40 73 75 62 73 65 63 74 |lines...|@subsect|
|00003200| 69 6f 6e 20 46 6f 6c 6c | 6f 77 20 54 68 65 20 52 |ion Foll|ow The R|
|00003210| 75 6c 65 73 0a 0a 20 49 | 74 27 73 20 72 65 61 6c |ules.. I|t's real|
|00003220| 6c 79 20 73 69 6d 70 6c | 65 2e 20 20 49 66 20 49 |ly simpl|e.  If I|
|00003230| 20 74 65 6c 6c 20 79 6f | 75 20 74 6f 20 63 68 65 | tell yo|u to che|
|00003240| 63 6b 20 72 65 74 75 72 | 6e 20 76 61 6c 75 65 73 |ck retur|n values|
|00003250| 2c 20 63 68 65 63 6b 20 | 73 61 6d 70 6c 65 0a 74 |, check |sample.t|
|00003260| 79 70 65 73 20 77 68 65 | 6e 20 72 65 63 6f 72 64 |ypes whe|n record|
|00003270| 69 6e 67 2c 20 6e 6f 74 | 20 74 6f 20 74 72 61 73 |ing, not| to tras|
|00003280| 68 20 64 32 2d 64 37 2f | 61 32 2d 61 36 20 69 6e |h d2-d7/|a2-a6 in|
|00003290| 20 68 6f 6f 6b 73 2c 20 | 6f 72 20 6e 6f 74 20 74 | hooks, |or not t|
|000032a0| 6f 20 63 61 6c 6c 0a 40 | 63 6f 64 65 7b 41 48 49 |o call.@|code{AHI|
|000032b0| 5f 43 6f 6e 74 72 6f 6c | 41 75 64 69 6f 28 29 7d |_Control|Audio()}|
|000032c0| 20 77 69 74 68 20 74 68 | 65 20 40 63 6f 64 65 7b | with th|e @code{|
|000032d0| 41 48 49 43 5f 50 6c 61 | 79 7d 20 74 61 67 20 66 |AHIC_Pla|y} tag f|
|000032e0| 72 6f 6d 20 69 6e 74 65 | 72 72 75 70 74 73 20 6f |rom inte|rrupts o|
|000032f0| 72 0a 68 6f 6f 6b 73 2c | 20 79 6f 75 20 64 6f 20 |r.hooks,| you do |
|00003300| 61 73 20 79 6f 75 20 61 | 72 65 20 74 6f 6c 64 2e |as you a|re told.|
|00003310| 0a 0a 0a 40 73 75 62 73 | 65 63 74 69 6f 6e 20 54 |...@subs|ection T|
|00003320| 68 65 20 4c 69 62 72 61 | 72 79 20 42 61 73 65 0a |he Libra|ry Base.|
|00003330| 0a 40 63 69 6e 64 65 78 | 20 4c 69 62 72 61 72 79 |.@cindex| Library|
|00003340| 20 62 61 73 65 0a 40 74 | 69 6e 64 65 78 20 41 48 | base.@t|index AH|
|00003350| 49 42 61 73 65 0a 0a 20 | 54 68 65 20 40 63 6f 64 |IBase.. |The @cod|
|00003360| 65 7b 41 48 49 42 61 73 | 65 7d 20 73 74 72 75 63 |e{AHIBas|e} struc|
|00003370| 74 75 72 65 20 69 73 20 | 70 72 69 76 61 74 65 2c |ture is |private,|
|00003380| 20 73 6f 20 61 72 65 20 | 74 68 65 20 73 75 62 20 | so are |the sub |
|00003390| 6c 69 62 72 61 72 69 65 | 73 27 20 6c 69 62 72 61 |librarie|s' libra|
|000033a0| 72 79 0a 62 61 73 65 20 | 73 74 72 75 63 74 75 72 |ry.base |structur|
|000033b0| 65 73 2e 20 20 44 6f 6e | 27 74 20 74 72 79 20 74 |es.  Don|'t try t|
|000033c0| 6f 20 62 65 20 63 6c 65 | 76 65 72 2e 0a 0a 0a 40 |o be cle|ver....@|
|000033d0| 73 75 62 73 65 63 74 69 | 6f 6e 20 54 68 65 20 41 |subsecti|on The A|
|000033e0| 75 64 69 6f 20 44 61 74 | 61 62 61 73 65 0a 0a 40 |udio Dat|abase..@|
|000033f0| 63 69 6e 64 65 78 20 54 | 68 65 20 41 75 64 69 6f |cindex T|he Audio|
|00003400| 20 44 61 74 61 62 61 73 | 65 0a 0a 40 66 69 6e 64 | Databas|e..@find|
|00003410| 65 78 20 41 48 49 5f 4e | 65 78 74 41 75 64 69 6f |ex AHI_N|extAudio|
|00003420| 49 44 28 29 0a 40 66 69 | 6e 64 65 78 20 41 48 49 |ID().@fi|ndex AHI|
|00003430| 5f 47 65 74 41 75 64 69 | 6f 41 74 74 72 73 41 28 |_GetAudi|oAttrsA(|
|00003440| 29 0a 40 66 69 6e 64 65 | 78 20 41 48 49 5f 42 65 |).@finde|x AHI_Be|
|00003450| 73 74 41 75 64 69 6f 49 | 44 41 28 29 0a 0a 20 54 |stAudioI|DA().. T|
|00003460| 68 65 20 69 6d 70 6c 65 | 6d 65 6e 74 61 74 69 6f |he imple|mentatio|
|00003470| 6e 20 6f 66 20 74 68 65 | 20 64 61 74 61 62 61 73 |n of the| databas|
|00003480| 65 20 69 73 20 70 72 69 | 76 61 74 65 2c 20 61 6e |e is pri|vate, an|
|00003490| 64 20 6d 61 79 20 63 68 | 61 6e 67 65 20 61 6e 79 |d may ch|ange any|
|000034a0| 20 74 69 6d 65 2e 0a 40 | 63 6f 64 65 7b 61 68 69 | time..@|code{ahi|
|000034b0| 2e 64 65 76 69 63 65 7d | 20 70 72 6f 76 69 64 65 |.device}| provide|
|000034c0| 73 20 66 75 6e 63 74 69 | 6f 6e 73 20 61 63 63 65 |s functi|ons acce|
|000034d0| 73 73 20 74 68 65 20 69 | 6e 66 6f 72 6d 61 74 69 |ss the i|nformati|
|000034e0| 6f 6e 20 69 6e 20 74 68 | 65 20 64 61 74 61 62 61 |on in th|e databa|
|000034f0| 73 65 0a 28 40 63 6f 64 | 65 7b 41 48 49 5f 4e 65 |se.(@cod|e{AHI_Ne|
|00003500| 78 74 41 75 64 69 6f 49 | 44 28 29 7d 2c 20 40 63 |xtAudioI|D()}, @c|
|00003510| 6f 64 65 7b 41 48 49 5f | 47 65 74 41 75 64 69 6f |ode{AHI_|GetAudio|
|00003520| 41 74 74 72 73 41 28 29 | 7d 20 61 6e 64 0a 40 63 |AttrsA()|} and.@c|
|00003530| 6f 64 65 7b 41 48 49 5f | 42 65 73 74 41 75 64 69 |ode{AHI_|BestAudi|
|00003540| 6f 49 44 41 28 29 7d 29 | 2e 0a 0a 0a 40 73 75 62 |oIDA()})|....@sub|
|00003550| 73 65 63 74 69 6f 6e 20 | 55 73 65 72 20 48 6f 6f |section |User Hoo|
|00003560| 6b 73 0a 0a 40 63 69 6e | 64 65 78 20 48 6f 6f 6b |ks..@cin|dex Hook|
|00003570| 73 0a 0a 20 41 6c 6c 20 | 75 73 65 72 20 68 6f 6f |s.. All |user hoo|
|00003580| 6b 73 20 6d 75 73 74 20 | 66 6f 6c 6c 6f 77 20 6e |ks must |follow n|
|00003590| 6f 72 6d 61 6c 20 72 65 | 67 69 73 74 65 72 20 63 |ormal re|gister c|
|000035a0| 6f 6e 76 65 6e 74 69 6f | 6e 73 2c 20 77 68 69 63 |onventio|ns, whic|
|000035b0| 68 20 6d 65 61 6e 73 20 | 74 68 61 74 0a 64 32 2d |h means |that.d2-|
|000035c0| 64 37 20 61 6e 64 20 61 | 32 2d 61 36 20 6d 75 73 |d7 and a|2-a6 mus|
|000035d0| 74 20 62 65 20 70 72 65 | 73 65 72 76 65 64 2e 20 |t be pre|served. |
|000035e0| 20 54 68 65 79 20 6d 61 | 79 20 62 65 20 63 61 6c | They ma|y be cal|
|000035f0| 6c 65 64 20 66 72 6f 6d | 20 61 6e 20 69 6e 74 65 |led from| an inte|
|00003600| 72 72 75 70 74 2c 0a 62 | 75 74 20 79 6f 75 20 63 |rrupt,.b|ut you c|
|00003610| 61 6e 6e 6f 74 20 63 6f | 75 6e 74 20 6f 6e 20 74 |annot co|unt on t|
|00003620| 68 61 74 3b 20 69 74 20 | 63 61 6e 20 62 65 20 79 |hat; it |can be y|
|00003630| 6f 75 72 20 6f 77 6e 20 | 70 72 6f 63 65 73 73 20 |our own |process |
|00003640| 6f 72 20 61 6e 6f 74 68 | 65 72 0a 70 72 6f 63 65 |or anoth|er.proce|
|00003650| 73 73 2e 20 20 44 6f 6e | 27 74 20 61 73 73 75 6d |ss.  Don|'t assum|
|00003660| 65 20 74 68 65 20 73 79 | 73 74 65 6d 20 69 73 20 |e the sy|stem is |
|00003670| 69 6e 20 73 69 6e 67 6c | 65 2d 74 68 72 65 61 64 |in singl|e-thread|
|00003680| 20 6d 6f 64 65 2e 20 20 | 4e 65 76 65 72 20 73 70 | mode.  |Never sp|
|00003690| 65 6e 64 0a 6d 75 63 68 | 20 74 69 6d 65 20 69 6e |end.much| time in|
|000036a0| 20 61 20 68 6f 6f 6b 2c | 20 67 65 74 20 74 68 65 | a hook,| get the|
|000036b0| 20 77 6f 72 6b 20 64 6f | 6e 65 20 61 73 20 71 75 | work do|ne as qu|
|000036c0| 69 63 6b 20 61 73 20 70 | 6f 73 73 69 62 6c 65 20 |ick as p|ossible |
|000036d0| 61 6e 64 20 74 68 65 6e | 0a 72 65 74 75 72 6e 2e |and then|.return.|
|000036e0| 0a 0a 0a 40 73 75 62 73 | 65 63 74 69 6f 6e 20 46 |...@subs|ection F|
|000036f0| 75 6e 63 74 69 6f 6e 20 | 43 61 6c 6c 73 20 46 72 |unction |Calls Fr|
|00003700| 6f 6d 20 4f 74 68 65 72 | 20 54 61 73 6b 73 2c 20 |om Other| Tasks, |
|00003710| 49 6e 74 65 72 72 75 70 | 74 73 20 4f 72 20 55 73 |Interrup|ts Or Us|
|00003720| 65 72 20 48 6f 6f 6b 73 | 0a 0a 20 54 68 65 20 40 |er Hooks|.. The @|
|00003730| 63 6f 64 65 7b 41 48 49 | 41 75 64 69 6f 43 74 72 |code{AHI|AudioCtr|
|00003740| 6c 7d 20 73 74 72 75 63 | 74 75 72 65 20 6d 61 79 |l} struc|ture may|
|00003750| 20 6e 6f 74 20 62 65 20 | 73 68 61 72 65 64 20 77 | not be |shared w|
|00003760| 69 74 68 20 6f 74 68 65 | 72 0a 74 61 73 6b 73 2f |ith othe|r.tasks/|
|00003770| 74 68 72 65 61 64 73 2e | 20 20 54 68 65 20 74 61 |threads.|  The ta|
|00003780| 73 6b 20 74 68 61 74 20 | 63 61 6c 6c 65 64 20 40 |sk that |called @|
|00003790| 63 6f 64 65 7b 41 48 49 | 5f 41 6c 6c 6f 63 41 75 |code{AHI|_AllocAu|
|000037a0| 64 69 6f 41 28 29 7d 20 | 6d 75 73 74 20 64 6f 20 |dioA()} |must do |
|000037b0| 61 6c 6c 0a 6f 74 68 65 | 72 20 63 61 6c 6c 73 20 |all.othe|r calls |
|000037c0| 74 6f 6f 20 28 65 78 63 | 65 70 74 20 74 68 6f 73 |too (exc|ept thos|
|000037d0| 65 20 63 61 6c 6c 61 62 | 6c 65 20 66 72 6f 6d 20 |e callab|le from |
|000037e0| 69 6e 74 65 72 72 75 70 | 74 73 29 2e 0a 0a 20 4f |interrup|ts)... O|
|000037f0| 6e 6c 79 20 63 61 6c 6c | 73 20 73 70 65 63 69 66 |nly call|s specif|
|00003800| 69 63 61 6c 6c 79 20 73 | 61 69 64 20 74 6f 20 62 |ically s|aid to b|
|00003810| 65 20 63 61 6c 6c 61 62 | 6c 65 20 66 72 6f 6d 20 |e callab|le from |
|00003820| 69 6e 74 65 72 72 75 70 | 74 73 20 6d 61 79 20 62 |interrup|ts may b|
|00003830| 65 20 63 61 6c 6c 65 64 | 0a 66 72 6f 6d 20 75 73 |e called|.from us|
|00003840| 65 72 20 68 6f 6f 6b 73 | 20 6f 72 20 69 6e 74 65 |er hooks| or inte|
|00003850| 72 72 75 70 74 73 2e 20 | 20 4e 6f 74 65 20 74 68 |rrupts. | Note th|
|00003860| 61 74 20 40 63 6f 64 65 | 7b 41 48 49 5f 43 6f 6e |at @code|{AHI_Con|
|00003870| 74 72 6f 6c 41 75 64 69 | 6f 41 28 29 7d 20 68 61 |trolAudi|oA()} ha|
|00003880| 73 0a 73 6f 6d 65 20 74 | 61 67 73 20 74 68 61 74 |s.some t|ags that|
|00003890| 20 6d 75 73 74 20 6e 6f | 74 20 62 65 20 70 72 65 | must no|t be pre|
|000038a0| 73 65 6e 74 20 77 68 65 | 6e 20 63 61 6c 6c 65 64 |sent whe|n called|
|000038b0| 20 66 72 6f 6d 20 61 6e | 20 69 6e 74 65 72 72 75 | from an| interru|
|000038c0| 70 74 2e 0a 0a 0a 40 73 | 75 62 73 65 63 74 69 6f |pt....@s|ubsectio|
|000038d0| 6e 20 4d 75 6c 74 69 74 | 61 73 6b 69 6e 67 0a 0a |n Multit|asking..|
|000038e0| 40 63 69 6e 64 65 78 20 | 4d 75 6c 74 69 74 61 73 |@cindex |Multitas|
|000038f0| 6b 69 6e 67 0a 0a 20 4d | 6f 73 74 20 61 75 64 69 |king.. M|ost audi|
|00003900| 6f 20 64 72 69 76 65 72 | 73 20 6e 65 65 64 20 6d |o driver|s need m|
|00003910| 75 6c 74 69 74 61 73 6b | 69 6e 67 20 74 6f 20 62 |ultitask|ing to b|
|00003920| 65 20 74 75 72 6e 65 64 | 20 6f 6e 20 74 6f 20 66 |e turned| on to f|
|00003930| 75 6e 63 74 69 6f 6e 20 | 70 72 6f 70 65 72 6c 79 |unction |properly|
|00003940| 2e 0a 44 6f 6e 27 74 20 | 74 75 72 6e 20 69 74 20 |..Don't |turn it |
|00003950| 6f 66 66 20 77 68 69 6c | 65 20 75 73 69 6e 67 20 |off whil|e using |
|00003960| 74 68 65 20 64 65 76 69 | 63 65 2e 0a 0a 0a 0a 40 |the devi|ce.....@|
|00003970| 63 20 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |c ******|********|
|00003980| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003990| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000039a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000039b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 40 63 20 2a 2a 2a |********|*.@c ***|
|000039c0| 2a 20 4f 70 65 6e 69 6e | 67 20 41 6e 64 20 43 6c |* Openin|g And Cl|
|000039d0| 6f 73 69 6e 67 20 61 68 | 69 2e 64 65 76 69 63 65 |osing ah|i.device|
|000039e0| 20 46 6f 72 20 4c 6f 77 | 2d 6c 65 76 65 6c 20 41 | For Low|-level A|
|000039f0| 63 63 65 73 73 20 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |ccess **|********|
|00003a00| 2a 2a 2a 2a 0a 40 63 20 | 2a 2a 2a 2a 2a 2a 2a 2a |****.@c |********|
|00003a10| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003a20| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003a30| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00003a40| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 0a |********|*******.|
|00003a50| 0a 40 6e 6f 64 65 20 4f | 70 65 6e 69 6e 67 20 41 |.@node O|pening A|
|00003a60| 6e 64 20 43 6c 6f 73 69 | 6e 67 20 61 68 69 2e 64 |nd Closi|ng ahi.d|
|00003a70| 65 76 69 63 65 20 46 6f | 72 20 4c 6f 77 2d 6c 65 |evice Fo|r Low-le|
|00003a80| 76 65 6c 20 41 63 63 65 | 73 73 2c 20 4f 62 74 61 |vel Acce|ss, Obta|
|00003a90| 69 6e 69 6e 67 20 54 68 | 65 20 48 61 72 64 77 61 |ining Th|e Hardwa|
|00003aa0| 72 65 2c 20 47 75 69 64 | 65 6c 69 6e 65 73 2c 20 |re, Guid|elines, |
|00003ab0| 46 75 6e 63 74 69 6f 6e | 20 49 6e 74 65 72 66 61 |Function| Interfa|
|00003ac0| 63 65 0a 40 63 6f 6d 6d | 65 6e 74 20 20 6e 6f 64 |ce.@comm|ent  nod|
|00003ad0| 65 2d 6e 61 6d 65 2c 20 | 20 6e 65 78 74 2c 20 20 |e-name, | next,  |
|00003ae0| 70 72 65 76 69 6f 75 73 | 2c 20 20 75 70 0a 40 73 |previous|,  up.@s|
|00003af0| 65 63 74 69 6f 6e 20 4f | 70 65 6e 69 6e 67 20 41 |ection O|pening A|
|00003b00| 6e 64 20 43 6c 6f 73 69 | 6e 67 20 40 63 6f 64 65 |nd Closi|ng @code|
|00003b10| 7b 61 68 69 2e 64 65 76 | 69 63 65 7d 20 46 6f 72 |{ahi.dev|ice} For|
|00003b20| 20 4c 6f 77 2d 6c 65 76 | 65 6c 20 41 63 63 65 73 | Low-lev|el Acces|
|00003b30| 73 0a 0a 0a 20 4e 6f 74 | 20 74 6f 6f 20 68 61 72 |s... Not| too har|
|00003b40| 64 2e 20 20 4a 75 73 74 | 20 6f 70 65 6e 20 40 63 |d.  Just| open @c|
|00003b50| 6f 64 65 7b 61 68 69 2e | 64 65 76 69 63 65 7d 20 |ode{ahi.|device} |
|00003b60| 75 6e 69 74 20 40 63 6f | 64 65 7b 41 48 49 5f 4e |unit @co|de{AHI_N|
|00003b70| 4f 5f 55 4e 49 54 7d 20 | 61 6e 64 0a 69 6e 69 74 |O_UNIT} |and.init|
|00003b80| 69 61 6c 69 7a 65 20 40 | 63 6f 64 65 7b 41 48 49 |ialize @|code{AHI|
|00003b90| 42 61 73 65 7d 2e 20 20 | 41 66 74 65 72 20 74 68 |Base}.  |After th|
|00003ba0| 61 74 20 79 6f 75 20 63 | 61 6e 20 61 63 63 65 73 |at you c|an acces|
|00003bb0| 73 20 61 6c 6c 20 74 68 | 65 20 66 75 6e 63 74 69 |s all th|e functi|
|00003bc0| 6f 6e 73 20 6f 66 0a 74 | 68 65 20 64 65 76 69 63 |ons of.t|he devic|
|00003bd0| 65 20 6a 75 73 74 20 61 | 73 20 69 66 20 79 6f 75 |e just a|s if you|
|00003be0| 20 68 61 64 20 6f 70 65 | 6e 65 64 20 61 20 73 74 | had ope|ned a st|
|00003bf0| 61 6e 64 61 72 64 20 73 | 68 61 72 65 64 20 6c 69 |andard s|hared li|
|00003c00| 62 72 61 72 79 2e 0a 0a | 0a 40 73 75 62 73 65 63 |brary...|.@subsec|
|00003c10| 74 69 6f 6e 20 40 63 6f | 64 65 7b 41 73 73 65 6d |tion @co|de{Assem|
|00003c20| 62 6c 65 72 7d 0a 0a 20 | 46 6f 72 20 74 68 65 20 |bler}.. |For the |
|00003c30| 61 73 73 65 6d 62 6c 65 | 72 20 70 72 6f 67 72 61 |assemble|r progra|
|00003c40| 6d 6d 65 72 20 74 68 65 | 72 65 20 61 72 65 20 74 |mmer the|re are t|
|00003c50| 77 6f 20 68 61 6e 64 79 | 20 6d 61 63 72 6f 73 3a |wo handy| macros:|
|00003c60| 20 40 63 6f 64 65 7b 4f | 50 45 4e 41 48 49 7d 0a | @code{O|PENAHI}.|
|00003c70| 61 6e 64 20 40 63 6f 64 | 65 7b 43 4c 4f 53 45 41 |and @cod|e{CLOSEA|
|00003c80| 48 49 7d 2e 20 20 48 65 | 72 65 20 69 73 20 61 20 |HI}.  He|re is a |
|00003c90| 73 6d 61 6c 6c 20 65 78 | 61 6d 70 6c 65 20 68 6f |small ex|ample ho|
|00003ca0| 77 20 74 6f 20 75 73 65 | 20 74 68 65 6d 3a 0a 0a |w to use| them:..|
|00003cb0| 40 65 78 61 6d 70 6c 65 | 0a 20 20 20 20 20 20 20 |@example|.       |
|00003cc0| 20 4f 50 45 4e 41 48 49 | 20 34 20 20 20 20 20 20 | OPENAHI| 4      |
|00003cd0| 20 20 20 20 20 20 20 20 | 20 20 20 20 3b 4f 70 65 |        |    ;Ope|
|00003ce0| 6e 20 61 74 20 6c 65 61 | 73 74 20 76 65 72 73 69 |n at lea|st versi|
|00003cf0| 6f 6e 20 34 2e 0a 20 20 | 20 20 20 20 20 20 6c 65 |on 4..  |      le|
|00003d00| 61 20 20 20 20 20 5f 41 | 48 49 42 61 73 65 28 70 |a     _A|HIBase(p|
|00003d10| 63 29 2c 61 30 0a 20 20 | 20 20 20 20 20 20 6d 6f |c),a0.  |      mo|
|00003d20| 76 65 2e 6c 20 20 64 30 | 2c 28 61 30 29 0a 20 20 |ve.l  d0|,(a0).  |
|00003d30| 20 20 20 20 20 20 62 65 | 71 20 20 20 20 20 65 72 |      be|q     er|
|00003d40| 72 6f 72 0a 0a 3b 20 41 | 48 49 27 73 20 66 75 6e |ror..; A|HI's fun|
|00003d50| 63 74 69 6f 6e 73 20 63 | 61 6e 20 6e 6f 77 20 62 |ctions c|an now b|
|00003d60| 65 20 63 61 6c 6c 65 64 | 20 61 73 20 6e 6f 72 6d |e called| as norm|
|00003d70| 61 6c 20 6c 69 62 72 61 | 72 79 20 66 75 6e 63 74 |al libra|ry funct|
|00003d80| 69 6f 6e 73 3a 0a 20 20 | 20 20 20 20 20 20 6d 6f |ions:.  |      mo|
|00003d90| 76 65 2e 6c 20 20 5f 41 | 48 49 42 61 73 65 28 70 |ve.l  _A|HIBase(p|
|00003da0| 63 29 2c 61 36 0a 20 20 | 20 20 20 20 20 20 6d 6f |c),a6.  |      mo|
|00003db0| 76 65 71 20 20 20 23 41 | 48 49 5f 49 4e 56 41 4c |veq   #A|HI_INVAL|
|00003dc0| 49 44 5f 49 44 2c 64 30 | 0a 20 20 20 20 20 20 20 |ID_ID,d0|.       |
|00003dd0| 20 6a 73 72 20 20 20 20 | 20 5f 4c 56 4f 41 48 49 | jsr    | _LVOAHI|
|00003de0| 5f 4e 65 78 74 41 75 64 | 69 6f 49 44 28 61 36 29 |_NextAud|ioID(a6)|
|00003df0| 0a 0a 65 72 72 6f 72 3a | 0a 20 20 20 20 20 20 20 |..error:|.       |
|00003e00| 20 43 4c 4f 53 45 41 48 | 49 0a 20 20 20 20 20 20 | CLOSEAH|I.      |
|00003e10| 20 20 72 74 73 0a 40 65 | 6e 64 20 65 78 61 6d 70 |  rts.@e|nd examp|
|00003e20| 6c 65 0a 0a 0a 20 4e 6f | 74 65 20 74 68 61 74 20 |le... No|te that |
|00003e30| 79 6f 75 20 40 73 74 72 | 6f 6e 67 7b 68 61 76 65 |you @str|ong{have|
|00003e40| 7d 20 74 6f 20 65 78 65 | 63 75 74 65 20 74 68 65 |} to exe|cute the|
|00003e50| 20 40 63 6f 64 65 7b 43 | 4c 4f 53 45 41 48 49 7d | @code{C|LOSEAHI}|
|00003e60| 20 6d 61 63 72 6f 20 65 | 76 65 6e 20 69 66 0a 40 | macro e|ven if.@|
|00003e70| 63 6f 64 65 7b 4f 50 45 | 4e 41 48 49 7d 20 66 61 |code{OPE|NAHI} fa|
|00003e80| 69 6c 65 64 21 0a 0a 0a | 40 73 75 62 73 65 63 74 |iled!...|@subsect|
|00003e90| 69 6f 6e 20 40 63 6f 64 | 65 7b 43 7d 0a 0a 20 46 |ion @cod|e{C}.. F|
|00003ea0| 6f 72 20 74 68 65 20 43 | 20 70 72 6f 67 72 61 6d |or the C| program|
|00003eb0| 6d 65 72 2c 20 68 65 72 | 65 20 69 73 20 68 6f 77 |mer, her|e is how|
|00003ec0| 20 69 74 20 73 68 6f 75 | 6c 64 20 62 65 20 64 6f | it shou|ld be do|
|00003ed0| 6e 65 3a 0a 0a 40 6e 6f | 69 6e 64 65 6e 74 0a 40 |ne:..@no|indent.@|
|00003ee0| 65 78 61 6d 70 6c 65 0a | 73 74 72 75 63 74 20 4c |example.|struct L|
|00003ef0| 69 62 72 61 72 79 20 20 | 20 20 2a 41 48 49 42 61 |ibrary  |  *AHIBa|
|00003f00| 73 65 3b 0a 73 74 72 75 | 63 74 20 4d 73 67 50 6f |se;.stru|ct MsgPo|
|00003f10| 72 74 20 20 20 20 2a 41 | 48 49 6d 70 3d 4e 55 4c |rt    *A|HImp=NUL|
|00003f20| 4c 3b 0a 73 74 72 75 63 | 74 20 41 48 49 52 65 71 |L;.struc|t AHIReq|
|00003f30| 75 65 73 74 20 2a 41 48 | 49 69 6f 3d 4e 55 4c 4c |uest *AH|Iio=NULL|
|00003f40| 3b 0a 42 59 54 45 20 20 | 20 20 20 20 20 20 20 20 |;.BYTE  |        |
|00003f50| 20 20 20 20 20 41 48 49 | 44 65 76 69 63 65 3d 2d |     AHI|Device=-|
|00003f60| 31 3b 0a 0a 69 66 28 41 | 48 49 6d 70 20 3d 20 43 |1;..if(A|HImp = C|
|00003f70| 72 65 61 74 65 4d 73 67 | 50 6f 72 74 28 29 29 0a |reateMsg|Port()).|
|00003f80| 40 7b 0a 20 20 69 66 28 | 41 48 49 69 6f 20 3d 20 |@{.  if(|AHIio = |
|00003f90| 28 73 74 72 75 63 74 20 | 41 48 49 52 65 71 75 65 |(struct |AHIReque|
|00003fa0| 73 74 20 2a 29 20 43 72 | 65 61 74 65 49 4f 52 65 |st *) Cr|eateIORe|
|00003fb0| 71 75 65 73 74 28 0a 20 | 20 20 20 20 20 41 48 49 |quest(. |     AHI|
|00003fc0| 6d 70 2c 20 73 69 7a 65 | 6f 66 28 73 74 72 75 63 |mp, size|of(struc|
|00003fd0| 74 20 41 48 49 52 65 71 | 75 65 73 74 29 29 29 0a |t AHIReq|uest))).|
|00003fe0| 20 20 40 7b 0a 20 20 20 | 20 41 48 49 69 6f 2d 3e |  @{.   | AHIio->|
|00003ff0| 61 68 69 72 5f 56 65 72 | 73 69 6f 6e 20 3d 20 34 |ahir_Ver|sion = 4|
|00004000| 3b 20 20 2f 2a 20 4f 70 | 65 6e 20 61 74 20 6c 65 |;  /* Op|en at le|
|00004010| 61 73 74 20 76 65 72 73 | 69 6f 6e 20 34 2e 20 2a |ast vers|ion 4. *|
|00004020| 2f 0a 20 20 20 20 69 66 | 28 21 28 41 48 49 44 65 |/.    if|(!(AHIDe|
|00004030| 76 69 63 65 20 3d 20 4f | 70 65 6e 44 65 76 69 63 |vice = O|penDevic|
|00004040| 65 28 41 48 49 4e 41 4d | 45 2c 20 41 48 49 5f 4e |e(AHINAM|E, AHI_N|
|00004050| 4f 5f 55 4e 49 54 2c 0a | 20 20 20 20 20 20 20 20 |O_UNIT,.|        |
|00004060| 28 73 74 72 75 63 74 20 | 49 4f 52 65 71 75 65 73 |(struct |IOReques|
|00004070| 74 20 2a 29 20 41 48 49 | 69 6f 2c 20 4e 55 4c 4c |t *) AHI|io, NULL|
|00004080| 29 29 29 0a 20 20 20 20 | 40 7b 0a 20 20 20 20 20 |))).    |@{.     |
|00004090| 20 41 48 49 42 61 73 65 | 20 3d 20 28 73 74 72 75 | AHIBase| = (stru|
|000040a0| 63 74 20 4c 69 62 72 61 | 72 79 20 2a 29 20 41 48 |ct Libra|ry *) AH|
|000040b0| 49 69 6f 2d 3e 61 68 69 | 72 5f 53 74 64 2e 69 6f |Iio->ahi|r_Std.io|
|000040c0| 5f 44 65 76 69 63 65 3b | 0a 0a 2f 2f 20 41 48 49 |_Device;|..// AHI|
|000040d0| 27 73 20 66 75 6e 63 74 | 69 6f 6e 73 20 63 61 6e |'s funct|ions can|
|000040e0| 20 6e 6f 77 20 62 65 20 | 63 61 6c 6c 65 64 20 61 | now be |called a|
|000040f0| 73 20 6e 6f 72 6d 61 6c | 20 6c 69 62 72 61 72 79 |s normal| library|
|00004100| 20 66 75 6e 63 74 69 6f | 6e 73 3a 0a 20 20 20 20 | functio|ns:.    |
|00004110| 20 20 41 48 49 5f 4e 65 | 78 74 41 75 64 69 6f 49 |  AHI_Ne|xtAudioI|
|00004120| 44 28 41 48 49 5f 49 4e | 56 41 4c 49 44 5f 49 44 |D(AHI_IN|VALID_ID|
|00004130| 29 3b 0a 0a 20 20 20 20 | 20 20 43 6c 6f 73 65 44 |);..    |  CloseD|
|00004140| 65 76 69 63 65 28 28 73 | 74 72 75 63 74 20 49 4f |evice((s|truct IO|
|00004150| 52 65 71 75 65 73 74 20 | 2a 29 20 41 48 49 69 6f |Request |*) AHIio|
|00004160| 29 3b 0a 20 20 20 20 20 | 20 41 48 49 44 65 76 69 |);.     | AHIDevi|
|00004170| 63 65 20 3d 20 2d 31 3b | 0a 20 20 20 20 40 7d 0a |ce = -1;|.    @}.|
|00004180| 20 20 20 20 44 65 6c 65 | 74 65 49 4f 52 65 71 75 |    Dele|teIORequ|
|00004190| 65 73 74 28 28 73 74 72 | 75 63 74 20 49 4f 52 65 |est((str|uct IORe|
|000041a0| 71 75 65 73 74 20 2a 29 | 20 41 48 49 69 6f 29 3b |quest *)| AHIio);|
|000041b0| 0a 20 20 20 20 41 48 49 | 69 6f 20 3d 20 4e 55 4c |.    AHI|io = NUL|
|000041c0| 4c 3b 0a 20 20 40 7d 0a | 20 20 44 65 6c 65 74 65 |L;.  @}.|  Delete|
|000041d0| 4d 73 67 50 6f 72 74 28 | 41 48 49 6d 70 29 3b 0a |MsgPort(|AHImp);.|
|000041e0| 20 20 41 48 49 6d 70 20 | 3d 20 4e 55 4c 4c 3b 0a |  AHImp |= NULL;.|
|000041f0| 40 7d 0a 40 65 6e 64 20 | 65 78 61 6d 70 6c 65 0a |@}.@end |example.|
|00004200| 0a 0a 0a 40 63 20 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |...@c **|********|
|00004210| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00004220| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00004230| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00004240| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 0a 40 63 |********|*****.@c|
|00004250| 20 2a 2a 2a 2a 20 4f 62 | 74 61 69 6e 69 6e 67 20 | **** Ob|taining |
|00004260| 54 68 65 20 48 61 72 64 | 77 61 72 65 20 2a 2a 2a |The Hard|ware ***|
|00004270| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00004280| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00004290| 2a 2a 2a 2a 2a 2a 2a 2a | 0a 40 63 20 2a 2a 2a 2a |********|.@c ****|
|000042a0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000042b0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000042c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000042d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000042e0| 2a 2a 2a 0a 0a 40 6e 6f | 64 65 20 4f 62 74 61 69 |***..@no|de Obtai|
|000042f0| 6e 69 6e 67 20 54 68 65 | 20 48 61 72 64 77 61 72 |ning The| Hardwar|
|00004300| 65 2c 20 44 65 63 6c 61 | 72 69 6e 67 20 53 6f 75 |e, Decla|ring Sou|
|00004310| 6e 64 73 2c 20 4f 70 65 | 6e 69 6e 67 20 41 6e 64 |nds, Ope|ning And|
|00004320| 20 43 6c 6f 73 69 6e 67 | 20 61 68 69 2e 64 65 76 | Closing| ahi.dev|
|00004330| 69 63 65 20 46 6f 72 20 | 4c 6f 77 2d 6c 65 76 65 |ice For |Low-leve|
|00004340| 6c 20 41 63 63 65 73 73 | 2c 20 46 75 6e 63 74 69 |l Access|, Functi|
|00004350| 6f 6e 20 49 6e 74 65 72 | 66 61 63 65 0a 40 63 6f |on Inter|face.@co|
|00004360| 6d 6d 65 6e 74 20 20 6e | 6f 64 65 2d 6e 61 6d 65 |mment  n|ode-name|
|00004370| 2c 20 20 6e 65 78 74 2c | 20 20 70 72 65 76 69 6f |,  next,|  previo|
|00004380| 75 73 2c 20 20 75 70 0a | 40 73 65 63 74 69 6f 6e |us,  up.|@section|
|00004390| 20 4f 62 74 61 69 6e 69 | 6e 67 20 54 68 65 20 48 | Obtaini|ng The H|
|000043a0| 61 72 64 77 61 72 65 0a | 0a 20 49 66 20 79 6f 75 |ardware.|. If you|
|000043b0| 20 77 69 73 68 20 74 6f | 20 63 61 6c 6c 20 61 6e | wish to| call an|
|000043c0| 79 20 6f 74 68 65 72 20 | 66 75 6e 63 74 69 6f 6e |y other |function|
|000043d0| 20 74 68 61 6e 0a 0a 40 | 69 74 65 6d 69 7a 65 20 | than..@|itemize |
|000043e0| 40 62 75 6c 6c 65 74 0a | 0a 40 69 74 65 6d 0a 40 |@bullet.|.@item.@|
|000043f0| 63 6f 64 65 7b 41 48 49 | 5f 41 6c 6c 6f 63 41 75 |code{AHI|_AllocAu|
|00004400| 64 69 6f 52 65 71 75 65 | 73 74 41 28 29 7d 0a 0a |dioReque|stA()}..|
|00004410| 40 69 74 65 6d 0a 40 63 | 6f 64 65 7b 41 48 49 5f |@item.@c|ode{AHI_|
|00004420| 41 75 64 69 6f 52 65 71 | 75 65 73 74 41 28 29 7d |AudioReq|uestA()}|
|00004430| 0a 0a 40 69 74 65 6d 0a | 40 63 6f 64 65 7b 41 48 |..@item.|@code{AH|
|00004440| 49 5f 42 65 73 74 41 75 | 64 69 6f 49 44 41 28 29 |I_BestAu|dioIDA()|
|00004450| 7d 0a 0a 40 69 74 65 6d | 0a 40 63 6f 64 65 7b 41 |}..@item|.@code{A|
|00004460| 48 49 5f 46 72 65 65 41 | 75 64 69 6f 52 65 71 75 |HI_FreeA|udioRequ|
|00004470| 65 73 74 28 29 7d 0a 0a | 40 69 74 65 6d 0a 40 63 |est()}..|@item.@c|
|00004480| 6f 64 65 7b 41 48 49 5f | 47 65 74 41 75 64 69 6f |ode{AHI_|GetAudio|
|00004490| 41 74 74 72 73 41 28 29 | 7d 0a 0a 40 69 74 65 6d |AttrsA()|}..@item|
|000044a0| 0a 40 63 6f 64 65 7b 41 | 48 49 5f 4e 65 78 74 41 |.@code{A|HI_NextA|
|000044b0| 75 64 69 6f 49 44 28 29 | 7d 0a 0a 40 69 74 65 6d |udioID()|}..@item|
|000044c0| 0a 40 63 6f 64 65 7b 41 | 48 49 5f 53 61 6d 70 6c |.@code{A|HI_Sampl|
|000044d0| 65 46 72 61 6d 65 53 69 | 7a 65 28 29 7d 0a 0a 40 |eFrameSi|ze()}..@|
|000044e0| 65 6e 64 20 69 74 65 6d | 69 7a 65 0a 0a 40 66 69 |end item|ize..@fi|
|000044f0| 6e 64 65 78 20 41 48 49 | 5f 41 6c 6c 6f 63 41 75 |ndex AHI|_AllocAu|
|00004500| 64 69 6f 41 28 29 0a 40 | 74 69 6e 64 65 78 20 41 |dioA().@|tindex A|
|00004510| 48 49 41 75 64 69 6f 43 | 74 72 6c 0a 40 76 69 6e |HIAudioC|trl.@vin|
|00004520| 64 65 78 20 61 68 69 61 | 63 5f 55 73 65 72 44 61 |dex ahia|c_UserDa|
|00004530| 74 61 0a 0a 40 64 6f 74 | 73 7b 7d 79 6f 75 20 68 |ta..@dot|s{}you h|
|00004540| 61 76 65 20 74 6f 20 61 | 6c 6c 6f 63 61 74 65 20 |ave to a|llocate |
|00004550| 74 68 65 20 61 63 74 75 | 61 6c 20 73 6f 75 6e 64 |the actu|al sound|
|00004560| 20 68 61 72 64 77 61 72 | 65 2e 20 20 54 68 69 73 | hardwar|e.  This|
|00004570| 20 69 73 20 64 6f 6e 65 | 20 77 69 74 68 0a 40 63 | is done| with.@c|
|00004580| 6f 64 65 7b 41 48 49 5f | 41 6c 6c 6f 63 41 75 64 |ode{AHI_|AllocAud|
|00004590| 69 6f 41 28 29 7d 2e 20 | 20 40 63 6f 64 65 7b 41 |ioA()}. | @code{A|
|000045a0| 48 49 5f 41 6c 6c 6f 63 | 41 75 64 69 6f 41 28 29 |HI_Alloc|AudioA()|
|000045b0| 7d 20 72 65 74 75 72 6e | 73 20 61 6e 0a 40 63 6f |} return|s an.@co|
|000045c0| 64 65 7b 41 48 49 41 75 | 64 69 6f 43 74 72 6c 7d |de{AHIAu|dioCtrl}|
|000045d0| 20 73 74 72 75 63 74 75 | 72 65 2c 20 6f 72 20 40 | structu|re, or @|
|000045e0| 63 6f 64 65 7b 4e 55 4c | 4c 7d 20 69 66 20 74 68 |code{NUL|L} if th|
|000045f0| 65 20 68 61 72 64 77 61 | 72 65 20 63 6f 75 6c 64 |e hardwa|re could|
|00004600| 20 6e 6f 74 20 62 65 0a | 61 6c 6c 6f 63 61 74 65 | not be.|allocate|
|00004610| 64 2e 20 20 54 68 65 20 | 40 63 6f 64 65 7b 41 48 |d.  The |@code{AH|
|00004620| 49 41 75 64 69 6f 43 74 | 72 6c 7d 20 73 74 72 75 |IAudioCt|rl} stru|
|00004630| 63 74 75 72 65 20 68 61 | 73 20 6f 6e 6c 79 20 6f |cture ha|s only o|
|00004640| 6e 65 20 70 75 62 6c 69 | 63 20 66 69 65 6c 64 2c |ne publi|c field,|
|00004650| 0a 40 63 6f 64 65 7b 61 | 68 69 61 63 5f 55 73 65 |.@code{a|hiac_Use|
|00004660| 72 44 61 74 61 7d 2e 20 | 20 54 68 69 73 20 69 73 |rData}. | This is|
|00004670| 20 75 6e 75 73 65 64 20 | 62 79 20 40 73 63 7b 41 | unused |by @sc{A|
|00004680| 68 69 7d 20 61 6e 64 20 | 79 6f 75 20 6d 61 79 20 |hi} and |you may |
|00004690| 73 74 6f 72 65 0a 61 6e | 79 74 68 69 6e 67 20 79 |store.an|ything y|
|000046a0| 6f 75 20 6c 69 6b 65 20 | 68 65 72 65 2e 0a 0a 20 |ou like |here... |
|000046b0| 49 66 20 40 63 6f 64 65 | 7b 41 48 49 5f 41 6c 6c |If @code|{AHI_All|
|000046c0| 6f 63 41 75 64 69 6f 41 | 28 29 7d 20 66 61 69 6c |ocAudioA|()} fail|
|000046d0| 73 20 69 74 20 69 73 20 | 69 6d 70 6f 72 74 61 6e |s it is |importan|
|000046e0| 74 20 74 68 61 74 20 79 | 6f 75 20 68 61 6e 64 6c |t that y|ou handl|
|000046f0| 65 20 74 68 65 0a 73 69 | 74 75 61 74 69 6f 6e 20 |e the.si|tuation |
|00004700| 67 72 61 63 65 66 75 6c | 6c 79 2e 0a 0a 40 66 69 |graceful|ly...@fi|
|00004710| 6e 64 65 78 20 41 48 49 | 5f 46 72 65 65 41 75 64 |ndex AHI|_FreeAud|
|00004720| 69 6f 28 29 0a 0a 20 57 | 68 65 6e 20 79 6f 75 20 |io().. W|hen you |
|00004730| 61 72 65 20 66 69 6e 69 | 73 68 65 64 20 70 6c 61 |are fini|shed pla|
|00004740| 79 69 6e 67 20 6f 72 20 | 72 65 63 6f 72 64 69 6e |ying or |recordin|
|00004750| 67 2c 20 63 61 6c 6c 20 | 40 63 6f 64 65 7b 41 48 |g, call |@code{AH|
|00004760| 49 5f 46 72 65 65 41 75 | 64 69 6f 28 29 7d 20 74 |I_FreeAu|dio()} t|
|00004770| 6f 0a 64 65 61 6c 6c 6f | 63 61 74 65 20 74 68 65 |o.deallo|cate the|
|00004780| 20 68 61 72 64 77 61 72 | 65 20 61 6e 64 20 6f 74 | hardwar|e and ot|
|00004790| 68 65 72 20 72 65 73 6f | 75 72 63 65 73 20 61 6c |her reso|urces al|
|000047a0| 6c 6f 63 61 74 65 64 20 | 62 79 0a 40 63 6f 64 65 |located |by.@code|
|000047b0| 7b 41 48 49 5f 41 6c 6c | 6f 63 41 75 64 69 6f 41 |{AHI_All|ocAudioA|
|000047c0| 28 29 7d 2e 20 20 40 63 | 6f 64 65 7b 41 48 49 5f |()}.  @c|ode{AHI_|
|000047d0| 46 72 65 65 41 75 64 69 | 6f 28 29 7d 20 61 6c 73 |FreeAudi|o()} als|
|000047e0| 6f 20 64 65 61 6c 6c 6f | 63 61 74 65 73 20 61 6c |o deallo|cates al|
|000047f0| 6c 0a 6c 6f 61 64 65 64 | 20 73 6f 75 6e 64 73 20 |l.loaded| sounds |
|00004800| 28 40 70 78 72 65 66 7b | 44 65 63 6c 61 72 69 6e |(@pxref{|Declarin|
|00004810| 67 20 53 6f 75 6e 64 73 | 7d 29 2e 0a 0a 0a 40 73 |g Sounds|})....@s|
|00004820| 75 62 73 65 63 74 69 6f | 6e 20 40 63 6f 64 65 7b |ubsectio|n @code{|
|00004830| 41 48 49 5f 41 6c 6c 6f | 63 41 75 64 69 6f 41 28 |AHI_Allo|cAudioA(|
|00004840| 29 7d 20 54 61 67 73 0a | 0a 40 63 6f 64 65 7b 41 |)} Tags.|.@code{A|
|00004850| 48 49 5f 41 6c 6c 6f 63 | 41 75 64 69 6f 41 28 29 |HI_Alloc|AudioA()|
|00004860| 7d 20 74 61 6b 65 73 20 | 73 65 76 65 72 61 6c 20 |} takes |several |
|00004870| 74 61 67 73 20 61 73 20 | 69 6e 70 75 74 2e 0a 0a |tags as |input...|
|00004880| 40 76 74 61 62 6c 65 20 | 40 63 6f 64 65 0a 0a 40 |@vtable |@code..@|
|00004890| 76 69 6e 64 65 78 20 41 | 48 49 5f 44 45 46 41 55 |vindex A|HI_DEFAU|
|000048a0| 4c 54 5f 49 44 0a 0a 40 | 69 74 65 6d 20 41 48 49 |LT_ID..@|item AHI|
|000048b0| 41 5f 41 75 64 69 6f 49 | 44 0a 54 68 69 73 20 69 |A_AudioI|D.This i|
|000048c0| 73 20 74 68 65 20 61 75 | 64 69 6f 20 6d 6f 64 65 |s the au|dio mode|
|000048d0| 20 74 6f 20 62 65 20 75 | 73 65 64 2e 20 20 59 6f | to be u|sed.  Yo|
|000048e0| 75 20 6d 75 73 74 20 6e | 6f 74 20 75 73 65 20 61 |u must n|ot use a|
|000048f0| 6e 79 20 68 61 72 64 63 | 6f 64 65 64 20 76 61 6c |ny hardc|oded val|
|00004900| 75 65 73 0a 6f 74 68 65 | 72 20 74 68 61 6e 20 40 |ues.othe|r than @|
|00004910| 63 6f 64 65 7b 41 48 49 | 5f 44 45 46 41 55 4c 54 |code{AHI|_DEFAULT|
|00004920| 5f 49 44 7d 2c 20 77 68 | 69 63 68 20 69 73 20 74 |_ID}, wh|ich is t|
|00004930| 68 65 20 75 73 65 72 27 | 73 20 64 65 66 61 75 6c |he user'|s defaul|
|00004940| 74 20 66 61 6c 6c 62 61 | 63 6b 20 49 44 2e 0a 49 |t fallba|ck ID..I|
|00004950| 6e 20 6d 6f 73 74 20 63 | 61 73 65 73 20 79 6f 75 |n most c|ases you|
|00004960| 20 73 68 6f 75 6c 64 20 | 61 73 6b 20 74 68 65 20 | should |ask the |
|00004970| 75 73 65 72 20 66 6f 72 | 20 61 6e 20 49 44 20 63 |user for| an ID c|
|00004980| 6f 64 65 20 28 77 69 74 | 68 0a 40 63 6f 64 65 7b |ode (wit|h.@code{|
|00004990| 41 48 49 5f 41 75 64 69 | 6f 52 65 71 75 65 73 74 |AHI_Audi|oRequest|
|000049a0| 41 28 29 7d 29 20 61 6e | 64 20 74 68 65 6e 20 73 |A()}) an|d then s|
|000049b0| 74 6f 72 65 20 74 68 65 | 20 76 61 6c 75 65 20 69 |tore the| value i|
|000049c0| 6e 20 79 6f 75 72 20 73 | 65 74 74 69 6e 67 73 20 |n your s|ettings |
|000049d0| 66 69 6c 65 2e 0a 0a 40 | 76 69 6e 64 65 78 20 41 |file...@|vindex A|
|000049e0| 48 49 5f 44 45 46 41 55 | 4c 54 5f 46 52 45 51 0a |HI_DEFAU|LT_FREQ.|
|000049f0| 0a 40 69 74 65 6d 20 41 | 48 49 41 5f 4d 69 78 46 |.@item A|HIA_MixF|
|00004a00| 72 65 71 0a 54 68 69 73 | 20 69 73 20 74 68 65 20 |req.This| is the |
|00004a10| 6d 69 78 69 6e 67 20 66 | 72 65 71 75 65 6e 63 79 |mixing f|requency|
|00004a20| 20 74 6f 20 62 65 20 75 | 73 65 64 2e 20 20 54 68 | to be u|sed.  Th|
|00004a30| 65 20 61 63 74 75 61 6c | 20 66 72 65 71 75 65 6e |e actual| frequen|
|00004a40| 63 79 20 77 69 6c 6c 20 | 62 65 0a 72 6f 75 6e 64 |cy will |be.round|
|00004a50| 65 64 20 74 6f 20 74 68 | 65 20 6e 65 61 72 65 73 |ed to th|e neares|
|00004a60| 74 20 66 72 65 71 75 65 | 6e 63 79 20 73 75 70 70 |t freque|ncy supp|
|00004a70| 6f 72 74 65 64 20 62 79 | 20 74 68 65 20 73 6f 75 |orted by| the sou|
|00004a80| 6e 64 20 68 61 72 64 77 | 61 72 65 2e 20 20 54 6f |nd hardw|are.  To|
|00004a90| 20 66 69 6e 64 0a 74 68 | 65 20 61 63 74 75 61 6c | find.th|e actual|
|00004aa0| 20 66 72 65 71 75 65 6e | 63 79 2c 20 75 73 65 20 | frequen|cy, use |
|00004ab0| 40 63 6f 64 65 7b 41 48 | 49 5f 47 65 74 41 75 64 |@code{AH|I_GetAud|
|00004ac0| 69 6f 41 74 74 72 73 41 | 28 29 7d 2e 20 20 49 66 |ioAttrsA|()}.  If|
|00004ad0| 20 6f 6d 69 74 74 65 64 | 20 6f 72 0a 40 63 6f 64 | omitted| or.@cod|
|00004ae0| 65 7b 41 48 49 5f 44 45 | 46 41 55 4c 54 5f 46 52 |e{AHI_DE|FAULT_FR|
|00004af0| 45 51 7d 2c 20 74 68 65 | 20 75 73 65 72 27 73 20 |EQ}, the| user's |
|00004b00| 70 72 65 66 65 72 72 65 | 64 20 66 61 6c 6c 62 61 |preferre|d fallba|
|00004b10| 63 6b 20 66 72 65 71 75 | 65 6e 63 79 20 77 69 6c |ck frequ|ency wil|
|00004b20| 6c 20 62 65 0a 75 73 65 | 64 2e 20 20 49 6e 20 6d |l be.use|d.  In m|
|00004b30| 6f 73 74 20 63 61 73 65 | 73 20 79 6f 75 20 73 68 |ost case|s you sh|
|00004b40| 6f 75 6c 64 20 61 73 6b | 20 74 68 65 20 75 73 65 |ould ask| the use|
|00004b50| 72 20 66 6f 72 20 61 20 | 66 72 65 71 75 65 6e 63 |r for a |frequenc|
|00004b60| 79 20 28 77 69 74 68 0a | 40 63 6f 64 65 7b 41 48 |y (with.|@code{AH|
|00004b70| 49 5f 41 75 64 69 6f 52 | 65 71 75 65 73 74 41 28 |I_AudioR|equestA(|
|00004b80| 29 7d 29 20 61 6e 64 20 | 74 68 65 6e 20 73 74 6f |)}) and |then sto|
|00004b90| 72 65 20 74 68 65 20 76 | 61 6c 75 65 20 69 6e 20 |re the v|alue in |
|00004ba0| 79 6f 75 72 20 73 65 74 | 74 69 6e 67 73 20 66 69 |your set|tings fi|
|00004bb0| 6c 65 2e 0a 0a 40 69 74 | 65 6d 20 41 48 49 41 5f |le...@it|em AHIA_|
|00004bc0| 43 68 61 6e 6e 65 6c 73 | 0a 41 6c 6c 20 73 6f 75 |Channels|.All sou|
|00004bd0| 6e 64 73 20 61 72 65 20 | 70 6c 61 79 65 64 20 6f |nds are |played o|
|00004be0| 6e 20 61 20 40 64 66 6e | 7b 63 68 61 6e 6e 65 6c |n a @dfn|{channel|
|00004bf0| 7d 2c 20 61 6e 64 20 74 | 68 69 73 20 74 61 67 20 |}, and t|his tag |
|00004c00| 73 65 6c 65 63 74 73 20 | 68 6f 77 20 6d 61 6e 79 |selects |how many|
|00004c10| 20 79 6f 75 0a 77 69 73 | 68 20 74 6f 20 75 73 65 | you.wis|h to use|
|00004c20| 2e 20 20 49 6e 20 67 65 | 6e 65 72 61 6c 20 69 74 |.  In ge|neral it|
|00004c30| 20 74 61 6b 65 73 20 6d | 6f 72 65 20 43 50 55 20 | takes m|ore CPU |
|00004c40| 70 6f 77 65 72 20 74 68 | 65 20 6d 6f 72 65 20 63 |power th|e more c|
|00004c50| 68 61 6e 6e 65 6c 73 20 | 79 6f 75 20 75 73 65 0a |hannels |you use.|
|00004c60| 61 6e 64 20 74 68 65 20 | 76 6f 6c 75 6d 65 20 67 |and the |volume g|
|00004c70| 65 74 73 20 6c 6f 77 65 | 72 20 61 6e 64 20 6c 6f |ets lowe|r and lo|
|00004c80| 77 65 72 2e 0a 0a 40 69 | 74 65 6d 20 41 48 49 41 |wer...@i|tem AHIA|
|00004c90| 5f 53 6f 75 6e 64 73 0a | 59 6f 75 20 6d 75 73 74 |_Sounds.|You must|
|00004ca0| 20 74 65 6c 6c 20 40 73 | 63 7b 41 68 69 7d 20 68 | tell @s|c{Ahi} h|
|00004cb0| 6f 77 20 6d 61 6e 79 20 | 64 69 66 66 65 72 65 6e |ow many |differen|
|00004cc0| 74 20 73 6f 75 6e 64 73 | 20 79 6f 75 20 61 72 65 |t sounds| you are|
|00004cd0| 20 67 6f 69 6e 67 20 74 | 6f 20 70 6c 61 79 2e 0a | going t|o play..|
|00004ce0| 40 78 72 65 66 7b 44 65 | 63 6c 61 72 69 6e 67 20 |@xref{De|claring |
|00004cf0| 53 6f 75 6e 64 73 7d 20 | 66 6f 72 20 6d 6f 72 65 |Sounds} |for more|
|00004d00| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 2e 0a 0a 40 | informa|tion...@|
|00004d10| 74 69 6e 64 65 78 20 41 | 48 49 53 6f 75 6e 64 4d |tindex A|HISoundM|
|00004d20| 65 73 73 61 67 65 0a 40 | 76 69 6e 64 65 78 20 61 |essage.@|vindex a|
|00004d30| 68 69 73 6d 5f 43 68 61 | 6e 6e 65 6c 0a 0a 40 69 |hism_Cha|nnel..@i|
|00004d40| 74 65 6d 20 41 48 49 41 | 5f 53 6f 75 6e 64 46 75 |tem AHIA|_SoundFu|
|00004d50| 6e 63 0a 57 69 74 68 20 | 74 68 69 73 20 74 61 67 |nc.With |this tag|
|00004d60| 20 79 6f 75 20 74 65 6c | 6c 20 40 73 63 7b 41 68 | you tel|l @sc{Ah|
|00004d70| 69 7d 20 74 6f 20 63 61 | 6c 6c 20 61 20 68 6f 6f |i} to ca|ll a hoo|
|00004d80| 6b 20 77 68 65 6e 20 61 | 20 73 6f 75 6e 64 20 68 |k when a| sound h|
|00004d90| 61 73 20 62 65 65 6e 0a | 73 74 61 72 74 65 64 2e |as been.|started.|
|00004da0| 20 20 49 74 20 77 6f 72 | 6b 73 20 6a 75 73 74 20 |  It wor|ks just |
|00004db0| 6c 69 6b 65 20 50 61 75 | 6c 61 27 73 20 61 75 64 |like Pau|la's aud|
|00004dc0| 69 6f 20 69 6e 74 65 72 | 72 75 70 74 73 2e 20 20 |io inter|rupts.  |
|00004dd0| 54 68 65 20 68 6f 6f 6b | 20 72 65 63 65 69 76 65 |The hook| receive|
|00004de0| 73 20 61 6e 0a 40 63 6f | 64 65 7b 41 48 49 53 6f |s an.@co|de{AHISo|
|00004df0| 75 6e 64 4d 65 73 73 61 | 67 65 7d 20 73 74 72 75 |undMessa|ge} stru|
|00004e00| 63 74 75 72 65 20 61 73 | 20 6d 65 73 73 61 67 65 |cture as| message|
|00004e10| 2e 0a 40 63 6f 64 65 7b | 41 48 49 53 6f 75 6e 64 |..@code{|AHISound|
|00004e20| 4d 65 73 73 61 67 65 2d | 3e 61 68 69 73 6d 5f 43 |Message-|>ahism_C|
|00004e30| 68 61 6e 6e 65 6c 7d 20 | 69 6e 64 69 63 61 74 65 |hannel} |indicate|
|00004e40| 73 20 77 68 69 63 68 20 | 63 68 61 6e 6e 65 6c 20 |s which |channel |
|00004e50| 74 68 65 20 73 6f 75 6e | 64 0a 74 68 61 74 20 63 |the soun|d.that c|
|00004e60| 61 75 73 65 64 20 74 68 | 65 20 68 6f 6f 6b 20 74 |aused th|e hook t|
|00004e70| 6f 20 62 65 20 63 61 6c | 6c 65 64 20 69 73 20 70 |o be cal|led is p|
|00004e80| 6c 61 79 65 64 20 6f 6e | 2e 0a 0a 40 69 74 65 6d |layed on|...@item|
|00004e90| 20 41 48 49 41 5f 50 6c | 61 79 65 72 46 75 6e 63 | AHIA_Pl|ayerFunc|
|00004ea0| 0a 49 66 20 79 6f 75 20 | 61 72 65 20 67 6f 69 6e |.If you |are goin|
|00004eb0| 67 20 74 6f 20 70 6c 61 | 79 20 61 20 6d 75 73 69 |g to pla|y a musi|
|00004ec0| 63 61 6c 20 73 63 6f 72 | 65 2c 20 79 6f 75 20 73 |cal scor|e, you s|
|00004ed0| 68 6f 75 6c 64 20 75 73 | 65 20 74 68 69 73 20 60 |hould us|e this `|
|00004ee0| 60 69 6e 74 65 72 72 75 | 70 74 27 27 0a 73 6f 75 |`interru|pt''.sou|
|00004ef0| 72 63 65 20 69 6e 73 74 | 65 61 64 20 6f 66 20 56 |rce inst|ead of V|
|00004f00| 42 4c 41 4e 4b 20 6f 72 | 20 43 49 41 20 74 69 6d |BLANK or| CIA tim|
|00004f10| 65 72 73 20 69 6e 20 6f | 72 64 65 72 20 74 6f 20 |ers in o|rder to |
|00004f20| 67 65 74 20 74 68 65 20 | 62 65 73 74 20 72 65 73 |get the |best res|
|00004f30| 75 6c 74 20 77 69 74 68 | 0a 61 6c 6c 20 61 75 64 |ult with|.all aud|
|00004f40| 69 6f 20 64 72 69 76 65 | 72 73 2e 20 20 49 66 20 |io drive|rs.  If |
|00004f50| 79 6f 75 20 63 61 6e 6e | 6f 74 20 75 73 65 20 74 |you cann|ot use t|
|00004f60| 68 69 73 2c 20 79 6f 75 | 20 6d 75 73 74 20 6e 6f |his, you| must no|
|00004f70| 74 20 75 73 65 20 61 6e | 79 0a 60 60 6e 6f 6e 2d |t use an|y.``non-|
|00004f80| 72 65 61 6c 74 69 6d 65 | 27 27 20 6d 6f 64 65 73 |realtime|'' modes|
|00004f90| 20 28 73 65 65 20 40 63 | 6f 64 65 7b 41 48 49 5f | (see @c|ode{AHI_|
|00004fa0| 47 65 74 41 75 64 69 6f | 41 74 74 72 73 41 28 29 |GetAudio|AttrsA()|
|00004fb0| 7d 20 69 6e 20 74 68 65 | 20 61 75 74 6f 64 6f 63 |} in the| autodoc|
|00004fc0| 73 2c 0a 74 68 65 20 40 | 63 6f 64 65 7b 41 48 49 |s,.the @|code{AHI|
|00004fd0| 44 42 5f 52 65 61 6c 74 | 69 6d 65 7d 20 74 61 67 |DB_Realt|ime} tag|
|00004fe0| 29 2e 0a 0a 40 69 74 65 | 6d 20 41 48 49 41 5f 50 |)...@ite|m AHIA_P|
|00004ff0| 6c 61 79 65 72 46 72 65 | 71 0a 49 66 20 6e 6f 6e |layerFre|q.If non|
|00005000| 2d 7a 65 72 6f 2c 20 69 | 74 20 65 6e 61 62 6c 65 |-zero, i|t enable|
|00005010| 73 20 74 69 6d 69 6e 67 | 20 61 6e 64 20 73 70 65 |s timing| and spe|
|00005020| 63 69 66 69 65 73 20 68 | 6f 77 20 6d 61 6e 79 20 |cifies h|ow many |
|00005030| 74 69 6d 65 73 20 70 65 | 72 20 73 65 63 6f 6e 64 |times pe|r second|
|00005040| 0a 40 63 6f 64 65 7b 50 | 6c 61 79 65 72 46 75 6e |.@code{P|layerFun|
|00005050| 63 7d 20 77 69 6c 6c 20 | 62 65 20 63 61 6c 6c 65 |c} will |be calle|
|00005060| 64 2e 20 20 54 68 69 73 | 20 6d 75 73 74 20 62 65 |d.  This| must be|
|00005070| 20 73 70 65 63 69 66 69 | 65 64 20 69 66 0a 40 63 | specifi|ed if.@c|
|00005080| 6f 64 65 7b 41 48 49 41 | 5f 50 6c 61 79 65 72 46 |ode{AHIA|_PlayerF|
|00005090| 75 6e 63 7d 20 69 73 21 | 20 20 49 74 20 69 73 20 |unc} is!|  It is |
|000050a0| 73 75 67 67 65 73 74 65 | 64 20 74 68 61 74 20 79 |suggeste|d that y|
|000050b0| 6f 75 20 6b 65 65 70 20 | 74 68 65 20 66 72 65 71 |ou keep |the freq|
|000050c0| 75 65 6e 63 79 0a 62 65 | 6c 6f 77 20 31 30 30 2d |uency.be|low 100-|
|000050d0| 32 30 30 20 48 7a 2e 20 | 20 53 69 6e 63 65 20 74 |200 Hz. | Since t|
|000050e0| 68 65 20 66 72 65 71 75 | 65 6e 63 79 20 69 73 20 |he frequ|ency is |
|000050f0| 61 20 66 69 78 70 6f 69 | 6e 74 20 6e 75 6d 62 65 |a fixpoi|nt numbe|
|00005100| 72 0a 40 63 6f 64 65 7b | 41 48 49 41 5f 50 6c 61 |r.@code{|AHIA_Pla|
|00005110| 79 65 72 46 72 65 71 7d | 20 73 68 6f 75 6c 64 20 |yerFreq}| should |
|00005120| 62 65 20 6c 65 73 73 20 | 74 68 61 6e 20 31 33 31 |be less |than 131|
|00005130| 30 37 32 30 30 20 28 74 | 68 61 74 27 73 20 32 30 |07200 (t|hat's 20|
|00005140| 30 20 48 7a 29 2e 0a 0a | 40 69 74 65 6d 20 41 48 |0 Hz)...|@item AH|
|00005150| 49 41 5f 4d 69 6e 50 6c | 61 79 65 72 46 72 65 71 |IA_MinPl|ayerFreq|
|00005160| 0a 54 68 65 20 6d 69 6e | 69 6d 75 6d 20 66 72 65 |.The min|imum fre|
|00005170| 71 75 65 6e 63 79 20 28 | 40 63 6f 64 65 7b 41 48 |quency (|@code{AH|
|00005180| 49 41 5f 50 6c 61 79 65 | 72 46 72 65 71 7d 29 20 |IA_Playe|rFreq}) |
|00005190| 79 6f 75 20 77 69 6c 6c | 20 75 73 65 2e 20 20 59 |you will| use.  Y|
|000051a0| 6f 75 20 73 68 6f 75 6c | 64 0a 61 6c 77 61 79 73 |ou shoul|d.always|
|000051b0| 20 73 75 70 70 6c 79 20 | 74 68 69 73 20 69 66 20 | supply |this if |
|000051c0| 79 6f 75 20 61 72 65 20 | 75 73 69 6e 67 20 74 68 |you are |using th|
|000051d0| 65 20 64 65 76 69 63 65 | 27 73 20 69 6e 74 65 72 |e device|'s inter|
|000051e0| 72 75 70 74 20 66 65 61 | 74 75 72 65 21 0a 0a 40 |rupt fea|ture!..@|
|000051f0| 69 74 65 6d 20 41 48 49 | 41 5f 4d 61 78 50 6c 61 |item AHI|A_MaxPla|
|00005200| 79 65 72 46 72 65 71 0a | 54 68 65 20 6d 61 78 69 |yerFreq.|The maxi|
|00005210| 6d 75 6d 20 66 72 65 71 | 75 65 6e 63 79 20 28 40 |mum freq|uency (@|
|00005220| 63 6f 64 65 7b 41 48 49 | 41 5f 50 6c 61 79 65 72 |code{AHI|A_Player|
|00005230| 46 72 65 71 7d 29 20 79 | 6f 75 20 77 69 6c 6c 20 |Freq}) y|ou will |
|00005240| 75 73 65 2e 20 20 59 6f | 75 20 73 68 6f 75 6c 64 |use.  Yo|u should|
|00005250| 0a 61 6c 77 61 79 73 20 | 73 75 70 70 6c 79 20 74 |.always |supply t|
|00005260| 68 69 73 20 69 66 20 79 | 6f 75 20 61 72 65 20 75 |his if y|ou are u|
|00005270| 73 69 6e 67 20 74 68 65 | 20 64 65 76 69 63 65 27 |sing the| device'|
|00005280| 73 20 69 6e 74 65 72 72 | 75 70 74 20 66 65 61 74 |s interr|upt feat|
|00005290| 75 72 65 21 0a 0a 40 69 | 74 65 6d 20 41 48 49 41 |ure!..@i|tem AHIA|
|000052a0| 5f 52 65 63 6f 72 64 46 | 75 6e 63 0a 54 68 69 73 |_RecordF|unc.This|
|000052b0| 20 68 6f 6f 6b 20 77 69 | 6c 6c 20 62 65 20 63 61 | hook wi|ll be ca|
|000052c0| 6c 6c 65 64 20 72 65 67 | 75 6c 61 72 6c 79 20 77 |lled reg|ularly w|
|000052d0| 68 65 6e 20 73 61 6d 70 | 6c 69 6e 67 20 69 73 20 |hen samp|ling is |
|000052e0| 74 75 72 6e 65 64 20 6f | 6e 20 28 73 65 65 0a 40 |turned o|n (see.@|
|000052f0| 63 6f 64 65 7b 41 48 49 | 5f 43 6f 6e 74 72 6f 6c |code{AHI|_Control|
|00005300| 41 75 64 69 6f 41 28 29 | 7d 29 2e 20 20 49 74 20 |AudioA()|}).  It |
|00005310| 69 73 20 69 6d 70 6f 72 | 74 61 6e 74 20 74 68 61 |is impor|tant tha|
|00005320| 74 20 79 6f 75 20 61 6c | 77 61 79 73 20 63 68 65 |t you al|ways che|
|00005330| 63 6b 20 74 68 65 0a 66 | 6f 72 6d 61 74 20 6f 66 |ck the.f|ormat of|
|00005340| 20 74 68 65 20 73 61 6d | 70 6c 65 64 20 64 61 74 | the sam|pled dat|
|00005350| 61 2c 20 61 6e 64 20 69 | 67 6e 6f 72 65 20 69 74 |a, and i|gnore it|
|00005360| 20 69 66 20 79 6f 75 20 | 63 61 6e 27 74 20 70 61 | if you |can't pa|
|00005370| 72 73 65 20 69 74 2e 20 | 20 53 69 6e 63 65 0a 74 |rse it. | Since.t|
|00005380| 68 69 73 20 68 6f 6f 6b | 20 6d 61 79 20 62 65 20 |his hook| may be |
|00005390| 63 61 6c 6c 65 64 20 66 | 72 6f 6d 20 61 6e 20 69 |called f|rom an i|
|000053a0| 6e 74 65 72 72 75 70 74 | 2c 20 69 74 20 69 73 20 |nterrupt|, it is |
|000053b0| 6e 6f 74 20 6c 65 67 61 | 6c 20 74 6f 20 64 69 72 |not lega|l to dir|
|000053c0| 65 63 74 6c 79 0a 40 63 | 6f 64 65 7b 57 72 69 74 |ectly.@c|ode{Writ|
|000053d0| 65 28 29 7d 20 74 68 65 | 20 62 75 66 66 65 72 20 |e()} the| buffer |
|000053e0| 74 6f 20 64 69 73 6b 2e | 20 20 54 6f 20 72 65 63 |to disk.|  To rec|
|000053f0| 6f 72 64 20 64 69 72 65 | 63 74 6c 79 20 74 6f 20 |ord dire|ctly to |
|00005400| 68 61 72 64 64 69 73 6b | 20 79 6f 75 0a 68 61 76 |harddisk| you.hav|
|00005410| 65 20 74 6f 20 63 6f 70 | 79 20 74 68 65 20 73 61 |e to cop|y the sa|
|00005420| 6d 70 6c 65 73 20 74 6f | 20 61 6e 6f 74 68 65 72 |mples to| another|
|00005430| 20 62 75 66 66 65 72 20 | 61 6e 64 20 73 69 67 6e | buffer |and sign|
|00005440| 61 6c 20 61 20 70 72 6f | 63 65 73 73 20 74 6f 20 |al a pro|cess to |
|00005450| 73 61 76 65 20 69 74 2e | 0a 54 6f 20 66 69 6e 64 |save it.|.To find|
|00005460| 20 6f 75 74 20 74 68 65 | 20 72 65 71 75 69 72 65 | out the| require|
|00005470| 64 20 73 69 7a 65 20 6f | 66 20 74 68 65 20 62 75 |d size o|f the bu|
|00005480| 66 66 65 72 2c 20 73 65 | 65 0a 40 63 6f 64 65 7b |ffer, se|e.@code{|
|00005490| 41 48 49 5f 47 65 74 41 | 75 64 69 6f 41 74 74 72 |AHI_GetA|udioAttr|
|000054a0| 73 41 28 29 7d 20 69 6e | 20 74 68 65 20 61 75 74 |sA()} in| the aut|
|000054b0| 6f 64 6f 63 73 2c 20 74 | 68 65 0a 40 63 6f 64 65 |odocs, t|he.@code|
|000054c0| 7b 41 48 49 44 42 5f 4d | 61 78 52 65 63 6f 72 64 |{AHIDB_M|axRecord|
|000054d0| 53 61 6d 70 6c 65 73 7d | 20 74 61 67 2e 0a 0a 40 |Samples}| tag...@|
|000054e0| 76 69 6e 64 65 78 20 61 | 68 69 61 63 5f 55 73 65 |vindex a|hiac_Use|
|000054f0| 72 44 61 74 61 0a 0a 40 | 69 74 65 6d 20 41 48 49 |rData..@|item AHI|
|00005500| 41 5f 55 73 65 72 44 61 | 74 61 0a 43 61 6e 20 62 |A_UserDa|ta.Can b|
|00005510| 65 20 75 73 65 64 20 74 | 6f 20 69 6e 69 74 69 61 |e used t|o initia|
|00005520| 6c 69 7a 65 20 74 68 65 | 20 40 63 6f 64 65 7b 61 |lize the| @code{a|
|00005530| 68 69 61 63 5f 55 73 65 | 72 44 61 74 61 7d 20 66 |hiac_Use|rData} f|
|00005540| 69 65 6c 64 2e 20 20 59 | 6f 75 20 64 6f 20 6e 6f |ield.  Y|ou do no|
|00005550| 74 20 68 61 76 65 0a 74 | 6f 20 75 73 65 20 74 68 |t have.t|o use th|
|00005560| 69 73 20 74 61 67 20 74 | 6f 20 63 68 61 6e 67 65 |is tag t|o change|
|00005570| 20 40 63 6f 64 65 7b 61 | 68 69 61 63 5f 55 73 65 | @code{a|hiac_Use|
|00005580| 72 44 61 74 61 7d 2c 20 | 79 6f 75 20 6d 61 79 20 |rData}, |you may |
|00005590| 77 72 69 74 65 20 74 6f | 20 69 74 0a 64 69 72 65 |write to| it.dire|
|000055a0| 63 74 6c 79 2e 0a 0a 40 | 65 6e 64 20 76 74 61 62 |ctly...@|end vtab|
|000055b0| 6c 65 0a 0a 40 63 20 2a | 2a 2a 2a 2a 2a 2a 2a 2a |le..@c *|********|
|000055c0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000055d0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000055e0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|000055f0| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 0a 40 |********|******.@|
|00005600| 63 20 2a 2a 2a 2a 20 44 | 65 63 6c 61 72 69 6e 67 |c **** D|eclaring|
|00005610| 20 53 6f 75 6e 64 73 20 | 2a 2a 2a 2a 2a 2a 2a 2a | Sounds |********|
|00005620| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005630| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005640| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 0a 40 63 20 2a 2a 2a |********|*.@c ***|
|00005650| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005660| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005670| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005680| 2a 2a 2a 2a 2a 2a 2a 2a | 2a 2a 2a 2a 2a 2a 2a 2a |********|********|
|00005690| 2a 2a 2a 2a 0a 0a 40 6e | 6f 64 65 20 44 65 63 6c |****..@n|ode Decl|
|000056a0| 61 72 69 6e 67 20 53 6f | 75 6e 64 73 2c 20 4d 61 |aring So|unds, Ma|
|000056b0| 6b 69 6e 67 20 4e 6f 69 | 73 65 2c 20 4f 62 74 61 |king Noi|se, Obta|
|000056c0| 69 6e 69 6e 67 20 54 68 | 65 20 48 61 72 64 77 61 |ining Th|e Hardwa|
|000056d0| 72 65 2c 20 46 75 6e 63 | 74 69 6f 6e 20 49 6e 74 |re, Func|tion Int|
|000056e0| 65 72 66 61 63 65 0a 40 | 63 6f 6d 6d 65 6e 74 20 |erface.@|comment |
|000056f0| 20 6e 6f 64 65 2d 6e 61 | 6d 65 2c 20 20 6e 65 78 | node-na|me,  nex|
|00005700| 74 2c 20 20 70 72 65 76 | 69 6f 75 73 2c 20 20 75 |t,  prev|ious,  u|
|00005710| 70 0a 40 73 65 63 74 69 | 6f 6e 20 44 65 63 6c 61 |p.@secti|on Decla|
|00005720| 72 69 6e 67 20 53 6f 75 | 6e 64 73 0a 0a 40 63 69 |ring Sou|nds..@ci|
|00005730| 6e 64 65 78 20 4c 6f 61 | 64 69 6e 67 20 53 6f 75 |ndex Loa|ding Sou|
|00005740| 6e 64 73 0a 40 63 69 6e | 64 65 78 20 55 6e 6c 6f |nds.@cin|dex Unlo|
|00005750| 61 64 69 6e 67 20 53 6f | 75 6e 64 73 0a 0a 40 66 |ading So|unds..@f|
|00005760| 69 6e 64 65 78 20 41 48 | 49 5f 4c 6f 61 64 53 6f |index AH|I_LoadSo|
|00005770| 75 6e 64 28 29 0a 0a 42 | 65 66 6f 72 65 20 79 6f |und()..B|efore yo|
|00005780| 75 20 63 61 6e 20 70 6c | 61 79 20 61 20 73 61 6d |u can pl|ay a sam|
|00005790| 70 6c 65 20 61 72 72 61 | 79 2c 20 79 6f 75 20 6d |ple arra|y, you m|
|000057a0| 75 73 74 20 40 63 6f 64 | 65 7b 41 48 49 5f 4c 6f |ust @cod|e{AHI_Lo|
|000057b0| 61 64 53 6f 75 6e 64 28 | 29 7d 20 69 74 2e 0a 57 |adSound(|)} it..W|
|000057c0| 68 79 3f 20 20 42 65 63 | 61 75 73 65 20 69 66 20 |hy?  Bec|ause if |
|000057d0| 40 73 63 7b 41 68 69 7d | 20 6b 6e 6f 77 73 20 77 |@sc{Ahi}| knows w|
|000057e0| 68 61 74 20 6b 69 6e 64 | 20 6f 66 20 73 6f 75 6e |hat kind| of soun|
|000057f0| 64 73 20 74 68 61 74 20 | 77 69 6c 6c 20 62 65 20 |ds that |will be |
|00005800| 70 6c 61 79 65 64 0a 6c | 61 74 65 72 2c 20 74 61 |played.l|ater, ta|
|00005810| 62 6c 65 73 20 61 6e 64 | 20 73 74 75 66 66 20 63 |bles and| stuff c|
|00005820| 61 6e 20 62 65 20 73 65 | 74 20 75 70 20 69 6e 20 |an be se|t up in |
|00005830| 61 64 76 61 6e 63 65 2e | 20 20 53 6f 6d 65 20 64 |advance.|  Some d|
|00005840| 72 69 76 65 72 73 20 6d | 61 79 20 65 76 65 6e 0a |rivers m|ay even.|
|00005850| 75 70 6c 6f 61 64 20 74 | 68 65 20 73 61 6d 70 6c |upload t|he sampl|
|00005860| 65 73 20 74 6f 20 74 68 | 65 20 73 6f 75 6e 64 20 |es to th|e sound |
|00005870| 63 61 72 64 73 20 6c 6f | 63 61 6c 20 52 41 4d 20 |cards lo|cal RAM |
|00005880| 61 6e 64 20 70 6c 61 79 | 20 61 6c 6c 20 73 61 6d |and play| all sam|
|00005890| 70 6c 65 73 20 66 72 6f | 6d 0a 74 68 65 72 65 2c |ples fro|m.there,|
|000058a0| 20 64 72 61 73 74 69 63 | 61 6c 6c 79 20 72 65 64 | drastic|ally red|
|000058b0| 75 63 69 6e 67 20 43 50 | 55 20 61 6e 64 20 62 75 |ucing CP|U and bu|
|000058c0| 73 20 6c 6f 61 64 2e 0a | 0a 59 6f 75 20 73 68 6f |s load..|.You sho|
|000058d0| 75 6c 64 20 40 63 6f 64 | 65 7b 41 48 49 5f 4c 6f |uld @cod|e{AHI_Lo|
|000058e0| 61 64 53 6f 75 6e 64 28 | 29 7d 20 74 68 65 20 6d |adSound(|)} the m|
|000058f0| 6f 73 74 20 69 6d 70 6f | 72 74 61 6e 74 20 73 6f |ost impo|rtant so|
|00005900| 75 6e 64 73 20 66 69 72 | 73 74 2c 20 73 69 6e 63 |unds fir|st, sinc|
|00005910| 65 0a 74 68 65 20 73 6f | 75 6e 64 20 63 61 72 64 |e.the so|und card|
|00005920| 73 20 52 41 4d 20 6d 61 | 79 20 6e 6f 74 20 62 65 |s RAM ma|y not be|
|00005930| 20 6c 61 72 67 65 20 65 | 6e 6f 75 67 68 20 74 6f | large e|nough to|
|00005940| 20 68 6f 6c 64 20 61 6c | 6c 20 79 6f 75 72 20 73 | hold al|l your s|
|00005950| 6f 75 6e 64 73 2e 0a 0a | 40 63 6f 64 65 7b 41 48 |ounds...|@code{AH|
|00005960| 49 5f 4c 6f 61 64 53 6f | 75 6e 64 28 29 7d 20 61 |I_LoadSo|und()} a|
|00005970| 6c 73 6f 20 61 73 73 6f | 63 69 61 74 65 73 20 65 |lso asso|ciates e|
|00005980| 61 63 68 20 73 6f 75 6e | 64 20 6f 72 20 73 61 6d |ach soun|d or sam|
|00005990| 70 6c 65 20 61 72 72 61 | 79 20 77 69 74 68 20 61 |ple arra|y with a|
|000059a0| 0a 6e 75 6d 62 65 72 2c | 20 77 68 69 63 68 20 69 |.number,| which i|
|000059b0| 73 20 6c 61 74 65 72 20 | 75 73 65 64 20 74 6f 20 |s later |used to |
|000059c0| 72 65 66 65 72 20 74 6f | 20 74 68 61 74 20 70 61 |refer to| that pa|
|000059d0| 72 74 69 63 75 6c 61 72 | 20 73 6f 75 6e 64 2e 0a |rticular| sound..|
|000059e0| 0a 20 54 68 65 72 65 20 | 61 72 65 20 32 20 74 79 |. There |are 2 ty|
|000059f0| 70 65 73 20 6f 66 20 73 | 6f 75 6e 64 73 2c 20 6e |pes of s|ounds, n|
|00005a00| 61 6d 65 6c 79 20 40 63 | 6f 64 65 7b 41 48 49 53 |amely @c|ode{AHIS|
|00005a10| 54 5f 53 41 4d 50 4c 45 | 7d 20 61 6e 64 0a 40 63 |T_SAMPLE|} and.@c|
|00005a20| 6f 64 65 7b 41 48 49 53 | 54 5f 44 59 4e 41 4d 49 |ode{AHIS|T_DYNAMI|
|00005a30| 43 53 41 4d 50 4c 45 7d | 2e 0a 0a 40 63 20 61 6e |CSAMPLE}|...@c an|
|00005a40| 64 20 40 63 6f 64 65 7b | 41 48 49 53 54 5f 49 4e |d @code{|AHIST_IN|
|00005a50| 50 55 54 7d 2e 0a 0a 40 | 76 74 61 62 6c 65 20 40 |PUT}...@|vtable @|
|00005a60| 63 6f 64 65 0a 0a 40 69 | 74 65 6d 20 41 48 49 53 |code..@i|tem AHIS|
|00005a70| 54 5f 53 41 4d 50 4c 45 | 0a 54 68 69 73 20 69 73 |T_SAMPLE|.This is|
|00005a80| 20 75 73 65 64 20 66 6f | 72 20 73 74 61 74 69 63 | used fo|r static|
|00005a90| 20 73 61 6d 70 6c 65 73 | 2e 20 20 4d 6f 73 74 20 | samples|.  Most |
|00005aa0| 73 6f 75 6e 64 73 20 74 | 68 61 74 20 77 69 6c 6c |sounds t|hat will|
|00005ab0| 20 62 65 20 70 6c 61 79 | 65 64 20 61 72 65 20 6f | be play|ed are o|
|00005ac0| 66 0a 74 68 69 73 20 74 | 79 70 65 2e 20 20 4f 6e |f.this t|ype.  On|
|00005ad0| 63 65 20 74 68 65 20 73 | 61 6d 70 6c 65 73 20 68 |ce the s|amples h|
|00005ae0| 61 73 20 62 65 65 6e 20 | 60 60 6c 6f 61 64 65 64 |as been |``loaded|
|00005af0| 27 27 2c 20 79 6f 75 20 | 6d 61 79 20 6e 6f 74 20 |'', you |may not |
|00005b00| 61 6c 74 65 72 20 74 68 | 65 0a 6d 65 6d 6f 72 79 |alter th|e.memory|
|00005b10| 20 77 68 65 72 65 20 74 | 68 65 20 73 61 6d 70 6c | where t|he sampl|
|00005b20| 65 73 20 61 72 65 20 6c | 6f 63 61 74 65 64 2e 20 |es are l|ocated. |
|00005b30| 20 59 6f 75 20 6d 61 79 | 2c 20 68 6f 77 65 76 65 | You may|, howeve|
|00005b40| 72 2c 20 72 65 61 64 20 | 66 72 6f 6d 20 69 74 2e |r, read |from it.|
|00005b50| 0a 0a 40 69 74 65 6d 20 | 41 48 49 53 54 5f 44 59 |..@item |AHIST_DY|
|00005b60| 4e 41 4d 49 43 53 41 4d | 50 4c 45 0a 49 66 20 79 |NAMICSAM|PLE.If y|
|00005b70| 6f 75 20 77 69 73 68 20 | 74 6f 20 70 6c 61 79 20 |ou wish |to play |
|00005b80| 73 61 6d 70 6c 65 73 20 | 74 68 61 74 20 79 6f 75 |samples |that you|
|00005b90| 20 63 61 6c 63 75 6c 61 | 74 65 20 69 6e 20 72 65 | calcula|te in re|
|00005ba0| 61 6c 74 69 6d 65 2c 20 | 6f 72 20 6c 6f 61 64 20 |altime, |or load |
|00005bb0| 69 6e 0a 70 6f 72 74 69 | 6f 6e 73 20 66 72 6f 6d |in.porti|ons from|
|00005bc0| 20 64 69 73 6b 2c 20 79 | 6f 75 20 6d 75 73 74 20 | disk, y|ou must |
|00005bd0| 75 73 65 20 74 68 69 73 | 20 74 79 70 65 2e 20 20 |use this| type.  |
|00005be0| 54 68 65 73 65 20 73 61 | 6d 70 6c 65 73 20 77 69 |These sa|mples wi|
|00005bf0| 6c 6c 20 6e 65 76 65 72 | 20 62 65 0a 75 70 6c 6f |ll never| be.uplo|
|00005c00| 61 64 65 64 20 74 6f 20 | 61 20 73 6f 75 6e 64 20 |aded to |a sound |
|00005c10| 63 61 72 64 73 20 6c 6f | 63 61 6c 20 52 41 4d 2c |cards lo|cal RAM,|
|00005c20| 20 62 75 74 20 61 6c 77 | 61 79 73 20 70 6c 61 79 | but alw|ays play|
|00005c30| 65 64 20 66 72 6f 6d 20 | 74 68 65 20 6e 6f 72 6d |ed from |the norm|
|00005c40| 61 6c 0a 6d 65 6d 6f 72 | 79 2e 20 20 54 68 65 72 |al.memor|y.  Ther|
|00005c50| 65 20 69 73 20 61 20 63 | 61 74 63 68 2c 20 68 6f |e is a c|atch, ho|
|00005c60| 77 65 76 65 72 2e 20 20 | 42 65 63 61 75 73 65 20 |wever.  |Because |
|00005c70| 6f 66 20 74 68 65 20 66 | 61 63 74 20 74 68 61 74 |of the f|act that|
|00005c80| 20 74 68 65 20 73 6f 75 | 6e 64 20 69 73 0a 6d 69 | the sou|nd is.mi|
|00005c90| 78 65 64 20 69 6e 20 63 | 68 75 6e 6b 73 2c 20 79 |xed in c|hunks, y|
|00005ca0| 6f 75 20 6d 75 73 74 20 | 68 61 76 65 20 61 20 63 |ou must |have a c|
|00005cb0| 65 72 74 61 69 6e 20 6e | 75 6d 62 65 72 20 6f 66 |ertain n|umber of|
|00005cc0| 20 73 61 6d 70 6c 65 73 | 20 69 6e 20 6d 65 6d 6f | samples| in memo|
|00005cd0| 72 79 20 62 65 66 6f 72 | 65 0a 79 6f 75 20 73 74 |ry befor|e.you st|
|00005ce0| 61 72 74 20 61 20 73 6f | 75 6e 64 20 6f 66 20 74 |art a so|und of t|
|00005cf0| 68 69 73 20 74 79 70 65 | 2e 20 20 54 6f 20 63 61 |his type|.  To ca|
|00005d00| 6c 63 75 6c 61 74 65 20 | 74 68 65 20 73 69 7a 65 |lculate |the size|
|00005d10| 20 6f 66 20 74 68 65 20 | 62 75 66 66 65 72 20 28 | of the |buffer (|
|00005d20| 69 6e 0a 73 61 6d 70 6c | 65 73 29 2c 20 75 73 65 |in.sampl|es), use|
|00005d30| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 66 | the fol|lowing f|
|00005d40| 6f 72 6d 75 6c 61 3a 0a | 0a 40 65 78 61 6d 70 6c |ormula:.|.@exampl|
|00005d50| 65 0a 40 6d 61 74 68 7b | 73 69 7a 65 20 3d 20 73 |e.@math{|size = s|
|00005d60| 61 6d 70 6c 65 73 20 2a | 20 46 73 20 2f 20 46 6d |amples *| Fs / Fm|
|00005d70| 7d 0a 40 65 6e 64 20 65 | 78 61 6d 70 6c 65 0a 0a |}.@end e|xample..|
|00005d80| 77 68 65 72 65 20 73 61 | 6d 70 6c 65 73 20 69 73 |where sa|mples is|
|00005d90| 20 74 68 65 20 76 61 6c | 75 65 20 72 65 74 75 72 | the val|ue retur|
|00005da0| 6e 65 64 20 66 72 6f 6d | 20 40 63 6f 64 65 7b 41 |ned from| @code{A|
|00005db0| 48 49 5f 47 65 74 41 75 | 64 69 6f 41 74 74 72 73 |HI_GetAu|dioAttrs|
|00005dc0| 41 28 29 7d 20 77 68 65 | 6e 0a 63 61 6c 6c 65 64 |A()} whe|n.called|
|00005dd0| 20 77 69 74 68 20 74 68 | 65 20 40 63 6f 64 65 7b | with th|e @code{|
|00005de0| 41 48 49 44 42 5f 4d 61 | 78 50 6c 61 79 53 61 6d |AHIDB_Ma|xPlaySam|
|00005df0| 70 6c 65 73 7d 20 74 61 | 67 2c 20 46 73 20 69 73 |ples} ta|g, Fs is|
|00005e00| 20 74 68 65 20 68 69 67 | 68 65 73 74 0a 66 72 65 | the hig|hest.fre|
|00005e10| 71 75 65 6e 63 79 20 74 | 68 65 20 73 6f 75 6e 64 |quency t|he sound|
|00005e20| 20 77 69 6c 6c 20 62 65 | 20 70 6c 61 79 65 64 20 | will be| played |
|00005e30| 61 74 20 61 6e 64 20 46 | 6d 20 69 73 20 74 68 65 |at and F|m is the|
|00005e40| 20 61 63 74 75 61 6c 20 | 6d 69 78 69 6e 67 20 66 | actual |mixing f|
|00005e50| 72 65 71 75 65 6e 63 79 | 0a 28 40 63 6f 64 65 7b |requency|.(@code{|
|00005e60| 41 48 49 5f 43 6f 6e 74 | 72 6f 6c 41 75 64 69 6f |AHI_Cont|rolAudio|
|00005e70| 41 28 29 2f 41 48 49 43 | 5f 4d 69 78 46 72 65 71 |A()/AHIC|_MixFreq|
|00005e80| 5f 51 75 65 72 79 7d 29 | 2e 0a 0a 0a 40 63 20 40 |_Query})|....@c @|
|00005e90| 69 74 65 6d 20 41 48 49 | 53 54 5f 49 4e 50 55 54 |item AHI|ST_INPUT|
|00005ea0| 0a 40 63 20 54 68 69 73 | 20 73 6f 75 6e 64 20 74 |.@c This| sound t|
|00005eb0| 79 70 65 20 69 73 20 75 | 73 65 64 20 74 6f 20 75 |ype is u|sed to u|
|00005ec0| 73 65 20 40 73 63 7b 41 | 68 69 7d 27 73 20 44 53 |se @sc{A|hi}'s DS|
|00005ed0| 50 2d 65 66 66 65 63 74 | 73 20 69 6e 20 72 65 61 |P-effect|s in rea|
|00005ee0| 6c 2d 74 69 6d 65 2e 20 | 20 5b 49 74 0a 40 63 20 |l-time. | [It.@c |
|00005ef0| 64 6f 65 73 20 6e 6f 74 | 20 77 6f 72 6b 20 79 65 |does not| work ye|
|00005f00| 74 2e 20 46 49 58 49 54 | 5d 0a 0a 40 65 6e 64 20 |t. FIXIT|]..@end |
|00005f10| 76 74 61 62 6c 65 0a 0a | 54 68 65 20 73 61 6d 70 |vtable..|The samp|
|00005f20| 6c 65 73 20 63 61 6e 20 | 62 65 20 69 6e 20 6f 6e |les can |be in on|
|00005f30| 65 20 6f 66 20 66 6f 75 | 72 20 64 69 66 66 65 72 |e of fou|r differ|
|00005f40| 65 6e 74 20 66 6f 72 6d | 61 74 73 2c 20 6e 61 6d |ent form|ats, nam|
|00005f50| 65 64 20 40 63 6f 64 65 | 7b 41 48 49 53 54 5f 4d |ed @code|{AHIST_M|
|00005f60| 38 53 7d 2c 0a 40 63 6f | 64 65 7b 41 48 49 53 54 |8S},.@co|de{AHIST|
|00005f70| 5f 53 38 53 7d 2c 20 40 | 63 6f 64 65 7b 41 48 49 |_S8S}, @|code{AHI|
|00005f80| 53 54 5f 4d 31 36 53 7d | 2c 20 61 6e 64 20 40 63 |ST_M16S}|, and @c|
|00005f90| 6f 64 65 7b 41 48 49 53 | 54 5f 53 31 36 53 7d 2e |ode{AHIS|T_S16S}.|
|00005fa0| 0a 0a 40 76 74 61 62 6c | 65 20 40 63 6f 64 65 0a |..@vtabl|e @code.|
|00005fb0| 0a 40 69 74 65 6d 20 41 | 48 49 53 54 5f 4d 38 53 |.@item A|HIST_M8S|
|00005fc0| 0a 54 68 69 73 20 69 73 | 20 61 6e 20 38 20 62 69 |.This is| an 8 bi|
|00005fd0| 74 20 6d 6f 6e 6f 20 73 | 6f 75 6e 64 2e 20 45 61 |t mono s|ound. Ea|
|00005fe0| 63 68 20 73 61 6d 70 6c | 65 20 66 72 61 6d 65 20 |ch sampl|e frame |
|00005ff0| 69 73 20 6a 75 73 74 20 | 6f 6e 65 20 73 69 67 6e |is just |one sign|
|00006000| 65 64 20 62 79 74 65 2e | 0a 0a 40 69 74 65 6d 20 |ed byte.|..@item |
|00006010| 41 48 49 53 54 5f 53 38 | 53 0a 54 68 69 73 20 69 |AHIST_S8|S.This i|
|00006020| 73 20 61 6e 20 38 20 62 | 69 74 20 73 74 65 72 65 |s an 8 b|it stere|
|00006030| 6f 20 73 6f 75 6e 64 2e | 20 45 61 63 68 20 73 61 |o sound.| Each sa|
|00006040| 6d 70 6c 65 20 66 72 61 | 6d 65 20 69 73 20 6f 6e |mple fra|me is on|
|00006050| 65 20 73 69 67 6e 65 64 | 20 62 79 74 65 20 72 65 |e signed| byte re|
|00006060| 70 72 65 73 65 6e 74 69 | 6e 67 0a 74 68 65 20 6c |presenti|ng.the l|
|00006070| 65 66 74 20 63 68 61 6e | 6e 65 6c 2c 20 66 6f 6c |eft chan|nel, fol|
|00006080| 6c 6f 77 65 64 20 62 79 | 20 61 6e 6f 74 68 65 72 |lowed by| another|
|00006090| 20 6f 6e 65 20 66 6f 72 | 20 74 68 65 20 72 69 67 | one for| the rig|
|000060a0| 68 74 20 63 68 61 6e 6e | 65 6c 2e 0a 0a 40 69 74 |ht chann|el...@it|
|000060b0| 65 6d 20 41 48 49 53 54 | 5f 4d 31 36 53 0a 54 68 |em AHIST|_M16S.Th|
|000060c0| 69 73 20 69 73 20 61 20 | 31 36 20 62 69 74 20 6d |is is a |16 bit m|
|000060d0| 6f 6e 6f 20 73 6f 75 6e | 64 2e 20 20 45 61 63 68 |ono soun|d.  Each|
|000060e0| 20 73 61 6d 70 6c 65 20 | 66 72 61 6d 65 20 69 73 | sample |frame is|
|000060f0| 20 6a 75 73 74 20 6f 6e | 65 20 73 69 67 6e 65 64 | just on|e signed|
|00006100| 20 31 36 20 62 69 74 0a | 77 6f 72 64 2c 20 69 6e | 16 bit.|word, in|
|00006110| 20 62 69 67 20 65 6e 64 | 69 61 6e 2f 6e 65 74 77 | big end|ian/netw|
|00006120| 6f 72 6b 20 6f 72 64 65 | 72 20 66 6f 72 6d 61 74 |ork orde|r format|
|00006130| 20 28 6d 6f 73 74 20 73 | 69 67 6e 69 66 69 63 61 | (most s|ignifica|
|00006140| 6e 74 20 62 79 74 65 20 | 66 69 72 73 74 29 2e 0a |nt byte |first)..|
|00006150| 0a 40 69 74 65 6d 20 41 | 48 49 53 54 5f 53 31 36 |.@item A|HIST_S16|
|00006160| 53 0a 54 68 69 73 20 69 | 73 20 61 20 31 36 20 62 |S.This i|s a 16 b|
|00006170| 69 74 20 73 74 65 72 65 | 6f 20 73 6f 75 6e 64 2e |it stere|o sound.|
|00006180| 20 20 45 61 63 68 20 73 | 61 6d 70 6c 65 20 66 72 |  Each s|ample fr|
|00006190| 61 6d 65 20 69 73 20 6f | 6e 65 20 73 69 67 6e 65 |ame is o|ne signe|
|000061a0| 64 20 31 36 20 62 69 74 | 0a 77 6f 72 64 2c 20 69 |d 16 bit|.word, i|
|000061b0| 6e 20 62 69 67 20 65 6e | 64 69 61 6e 2f 6e 65 74 |n big en|dian/net|
|000061c0| 77 6f 72 6b 20 6f 72 64 | 65 72 20 66 6f 72 6d 61 |work ord|er forma|
|000061d0| 74 20 28 6d 6f 73 74 20 | 73 69 67 6e 69 66 69 63 |t (most |signific|
|000061e0| 61 6e 74 20 62 79 74 65 | 20 66 69 72 73 74 29 0a |ant byte| first).|
|000061f0| 72 65 70 72 65 73 65 6e | 74 69 6e 67 20 74 68 65 |represen|ting the|
|00006200| 20 6c 65 66 74 20 63 68 | 61 6e 6e 65 6c 2c 20 66 | left ch|annel, f|
|00006210| 6f 6c 6c 6f 77 65 64 20 | 62 79 20 61 6e 6f 74 68 |ollowed |by anoth|
|00006220| 65 72 20 6f 6e 65 20 66 | 6f 72 20 74 68 65 20 72 |er one f|or the r|
|00006230| 69 67 68 74 0a 63 68 61 | 6e 6e 65 6c 2e 0a 0a 40 |ight.cha|nnel...@|
|00006240| 65 6e 64 20 76 74 61 62 | 6c 65 0a 0a 0a 40 66 69 |end vtab|le...@fi|
|00006250| 6e 64 65 78 20 41 48 49 | 5f 55 6e 6c 6f 61 64 53 |ndex AHI|_UnloadS|
|00006260| 6f 75 6e 64 28 29 0a 0a | 20 49 66 20 79 6f 75 20 |ound()..| If you |
|00006270| 6b 6e 6f 77 20 74 68 61 | 74 20 79 6f 75 20 77 6f |know tha|t you wo|
|00006280| 6e 27 74 20 75 73 65 20 | 61 20 73 6f 75 6e 64 20 |n't use |a sound |
|00006290| 61 6e 79 6d 6f 72 65 2c | 20 63 61 6c 6c 0a 40 63 |anymore,| call.@c|
|000062a0| 6f 64 65 7b 41 48 49 5f | 55 6e 6c 6f 61 64 53 6f |ode{AHI_|UnloadSo|
|000062b0| 75 6e 64 28 29 7d 2e 20 | 20 40 63 6f 64 65 7b 41 |und()}. | @code{A|
|000062c0| 48 49 5f 46 72 65 65 41 | 75 64 69 6f 28 29 7d 20 |HI_FreeA|udio()} |
|000062d0| 77 69 6c 6c 20 61 6c 73 | 6f 20 64 6f 20 74 68 61 |will als|o do tha|
|000062e0| 74 20 66 6f 72 20 79 6f | 75 0a 66 6f 72 20 61 6e |t for yo|u.for an|
|000062f0| 79 20 73 6f 75 6e 64 73 | 20 6c 65 66 74 20 77 68 |y sounds| left wh|
|00006300| 65 6e 20 63 61 6c 6c 65 | 64 2e 0a 0a 20 54 68 65 |en calle|d... The|
|00006310| 72 65 20 69 73 20 6e 6f | 20 6e 65 65 64 20 74 6f |re is no| need to|
|00006320| 20 70 6c 61 63 65 20 61 | 20 73 61 6d 70 6c 65 20 | place a| sample |
|00006330| 61 72 72 61 79 20 69 6e | 20 40 64 66 6e 7b 43 68 |array in| @dfn{Ch|
|00006340| 69 70 20 6d 65 6d 6f 72 | 79 7d 2c 20 62 75 74 20 |ip memor|y}, but |
|00006350| 69 74 0a 40 73 74 72 6f | 6e 67 7b 6d 75 73 74 20 |it.@stro|ng{must |
|00006360| 6e 6f 74 7d 20 62 65 20 | 73 77 61 70 70 65 64 20 |not} be |swapped |
|00006370| 6f 75 74 21 20 20 41 6c | 6c 6f 63 61 74 65 20 79 |out!  Al|locate y|
|00006380| 6f 75 72 20 73 61 6d 70 | 6c 65 20 6d 65 6d 6f 72 |our samp|le memor|
|00006390| 79 20 77 69 74 68 20 74 | 68 65 0a 40 63 6f 64 65 |y with t|he.@code|
|000063a0| 7b 4d 45 4d 46 5f 50 55 | 42 4c 49 43 7d 20 66 6c |{MEMF_PU|BLIC} fl|
|000063b0| 61 67 20 73 65 74 2e 20 | 20 49 66 20 79 6f 75 20 |ag set. | If you |
|000063c0| 77 69 73 68 20 74 6f 20 | 68 61 76 65 20 79 6f 75 |wish to |have you|
|000063d0| 72 20 73 61 6d 70 6c 65 | 73 20 69 6e 20 76 69 72 |r sample|s in vir|
|000063e0| 74 75 61 6c 0a 6d 65 6d | 6f 72 79 2c 20 79 6f 75 |tual.mem|ory, you|
|000063f0| 20 68 61 76 65 20 74 6f | 20 77 72 69 74 65 20 61 | have to| write a|
+--------+-------------------------+-------------------------+--------+--------+