/ Celestin Apprentice 2 / Apprentice-Release2.iso / Tools / Languages / Python 1.1 / Doc / libaudio.tex

< prev

next >

MacOS 8.1

Win98

DOS

view JSON data

view as text

+--------+-------------------------+-------------------------+--------+--------+
|00000000| 5c 73 65 63 74 69 6f 6e | 7b 42 75 69 6c 74 2d 69 |\section|{Built-i|
|00000010| 6e 20 4d 6f 64 75 6c 65 | 20 5c 73 65 63 74 63 6f |n Module| \sectco|
|00000020| 64 65 7b 61 75 64 69 6f | 7d 7d 0d 5c 62 69 6d 6f |de{audio|}}.\bimo|
|00000030| 64 69 6e 64 65 78 7b 61 | 75 64 69 6f 7d 0d 0d 5c |dindex{a|udio}..\|
|00000040| 73 74 72 6f 6e 67 7b 4e | 6f 74 65 3a 7d 20 54 68 |strong{N|ote:} Th|
|00000050| 69 73 20 6d 6f 64 75 6c | 65 20 69 73 20 6f 62 73 |is modul|e is obs|
|00000060| 6f 6c 65 74 65 2c 20 73 | 69 6e 63 65 20 74 68 65 |olete, s|ince the|
|00000070| 20 68 61 72 64 77 61 72 | 65 20 74 6f 20 77 68 69 | hardwar|e to whi|
|00000080| 63 68 20 69 74 0d 69 6e | 74 65 72 66 61 63 65 73 |ch it.in|terfaces|
|00000090| 20 69 73 20 6f 62 73 6f | 6c 65 74 65 2e 20 20 46 | is obso|lete.  F|
|000000a0| 6f 72 20 61 75 64 69 6f | 20 6f 6e 20 74 68 65 20 |or audio| on the |
|000000b0| 49 6e 64 69 67 6f 20 6f | 72 20 34 44 2f 33 35 2c |Indigo o|r 4D/35,|
|000000c0| 20 73 65 65 0d 62 75 69 | 6c 74 2d 69 6e 20 6d 6f | see.bui|lt-in mo|
|000000d0| 64 75 6c 65 20 5c 63 6f | 64 65 7b 61 6c 7d 20 61 |dule \co|de{al} a|
|000000e0| 62 6f 76 65 2e 0d 0d 54 | 68 69 73 20 6d 6f 64 75 |bove...T|his modu|
|000000f0| 6c 65 20 70 72 6f 76 69 | 64 65 73 20 72 75 64 69 |le provi|des rudi|
|00000100| 6d 65 6e 74 61 72 79 20 | 61 63 63 65 73 73 20 74 |mentary |access t|
|00000110| 6f 20 74 68 65 20 61 75 | 64 69 6f 20 49 2f 4f 20 |o the au|dio I/O |
|00000120| 64 65 76 69 63 65 0d 5c | 66 69 6c 65 7b 2f 64 65 |device.\|file{/de|
|00000130| 76 2f 61 75 64 69 6f 7d | 20 6f 6e 20 74 68 65 20 |v/audio}| on the |
|00000140| 53 69 6c 69 63 6f 6e 20 | 47 72 61 70 68 69 63 73 |Silicon |Graphics|
|00000150| 20 50 65 72 73 6f 6e 61 | 6c 20 49 52 49 53 20 34 | Persona|l IRIS 4|
|00000160| 44 2f 32 35 3b 0d 73 65 | 65 20 7b 5c 69 74 20 61 |D/25;.se|e {\it a|
|00000170| 75 64 69 6f 7d 28 37 29 | 2e 20 49 74 20 73 75 70 |udio}(7)|. It sup|
|00000180| 70 6f 72 74 73 20 74 68 | 65 20 66 6f 6c 6c 6f 77 |ports th|e follow|
|00000190| 69 6e 67 20 6f 70 65 72 | 61 74 69 6f 6e 73 3a 0d |ing oper|ations:.|
|000001a0| 0d 5c 72 65 6e 65 77 63 | 6f 6d 6d 61 6e 64 7b 5c |.\renewc|ommand{\|
|000001b0| 69 6e 64 65 78 73 75 62 | 69 74 65 6d 7d 7b 28 69 |indexsub|item}{(i|
|000001c0| 6e 20 6d 6f 64 75 6c 65 | 20 61 75 64 69 6f 29 7d |n module| audio)}|
|000001d0| 0d 5c 62 65 67 69 6e 7b | 66 75 6e 63 64 65 73 63 |.\begin{|funcdesc|
|000001e0| 7d 7b 73 65 74 6f 75 74 | 67 61 69 6e 7d 7b 6e 7d |}{setout|gain}{n}|
|000001f0| 0d 53 65 74 73 20 74 68 | 65 20 6f 75 74 70 75 74 |.Sets th|e output|
|00000200| 20 67 61 69 6e 2e 0d 5c | 69 66 74 65 78 69 0d 5c | gain..\|iftexi.\|
|00000210| 63 6f 64 65 7b 30 20 3c | 3d 20 5c 76 61 72 7b 6e |code{0 <|= \var{n|
|00000220| 7d 20 3c 20 32 35 36 7d | 2e 0d 5c 65 6c 73 65 0d |} < 256}|..\else.|
|00000230| 24 30 20 5c 6c 65 71 20 | 5c 76 61 72 7b 6e 7d 20 |$0 \leq |\var{n} |
|00000240| 3c 20 32 35 36 24 2e 0d | 25 25 4a 48 58 58 58 20 |< 256$..|%%JHXXX |
|00000250| 53 65 74 73 20 74 68 65 | 20 6f 75 74 70 75 74 20 |Sets the| output |
|00000260| 67 61 69 6e 20 28 30 2d | 32 35 35 29 2e 0d 5c 66 |gain (0-|255)..\f|
|00000270| 69 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |i.\end{f|uncdesc}|
|00000280| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000290| 63 7d 7b 67 65 74 6f 75 | 74 67 61 69 6e 7d 7b 7d |c}{getou|tgain}{}|
|000002a0| 0d 52 65 74 75 72 6e 73 | 20 74 68 65 20 6f 75 74 |.Returns| the out|
|000002b0| 70 75 74 20 67 61 69 6e | 2e 0d 5c 65 6e 64 7b 66 |put gain|..\end{f|
|000002c0| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|000002d0| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 73 65 74 72 61 |{funcdes|c}{setra|
|000002e0| 74 65 7d 7b 6e 7d 0d 53 | 65 74 73 20 74 68 65 20 |te}{n}.S|ets the |
|000002f0| 73 61 6d 70 6c 69 6e 67 | 20 72 61 74 65 3a 20 5c |sampling| rate: \|
|00000300| 63 6f 64 65 7b 31 7d 20 | 3d 20 33 32 4b 2f 73 65 |code{1} |= 32K/se|
|00000310| 63 2c 20 5c 63 6f 64 65 | 7b 32 7d 20 3d 20 31 36 |c, \code|{2} = 16|
|00000320| 4b 2f 73 65 63 2c 0d 5c | 63 6f 64 65 7b 33 7d 20 |K/sec,.\|code{3} |
|00000330| 3d 20 38 4b 2f 73 65 63 | 2e 0d 5c 65 6e 64 7b 66 |= 8K/sec|..\end{f|
|00000340| 75 6e 63 64 65 73 63 7d | 0d 0d 5c 62 65 67 69 6e |uncdesc}|..\begin|
|00000350| 7b 66 75 6e 63 64 65 73 | 63 7d 7b 73 65 74 64 75 |{funcdes|c}{setdu|
|00000360| 72 61 74 69 6f 6e 7d 7b | 6e 7d 0d 53 65 74 73 20 |ration}{|n}.Sets |
|00000370| 74 68 65 20 60 73 6f 75 | 6e 64 20 64 75 72 61 74 |the `sou|nd durat|
|00000380| 69 6f 6e 27 20 69 6e 20 | 75 6e 69 74 73 20 6f 66 |ion' in |units of|
|00000390| 20 31 2f 31 30 30 20 73 | 65 63 6f 6e 64 73 2e 0d | 1/100 s|econds..|
|000003a0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|000003b0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000003c0| 7b 72 65 61 64 7d 7b 6e | 7d 0d 52 65 61 64 73 20 |{read}{n|}.Reads |
|000003d0| 61 20 63 68 75 6e 6b 20 | 6f 66 0d 5c 76 61 72 7b |a chunk |of.\var{|
|000003e0| 6e 7d 0d 73 61 6d 70 6c | 65 64 20 62 79 74 65 73 |n}.sampl|ed bytes|
|000003f0| 20 66 72 6f 6d 20 74 68 | 65 20 61 75 64 69 6f 20 | from th|e audio |
|00000400| 69 6e 70 75 74 20 28 6c | 69 6e 65 20 69 6e 20 6f |input (l|ine in o|
|00000410| 72 20 6d 69 63 72 6f 70 | 68 6f 6e 65 29 2e 0d 54 |r microp|hone)..T|
|00000420| 68 65 20 63 68 75 6e 6b | 20 69 73 20 72 65 74 75 |he chunk| is retu|
|00000430| 72 6e 65 64 20 61 73 20 | 61 20 73 74 72 69 6e 67 |rned as |a string|
|00000440| 20 6f 66 20 6c 65 6e 67 | 74 68 20 6e 2e 0d 45 61 | of leng|th n..Ea|
|00000450| 63 68 20 62 79 74 65 20 | 65 6e 63 6f 64 65 73 20 |ch byte |encodes |
|00000460| 6f 6e 65 20 73 61 6d 70 | 6c 65 20 61 73 20 61 20 |one samp|le as a |
|00000470| 73 69 67 6e 65 64 20 38 | 2d 62 69 74 20 71 75 61 |signed 8|-bit qua|
|00000480| 6e 74 69 74 79 20 75 73 | 69 6e 67 20 6c 69 6e 65 |ntity us|ing line|
|00000490| 61 72 0d 65 6e 63 6f 64 | 69 6e 67 2e 0d 54 68 69 |ar.encod|ing..Thi|
|000004a0| 73 20 73 74 72 69 6e 67 | 20 63 61 6e 20 62 65 20 |s string| can be |
|000004b0| 63 6f 6e 76 65 72 74 65 | 64 20 74 6f 20 6e 75 6d |converte|d to num|
|000004c0| 62 65 72 73 20 75 73 69 | 6e 67 20 5c 63 6f 64 65 |bers usi|ng \code|
|000004d0| 7b 63 68 72 32 6e 75 6d | 28 29 7d 20 64 65 73 63 |{chr2num|()} desc|
|000004e0| 72 69 62 65 64 0d 62 65 | 6c 6f 77 2e 0d 5c 65 6e |ribed.be|low..\en|
|000004f0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000500| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 77 72 |gin{func|desc}{wr|
|00000510| 69 74 65 7d 7b 62 75 66 | 7d 0d 57 72 69 74 65 73 |ite}{buf|}.Writes|
|00000520| 20 61 20 63 68 75 6e 6b | 20 6f 66 20 73 61 6d 70 | a chunk| of samp|
|00000530| 6c 65 73 20 74 6f 20 74 | 68 65 20 61 75 64 69 6f |les to t|he audio|
|00000540| 20 6f 75 74 70 75 74 20 | 28 73 70 65 61 6b 65 72 | output |(speaker|
|00000550| 29 2e 0d 5c 65 6e 64 7b | 66 75 6e 63 64 65 73 63 |)..\end{|funcdesc|
|00000560| 7d 0d 0d 54 68 65 73 65 | 20 6f 70 65 72 61 74 69 |}..These| operati|
|00000570| 6f 6e 73 20 73 75 70 70 | 6f 72 74 20 61 73 79 6e |ons supp|ort asyn|
|00000580| 63 68 72 6f 6e 6f 75 73 | 20 61 75 64 69 6f 20 49 |chronous| audio I|
|00000590| 2f 4f 3a 0d 0d 5c 72 65 | 6e 65 77 63 6f 6d 6d 61 |/O:..\re|newcomma|
|000005a0| 6e 64 7b 5c 69 6e 64 65 | 78 73 75 62 69 74 65 6d |nd{\inde|xsubitem|
|000005b0| 7d 7b 28 69 6e 20 6d 6f | 64 75 6c 65 20 61 75 64 |}{(in mo|dule aud|
|000005c0| 69 6f 29 7d 0d 5c 62 65 | 67 69 6e 7b 66 75 6e 63 |io)}.\be|gin{func|
|000005d0| 64 65 73 63 7d 7b 73 74 | 61 72 74 5f 72 65 63 6f |desc}{st|art_reco|
|000005e0| 72 64 69 6e 67 7d 7b 6e | 7d 0d 53 74 61 72 74 73 |rding}{n|}.Starts|
|000005f0| 20 61 20 73 65 63 6f 6e | 64 20 74 68 72 65 61 64 | a secon|d thread|
|00000600| 20 28 61 20 70 72 6f 63 | 65 73 73 20 77 69 74 68 | (a proc|ess with|
|00000610| 20 73 68 61 72 65 64 20 | 6d 65 6d 6f 72 79 29 20 | shared |memory) |
|00000620| 74 68 61 74 20 62 65 67 | 69 6e 73 20 72 65 61 64 |that beg|ins read|
|00000630| 69 6e 67 0d 5c 76 61 72 | 7b 6e 7d 0d 62 79 74 65 |ing.\var|{n}.byte|
|00000640| 73 20 66 72 6f 6d 20 74 | 68 65 20 61 75 64 69 6f |s from t|he audio|
|00000650| 20 64 65 76 69 63 65 2e | 0d 54 68 65 20 6d 61 69 | device.|.The mai|
|00000660| 6e 20 74 68 72 65 61 64 | 20 69 6d 6d 65 64 69 61 |n thread| immedia|
|00000670| 74 65 6c 79 20 63 6f 6e | 74 69 6e 75 65 73 2e 0d |tely con|tinues..|
|00000680| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0d 0d |\end{fun|cdesc}..|
|00000690| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|000006a0| 7b 77 61 69 74 5f 72 65 | 63 6f 72 64 69 6e 67 7d |{wait_re|cording}|
|000006b0| 7b 7d 0d 57 61 69 74 73 | 20 66 6f 72 20 74 68 65 |{}.Waits| for the|
|000006c0| 20 73 65 63 6f 6e 64 20 | 74 68 72 65 61 64 20 74 | second |thread t|
|000006d0| 6f 20 66 69 6e 69 73 68 | 20 61 6e 64 20 72 65 74 |o finish| and ret|
|000006e0| 75 72 6e 73 20 74 68 65 | 20 64 61 74 61 20 72 65 |urns the| data re|
|000006f0| 61 64 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |ad..\end|{funcdes|
|00000700| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000710| 65 73 63 7d 7b 73 74 6f | 70 5f 72 65 63 6f 72 64 |esc}{sto|p_record|
|00000720| 69 6e 67 7d 7b 7d 0d 4d | 61 6b 65 73 20 74 68 65 |ing}{}.M|akes the|
|00000730| 20 73 65 63 6f 6e 64 20 | 74 68 72 65 61 64 20 73 | second |thread s|
|00000740| 74 6f 70 20 72 65 61 64 | 69 6e 67 20 61 73 20 73 |top read|ing as s|
|00000750| 6f 6f 6e 20 61 73 20 70 | 6f 73 73 69 62 6c 65 2e |oon as p|ossible.|
|00000760| 0d 52 65 74 75 72 6e 73 | 20 74 68 65 20 64 61 74 |.Returns| the dat|
|00000770| 61 20 72 65 61 64 20 73 | 6f 20 66 61 72 2e 0d 5c |a read s|o far..\|
|00000780| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0d 0d 5c |end{func|desc}..\|
|00000790| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|000007a0| 70 6f 6c 6c 5f 72 65 63 | 6f 72 64 69 6e 67 7d 7b |poll_rec|ording}{|
|000007b0| 7d 0d 52 65 74 75 72 6e | 73 20 74 72 75 65 20 69 |}.Return|s true i|
|000007c0| 66 20 74 68 65 20 73 65 | 63 6f 6e 64 20 74 68 72 |f the se|cond thr|
|000007d0| 65 61 64 20 68 61 73 20 | 66 69 6e 69 73 68 65 64 |ead has |finished|
|000007e0| 20 72 65 61 64 69 6e 67 | 20 28 73 6f 0d 5c 63 6f | reading| (so.\co|
|000007f0| 64 65 7b 77 61 69 74 5f | 72 65 63 6f 72 64 69 6e |de{wait_|recordin|
|00000800| 67 28 29 7d 20 77 6f 75 | 6c 64 20 72 65 74 75 72 |g()} wou|ld retur|
|00000810| 6e 20 74 68 65 20 64 61 | 74 61 20 77 69 74 68 6f |n the da|ta witho|
|00000820| 75 74 20 64 65 6c 61 79 | 29 2e 0d 5c 65 6e 64 7b |ut delay|)..\end{|
|00000830| 66 75 6e 63 64 65 73 63 | 7d 0d 0d 5c 62 65 67 69 |funcdesc|}..\begi|
|00000840| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 73 74 61 72 |n{funcde|sc}{star|
|00000850| 74 5f 70 6c 61 79 69 6e | 67 7d 7b 7d 0d 5c 66 75 |t_playin|g}{}.\fu|
|00000860| 6e 63 6c 69 6e 65 7b 77 | 61 69 74 5f 70 6c 61 79 |ncline{w|ait_play|
|00000870| 69 6e 67 7d 7b 7d 0d 5c | 66 75 6e 63 6c 69 6e 65 |ing}{}.\|funcline|
|00000880| 7b 73 74 6f 70 5f 70 6c | 61 79 69 6e 67 7d 7b 7d |{stop_pl|aying}{}|
|00000890| 0d 5c 66 75 6e 63 6c 69 | 6e 65 7b 70 6f 6c 6c 5f |.\funcli|ne{poll_|
|000008a0| 70 6c 61 79 69 6e 67 7d | 7b 7d 0d 5c 62 65 67 69 |playing}|{}.\begi|
|000008b0| 6e 7b 73 6c 6f 70 70 79 | 70 61 72 7d 0d 53 69 6d |n{sloppy|par}.Sim|
|000008c0| 69 6c 61 72 20 62 75 74 | 20 66 6f 72 20 6f 75 74 |ilar but| for out|
|000008d0| 70 75 74 2e 0d 5c 63 6f | 64 65 7b 73 74 6f 70 5f |put..\co|de{stop_|
|000008e0| 70 6c 61 79 69 6e 67 28 | 29 7d 0d 72 65 74 75 72 |playing(|)}.retur|
|000008f0| 6e 73 20 61 20 6c 6f 77 | 65 72 20 62 6f 75 6e 64 |ns a low|er bound|
|00000900| 20 66 6f 72 20 74 68 65 | 20 6e 75 6d 62 65 72 20 | for the| number |
|00000910| 6f 66 20 62 79 74 65 73 | 20 61 63 74 75 61 6c 6c |of bytes| actuall|
|00000920| 79 20 70 6c 61 79 65 64 | 20 28 6e 6f 74 20 76 65 |y played| (not ve|
|00000930| 72 79 0d 61 63 63 75 72 | 61 74 65 29 2e 0d 5c 65 |ry.accur|ate)..\e|
|00000940| 6e 64 7b 73 6c 6f 70 70 | 79 70 61 72 7d 0d 5c 65 |nd{slopp|ypar}.\e|
|00000950| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d 0d 54 68 |nd{funcd|esc}..Th|
|00000960| 65 20 66 6f 6c 6c 6f 77 | 69 6e 67 20 6f 70 65 72 |e follow|ing oper|
|00000970| 61 74 69 6f 6e 73 20 64 | 6f 20 6e 6f 74 20 61 66 |ations d|o not af|
|00000980| 66 65 63 74 20 74 68 65 | 20 61 75 64 69 6f 20 64 |fect the| audio d|
|00000990| 65 76 69 63 65 20 62 75 | 74 20 61 72 65 0d 69 6d |evice bu|t are.im|
|000009a0| 70 6c 65 6d 65 6e 74 65 | 64 20 69 6e 20 43 20 66 |plemente|d in C f|
|000009b0| 6f 72 20 65 66 66 69 63 | 69 65 6e 63 79 3a 0d 0d |or effic|iency:..|
|000009c0| 5c 72 65 6e 65 77 63 6f | 6d 6d 61 6e 64 7b 5c 69 |\renewco|mmand{\i|
|000009d0| 6e 64 65 78 73 75 62 69 | 74 65 6d 7d 7b 28 69 6e |ndexsubi|tem}{(in|
|000009e0| 20 6d 6f 64 75 6c 65 20 | 61 75 64 69 6f 29 7d 0d | module |audio)}.|
|000009f0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00000a00| 7b 61 6d 70 6c 69 66 79 | 7d 7b 62 75 66 5c 2c 20 |{amplify|}{buf\, |
|00000a10| 66 31 5c 2c 20 66 32 7d | 0d 41 6d 70 6c 69 66 69 |f1\, f2}|.Amplifi|
|00000a20| 65 73 20 61 20 63 68 75 | 6e 6b 20 6f 66 20 73 61 |es a chu|nk of sa|
|00000a30| 6d 70 6c 65 73 20 62 79 | 20 61 20 76 61 72 69 61 |mples by| a varia|
|00000a40| 62 6c 65 20 66 61 63 74 | 6f 72 20 63 68 61 6e 67 |ble fact|or chang|
|00000a50| 69 6e 67 20 66 72 6f 6d | 0d 5c 63 6f 64 65 7b 5c |ing from|.\code{\|
|00000a60| 76 61 72 7b 66 31 7d 2f | 32 35 36 7d 20 74 6f 20 |var{f1}/|256} to |
|00000a70| 5c 63 6f 64 65 7b 5c 76 | 61 72 7b 66 32 7d 2f 32 |\code{\v|ar{f2}/2|
|00000a80| 35 36 2e 7d 0d 4e 65 67 | 61 74 69 76 65 20 66 61 |56.}.Neg|ative fa|
|00000a90| 63 74 6f 72 73 20 61 72 | 65 20 61 6c 6c 6f 77 65 |ctors ar|e allowe|
|00000aa0| 64 2e 0d 52 65 73 75 6c | 74 69 6e 67 20 76 61 6c |d..Resul|ting val|
|00000ab0| 75 65 73 20 74 68 61 74 | 20 61 72 65 20 74 6f 20 |ues that| are to |
|00000ac0| 6c 61 72 67 65 20 74 6f | 20 66 69 74 20 69 6e 20 |large to| fit in |
|00000ad0| 61 20 62 79 74 65 20 61 | 72 65 20 63 6c 69 70 70 |a byte a|re clipp|
|00000ae0| 65 64 2e 20 20 20 20 20 | 20 20 20 20 0d 5c 65 6e |ed.     |    .\en|
|00000af0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000b00| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 72 65 |gin{func|desc}{re|
|00000b10| 76 65 72 73 65 7d 7b 62 | 75 66 7d 0d 52 65 74 75 |verse}{b|uf}.Retu|
|00000b20| 72 6e 73 20 61 20 63 68 | 75 6e 6b 20 6f 66 20 73 |rns a ch|unk of s|
|00000b30| 61 6d 70 6c 65 73 20 62 | 61 63 6b 77 61 72 64 73 |amples b|ackwards|
|00000b40| 2e 0d 5c 65 6e 64 7b 66 | 75 6e 63 64 65 73 63 7d |..\end{f|uncdesc}|
|00000b50| 0d 0d 5c 62 65 67 69 6e | 7b 66 75 6e 63 64 65 73 |..\begin|{funcdes|
|00000b60| 63 7d 7b 61 64 64 7d 7b | 62 75 66 31 5c 2c 20 62 |c}{add}{|buf1\, b|
|00000b70| 75 66 32 7d 0d 42 79 74 | 65 77 69 73 65 20 61 64 |uf2}.Byt|ewise ad|
|00000b80| 64 73 20 74 77 6f 20 63 | 68 75 6e 6b 73 20 6f 66 |ds two c|hunks of|
|00000b90| 20 73 61 6d 70 6c 65 73 | 2e 0d 42 79 74 65 73 20 | samples|..Bytes |
|00000ba0| 74 68 61 74 20 65 78 63 | 65 65 64 20 74 68 65 20 |that exc|eed the |
|00000bb0| 72 61 6e 67 65 20 61 72 | 65 20 63 6c 69 70 70 65 |range ar|e clippe|
|00000bc0| 64 2e 0d 49 66 20 6f 6e | 65 20 62 75 66 66 65 72 |d..If on|e buffer|
|00000bd0| 20 69 73 20 73 68 6f 72 | 74 65 72 2c 20 69 74 20 | is shor|ter, it |
|00000be0| 69 73 20 61 73 73 75 6d | 65 64 20 74 6f 20 62 65 |is assum|ed to be|
|00000bf0| 20 70 61 64 64 65 64 20 | 77 69 74 68 20 7a 65 72 | padded |with zer|
|00000c00| 6f 73 2e 0d 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |os..\end|{funcdes|
|00000c10| 63 7d 0d 0d 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|00000c20| 65 73 63 7d 7b 63 68 72 | 32 6e 75 6d 7d 7b 62 75 |esc}{chr|2num}{bu|
|00000c30| 66 7d 0d 43 6f 6e 76 65 | 72 74 73 20 61 20 73 74 |f}.Conve|rts a st|
|00000c40| 72 69 6e 67 20 6f 66 20 | 73 61 6d 70 6c 65 64 20 |ring of |sampled |
|00000c50| 62 79 74 65 73 20 61 73 | 20 72 65 74 75 72 6e 65 |bytes as| returne|
|00000c60| 64 20 62 79 20 5c 63 6f | 64 65 7b 72 65 61 64 28 |d by \co|de{read(|
|00000c70| 29 7d 20 69 6e 74 6f 0d | 61 20 6c 69 73 74 20 63 |)} into.|a list c|
|00000c80| 6f 6e 74 61 69 6e 69 6e | 67 20 74 68 65 20 6e 75 |ontainin|g the nu|
|00000c90| 6d 65 72 69 63 20 76 61 | 6c 75 65 73 20 6f 66 20 |meric va|lues of |
|00000ca0| 74 68 65 20 73 61 6d 70 | 6c 65 73 2e 0d 5c 65 6e |the samp|les..\en|
|00000cb0| 64 7b 66 75 6e 63 64 65 | 73 63 7d 0d 0d 5c 62 65 |d{funcde|sc}..\be|
|00000cc0| 67 69 6e 7b 66 75 6e 63 | 64 65 73 63 7d 7b 6e 75 |gin{func|desc}{nu|
|00000cd0| 6d 32 63 68 72 7d 7b 6c | 69 73 74 7d 0d 5c 62 65 |m2chr}{l|ist}.\be|
|00000ce0| 67 69 6e 7b 73 6c 6f 70 | 70 79 70 61 72 7d 0d 43 |gin{slop|pypar}.C|
|00000cf0| 6f 6e 76 65 72 74 73 20 | 61 20 6c 69 73 74 20 61 |onverts |a list a|
|00000d00| 73 20 72 65 74 75 72 6e | 65 64 20 62 79 0d 5c 63 |s return|ed by.\c|
|00000d10| 6f 64 65 7b 63 68 72 32 | 6e 75 6d 28 29 7d 0d 62 |ode{chr2|num()}.b|
|00000d20| 61 63 6b 20 74 6f 20 61 | 20 62 75 66 66 65 72 20 |ack to a| buffer |
|00000d30| 61 63 63 65 70 74 61 62 | 6c 65 20 62 79 0d 5c 63 |acceptab|le by.\c|
|00000d40| 6f 64 65 7b 77 72 69 74 | 65 28 29 7d 2e 0d 5c 65 |ode{writ|e()}..\e|
|00000d50| 6e 64 7b 73 6c 6f 70 70 | 79 70 61 72 7d 0d 5c 65 |nd{slopp|ypar}.\e|
|00000d60| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0d          |nd{funcd|esc}.   |
+--------+-------------------------+-------------------------+--------+--------+