%!PS-Adobe-2.0 %%Creator: dvipsk 5.58f Copyright 1986, 1994 Radical Eye Software %%Title: libmacall.dvi %%Pages: 29 %%PageOrder: Ascend %%BoundingBox: 0 0 596 842 %%DocumentFonts: Helvetica Helvetica-Oblique Times-Roman Times-Bold %%+ Times-Italic Courier Helvetica-Bold Courier-Bold %%DocumentPaperSizes: a4 %%EndComments %DVIPSCommandLine: dvips -f -N0 libmacall.dvi %DVIPSParameters: dpi=600, compressed, comments removed %DVIPSSource: TeX output 1998.04.28:1423 %%BeginProcSet: texc.pro /TeXDict 250 dict def TeXDict begin /N{def}def /B{bind def}N /S{exch}N /X{S N}B /TR{translate}N /isls false N /vsize 11 72 mul N /hsize 8.5 72 mul N /landplus90{false}def /@rigin{isls{[0 landplus90{1 -1}{-1 1} ifelse 0 0 0]concat}if 72 Resolution div 72 VResolution div neg scale isls{landplus90{VResolution 72 div vsize mul 0 exch}{Resolution -72 div hsize mul 0}ifelse TR}if Resolution VResolution vsize -72 div 1 add mul TR[matrix currentmatrix{dup dup round sub abs 0.00001 lt{round}if} forall round exch round exch]setmatrix}N /@landscape{/isls true N}B /@manualfeed{statusdict /manualfeed true put}B /@copies{/#copies X}B /FMat[1 0 0 -1 0 0]N /FBB[0 0 0 0]N /nn 0 N /IE 0 N /ctr 0 N /df-tail{ /nn 8 dict N nn begin /FontType 3 N /FontMatrix fntrx N /FontBBox FBB N string /base X array /BitMaps X /BuildChar{CharBuilder}N /Encoding IE N end dup{/foo setfont}2 array copy cvx N load 0 nn put /ctr 0 N[}B /df{ /sf 1 N /fntrx FMat N df-tail}B /dfs{div /sf X /fntrx[sf 0 0 sf neg 0 0] N df-tail}B /E{pop nn dup definefont setfont}B /ch-width{ch-data dup length 5 sub get}B /ch-height{ch-data dup length 4 sub get}B /ch-xoff{ 128 ch-data dup length 3 sub get sub}B /ch-yoff{ch-data dup length 2 sub get 127 sub}B /ch-dx{ch-data dup length 1 sub get}B /ch-image{ch-data dup type /stringtype ne{ctr get /ctr ctr 1 add N}if}B /id 0 N /rw 0 N /rc 0 N /gp 0 N /cp 0 N /G 0 N /sf 0 N /CharBuilder{save 3 1 roll S dup /base get 2 index get S /BitMaps get S get /ch-data X pop /ctr 0 N ch-dx 0 ch-xoff ch-yoff ch-height sub ch-xoff ch-width add ch-yoff setcachedevice ch-width ch-height true[1 0 0 -1 -.1 ch-xoff sub ch-yoff .1 sub]/id ch-image N /rw ch-width 7 add 8 idiv string N /rc 0 N /gp 0 N /cp 0 N{rc 0 ne{rc 1 sub /rc X rw}{G}ifelse}imagemask restore}B /G{{id gp get /gp gp 1 add N dup 18 mod S 18 idiv pl S get exec}loop}B /adv{cp add /cp X}B /chg{rw cp id gp 4 index getinterval putinterval dup gp add /gp X adv}B /nd{/cp 0 N rw exit}B /lsh{rw cp 2 copy get dup 0 eq{pop 1}{ dup 255 eq{pop 254}{dup dup add 255 and S 1 and or}ifelse}ifelse put 1 adv}B /rsh{rw cp 2 copy get dup 0 eq{pop 128}{dup 255 eq{pop 127}{dup 2 idiv S 128 and or}ifelse}ifelse put 1 adv}B /clr{rw cp 2 index string putinterval adv}B /set{rw cp fillstr 0 4 index getinterval putinterval adv}B /fillstr 18 string 0 1 17{2 copy 255 put pop}for N /pl[{adv 1 chg} {adv 1 chg nd}{1 add chg}{1 add chg nd}{adv lsh}{adv lsh nd}{adv rsh}{ adv rsh nd}{1 add adv}{/rc X nd}{1 add set}{1 add clr}{adv 2 chg}{adv 2 chg nd}{pop nd}]dup{bind pop}forall N /D{/cc X dup type /stringtype ne{] }if nn /base get cc ctr put nn /BitMaps get S ctr S sf 1 ne{dup dup length 1 sub dup 2 index S get sf div put}if put /ctr ctr 1 add N}B /I{ cc 1 add D}B /bop{userdict /bop-hook known{bop-hook}if /SI save N @rigin 0 0 moveto /V matrix currentmatrix dup 1 get dup mul exch 0 get dup mul add .99 lt{/QV}{/RV}ifelse load def pop pop}N /eop{SI restore userdict /eop-hook known{eop-hook}if showpage}N /@start{userdict /start-hook known{start-hook}if pop /VResolution X /Resolution X 1000 div /DVImag X /IE 256 array N 0 1 255{IE S 1 string dup 0 3 index put cvn put}for 65781.76 div /vsize X 65781.76 div /hsize X}N /p{show}N /RMat[1 0 0 -1 0 0]N /BDot 260 string N /rulex 0 N /ruley 0 N /v{/ruley X /rulex X V}B /V {}B /RV statusdict begin /product where{pop product dup length 7 ge{0 7 getinterval dup(Display)eq exch 0 4 getinterval(NeXT)eq or}{pop false} ifelse}{false}ifelse end{{gsave TR -.1 .1 TR 1 1 scale rulex ruley false RMat{BDot}imagemask grestore}}{{gsave TR -.1 .1 TR rulex ruley scale 1 1 false RMat{BDot}imagemask grestore}}ifelse B /QV{gsave newpath transform round exch round exch itransform moveto rulex 0 rlineto 0 ruley neg rlineto rulex neg 0 rlineto fill grestore}B /a{moveto}B /delta 0 N /tail {dup /delta X 0 rmoveto}B /M{S p delta add tail}B /b{S p tail}B /c{-4 M} B /d{-3 M}B /e{-2 M}B /f{-1 M}B /g{0 M}B /h{1 M}B /i{2 M}B /j{3 M}B /k{ 4 M}B /w{0 rmoveto}B /l{p -4 w}B /m{p -3 w}B /n{p -2 w}B /o{p -1 w}B /q{ p 1 w}B /r{p 2 w}B /s{p 3 w}B /t{p 4 w}B /x{0 S rmoveto}B /y{3 2 roll p a}B /bos{/SS save N}B /eos{SS restore}B end %%EndProcSet %%BeginProcSet: 8r.enc % @@psencodingfile@{ % author = "S. Rahtz, P. MacKay, Alan Jeffrey, B. Horn, K. Berry", % version = "0.6", % date = "22 June 1996", % filename = "8r.enc", % email = "kb@@mail.tug.org", % address = "135 Center Hill Rd. // Plymouth, MA 02360", % codetable = "ISO/ASCII", % checksum = "119 662 4424", % docstring = "Encoding for TrueType or Type 1 fonts to be used with TeX." % @} % % Idea is to have all the characters normally included in Type 1 fonts % available for typesetting. This is effectively the characters in Adobe % Standard Encoding + ISO Latin 1 + extra characters from Lucida. % % Character code assignments were made as follows: % % (1) the Windows ANSI characters are almost all in their Windows ANSI % positions, because some Windows users cannot easily reencode the % fonts, and it makes no difference on other systems. The only Windows % ANSI characters not available are those that make no sense for % typesetting -- rubout (127 decimal), nobreakspace (160), softhyphen % (173). quotesingle and grave are moved just because it's such an % irritation not having them in TeX positions. % % (2) Remaining characters are assigned arbitrarily to the lower part % of the range, avoiding 0, 10 and 13 in case we meet dumb software. % % (3) Y&Y Lucida Bright includes some extra text characters; in the % hopes that other PostScript fonts, perhaps created for public % consumption, will include them, they are included starting at 0x12. % % (4) Remaining positions left undefined are for use in (hopefully) % upward-compatible revisions, if someday more characters are generally % available. % % (5) hyphen appears twice for compatibility with both ASCII and Windows. % /TeXBase1Encoding [ % 0x00 (encoded characters from Adobe Standard not in Windows 3.1) /.notdef /dotaccent /fi /fl /fraction /hungarumlaut /Lslash /lslash /ogonek /ring /.notdef /breve /minus /.notdef % These are the only two remaining unencoded characters, so may as % well include them. /Zcaron /zcaron % 0x10 /caron /dotlessi % (unusual TeX characters available in, e.g., Lucida Bright) /dotlessj /ff /ffi /ffl /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef /.notdef % very contentious; it's so painful not having quoteleft and quoteright % at 96 and 145 that we move the things normally found there down to here. /grave /quotesingle % 0x20 (ASCII begins) /space /exclam /quotedbl /numbersign /dollar /percent /ampersand /quoteright /parenleft /parenright /asterisk /plus /comma /hyphen /period /slash % 0x30 /zero /one /two /three /four /five /six /seven /eight /nine /colon /semicolon /less /equal /greater /question % 0x40 /at /A /B /C /D /E /F /G /H /I /J /K /L /M /N /O % 0x50 /P /Q /R /S /T /U /V /W /X /Y /Z /bracketleft /backslash /bracketright /asciicircum /underscore % 0x60 /quoteleft /a /b /c /d /e /f /g /h /i /j /k /l /m /n /o % 0x70 /p /q /r /s /t /u /v /w /x /y /z /braceleft /bar /braceright /asciitilde /.notdef % rubout; ASCII ends % 0x80 /.notdef /.notdef /quotesinglbase /florin /quotedblbase /ellipsis /dagger /daggerdbl /circumflex /perthousand /Scaron /guilsinglleft /OE /.notdef /.notdef /.notdef % 0x90 /.notdef /.notdef /.notdef /quotedblleft /quotedblright /bullet /endash /emdash /tilde /trademark /scaron /guilsinglright /oe /.notdef /.notdef /Ydieresis % 0xA0 /.notdef % nobreakspace /exclamdown /cent /sterling /currency /yen /brokenbar /section /dieresis /copyright /ordfeminine /guillemotleft /logicalnot /hyphen % Y&Y (also at 45); Windows' softhyphen /registered /macron % 0xD0 /degree /plusminus /twosuperior /threesuperior /acute /mu /paragraph /periodcentered /cedilla /onesuperior /ordmasculine /guillemotright /onequarter /onehalf /threequarters /questiondown % 0xC0 /Agrave /Aacute /Acircumflex /Atilde /Adieresis /Aring /AE /Ccedilla /Egrave /Eacute /Ecircumflex /Edieresis /Igrave /Iacute /Icircumflex /Idieresis % 0xD0 /Eth /Ntilde /Ograve /Oacute /Ocircumflex /Otilde /Odieresis /multiply /Oslash /Ugrave /Uacute /Ucircumflex /Udieresis /Yacute /Thorn /germandbls % 0xE0 /agrave /aacute /acircumflex /atilde /adieresis /aring /ae /ccedilla /egrave /eacute /ecircumflex /edieresis /igrave /iacute /icircumflex /idieresis % 0xF0 /eth /ntilde /ograve /oacute /ocircumflex /otilde /odieresis /divide /oslash /ugrave /uacute /ucircumflex /udieresis /yacute /thorn /ydieresis ] def %%EndProcSet %%BeginProcSet: texps.pro TeXDict begin /rf{findfont dup length 1 add dict begin{1 index /FID ne 2 index /UniqueID ne and{def}{pop pop}ifelse}forall[1 index 0 6 -1 roll exec 0 exch 5 -1 roll VResolution Resolution div mul neg 0 0]/Metrics exch def dict begin Encoding{exch dup type /integertype ne{pop pop 1 sub dup 0 le{pop}{[}ifelse}{FontMatrix 0 get div Metrics 0 get div def} ifelse}forall Metrics /Metrics currentdict end def[2 index currentdict end definefont 3 -1 roll makefont /setfont load]cvx def}def /ObliqueSlant{dup sin S cos div neg}B /SlantFont{4 index mul add}def /ExtendFont{3 -1 roll mul exch}def /ReEncodeFont{/Encoding exch def}def end %%EndProcSet TeXDict begin 39158280 55380996 1000 600 600 (libmacall.dvi) @start /Fa 134[60 5[47 3[60 1[93 33 9[60 4[40 1[40 3[113 86 86 73 66 80 1[66 86 86 106 73 2[40 86 86 66 73 86 80 80 86 65[{ TeXBase1Encoding ReEncodeFont }28 119.999947 /Times-Roman rf /Fb 136[72 50 1[28 50 33 1[55 55 55 1[22 1[22 22 55 55 28 55 55 50 55 55 9[94 66 2[66 3[78 5[28 2[61 66 72 72 1[66 65[{ TeXBase1Encoding ReEncodeFont }29 100.000000 /Helvetica rf /Fc 133[50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 1[50 50 50 50 50 50 50 50 50 6[50 50 1[50 50 50 50 50 50 1[50 50 50 50 50 2[50 50 50 50 50 50 50 50 50 22[50 42[{ TeXBase1Encoding ReEncodeFont }48 83.333336 /Courier-Bold rf /Fd 134[72 4[72 72 72 1[72 72 72 72 72 72 1[72 72 72 72 72 72 72 72 72 9[72 3[72 3[72 1[72 6[72 72 72 2[72 65[{ TeXBase1Encoding ReEncodeFont }27 119.999947 /Courier rf /Fe 138[66 33 1[40 2[66 66 1[27 2[27 3[66 66 2[66 13[80 5[100 10[80 8[66 66 66 66 66 66 66 66 66 66 1[33 40 45[{ TeXBase1Encoding ReEncodeFont }25 119.999947 /Helvetica rf /Ff 168[113 2[73 1[86 2[93 86 5[86 2[80 69[{ TeXBase1Encoding ReEncodeFont }7 119.999947 /Helvetica-Bold rf /Fg 135[42 1[42 46 23 42 28 1[46 46 46 1[18 2[18 46 2[46 46 42 1[46 12[51 55 60 1[55 2[69 3[23 60 2[55 1[60 55 55 7[46 46 46 46 46 46 46 46 46 46 1[23 28 42[42 2[{ TeXBase1Encoding ReEncodeFont }40 83.333336 /Helvetica rf /Fh 133[50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 50 3[50 1[50 50 50 1[50 50 50 50 50 50 50 50 50 50 50 50 2[50 50 50 50 50 50 50 50 50 1[50 1[50 2[50 1[50 50 50 1[50 50 50 50 50 1[50 50 50 50 50 50 50 50 39[{ TeXBase1Encoding ReEncodeFont }70 83.333336 /Courier rf /Fi 133[32 37 37 55 37 42 23 32 32 42 42 42 42 60 23 37 23 23 42 42 23 37 42 37 42 42 8[51 4[42 51 1[51 60 55 69 46 2[28 1[60 51 1[60 55 1[51 6[28 7[42 3[21 1[21 1[42 38[42 42 2[{ TeXBase1Encoding ReEncodeFont }47 83.333336 /Times-Italic rf /Fj 133[37 42 42 1[42 46 28 32 37 1[46 42 46 69 23 46 1[23 46 42 28 37 46 37 46 42 9[83 1[60 55 46 3[65 1[78 3[32 2[51 55 60 2[60 7[42 42 42 42 42 42 42 42 42 42 3[21 41[46 2[{ TeXBase1Encoding ReEncodeFont } 46 83.333336 /Times-Bold rf /Fk 1 14 df<923803FFC0033F13FC4AB67E020715E0 913A1FFE007FF8DA7FE0EB07FE4AC87ED903FCED3FC0D907F0ED0FE0D90FC0ED03F04948 6F7E49CA7E017E177E498349834848EF0F80000319C04917074848EF03E0000F19F04917 0148CC12F8A2001E1978003E197CA2003C193C007C193EA20078191EA300F8191FA24819 0FAA6C191FA20078191EA3007C193EA2003C193C003E197CA2001E1978001F19F8A26C6C EF01F06D1703000719E06C6CEF07C06D170F000119806C6CEF1F006D5F017E177E6D5F6D 6C4B5A6D6C4B5AD907F0ED0FE0D903FCED3FC0D900FF03FFC7FCDA7FE0EB07FEDA1FFEEB 7FF80207B612E002011580DA003F01FCC8FC030313C0484E7BBB53>13 D E /Fl 104[83 2[37 37 24[37 42 42 60 42 42 23 32 28 42 42 42 42 65 23 42 23 23 42 42 28 37 42 37 42 37 28 6[60 1[78 60 60 51 46 55 60 46 60 60 74 51 60 1[28 60 60 46 51 60 55 55 60 5[23 23 42 42 42 42 42 42 42 42 42 42 23 21 28 21 2[28 28 28 35[46 46 2[{ TeXBase1Encoding ReEncodeFont }74 83.333336 /Times-Roman rf /Fm 134[37 37 2[42 21 37 25 1[42 42 42 4[17 42 42 21 42 42 2[42 10[50 54 1[50 54 3[54 4[21 3[50 1[54 2[76 5[21 10[21 21 46[{ TeXBase1Encoding ReEncodeFont }28 75.000000 /Helvetica rf /Fn 137[50 1[28 39 33 1[50 50 50 78 28 2[28 50 1[33 44 1[44 1[44 9[94 72 72 1[55 66 1[55 1[72 4[33 3[61 72 66 1[72 6[28 50 50 2[50 50 1[50 50 50 2[33 25 2[33 33 40[{ TeXBase1Encoding ReEncodeFont }39 100.000000 /Times-Roman rf /Fo 137[72 80 1[72 3[80 80 120 3[32 4[80 2[80 14[104 10[112 71[{ TeXBase1Encoding ReEncodeFont }11 144.000000 /Helvetica rf /Fp 140[72 6[32 6[80 3[80 14[104 28[80 3[80 2[40 46[{ TeXBase1Encoding ReEncodeFont }8 144.000000 /Helvetica-Oblique rf /Fq 134[103 2[103 115 57 103 69 1[115 115 115 172 46 2[46 115 1[57 115 115 103 115 115 8[138 2[149 126 138 149 1[138 161 149 172 115 2[57 3[138 149 149 22[57 41[103 2[{ TeXBase1Encoding ReEncodeFont } 35 207.333359 /Helvetica rf end %%EndProlog %%BeginSetup %%Feature: *Resolution 600dpi TeXDict begin %%PaperSize: a4 %%EndSetup %%Page: 1 1 1 0 bop 0 83 3761 9 v 368 446 a Fq(Python)57 b(Libr)n(ar)6 b(y)57 b(Ref)-6 b(erence)m(,)57 b(Macintosh)2785 695 y(addendum)2875 925 y Fp(Release)39 b(1.5.1)2544 2159 y Fo(Guido)g(v)l(an)h(Rossum)3177 4332 y Fn(April)24 b(14,)g(1998)1631 5500 y(Corporation)h(for)g(National)f(Research)i (Initiati)n(v)o(es)c(\(CNRI\))1717 5616 y(1895)i(Preston)h(White)f(Dri) n(v)o(e,)g(Reston,)g(V)-11 b(a)25 b(20191,)f(USA)1841 5733 y(E-mail:)30 b Fm(guido@CNRI.Reston.V)-5 b(a.US)p Fn(,)19 b Fm(guido@p)n(ython.org)p eop %%Page: 2 2 2 1 bop 0 83 a Fl(Cop)o(yright)380 80 y(c)357 83 y Fk(\015)20 b Fl(1991-1995)d(by)j(Stichting)f(Mathematisch)g(Centrum,)h(Amsterdam,) e(The)i(Netherlands.)1544 313 y(All)h(Rights)g(Reserv)o(ed)0 543 y(Permission)15 b(to)i(use,)f(cop)o(y)-5 b(,)16 b(modify)-5 b(,)14 b(and)h(distrib)n(ute)h(this)g(softw)o(are)g(and)f(its)i (documentation)c(for)i(an)o(y)g(purpose)g(and)g(without)g(fee)0 642 y(is)20 b(hereby)e(granted,)f(pro)o(vided)g(that)i(the)h(abo)o(v)o (e)d(cop)o(yright)g(notice)i(appear)f(in)h(all)h(copies)f(and)g(that)g (both)f(that)i(cop)o(yright)d(notice)0 742 y(and)27 b(this)i (permission)e(notice)g(appear)g(in)h(supporting)e(documentation,)g(and) i(that)g(the)g(names)f(of)h(Stichting)f(Mathematisch)0 842 y(Centrum)19 b(or)h(CWI)h(or)f(Corporation)e(for)i(National)f (Research)h(Initiati)n(v)o(es)g(or)g(CNRI)h(not)f(be)g(used)g(in)g(adv) o(ertising)f(or)g(publicity)0 941 y(pertaining)f(to)j(distrib)n(ution)e (of)h(the)g(softw)o(are)g(without)f(speci\002c,)h(written)g(prior)f (permission.)0 1088 y(While)29 b(CWI)g(is)g(the)f(initial)g(source)f (for)h(this)g(softw)o(are,)i(a)e(modi\002ed)f(v)o(ersion)g(is)i(made)f (a)n(v)n(ailable)f(by)h(the)g(Corporation)e(for)0 1188 y(National)20 b(Research)g(Initiati)n(v)o(es)f(\(CNRI\))i(at)f(the)h (Internet)d(address)i Fm(ftp://ftp)m(.p)n(ython.org)-5 b Fl(.)0 1335 y(STICHTING)25 b(MA)-9 b(THEMA)g(TISCH)25 b(CENTR)m(UM)h(AND)g(CNRI)h(DISCLAIM)e(ALL)h(W)-10 b(ARRANTIES)26 b(WITH)g(REGARD)0 1434 y(T)o(O)j(THIS)g(SOFTW)-10 b(ARE,)29 b(INCLUDING)g(ALL)g(IMPLIED)f(W)-10 b(ARRANTIES)30 b(OF)f(MERCHANT)-8 b(ABILITY)29 b(AND)g(FIT)-8 b(-)0 1534 y(NESS,)18 b(IN)h(NO)f(EVENT)g (SHALL)g(STICHTING)g(MA)-9 b(THEMA)g(TISCH)17 b(CENTR)m(UM)h(OR)h(CNRI) g(BE)g(LIABLE)f(FOR)h(ANY)0 1634 y(SPECIAL,)24 b(INDIRECT)f(OR)i (CONSEQ)o(UENTIAL)e(D)m(AMA)m(GES)g(OR)i(ANY)f(D)m(AMA)m(GES)f(WHA)-9 b(TSOEVER)24 b(RESUL)-8 b(T)g(-)0 1733 y(ING)32 b(FR)m(OM)g(LOSS)h(OF)f (USE,)g(D)m(A)-9 b(T)h(A)32 b(OR)h(PR)m(OFITS,)f(WHETHER)g(IN)g(AN)h(A) m(CTION)e(OF)i(CONTRA)m(CT)-6 b(,)32 b(NEGLI-)0 1833 y(GENCE)25 b(OR)h(O)m(THER)e(T)o(OR)-5 b(TIOUS)25 b(A)m(CTION,)f (ARISING)h(OUT)g(OF)g(OR)h(IN)f(CONNECTION)g(WITH)f(THE)h(USE)g(OR)0 1932 y(PERFORMANCE)c(OF)g(THIS)f(SOFTW)-10 b(ARE.)p eop %%Page: 1 3 1 2 bop 1726 2767 a Fj(Abstract)0 2997 y Fl(Python)21 b(is)i(an)f(e)o(xtensible,)g(interpreted,)e(object-oriented)g (programming)f(language.)29 b(It)22 b(supports)f(a)i(wide)f(range)f(of) h(applica-)0 3097 y(tions,)e(from)f(simple)h(te)o(xt)g(processing)f (scripts)i(to)f(interacti)n(v)o(e)f(WWW)j(bro)n(wsers.)0 3244 y(This)k(manual)f(describes)h(modules)f(that)h(are)g(speci\002c)h (to)f(the)g(implementation)e(of)i(Python)f(on)h(the)g(Apple)f (Macintosh,)i(and)0 3343 y(should)19 b(be)h(used)g(as)h(an)f(addendum)e (to)i(the)g(platform-independent)c Fi(Python)j(Libr)o(ary)h(Refer)m (ence)p Fl(.)p eop %%Page: 2 4 2 3 bop eop %%Page: 1 5 1 4 bop 2625 747 a Fq(CONTENTS)0 1594 y Fj(1)83 b(Intr)o(oduction)3142 b(1)0 1777 y(2)83 b(Unimplemented)21 b(Modules)2702 b(3)0 1959 y(3)83 b(Macintosh)20 b(Speci\002c)h(Ser)o(vices)2617 b(5)125 2059 y Fl(3.1)85 b(Built-in)21 b(Module)e Fh(mac)55 b Fl(.)42 b(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(6)125 2159 y(3.2)85 b(Standard)19 b(Module)g Fh(macpath)68 b Fl(.)42 b(.)f(.)g(.)g(.)h(.)f (.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.) h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(6)125 2258 y(3.3)85 b(Built-in)21 b(Module)e Fh(ctb)55 b Fl(.)42 b(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(6)315 2358 y(connection)19 b(object)50 b(.)41 b(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(6)125 2457 y(3.4)85 b(Built-in)21 b(Module)e Fh(macfs)80 b Fl(.)41 b(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) f(.)g(.)g(.)h(.)f(.)128 b(7)315 2557 y(FSSpec)21 b(objects)66 b(.)42 b(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.) f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(9)315 2657 y(Alias)21 b(Objects)65 b(.)41 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)128 b(9)315 2756 y(FInfo)20 b(Objects)55 b(.)41 b(.)h(.)f(.)g(.)h(.)f(.)g (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)128 b(9)125 2856 y(3.5)85 b(Standard)19 b(Module)g Fh(ic)69 b Fl(.)42 b(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.) f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(10)315 2956 y(IC)21 b(Objects)33 b(.)41 b(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)87 b(10)125 3055 y(3.6)e(Built-in)21 b(Module)e Fh(MacOS)80 b Fl(.)41 b(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.) f(.)g(.)g(.)h(.)f(.)87 b(11)125 3155 y(3.7)e(Standard)19 b(Module)g Fh(macostools)43 b Fl(.)e(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(12)125 3254 y(3.8)e(Standard)19 b(Module)g Fh(findertools)55 b Fl(.)41 b(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(12)125 3354 y(3.9)e(Built-in)21 b(Module)e Fh(macspeech)67 b Fl(.)41 b(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.) h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(13)315 3454 y(V)-11 b(oice)21 b(Objects)52 b(.)41 b(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)87 b(13)315 3553 y(Speech)20 b(Channel)f(Objects)77 b(.)41 b(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f (.)g(.)g(.)h(.)f(.)87 b(14)125 3653 y(3.10)43 b(Standard)19 b(Module)g Fh(EasyDialogs)55 b Fl(.)41 b(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.) h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(14)125 3753 y(3.11)43 b(Standard)19 b(Module)g Fh(FrameWork)31 b Fl(.)41 b(.)g(.)g(.)h(.)f(.) g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h (.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(15)315 3852 y(Application)19 b(Objects)35 b(.)41 b(.)h(.)f(.)g(.)g(.) h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.) f(.)87 b(15)315 3952 y(W)m(indo)n(w)20 b(Objects)h(.)42 b(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.) f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(16)315 4051 y(ControlsW)m(indo)n (w)19 b(Object)79 b(.)41 b(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.) h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(17)315 4151 y(ScrolledW)m(indo)n(w)18 b(Object)27 b(.)41 b(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)87 b(17)315 4251 y(DialogW)m(indo)n(w)19 b(Objects)45 b(.)c(.)g(.)g(.)h(.) f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) 87 b(17)125 4350 y(3.12)43 b(Standard)19 b(Module)g Fh(MiniAEFrame)55 b Fl(.)41 b(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g (.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.) 87 b(18)315 4450 y(AEServ)o(er)19 b(Objects)39 b(.)i(.)g(.)h(.)f(.)g(.) g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.)h(.)f (.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)g(.)h(.)f(.)g(.)h(.)f(.)g(.)g(.) h(.)f(.)87 b(18)0 4633 y Fj(Module)21 b(Index)3182 b(19)0 4815 y(Index)3475 b(21)p 0 5965 3761 4 v 3742 6065 a Fg(i)p eop %%Page: 2 6 2 5 bop 0 5965 3761 4 v 0 6065 a Fg(ii)p eop %%Page: 1 7 1 6 bop 0 83 3761 9 v 3364 230 a Fg(CHAPTER)3502 427 y Ff(ONE)p 0 515 V 2681 978 a Fq(Introduction)0 1457 y Fl(This)27 b(manual)f(describes)h(the)g(MacOS-speci\002c)f(modules)g (a)n(v)n(ailable)h(in)g(Python)f(for)g(the)h(Apple)g(Macintosh.)44 b(Most)27 b(of)g(the)0 1556 y(modules)19 b(described)g(in)h(the)h Fi(Python)e(Libr)o(ary)h(Refer)m(ence)f Fl(are)h(also)h(a)n(v)n (ailable,)e(with)i(the)f(e)o(xceptions)f(listed)h(belo)n(w)-5 b(.)0 1703 y(F)o(or)21 b(quite)f(a)i(fe)n(w)e(modules)g(this)i(manual)e (does)g(not)h(gi)n(v)o(e)f(enough)f(information,)g(and)h(you)g(will)i (need)e(additional)g(documenta-)0 1803 y(tion.)j(This)17 b(is)g(the)f(case)h(for)f(the)g Fi(toolbox)f(modules)p Fl(,)h(for)f(which)h(Apple')-5 b(s)16 b Fi(Inside)g(Macintosh)f Fl(is)i(the)g(motherlode)d(of)i(information)0 1902 y(and)j(the)i Fi(waste)f Fl(module,)f(for)g(which)h(you)f(need)g(the)h(documentation) d(for)j(the)g(C)h(API.)f(Pointers)g(to)g(internet-based)e(sources)h(of) 0 2002 y(these)h(documents)f(are)h(a)n(v)n(ailable)g(in)g(the)g (documentation)d(included)i(with)i(the)f(MacPython)e(installer)-5 b(.)p 0 5965 3761 4 v 3714 6065 a Fg(1)p eop %%Page: 2 8 2 7 bop 0 5965 3761 4 v 0 6065 a Fg(2)p eop %%Page: 3 9 3 8 bop 0 83 3761 9 v 3364 230 a Fg(CHAPTER)3484 427 y Ff(TW)n(O)p 0 515 V 1476 978 a Fq(Unimplemented)57 b(Modules)0 1466 y Fl(The)23 b(follo)n(wing)e(modules)h(described)g(in) h(the)g Fi(Python)e(Libr)o(ary)i(Refer)m(ence)g Fl(are)g(not)f(a)n(v)n (ailable)h(or)g(not)f(fully)h(implemented)e(on)0 1565 y(the)f(Macintosh:)0 1795 y Fj(locale)40 b Fl(\227)21 b(No)f(support)f(for)h(locale)g(setting)g(in)g(the)h(underlying)c(C)k (implementation)d(\(yet\).)0 1961 y Fj(signal)41 b Fl(\227)21 b(Unix-speci\002c)0 2127 y Fj(thr)o(ead)40 b Fl(\227)21 b(No)f(support)f(for)h(multiple)f(threads)h(in)g(MacPython)f(\(yet\).)0 2293 y Fj(posix)41 b Fl(\227)21 b Fh(mac)f Fl(pro)o(vides)e(similar)j (functionality)-5 b(,)17 b(and)j(you)f(should)g(use)i Fh(os)f Fl(an)o(yw)o(ay)-5 b(...)0 2459 y Fj(crypt)41 b Fl(\227)20 b(Unix-speci\002c)0 2625 y Fj(dbm)42 b Fl(\227)21 b(Unix-speci\002c,)e(b)n(ut)h Fh(gdbm)g Fl(is)h(a)n(v)n(ailable.)0 2791 y Fj(termios)41 b Fl(\227)21 b(Unix-speci\002c.)j(Similar)c (functionality)e(is)j(a)n(v)n(ailable)f(in)g Fh(ctb)p Fl(.)0 2957 y Fj(fcntl,)g(r)o(esour)o(ce,)f(syslog)40 b Fl(\227)21 b(Unix-speci\002c.)0 3123 y Fj(mpz)0 3353 y Fl(Additionally)-5 b(,)14 b(the)i(modules)f(described)f(in)i(the)g Fi(SGI)g(IRIX)f(Speci\002c)f(services)j Fl(and)e Fi(SunOS)g(Speci\002c) f(Services)i Fl(are)g(not)g(a)n(v)n(ailable)0 3453 y(either)-5 b(.)p 0 5965 3761 4 v 3714 6065 a Fg(3)p eop %%Page: 4 10 4 9 bop 0 5965 3761 4 v 0 6065 a Fg(4)p eop %%Page: 5 11 5 10 bop 0 83 3761 9 v 3364 230 a Fg(CHAPTER)3355 427 y Ff(THREE)p 0 515 V 1183 978 a Fq(Macintosh)58 b(Speci\002c)f(Ser)6 b(vices)0 1465 y Fl(The)20 b(modules)f(in)h(this)h(chapter)e(are)h(a)n (v)n(ailable)g(on)g(the)g(Apple)g(Macintosh)f(only)-5 b(.)0 1612 y(Aside)20 b(from)g(the)g(modules)f(described)g(here)g (there)h(are)g(also)h(interf)o(aces)e(to)i(v)n(arious)e(MacOS)h (toolbox)o(es,)e(which)i(are)g(currently)0 1712 y(not)g(e)o(xtensi)n(v) o(ely)f(described.)26 b(The)20 b(toolbox)o(es)f(for)h(which)h(modules)e (e)o(xist)i(are:)27 b Fh(AE)21 b Fl(\(Apple)f(Ev)o(ents\),)f Fh(Cm)i Fl(\(Component)e(Man-)0 1812 y(ager\),)25 b Fh(Ctl)f Fl(\(Control)g(Manager\),)f Fh(Dlg)i Fl(\(Dialog)f(Manager\),)f Fh(Evt)i Fl(\(Ev)o(ent)e(Manager\),)h Fh(Fm)h Fl(\(F)o(ont)f (Manager\),)f Fh(List)i Fl(\(List)0 1911 y(Manager\),)c Fh(Menu)h Fl(\(Moenu)f(Manager\),)g Fh(Qd)h Fl(\(QuickDra)o(w\),)f Fh(Qt)i Fl(\(QuickT)m(ime\),)d Fh(Res)j Fl(\(Resource)e(Manager)g(and)h (Handles\),)0 2011 y Fh(Scrap)f Fl(\(Scrap)g(Manager\),)f Fh(Snd)i Fl(\(Sound)e(Manager\),)g Fh(TE)i Fl(\(T)-6 b(e)o(xtEdit\),)20 b Fh(Waste)i Fl(\(non-Apple)d Fj(T)-8 b(extEdit)22 b Fl(replacement\))e(and)0 2110 y Fh(Win)g Fl(\(W)m(indo)n(w)f(Manager\).)0 2257 y(If)g(applicable)e(the)i(module) e(will)j(de\002ne)e(a)h(number)e(of)i(Python)e(objects)i(for)f(the)h(v) n(arious)e(structures)i(declared)e(by)h(the)h(toolbox,)0 2357 y(and)i(operations)e(will)j(be)f(implemented)f(as)h(methods)g(of)f (the)i(object.)27 b(Other)21 b(operations)e(will)j(be)f(implemented)f (as)i(functions)0 2457 y(in)j(the)g(module.)37 b(Not)25 b(all)g(operations)e(possible)i(in)g(C)g(will)h(also)f(be)g(possible)f (in)h(Python)f(\(callbacks)g(are)g(often)g(a)i(problem\),)0 2556 y(and)e(parameters)g(will)i(occasionally)e(be)h(dif)n(ferent)e(in) i(Python)f(\(input)g(and)h(output)e(b)n(uf)n(fers,)i(especially\).)39 b(All)26 b(methods)e(and)0 2656 y(functions)f(ha)n(v)o(e)g(a)p 578 2656 25 4 v 608 2656 V 84 w Fh(doc)p 788 2656 V 817 2656 V 84 w Fl(string)h(describing)e(their)i(ar)o(guments)e(and)h (return)g(v)n(alues,)h(and)g(for)f(additional)g(description)f(you)0 2755 y(are)e(referred)f(to)h Fi(Inside)g(Macintosh)f Fl(or)h(similar)g(w)o(orks.)0 2902 y(The)g(follo)n(wing)e(modules)i (are)g(documented)d(here:)0 3132 y Fj(mac)41 b Fl(\227)21 b(Similar)f(interf)o(aces)g(to)g(the)g Fh(posix)g Fl(module.)0 3298 y Fj(macpath)41 b Fl(\227)20 b(P)o(ath)g(manipulation)e (functions;)h(use)i(via)f Fh(os.path)o Fl(.)0 3464 y Fj(ctb)41 b Fl(\227)21 b(Interf)o(aces)e(to)h(the)h(Communications)d(T) -7 b(ool)20 b(Box.)25 b(Only)19 b(the)i(Connection)d(Manager)h(is)i (currently)e(supported.)0 3630 y Fj(macconsole)40 b Fl(\227)21 b(Think)e(C')-5 b(s)22 b(console)d(package)g(is)i(a)n(v)n(ailable)f (using)f(this)i(module.)0 3796 y Fj(macdnr)41 b Fl(\227)21 b(Interf)o(aces)e(to)i(the)f(Macintosh)f(Domain)g(Name)h(Resolv)o(er)-5 b(.)0 3962 y Fj(macfs)41 b Fl(\227)21 b(Support)d(for)i(FSSpec,)g(the)g (Alias)h(Manager)m(,)e Fj(\002nder)i Fl(aliases,)f(and)g(the)g (Standard)f(File)i(package.)0 4128 y Fj(macic)41 b Fl(\227)21 b(Internet)e(Con\002g.)0 4294 y Fj(MacOS)41 b Fl(\227)21 b(Access)g(to)f(MacOS)g(speci\002c)h(interpreter)d(features.)0 4461 y Fj(macostools)40 b Fl(\227)21 b(Con)m(v)o(enience)c(routines)j (for)f(\002le)i(manipulation.)0 4627 y Fj(\002ndertools)41 b Fl(\227)21 b(Wrappers)e(around)f(the)j Fj(\002nder)p Fl(')-5 b(s)21 b(Apple)e(Ev)o(ents)h(interf)o(ace.)0 4793 y Fj(mactcp)41 b Fl(\227)20 b(The)g(MacTCP)h(interf)o(aces.)0 4959 y Fj(macspeech)41 b Fl(\227)21 b(Interf)o(ace)e(to)h(the)g (Macintosh)g(Speech)f(Manager)-5 b(.)0 5125 y Fj(EasyDialogs)40 b Fl(\227)21 b(Basic)g(Macintosh)e(dialogs.)0 5291 y Fj(FrameW)-6 b(ork)40 b Fl(\227)21 b(Interacti)n(v)o(e)d(application)h (frame)n(w)o(ork.)0 5457 y Fj(MiniAEFrame)42 b Fl(\227)20 b(Support)f(to)h(act)h(as)g(an)f(Open)g(Scripting)f(Architecture)g (\(OSA\))h(serv)o(er)f(\(\223)-7 b(Apple)19 b(Ev)o(ents\224\).)p 0 5965 3761 4 v 3714 6065 a Fg(5)p eop %%Page: 6 12 6 11 bop 0 86 a Fe(3.1)121 b(Built-in)32 b(Module)j Fd(mac)0 319 y Fl(This)24 b(module)e(pro)o(vides)g(a)i(subset)f(of)g(the)h (operating)e(system)h(dependent)f(functionality)f(pro)o(vided)g(by)i (the)h(optional)e(b)n(uilt-in)0 419 y(module)d Fh(posix)p Fl(.)24 b(It)d(is)g(best)f(accessed)h(through)d(the)i(more)f(portable)g (standard)g(module)g Fh(os)p Fl(.)0 566 y(The)k(follo)n(wing)f (functions)g(are)i(a)n(v)n(ailable)f(in)g(this)h(module:)31 b Fh(chdir\(\))p Fl(,)23 b Fh(close\(\))p Fl(,)g Fh(dup\(\))p Fl(,)h Fh(fdopen\(\))p Fl(,)f Fh(getcwd\(\))p Fl(,)0 665 y Fh(lseek\(\))p Fl(,)59 b Fh(listdir\(\))p Fl(,)g Fh(mkdir\(\))p Fl(,)g Fh(open\(\))p Fl(,)g Fh(read\(\))p Fl(,)h Fh(rename\(\))p Fl(,)f Fh(rmdir\(\))p Fl(,)g Fh(stat\(\))p Fl(,)g Fh(sync\(\))p Fl(,)0 765 y Fh(unlink\(\))p Fl(,)23 b Fh(write\(\))p Fl(,)f(as)i(well)g(as)f(the)g(e)o(xception)e Fh(error)p Fl(.)33 b(Note)23 b(that)h(the)f(times)g(returned)e(by)i Fh(stat\(\))f Fl(are)h(\003oating-)0 865 y(point)c(v)n(alues,)h(lik)o (e)g(all)h(time)g(v)n(alues)e(in)i(MacPython.)0 1011 y(One)e(additional)f(function)g(is)i(a)n(v)n(ailable:)25 b Fh(xstat\(\))p Fl(.)e(This)d(function)e(returns)g(the)h(same)h (information)d(as)j Fh(stat\(\))p Fl(,)f(b)n(ut)g(with)0 1111 y(three)h(e)o(xtra)f(v)n(alues)h(appended:)j(the)d(size)h(of)f (the)g(resource)f(fork)g(of)h(the)g(\002le)h(and)f(its)h(4-char)e (creator)g(and)h(type.)0 1438 y Fe(3.2)121 b(Standard)35 b(Module)f Fd(macpath)0 1671 y Fl(This)20 b(module)f(pro)o(vides)f(a)i (subset)g(of)g(the)g(pathname)e(manipulation)f(functions)i(a)n(v)n (ailable)g(from)g(the)h(optional)f(standard)f(mod-)0 1771 y(ule)i Fh(posixpath)p Fl(.)k(It)c(is)i(best)e(accessed)g(through) e(the)j(more)e(portable)g(standard)g(module)g Fh(os)p Fl(,)h(as)h Fh(os.path)n Fl(.)0 1918 y(The)35 b(follo)n(wing)e (functions)g(are)i(a)n(v)n(ailable)g(in)g(this)g(module:)53 b Fh(normcase\(\))p Fl(,)37 b Fh(normpath\(\))p Fl(,)g Fh(isabs\(\))p Fl(,)h Fh(join\(\))p Fl(,)0 2017 y Fh(split\(\))p Fl(,)17 b Fh(isdir\(\))p Fl(,)g Fh(isfile\(\))p Fl(,)g Fh(walk\(\))p Fl(,)g Fh(exists\(\))p Fl(.)23 b(F)o(or)17 b(other)g(functions)f(a)n(v)n(ailable)h(in)h Fh(posixpath)e Fl(dummy)0 2117 y(counterparts)i(are)i(a)n(v)n(ailable.)0 2444 y Fe(3.3)121 b(Built-in)32 b(Module)j Fd(ctb)0 2677 y Fl(This)22 b(module)e(pro)o(vides)g(a)i(partial)f(interf)o(ace)g(to)h (the)g(Macintosh)f(Communications)e(T)-7 b(oolbox.)28 b(Currently)-5 b(,)20 b(only)h(Connection)0 2777 y(Manager)e(tools)h (are)g(supported.)j(It)e(may)e(not)h(be)g(a)n(v)n(ailable)g(in)g(all)h (Mac)f(Python)f(v)o(ersions.)0 2924 y Fc(error)208 3023 y Fl(The)g(e)o(xception)g(raised)h(on)f(errors.)0 3170 y Fc(cmData)0 3270 y(cmCntl)0 3370 y(cmAttn)208 3469 y Fl(Flags)h(for)g(the)g Fi(c)o(hannel)e Fl(ar)o(gument)g(of)i(the)g Fh(Read\(\))g Fl(and)g Fh(Write\(\))f Fl(methods.)0 3616 y Fc(cmFlagsEOM)208 3716 y Fl(End-of-message)e(\003ag)j(for)g Fh(Read\(\))f Fl(and)h Fh(Write\(\))p Fl(.)0 3863 y Fc(choose*)208 3962 y Fl(V)-9 b(alues)20 b(returned)e(by)i Fh(Choose\(\))p Fl(.)0 4109 y Fc(cmStatus*)208 4209 y Fl(Bits)h(in)f(the)h(status)g(as) f(returned)f(by)h Fh(Status\(\))p Fl(.)0 4356 y Fc(available)n Fh(\(\))208 4455 y Fl(Return)f Fh(1)i Fl(if)f(the)h(Communication)c(T) -7 b(oolbox)19 b(is)i(a)n(v)n(ailable,)e(zero)h(otherwise.)0 4602 y Fc(CMNew)o Fh(\()p Fi(name)o(,)f(sizes)q Fh(\))208 4702 y Fl(Create)k(a)g(connection)e(object)i(using)f(the)i(connection)d (tool)h(named)g Fi(name)o Fl(.)34 b Fi(sizes)25 b Fl(is)f(a)f(6-tuple)f (gi)n(v)o(en)g(b)n(uf)n(fer)g(sizes)i(for)208 4801 y(data)18 b(in,)h(data)g(out,)g(control)e(in,)i(control)f(out,)g(attention)g(in)h (and)g(attention)f(out.)24 b(Alternati)n(v)o(ely)-5 b(,)16 b(passing)j Fh(None)g Fl(for)f Fi(sizes)208 4901 y Fl(will)i(result)h (in)f(def)o(ault)g(b)n(uf)n(fer)e(sizes.)0 5186 y Fb(connection)29 b(object)0 5389 y Fl(F)o(or)23 b(all)g(connection)e(methods)g(that)i (tak)o(e)g(a)h Fi(timeout)g Fl(ar)o(gument,)d(a)i(v)n(alue)f(of)h Fh(-1)g Fl(is)g(inde\002nite,)g(meaning)e(that)i(the)g(command)0 5488 y(runs)d(to)g(completion.)0 5635 y Fc(callback)208 5735 y Fl(If)c(this)h(member)e(is)i(set)g(to)g(a)f(v)n(alue)g(other)g (than)f Fh(None)i Fl(it)g(should)e(point)h(to)g(a)h(function)d (accepting)i(a)g(single)h(ar)o(gument)d(\(the)p 0 5965 3761 4 v 0 6065 a Fg(6)2239 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r(vices)p eop %%Page: 7 13 7 12 bop 208 83 a Fl(connection)20 b(object\).)33 b(This)23 b(will)h(mak)o(e)f(all)g(connection)e(object)i(methods)f(w)o(ork)g (asynchronously)-5 b(,)20 b(with)j(the)g(callback)208 183 y(routine)c(being)g(called)h(upon)f(completion.)208 315 y Fi(Note:)27 b Fl(for)21 b(reasons)h(be)o(yond)d(my)i (understanding)e(the)i(callback)g(routine)f(is)j(currently)d(ne)n(v)o (er)g(called.)29 b(Y)-9 b(ou)21 b(are)g(advised)208 415 y(against)e(using)h(asynchronous)d(calls)k(for)f(the)g(time)g(being.)0 562 y Fc(Open)o Fh(\()p Fi(timeout)q Fh(\))208 662 y Fl(Open)f(an)h(outgoing)e(connection,)g(w)o(aiting)i(at)h(most)f Fi(timeout)h Fl(seconds)f(for)f(the)i(connection)d(to)i(be)g (established.)0 808 y Fc(Listen)o Fh(\()p Fi(timeout)p Fh(\))208 908 y Fl(W)-7 b(ait)21 b(for)f(an)h(incoming)e(connection.)k (Stop)e(w)o(aiting)f(after)g Fi(timeout)i Fl(seconds.)j(This)c(call)g (is)h(only)d(meaningful)g(to)h(some)208 1008 y(tools.)0 1155 y Fc(accept)o Fh(\()p Fi(yesno)o Fh(\))208 1254 y Fl(Accept)f(\(when)h Fi(yesno)f Fl(is)j(non-zero\))17 b(or)j(reject)g(an)g(incoming)f(call)h(after)g Fh(Listen\(\))f Fl(returned.)0 1401 y Fc(Close)o Fh(\()p Fi(timeout,)g(now)p Fh(\))208 1501 y Fl(Close)24 b(a)g(connection.)32 b(When)23 b Fi(now)h Fl(is)g(zero,)f(the)h(close)f(is)i(orderly)d(\(i.e.)h (outstanding)e(output)h(is)j(\003ushed,)e(etc.\))g(with)h(a)208 1600 y(timeout)19 b(of)h Fi(timeout)h Fl(seconds.)k(When)20 b Fi(now)g Fl(is)h(non-zero)d(the)i(close)g(is)h(immediate,)e (discarding)g(output.)0 1747 y Fc(Read)o Fh(\()p Fi(len,)h(c)o(han,)f (timeout)p Fh(\))208 1847 y Fl(Read)27 b Fi(len)g Fl(bytes,)i(or)e (until)h Fi(timeout)g Fl(seconds)f(ha)n(v)o(e)g(passed,)h(from)f(the)g (channel)f Fi(c)o(han)g Fl(\(which)h(is)h(one)f(of)g Fh(cmData)p Fl(,)208 1946 y Fh(cmCntl)19 b Fl(or)h Fh(cmAttn)p Fl(\).)k(Return)c(a)g(2-tuple:)g(the)g(data)g(read)f(and)h(the)g (end-of-message)e(\003ag,)i Fh(cmFlagsEOM)p Fl(.)0 2093 y Fc(Write)o Fh(\()p Fi(b)n(uf)o(,)g(c)o(han,)f(timeout,)g(eom)p Fh(\))208 2193 y Fl(Write)g Fi(b)n(uf)30 b Fl(to)19 b(channel)e Fi(c)o(han)n Fl(,)i(aborting)e(after)h Fi(timeout)h Fl(seconds.)24 b(When)18 b Fi(eom)g Fl(has)h(the)f(v)n(alue)g Fh(cmFlagsEOM)p Fl(,)f(an)h(end-)208 2293 y(of-message)24 b(indicator)h(will)h(be)g (written)f(after)h(the)g(data)f(\(if)h(this)g(concept)f(has)h(a)g (meaning)f(for)g(this)h(communication)208 2392 y(tool\).)e(The)c (method)f(returns)g(the)h(number)e(of)i(bytes)g(written.)0 2539 y Fc(Status)o Fh(\(\))208 2639 y Fl(Return)f(connection)e(status)k (as)f(the)f(2-tuple)g Fh(\()p Fi(sizes)p Fh(,)50 b Fi(\003a)o(gs)o Fh(\))p Fl(.)25 b Fi(sizes)c Fl(is)g(a)f(6-tuple)e(gi)n(ving)h(the)g (actual)h(b)n(uf)n(fer)e(sizes)i(used)208 2738 y(\(see)g Fh(CMNew\(\))p Fl(\),)f Fi(\003a)o(gs)h Fl(is)h(a)f(set)h(of)f(bits)h (describing)e(the)h(state)h(of)f(the)g(connection.)0 2885 y Fc(GetConfig)n Fh(\(\))208 2985 y Fl(Return)h(the)g (con\002guration)e(string)j(of)f(the)h(communication)c(tool.)29 b(These)22 b(con\002guration)d(strings)i(are)h(tool-dependent,)208 3084 y(b)n(ut)e(usually)f(easily)i(parsed)e(and)h(modi\002ed.)0 3231 y Fc(SetConfig)n Fh(\()p Fi(str)s Fh(\))208 3331 y Fl(Set)i(the)g(con\002guration)d(string)j(for)f(the)h(tool.)30 b(The)22 b(strings)f(are)h(parsed)g(left-to-right,)e(with)i(later)g(v)n (alues)f(taking)g(prece-)208 3431 y(dence.)44 b(This)27 b(means)f(indi)n(vidual)f(con\002guration)g(parameters)g(can)i(be)g (modi\002ed)e(by)i(simply)f(appending)f(something)208 3530 y(lik)o(e)e Fh('baud)49 b(4800')23 b Fl(to)g(the)g(end)g(of)g(the) g(string)g(returned)e(by)i Fh(GetConfig\(\))f Fl(and)h(passing)f(that)i (to)f(this)h(method.)208 3630 y(The)e(method)f(returns)g(the)h(number)f (of)h(characters)g(actually)f(parsed)h(by)g(the)g(tool)h(before)d(it)k (encountered)19 b(an)k(error)e(\(or)208 3729 y(completed)d (successfully\).)0 3876 y Fc(Choose)o Fh(\(\))208 3976 y Fl(Present)24 b(the)g(user)g(with)g(a)g(dialog)g(to)g(choose)f(a)i (communication)c(tool)j(and)f(con\002gure)f(it.)38 b(If)24 b(there)f(is)i(an)f(outstanding)208 4076 y(connection)16 b(some)i(choices)g(\(lik)o(e)g(selecting)g(a)g(dif)n(ferent)f(tool\))h (may)f(cause)i(the)f(connection)e(to)i(be)h(aborted.)j(The)c(return)208 4175 y(v)n(alue)h(\(one)g(of)h(the)g Fh(choose*)g Fl(constants\))f (will)i(indicate)f(this.)0 4322 y Fc(Idle)o Fh(\(\))208 4422 y Fl(Gi)n(v)o(e)f(the)i(tool)f(a)g(chance)f(to)i(use)f(the)g (processor)-5 b(.)24 b(Y)-9 b(ou)20 b(should)f(call)i(this)g(method)d (re)o(gularly)-5 b(.)0 4569 y Fc(Abort)o Fh(\(\))208 4668 y Fl(Abort)19 b(an)h(outstanding)e(asynchronous)g Fh(Open\(\))h Fl(or)h Fh(Listen\(\))p Fl(.)0 4815 y Fc(Reset)o Fh(\(\))208 4915 y Fl(Reset)h(a)f(connection.)j(Exact)d(meaning)f (depends)f(on)i(the)g(tool.)0 5062 y Fc(Break)o Fh(\()p Fi(length)n Fh(\))208 5161 y Fl(Send)31 b(a)i(break.)59 b(Whether)31 b(this)i(means)f(an)o(ything,)g(what)g(it)h(means)f(and)f (interpretation)f(of)i(the)g Fi(length)f Fl(parameter)208 5261 y(depends)18 b(on)i(the)g(tool)g(in)h(use.)0 5588 y Fe(3.4)121 b(Built-in)32 b(Module)j Fd(macfs)p 0 5965 3761 4 v 0 6065 a Fg(3.4.)52 b(Built-in)25 b(Module)f Fh(macfs)2702 b Fg(7)p eop %%Page: 8 14 8 13 bop 0 83 a Fl(This)23 b(module)e(pro)o(vides)g(access)i(to)g (Macintosh)e(FSSpec)i(handling,)e(the)i(Alias)g(Manager)m(,)e Fj(\002nder)i Fl(aliases)h(and)e(the)g(Standard)0 183 y(File)f(package.)0 330 y(Whene)n(v)o(er)k(a)i(function)e(or)i(method)e (e)o(xpects)h(a)h Fi(\002le)g Fl(ar)o(gument,)f(this)h(ar)o(gument)d (can)j(be)f(one)h(of)f(three)g(things:)h(\(1\))f(a)h(full)f(or)0 429 y(partial)20 b(Macintosh)f(pathname,)f(\(2\))h(an)h(FSSpec)g (object)f(or)h(\(3\))f(a)i(3-tuple)d Fh(\()p Fi(wdRefNum)p Fh(,)49 b Fi(parID)o Fh(,)h Fi(name)n Fh(\))21 b Fl(as)f(described)f (in)0 529 y Fi(Inside)h(Macintosh:)f(F)l(iles)p Fl(.)25 b(A)c(description)e(of)h(aliases)h(and)e(the)i(Standard)e(File)h (package)f(can)h(also)h(be)f(found)e(there.)0 676 y Fc(FSSpec)o Fh(\()p Fi(\002le)o Fh(\))208 775 y Fl(Create)i(an)g(FSSpec)h(object)e (for)h(the)g(speci\002ed)g(\002le.)0 922 y Fc(RawFSSpec)n Fh(\()p Fi(data)o Fh(\))208 1022 y Fl(Create)k(an)g(FSSpec)h(object)f (gi)n(v)o(en)f(the)h(ra)o(w)g(data)h(for)e(the)i(C)g(structure)e(for)h (the)h(FSSpec)f(as)h(a)g(string.)37 b(This)25 b(is)g(mainly)208 1121 y(useful)19 b(if)i(you)e(ha)n(v)o(e)h(obtained)e(an)i(FSSpec)h (structure)e(o)o(v)o(er)g(a)i(netw)o(ork.)0 1268 y Fc(RawAlias)o Fh(\()p Fi(data)n Fh(\))208 1368 y Fl(Create)h(an)g(Alias)h(object)f (gi)n(v)o(en)f(the)h(ra)o(w)g(data)h(for)e(the)i(C)g(structure)e(for)h (the)g(alias)h(as)g(a)g(string.)31 b(This)22 b(is)h(mainly)f(useful)208 1468 y(if)e(you)f(ha)n(v)o(e)h(obtained)f(an)h(FSSpec)g(structure)f(o)o (v)o(er)g(a)i(netw)o(ork.)0 1614 y Fc(FInfo)o Fh(\(\))208 1714 y Fl(Create)f(a)h(zero-\002lled)e(FInfo)g(object.)0 1861 y Fc(ResolveAliasFile)m Fh(\()p Fi(\002le)o Fh(\))208 1961 y Fl(Resolv)o(e)i(an)g(alias)h(\002le.)29 b(Returns)22 b(a)f(3-tuple)g Fh(\()p Fi(fsspec)o Fh(,)50 b Fi(isfolder)r Fh(,)f Fi(aliased)q Fh(\))22 b Fl(where)f Fi(fsspec)h Fl(is)g(the)f(resulting)g(FSSpec)208 2060 y(object,)f Fi(isfolder)j Fl(is)g(true)d(if)i Fi(fsspec)f Fl(points)g(to)g(a)h (folder)e(and)g Fi(aliased)j Fl(is)f(true)f(if)g(the)g(\002le)h(w)o(as) g(an)f(alias)h(in)f(the)h(\002rst)f(place)208 2160 y(\(otherwise)e(the) h(FSSpec)g(object)g(for)g(the)g(\002le)h(itself)f(is)i(returned\).)0 2307 y Fc(StandardGetFile)m Fh(\()p Fa([)p Fi(type)o(,)e(...)12 b Fa(])o Fh(\))208 2406 y Fl(Present)18 b(the)g(user)g(with)g(a)h (standard)e(\223open)g(input)g(\002le\224)i(dialog.)24 b(Optionally)-5 b(,)16 b(you)i(can)g(pass)g(up)g(to)g(four)f (4-character)g(\002le)208 2506 y(types)h(to)g(limit)h(the)f(\002les)h (the)g(user)f(can)g(choose)f(from.)23 b(The)18 b(function)f(returns)g (an)h(FSSpec)h(object)f(and)f(a)i(\003ag)g(indicating)208 2606 y(that)h(the)g(user)g(completed)f(the)h(dialog)f(without)h (cancelling.)0 2752 y Fc(PromptGetFile)n Fh(\()p Fi(pr)l(ompt)q Fa([)p Fi(,)f(type)o(,)h(...)12 b Fa(])o Fh(\))208 2852 y Fl(Similar)20 b(to)g Fh(StandardGetFile\(\))e Fl(b)n(ut)i(allo)n(ws)g (you)g(to)g(specify)g(a)g(prompt.)0 2999 y Fc(StandardPutFile)m Fh(\()p Fi(pr)l(ompt,)g Fa([)p Fi(default)13 b Fa(])n Fh(\))208 3099 y Fl(Present)26 b(the)h(user)g(with)g(a)g(standard)e (\223open)h(output)f(\002le\224)j(dialog.)43 b Fi(pr)l(ompt)28 b Fl(is)g(the)f(prompt)e(string,)j(and)e(the)g(optional)208 3198 y Fi(default)17 b Fl(ar)o(gument)d(initializes)j(the)f(output)g (\002le)h(name.)23 b(The)16 b(function)f(returns)h(an)g(FSSpec)h (object)f(and)g(a)h(\003ag)g(indicating)208 3298 y(that)j(the)g(user)g (completed)f(the)h(dialog)f(without)h(cancelling.)0 3445 y Fc(GetDirectory)n Fh(\()p Fa([)p Fi(pr)l(ompt)13 b Fa(])o Fh(\))208 3544 y Fl(Present)32 b(the)g(user)g(with)h(a)f (non-standard)e(\223select)j(a)f(directory\224)f(dialog.)60 b Fi(pr)l(ompt)33 b Fl(is)h(the)e(prompt)f(string,)j(and)e(the)208 3644 y(optional.)23 b(Return)d(an)g(FSSpec)h(object)e(and)h(a)g (success-indicator)-5 b(.)0 3791 y Fc(SetFolder)n Fh(\()p Fa([)p Fi(fsspec)12 b Fa(])o Fh(\))208 3890 y Fl(Set)19 b(the)g(folder)f(that)h(is)h(initially)f(presented)f(to)h(the)g(user)g (when)f(one)h(of)g(the)g(\002le)g(selection)g(dialogs)g(is)g (presented.)24 b Fi(fsspec)208 3990 y Fl(should)f(point)h(to)g(a)h (\002le)g(in)g(the)f(folder)m(,)g(not)g(the)h(folder)e(itself)i(\(the)f (\002le)h(need)f(not)g(e)o(xist,)h(though\).)36 b(If)24 b(no)g(ar)o(gument)e(is)208 4090 y(passed)e(the)g(folder)f(will)i(be)f (set)h(to)f(the)g(current)f(directory)-5 b(,)18 b(i.e.)25 b(what)20 b Fh(os.getcwd\(\))f Fl(returns.)208 4222 y(Note)i(that)h (starting)f(with)h(system)g(7.5)f(the)h(user)g(can)f(change)g(Standard) f(File)j(beha)n(viour)c(with)j(the)g(\223general)e(controls\224)208 4322 y(controlpanel,)d(thereby)i(making)g(this)h(call)h(inoperati)n(v)o (e.)0 4469 y Fc(FindFolder)n Fh(\()p Fi(wher)m(e)o(,)f(whic)o(h,)g(cr)m (eate)o Fh(\))208 4569 y Fl(Locates)j(one)g(of)h(the)g(\223special\224) f(folders)g(that)h(MacOS)g(kno)n(ws)f(about,)h(such)f(as)i(the)f(trash) f(or)h(the)g(Preferences)e(folder)-5 b(.)208 4668 y Fi(wher)m(e)21 b Fl(is)h(the)f(disk)g(to)g(search,)g Fi(whic)o(h)f Fl(is)i(the)f (4-character)e(string)i(specifying)f(which)g(folder)g(to)h(locate.)27 b(Setting)21 b Fi(cr)m(eate)208 4768 y Fl(causes)f(the)g(folder)f(to)i (be)f(created)f(if)i(it)g(does)e(not)h(e)o(xist.)25 b(Returns)20 b(a)h Fh(\()p Fi(vr)m(efnum)o Fh(,)49 b Fi(dirid)r Fh(\))21 b Fl(tuple.)0 4915 y Fc(NewAliasMinimalFromFullPath)-5 b Fh(\()p Fi(pathname)m Fh(\))208 5014 y Fl(Return)20 b(a)h(minimal)e(alias)j(object)e(that)g(points)g(to)h(the)g(gi)n(v)o (en)e(\002le,)i(which)f(must)g(be)h(speci\002ed)f(as)h(a)g(full)g (pathname.)j(This)208 5114 y(is)d(the)f(only)f(w)o(ay)h(to)h(create)f (an)g(Alias)h(pointing)d(to)j(a)f(non-e)o(xisting)e(\002le.)208 5247 y(The)h(constants)h(for)g Fi(wher)m(e)g Fl(and)g Fi(whic)o(h)g Fl(can)g(be)g(obtained)f(from)g(the)h(standard)f(module)g Fi(MA)n(CFS)o Fl(.)0 5394 y Fc(FindApplication)m Fh(\()p Fi(cr)m(eator)q Fh(\))208 5493 y Fl(Locate)h(the)h(application)f(with)h (4-char)f(creator)g(code)h Fi(cr)m(eator)q Fl(.)29 b(The)21 b(function)e(returns)h(an)h(FSSpec)h(object)e(pointing)g(to)208 5593 y(the)g(application.)p 0 5965 3761 4 v 0 6065 a Fg(8)2239 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r (vices)p eop %%Page: 9 15 9 14 bop 0 83 a Fb(FSSpec)29 b(objects)0 286 y Fc(data)208 386 y Fl(The)19 b(ra)o(w)h(data)g(from)g(the)g(FSSpec)g(object,)g (suitable)g(for)f(passing)h(to)g(other)g(applications,)f(for)g (instance.)0 532 y Fc(as)p 105 532 25 4 v 30 w(pathname)n Fh(\(\))208 632 y Fl(Return)g(the)i(full)f(pathname)e(of)i(the)g (\002le)h(described)e(by)h(the)g(FSSpec)g(object.)0 779 y Fc(as)p 105 779 V 30 w(tuple)o Fh(\(\))208 879 y Fl(Return)f(the)i Fh(\()p Fi(wdRefNum)o Fh(,)49 b Fi(parID)o Fh(,)h Fi(name)o Fh(\))20 b Fl(tuple)g(of)g(the)g(\002le)h(described)e(by)h(the)g (FSSpec)g(object.)0 1025 y Fc(NewAlias)o Fh(\()p Fa([)p Fi(\002le)12 b Fa(])n Fh(\))208 1125 y Fl(Create)20 b(an)g(Alias)h (object)f(pointing)e(to)i(the)h(\002le)f(described)f(by)h(this)h (FSSpec.)k(If)20 b(the)g(optional)f Fi(\002le)h Fl(parameter)f(is)i (present)208 1225 y(the)f(alias)h(will)g(be)f(relati)n(v)o(e)f(to)i (that)f(\002le,)g(otherwise)g(it)h(will)g(be)f(absolute.)0 1372 y Fc(NewAliasMinimal)m Fh(\(\))208 1471 y Fl(Create)g(a)h(minimal) e(alias)i(pointing)e(to)h(this)h(\002le.)0 1618 y Fc(GetCreatorType)m Fh(\(\))208 1718 y Fl(Return)e(the)i(4-character)d(creator)h(and)g (type)h(of)g(the)g(\002le.)0 1865 y Fc(SetCreatorType)m Fh(\()p Fi(cr)m(eator)-9 b(,)20 b(type)o Fh(\))208 1964 y Fl(Set)g(the)h(4-character)d(creator)h(and)h(type)f(of)h(the)g (\002le.)0 2111 y Fc(GetFInfo)o Fh(\(\))208 2211 y Fl(Return)f(a)i (FInfo)e(object)h(describing)e(the)j(\002nder)e(info)h(for)f(the)h (\002le.)0 2358 y Fc(SetFInfo)o Fh(\()p Fi(\002nfo)n Fh(\))208 2457 y Fl(Set)g(the)h(\002nder)e(info)h(for)f(the)h(\002le)h (to)g(the)f(v)n(alues)g(gi)n(v)o(en)e(as)j Fi(\002nfo)f Fl(\(an)f(FInfo)h(object\).)0 2604 y Fc(GetDates)o Fh(\(\))208 2704 y Fl(Return)g(a)h(tuple)f(with)h(three)g(\003oating)f(point)g(v)n (alues)g(representing)f(the)i(creation)e(date,)i(modi\002cation)e(date) i(and)f(backup)208 2803 y(date)g(of)g(the)g(\002le.)0 2950 y Fc(SetDates)o Fh(\()p Fi(cr)m(date)o(,)f(moddate)o(,)g(bac)n (kupdate)m Fh(\))208 3050 y Fl(Set)29 b(the)h(creation,)g (modi\002cation)d(and)i(backup)e(date)i(of)g(the)g(\002le.)53 b(The)28 b(v)n(alues)h(are)g(in)g(the)h(standard)e(\003oating)g(point) 208 3149 y(format)19 b(used)h(for)f(times)i(throughout)c(Python.)0 3434 y Fb(Alias)29 b(Objects)0 3637 y Fc(data)208 3737 y Fl(The)19 b(ra)o(w)h(data)g(for)g(the)g(Alias)h(record,)e(suitable)h (for)f(storing)h(in)g(a)h(resource)e(or)h(transmitting)f(to)h(other)f (programs.)0 3884 y Fc(Resolve)o Fh(\()p Fa([)p Fi(\002le)12 b Fa(])n Fh(\))208 3983 y Fl(Resolv)o(e)22 b(the)h(alias.)33 b(If)23 b(the)g(alias)g(w)o(as)h(created)e(as)h(a)g(relati)n(v)o(e)f (alias)i(you)e(should)f(pass)j(the)e(\002le)i(relati)n(v)o(e)e(to)h (which)f(it)i(is.)208 4083 y(Return)d(the)h(FSSpec)g(for)f(the)h (\002le)h(pointed)d(to)i(and)g(a)g(\003ag)g(indicating)e(whether)h(the) h(Alias)h(object)e(itself)i(w)o(as)f(modi\002ed)208 4183 y(during)e(the)j(search)f(process.)32 b(If)22 b(the)h(\002le)g(does)f (not)g(e)o(xist)h(b)n(ut)f(the)h(path)f(leading)g(up)g(to)g(it)i(does)e (e)o(xist)h(a)g(v)n(alid)f(fsspec)g(is)208 4282 y(returned.)0 4429 y Fc(GetInfo)o Fh(\()p Fi(num)n Fh(\))208 4529 y Fl(An)e(interf)o(ace)f(to)h(the)h(C)g(routine)e Fh(GetAliasInfo\(\))p Fl(.)0 4676 y Fc(Update)o Fh(\()p Fi(\002le)o(,)h Fa([)p Fi(\002le2)12 b Fa(])n Fh(\))208 4775 y Fl(Update)19 b(the)h(alias)h(to)g(point)e(to)h(the)h Fi(\002le)f Fl(gi)n(v)o(en.)j (If)d Fi(\002le2)g Fl(is)h(present)f(a)g(relati)n(v)o(e)g(alias)h(will) g(be)f(created.)0 4922 y(Note)28 b(that)g(it)g(is)h(currently)d(not)h (possible)h(to)g(directly)f(manipulate)f(a)i(resource)f(as)i(an)e (Alias)i(object.)47 b(Hence,)29 b(after)f(calling)0 5022 y Fh(Update\(\))j Fl(or)g(after)g Fh(Resolve\(\))g Fl(indicates)g(that) h(the)g(alias)g(has)g(changed)e(the)i(Python)e(program)g(is)i (responsible)f(for)0 5121 y(getting)19 b(the)i Fh(data)f Fl(v)n(alue)f(from)g(the)h(Alias)h(object)f(and)g(modifying)d(the)k (resource.)0 5406 y Fb(FInf)m(o)28 b(Objects)0 5609 y Fl(See)21 b Fi(Inside)e(Macintosh:)24 b(F)l(iles)d Fl(for)f(a)g (complete)g(description)e(of)i(what)g(the)h(v)n(arious)e(\002elds)h (mean.)0 5756 y Fc(Creator)p 0 5965 3761 4 v 0 6065 a Fg(3.4.)52 b(Built-in)25 b(Module)f Fh(macfs)2702 b Fg(9)p eop %%Page: 10 16 10 15 bop 208 83 a Fl(The)19 b(4-character)g(creator)g(code)g(of)h(the) g(\002le.)0 230 y Fc(Type)208 330 y Fl(The)f(4-character)g(type)g(code) h(of)g(the)g(\002le.)0 476 y Fc(Flags)208 576 y Fl(The)e(\002nder)f (\003ags)i(for)f(the)g(\002le)h(as)g(16-bit)e(inte)o(ger)-5 b(.)24 b(The)18 b(bit)h(v)n(alues)f(in)g Fi(Fla)o(gs)g Fl(are)h(de\002ned)e(in)i(standard)e(module)g Fh(MACFS)p Fl(.)0 723 y Fc(Location)208 823 y Fl(A)j(Point)g(gi)n(ving)f(the)h (position)g(of)g(the)g(\002le')-5 b(s)21 b(icon)f(in)g(its)h(folder)-5 b(.)0 969 y Fc(Fldr)208 1069 y Fl(The)19 b(folder)g(the)i(\002le)f(is)i (in)e(\(as)h(an)f(inte)o(ger\).)0 1396 y Fe(3.5)121 b(Standard)35 b(Module)f Fd(ic)0 1629 y Fl(This)16 b(module)e(pro)o(vides)g(access)i (to)g(Macintosh)f(Internet)f(Con\002g)h(package,)g(which)g(stores)h (preferences)e(for)h(Internet)f(programs)0 1729 y(such)26 b(as)g(mail)h(address,)f(def)o(ault)g(homepage,)f(etc.)42 b(Also,)28 b(Internet)d(Con\002g)g(contains)h(an)f(elaborate)g(set)i (of)f(mappings)e(from)0 1829 y(Macintosh)k(creator/type)g(codes)h(to)g (foreign)f(\002lename)h(e)o(xtensions)f(plus)h(information)e(on)i(ho)n (w)g(to)h(transfer)e(\002les)j(\(binary)-5 b(,)0 1928 y(ascii,)21 b(etc\).)0 2075 y(There)j(is)i(a)f(lo)n(w-le)n(v)o(el)e (companion)f(module)i Fh(icglue)g Fl(which)g(pro)o(vides)f(the)i(basic) g(Internet)e(Con\002g)i(access)g(functionality)-5 b(.)0 2175 y(This)29 b(lo)n(w-le)n(v)o(el)e(module)g(is)j(not)e(documented,)g (b)n(ut)g(the)h(docstrings)e(of)i(the)f(routines)g(document)e(the)j (parameters)e(and)h(the)0 2274 y(routine)j(names)h(are)g(the)g(same)g (as)h(for)e(the)i(P)o(ascal)f(or)g(C)h(API)f(to)h(Internet)e(Con\002g,) j(so)f(the)f(standard)f(IC)h(programmers')0 2374 y(documentation)17 b(can)j(be)g(used)g(if)h(this)f(module)f(is)i(needed.)0 2521 y(The)d Fh(ic)g Fl(module)f(de\002nes)h(the)g Fh(error)g Fl(e)o(xception)e(and)i(symbolic)f(names)h(for)g(all)g(error)g(codes)f (Internet)g(Con\002g)h(can)g(produce;)0 2620 y(see)j(the)f(source)f (for)h(details.)0 2767 y Fc(error)208 2867 y Fl(Exception)e(raised)i (on)g(errors)f(in)h(the)h Fh(ic)f Fl(module.)0 3014 y(The)g Fh(ic)g Fl(module)f(de\002nes)h(the)g(follo)n(wing)f(class)i(and)f (function:)0 3161 y Fc(IC)p Fh(\()p Fa([)p Fi(signatur)m(e)p Fa([)p Fi(,)e(ic)12 b Fa(])g(])o Fh(\))208 3260 y Fl(Create)32 b(an)f(internet)g(con\002g)g(object.)59 b(The)31 b(signature)g(is)i(a)f (4-character)d(creator)i(code)g(of)h(the)f(current)g(application)208 3360 y(\(def)o(ault)f Fh('Pyth')o Fl(\))i(which)f(may)g(in\003uence)g (some)g(of)h(ICs)g(settings.)60 b(The)31 b(optional)f Fi(ic)j Fl(ar)o(gument)c(is)j(a)g(lo)n(w-le)n(v)o(el)208 3459 y Fh(icglue.icinstance)c Fl(created)i(beforehand,)h(this)g(may)g (be)g(useful)g(if)g(you)f(w)o(ant)h(to)g(get)h(preferences)d(from)h(a) 208 3559 y(dif)n(ferent)18 b(con\002g)h(\002le,)i(etc.)0 3706 y Fc(launchurl)n Fh(\()p Fi(url)p Fa([)p Fi(,)f(hint)13 b Fa(])p Fh(\))0 3806 y Fc(parseurl)o Fh(\()p Fi(data)p Fa([)p Fi(,)18 b(start)q Fa([)p Fi(,)j(end)r Fa([)p Fi(,)f(hint)13 b Fa(])f(])g(])n Fh(\))0 3905 y Fc(mapfile)o Fh(\()p Fi(\002le)o Fh(\))0 4005 y Fc(maptypecreator)m Fh(\()p Fi(type)o(,)20 b(cr)m(eator)r Fa([)p Fi(,)g(\002lename)12 b Fa(])n Fh(\))0 4104 y Fc(settypecreator)m Fh(\()p Fi(\002le)p Fh(\))208 4204 y Fl(These)20 b(functions)e(are)i(\223shortcuts\224)g (to)g(the)g(methods)f(of)h(the)h(same)f(name,)f(described)g(belo)n(w)-5 b(.)0 4489 y Fb(IC)27 b(Objects)0 4692 y Fh(IC)f Fl(objects)f(ha)n(v)o (e)f(a)i(mapping)e(interf)o(ace,)h(hence)g(to)g(obtain)g(the)g(mail)h (address)f(you)f(simply)h(get)h Fi(ic)p Fh(['MailAddress'])m Fl(.)0 4792 y(Assignment)19 b(also)i(w)o(orks,)f(and)f(changes)g(the)i (option)d(in)j(the)f(con\002guration)e(\002le.)0 4938 y(The)i(module)e(kno)n(ws)h(about)g(v)n(arious)g(datatypes,)g(and)g (con)m(v)o(erts)f(the)i(internal)f(IC)h(representation)e(to)i(a)g (\223logical\224)g(Python)e(data)0 5038 y(structure.)47 b(Running)27 b(the)h Fh(ic)g Fl(module)f(standalone)g(will)h(run)g(a)g (test)h(program)d(that)i(lists)h(all)g(k)o(e)o(ys)f(and)f(v)n(alues)h (in)g(your)f(IC)0 5138 y(database,)19 b(this)i(will)g(ha)n(v)o(e)f(to)g (serv)o(er)f(as)i(documentation.)0 5285 y(If)i(the)h(module)e(does)h (not)g(kno)n(w)g(ho)n(w)g(to)g(represent)g(the)g(data)h(it)g(returns)e (an)i(instance)f(of)g(the)h Fh(ICOpaqueData)d Fl(type,)j(with)0 5384 y(the)c(ra)o(w)g(data)g(in)h(its)g Fh(data)f Fl(attrib)n(ute.)k (Objects)d(of)f(this)g(type)g(are)g(also)h(acceptable)e(v)n(alues)h (for)f(assignment.)0 5531 y(Besides)i(the)f(dictionary)f(interf)o(ace,) g Fh(IC)h Fl(objects)g(ha)n(v)o(e)g(the)g(follo)n(wing)e(methods:)0 5678 y Fc(launchurl)n Fh(\()p Fi(url)p Fa([)p Fi(,)i(hint)13 b Fa(])p Fh(\))208 5778 y Fl(P)o(arse)21 b(the)g(gi)n(v)o(en)f(URL,)i (lauch)f(the)g(correct)f(application)g(and)h(pass)h(it)g(the)f(URL.)h (The)f(optional)f Fi(hint)j Fl(can)e(be)g(a)h(scheme)p 0 5965 3761 4 v 0 6065 a Fg(10)2193 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r(vices)p eop %%Page: 11 17 11 16 bop 208 83 a Fl(name)20 b(such)h(as)g Fh('mailto:')o Fl(,)g(in)g(which)g(case)g(incomplete)f(URLs)i(are)f(completed)e(with)i (this)h(scheme.)27 b(If)20 b Fi(hint)j Fl(is)f(not)208 183 y(pro)o(vided,)17 b(incomplete)i(URLs)i(are)f(in)m(v)n(alid.)0 330 y Fc(parseurl)o Fh(\()p Fi(data)p Fa([)p Fi(,)e(start)q Fa([)p Fi(,)j(end)r Fa([)p Fi(,)f(hint)13 b Fa(])f(])g(])n Fh(\))208 429 y Fl(Find)18 b(an)h(URL)g(some)n(where)f(in)g Fi(data)g Fl(and)h(return)e(start)j(position,)d(end)i(position)f(and)g (the)h(URL.)g(The)f(optional)g Fi(start)j Fl(and)208 529 y Fi(end)g Fl(can)e(be)g(used)g(to)h(limit)g(the)f(search,)g(so)h (for)f(instance)g(if)h(a)g(user)f(clicks)h(in)f(a)h(long)f(te)o (xt\002eld)g(you)f(can)h(pass)h(the)g(whole)208 628 y(te)o(xt\002eld)e (and)g(the)g(click-position)f(in)i Fi(start)i Fl(and)d(this)h(routine)f (will)h(return)f(the)g(whole)h(URL)g(in)g(which)f(the)g(user)h(click)o (ed.)208 728 y(As)i(abo)o(v)o(e,)d Fi(hint)j Fl(is)g(an)g(optional)d (scheme)i(used)g(to)g(complete)g(incomplete)e(URLs.)0 875 y Fc(mapfile)o Fh(\()p Fi(\002le)o Fh(\))208 975 y Fl(Return)52 b(the)h(mapping)e(entry)h(for)g(the)h(gi)n(v)o(en)f Fi(\002le)o Fl(,)61 b(which)53 b(can)f(be)h(passed)g(as)h(either)e(a)h (\002lename)g(or)f(an)208 1074 y Fh(macfs.FSSpec\(\))18 b Fl(result,)i(and)f(which)h(need)f(not)h(e)o(xist.)208 1203 y(The)25 b(mapping)g(entry)g(is)i(returned)e(as)i(a)g(tuple)e Fh(\()p Fi(ver)o(sion)p Fl(,)j Fi(type)o Fl(,)g Fi(cr)m(eator)r Fl(,)g Fi(postcr)m(eator)p Fl(,)g Fi(\003a)o(gs)o Fl(,)h Fi(e)n(xtension)n Fl(,)g Fi(appname)m Fl(,)208 1302 y Fi(postappname)l Fl(,)h Fi(mimetype)o Fl(,)g Fi(entryname)n Fh(\))p Fl(,)g(where)d Fi(ver)o(sion)h Fl(is)g(the)g(entry)e(v)o (ersion)h(number)m(,)g Fi(type)g Fl(is)i(the)e(4-character)208 1402 y(\002letype,)f Fi(cr)m(eator)i Fl(is)e(the)g(4-character)e (creator)g(type,)j Fi(postcr)m(eator)g Fl(is)f(the)g(4-character)e (creator)g(code)h(of)h(an)f(optional)208 1502 y(application)16 b(to)i(post-process)e(the)i(\002le)h(after)e(do)n(wnloading,)e Fi(\003a)o(gs)j Fl(are)g(v)n(arious)e(bits)j(specifying)d(whether)h(to) h(transfer)f(in)208 1601 y(binary)f(or)i(ascii)g(and)g(such,)f Fi(e)n(xtension)h Fl(is)g(the)g(\002lename)g(e)o(xtension)e(for)h(this) i(\002le)f(type,)g Fi(appname)e Fl(is)i(the)g(printable)f(name)208 1701 y(of)26 b(the)g(application)f(to)i(which)f(this)h(\002le)g (belongs,)g Fi(postappname)d Fl(is)j(the)g(name)f(of)g(the)g (postprocessing)f(application,)208 1801 y Fi(mimetype)19 b Fl(is)j(the)e(MIME)g(type)f(of)h(this)h(\002le)g(and)e Fi(entryname)h Fl(is)h(the)f(name)f(of)h(this)h(entry)-5 b(.)0 1947 y Fc(maptypecreator)m Fh(\()p Fi(type)o(,)20 b(cr)m(eator)r Fa([)p Fi(,)g(\002lename)12 b Fa(])n Fh(\))208 2047 y Fl(Return)26 b(the)h(mapping)e(entry)i(for)f(\002les)i(with)f (gi)n(v)o(en)f(4-character)f Fi(type)i Fl(and)g Fi(cr)m(eator)i Fl(codes.)45 b(The)27 b(optional)e Fi(\002lename)208 2147 y Fl(may)19 b(be)h(speci\002ed)g(to)h(further)d(help)i(\002nding)f (the)h(correct)f(entry)h(\(if)g(the)g(creator)f(code)h(is)h Fh('????')o Fl(,)f(for)g(instance\).)208 2275 y(The)f(mapping)g(entry)g (is)i(returned)e(in)h(the)g(same)h(format)e(as)i(for)e Fi(map\002le)o Fl(.)0 2422 y Fc(settypecreator)m Fh(\()p Fi(\002le)p Fh(\))208 2522 y Fl(Gi)n(v)o(en)h(an)i(e)o(xisting)e Fi(\002le)p Fl(,)i(speci\002ed)f(either)g(as)h(a)g(\002lename)f(or)g (as)h(an)g Fh(macfs.FSSpec\(\))d Fl(result,)j(set)g(its)g(creator)f (and)208 2621 y(type)e(correctly)g(based)g(on)h(its)h(e)o(xtension.)i (The)d(\002nder)f(is)i(told)f(about)f(the)h(change,)e(so)i(the)g (\002nder)g(icon)f(will)i(be)f(updated)208 2721 y(quickly)-5 b(.)0 3045 y Fe(3.6)121 b(Built-in)32 b(Module)j Fd(MacOS)0 3277 y Fl(This)18 b(module)f(pro)o(vides)f(access)j(to)f(MacOS)g (speci\002c)g(functionality)e(in)i(the)g(Python)f(interpreter)m(,)f (such)i(as)g(ho)n(w)g(the)g(interpreter)0 3377 y(e)n(v)o(entloop)g (functions)h(and)g(the)h(lik)o(e.)26 b(Use)21 b(with)f(care.)0 3524 y(Note)g(the)g(capitalisation)g(of)g(the)g(module)f(name,)g(this)i (is)g(a)g(historical)e(artif)o(act.)0 3671 y Fc(Error)208 3770 y Fl(This)28 b(e)o(xception)e(is)j(raised)f(on)g(MacOS)h (generated)d(errors,)j(either)f(from)f(functions)g(in)h(this)h(module)e (or)h(from)f(other)208 3870 y(mac-speci\002c)g(modules)h(lik)o(e)g(the) h(toolbox)e(interf)o(aces.)49 b(The)28 b(ar)o(guments)f(are)h(the)h (inte)o(ger)e(error)h(code)f(\(the)i Fh(OSErr)208 3970 y Fl(v)n(alue\))19 b(and)i(a)g(te)o(xtual)f(description)g(of)g(the)h (error)f(code.)26 b(Symbolic)20 b(names)h(for)f(all)i(kno)n(wn)d(error) h(codes)g(are)h(de\002ned)f(in)208 4069 y(the)g(standard)f(module)g Fh(macerrors)p Fl(.)0 4216 y Fc(SetEventHandler)m Fh(\()p Fi(handler)p Fh(\))208 4316 y Fl(In)59 b(the)g(inner)f(interpreter)g (loop)g(Python)g(will)i(occasionally)e(check)g(for)h(e)n(v)o(ents,)68 b(unless)60 b(disabled)e(with)208 4415 y Fh(ScheduleParams\(\))p Fl(.)21 b(W)m(ith)d(this)g(function)e(you)h(can)g(pass)h(a)g(Python)f (e)n(v)o(ent-handler)d(function)i(that)i(will)g(be)f(called)208 4515 y(if)g(an)h(e)n(v)o(ent)e(is)j(a)n(v)n(ailable.)k(The)18 b(e)n(v)o(ent)e(is)j(passed)e(as)h(parameter)e(and)h(the)h(function)e (should)g(return)h(non-zero)e(if)j(the)f(e)n(v)o(ent)208 4615 y(has)h(been)g(fully)g(processed,)f(otherwise)h(e)n(v)o(ent)g (processing)f(continues)g(\(by)h(passing)g(the)g(e)n(v)o(ent)g(to)g (the)h(console)e(windo)n(w)208 4714 y(package,)h(for)i(instance\).)208 4843 y(Call)d Fh(SetEventHandler\(\))e Fl(without)h(a)i(parameter)d(to) i(clear)g(the)g(e)n(v)o(ent)f(handler)-5 b(.)23 b(Setting)17 b(an)g(e)n(v)o(ent)f(handler)f(while)208 4943 y(one)k(is)i(already)e (set)i(is)h(an)e(error)-5 b(.)0 5089 y Fc(SchedParams)n Fh(\()p Fa([)p Fi(doint)q Fa([)p Fi(,)19 b(e)o(vtmask)q Fa([)p Fi(,)h(besocial)p Fa([)p Fi(,)f(interval)p Fa([)p Fi(,)h(bgyield)12 b Fa(])g(])g(])g(])g(])o Fh(\))208 5189 y Fl(In\003uence)19 b(the)h(interpreter)f(inner)h(loop)g(e)n(v)o (ent)g(handling.)k Fi(Interval)c Fl(speci\002es)h(ho)n(w)f(often)g (\(in)g(seconds,)g(\003oating)g(point\))208 5289 y(the)26 b(interpreter)f(should)g(enter)h(the)g(e)n(v)o(ent)g(processing)f (code.)42 b(When)26 b(true,)i Fi(doint)f Fl(causes)f(interrupt)f (\(command-dot\))208 5388 y(checking)d(to)j(be)f(done.)37 b Fi(e)o(vtmask)26 b Fl(tells)f(the)g(interpreter)d(to)j(do)f(e)n(v)o (ent)g(processing)f(for)g(e)n(v)o(ents)h(in)h(the)f(mask)h(\(redra)o (ws,)208 5488 y(mouseclicks)d(to)i(switch)h(to)f(other)f(applications,) g(etc\).)36 b(The)24 b Fi(besocial)f Fl(\003ag)h(gi)n(v)o(es)f(other)g (processes)h(a)g(chance)f(to)h(run.)208 5588 y(The)o(y)18 b(are)h(granted)f(minimal)h(runtime)g(when)f(Python)h(is)h(in)g(the)f (fore)o(ground)d(and)j Fi(bgyield)h Fl(seconds)f(per)g Fi(interval)h Fl(when)208 5687 y(Python)f(runs)g(in)i(the)f (background.)208 5816 y(All)e(parameters)f(are)h(optional,)f(and)h(def) o(ault)f(to)i(the)f(current)f(v)n(alue.)23 b(The)18 b(return)f(v)n (alue)h(of)f(this)i(function)e(is)i(a)f(tuple)g(with)p 0 5965 3761 4 v 0 6065 a Fg(3.6.)52 b(Built-in)25 b(Module)f Fh(MacOS)2656 b Fg(11)p eop %%Page: 12 18 12 17 bop 208 83 a Fl(the)26 b(old)g(v)n(alues)g(of)g(these)g(options.) 42 b(Initial)26 b(def)o(aults)g(are)g(that)h(all)f(processing)f(is)i (enabled,)g(checking)d(is)j(done)f(e)n(v)o(ery)208 183 y(quarter)18 b(second)i(and)f(the)i(CPU)g(is)g(gi)n(v)o(en)e(up)h(for)f (a)i(quarter)e(second)g(when)h(in)g(the)g(background.)0 330 y Fc(HandleEvent)n Fh(\()p Fi(e)o(v)o Fh(\))208 429 y Fl(P)o(ass)27 b(the)f(e)n(v)o(ent)f(record)g Fi(e)o(v)h Fl(back)g(to)g(the)h(Python)e(e)n(v)o(ent)g(loop,)i(or)f(possibly)f(to) i(the)f(handler)f(for)g(the)h Fh(sys.stdout)208 529 y Fl(windo)n(w)17 b(\(based)h(on)g(the)h(compiler)f(used)g(to)h(b)n(uild) f(Python\).)23 b(This)c(allo)n(ws)g(Python)f(programs)e(that)j(do)g (their)f(o)n(wn)g(e)n(v)o(ent)208 628 y(handling)g(to)i(still)i(ha)n(v) o(e)d(some)h(command-period)c(and)k(windo)n(w-switching)d(capability)-5 b(.)208 761 y(If)19 b(you)g(attempt)g(to)h(call)h(this)f(function)e (from)h(an)g(e)n(v)o(ent)g(handler)f(set)j(through)d Fh(SetEventHandler\(\))f Fl(you)i(will)h(get)208 861 y(an)g(e)o(xception.)0 1008 y Fc(GetErrorString)m Fh(\()p Fi(errno)p Fh(\))208 1107 y Fl(Return)f(the)i(te)o(xtual)e(description) g(of)h(MacOS)g(error)f(code)h Fi(errno)o Fl(.)0 1254 y Fc(splash)o Fh(\()p Fi(r)m(esid)r Fh(\))208 1354 y Fl(This)27 b(function)f(will)j(put)e(a)h(splash)g(windo)n(w)f (on-screen,)g(with)h(the)g(contents)f(of)g(the)h(DLOG)g(resource)e (speci\002ed)i(by)208 1453 y Fi(r)m(esid)r Fl(.)37 b(Calling)24 b(with)g(a)h(zero)e(ar)o(gument)f(will)j(remo)o(v)o(e)d(the)i(splash)g (screen.)36 b(This)25 b(function)d(is)j(useful)f(if)g(you)f(w)o(ant)h (an)208 1553 y(applet)16 b(to)h(post)g(a)g(splash)g(screen)g(early)f (in)h(initialization)f(without)g(\002rst)i(ha)n(ving)e(to)h(load)f (numerous)f(e)o(xtension)h(modules.)0 1700 y Fc(DebugStr)o Fh(\()p Fi(messa)o(g)o(e)k Fa([)p Fi(,)g(object)13 b Fa(])o Fh(\))208 1800 y Fl(Drop)22 b(to)i(the)g(lo)n(w-le)n(v)o(el)e (deb)n(ugger)g(with)h(message)h Fi(messa)o(g)o(e)p Fl(.)35 b(The)24 b(optional)e Fi(object)j Fl(ar)o(gument)c(is)j(not)g(used,)g (b)n(ut)f(can)208 1899 y(easily)d(be)g(inspected)f(from)h(the)g(deb)n (ugger)-5 b(.)208 2032 y(Note)17 b(that)g(you)g(should)f(use)i(this)g (function)d(with)j(e)o(xtreme)e(care:)23 b(if)18 b(no)f(lo)n(w-le)n(v)o (el)f(deb)n(ugger)f(lik)o(e)j(MacsBug)f(is)h(installed)208 2132 y(this)i(call)h(will)g(crash)f(your)f(system.)25 b(It)20 b(is)h(intended)e(mainly)h(for)f(de)n(v)o(elopers)f(of)i (Python)f(e)o(xtension)g(modules.)0 2279 y Fc(openrf)o Fh(\()p Fi(name)g Fa([)p Fi(,)i(mode)12 b Fa(])n Fh(\))208 2378 y Fl(Open)22 b(the)g(resource)g(fork)g(of)g(a)h(\002le.)34 b(Ar)o(guments)20 b(are)j(the)g(same)g(as)g(for)f(the)h(b)n(uilt-in)f (function)f Fh(open\(\))p Fl(.)32 b(The)23 b(object)208 2478 y(returned)18 b(has)i(\002le-lik)o(e)h(semantics,)f(b)n(ut)g(it)h (is)g(not)f(a)g(Python)f(\002le)i(object,)f(so)g(there)g(may)g(be)g (subtle)g(dif)n(ferences.)0 2805 y Fe(3.7)121 b(Standard)35 b(Module)f Fd(macostools)0 3038 y Fl(This)20 b(module)f(contains)h (some)g(con)m(v)o(enience)d(routines)i(for)h(\002le-manipulation)d(on)j (the)g(Macintosh.)0 3185 y(The)g Fh(macostools)f Fl(module)g(de\002nes) h(the)g(follo)n(wing)e(functions:)0 3332 y Fc(copy)o Fh(\()p Fi(sr)m(c,)j(dst)q Fa([)p Fi(,)g(cr)m(eatepath)p Fa([)p Fi(,)d(copytimes)12 b Fa(])g(])n Fh(\))208 3431 y Fl(Cop)o(y)23 b(\002le)i Fi(sr)m(c)g Fl(to)f Fi(dst)r Fl(.)37 b(The)23 b(\002les)i(can)f(be)g(speci\002ed)g(as)h(pathnames)e (or)g(FSSpec)i(objects.)36 b(If)24 b Fi(cr)m(eatepath)f Fl(is)i(non-zero)208 3531 y Fi(dst)30 b Fl(must)f(be)g(a)g(pathname)e (and)h(the)h(folders)f(leading)g(to)g(the)h(destination)f(are)h (created)f(if)h(necessary)-5 b(.)49 b(The)29 b(method)208 3631 y(copies)19 b(data)i(and)e(resource)g(fork)h(and)f(some)h (\002nder)g(information)e(\(creator)m(,)g(type,)i(\003ags\))g(and)g (optionally)e(the)i(creation,)208 3730 y(modi\002cation)c(and)i(backup) e(times)j(\(def)o(ault)e(is)j(to)e(cop)o(y)f(them\).)24 b(Custom)18 b(icons,)g(comments)f(and)h(icon)g(position)f(are)i(not)208 3830 y(copied.)208 3963 y(If)h(the)g(source)f(is)i(an)g(alias)f(the)h (original)e(to)h(which)g(the)g(alias)h(points)f(is)h(copied,)e(not)g (the)i(alias\002le.)0 4110 y Fc(copytree)o Fh(\()p Fi(sr)m(c,)f(dst)r Fh(\))208 4209 y Fl(Recursi)n(v)o(ely)j(cop)o(y)g(a)i(\002le)f(tree)h (from)e Fi(sr)m(c)i Fl(to)f Fi(dst)r Fl(,)h(creating)e(folders)h(as)h (needed.)35 b Fi(sr)m(c)25 b Fl(and)f Fi(dst)i Fl(should)d(be)i (speci\002ed)e(as)208 4309 y(pathnames.)0 4456 y Fc(mkalias)o Fh(\()p Fi(sr)m(c,)d(dst)r Fh(\))208 4555 y Fl(Create)g(a)h(\002nder)e (alias)i Fi(dst)h Fl(pointing)d(to)h Fi(sr)m(c)p Fl(.)26 b(Both)20 b(may)g(be)g(speci\002ed)g(as)h(pathnames)e(or)h(FSSpec)g (objects.)0 4702 y Fc(touched)o Fh(\()p Fi(dst)q Fh(\))208 4802 y Fl(T)-6 b(ell)21 b(the)h(\002nder)e(that)h(some)g(bits)h(of)f (\002nder)n(-information)d(such)i(as)i(creator)f(or)g(type)f(for)h (\002le)h Fi(dst)h Fl(has)e(changed.)27 b(The)21 b(\002le)208 4902 y(can)f(be)g(speci\002ed)g(by)f(pathname)g(or)h(fsspec.)25 b(This)20 b(call)h(should)e(prod)g(the)h(\002nder)g(into)f(redra)o (wing)g(the)h(\002les)h(icon.)0 5048 y Fc(BUFSIZ)208 5148 y Fl(The)e(b)n(uf)n(fer)g(size)i(for)f Fh(copy)o Fl(,)g(def)o(ault)g(1)g(me)o(gabyte.)0 5295 y(Note)f(that)g(the)g (process)g(of)f(creating)g(\002nder)h(aliases)h(is)g(not)e(speci\002ed) h(in)g(the)g(Apple)g(documentation.)i(Hence,)e(aliases)h(created)0 5394 y(with)g Fh(mkalias\(\))f Fl(could)h(concei)n(v)n(ably)d(ha)n(v)o (e)j(incompatible)e(beha)n(viour)g(in)j(some)f(cases.)0 5722 y Fe(3.8)121 b(Standard)35 b(Module)f Fd(findertools)p 0 5965 3761 4 v 0 6065 a Fg(12)2193 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r(vices)p eop %%Page: 13 19 13 18 bop 0 83 a Fl(This)29 b(module)f(contains)g(routines)g(that)h(gi) n(v)o(e)f(Python)g(programs)f(access)i(to)g(some)g(functionality)e(pro) o(vided)f(by)j(the)g(\002nder)-5 b(.)0 183 y(The)o(y)19 b(are)h(implemented)f(as)h(wrappers)f(around)g(the)h(AppleEv)o(ent)e (interf)o(ace)h(to)i(the)f(\002nder)-5 b(.)0 330 y(All)21 b(\002le)g(and)e(folder)g(parameters)g(can)h(be)g(speci\002ed)g(either) g(as)h(full)f(pathnames)f(or)h(as)h(FSSpec)f(objects.)0 476 y(The)g Fh(findertools)f Fl(module)f(de\002nes)i(the)h(follo)n (wing)d(functions:)0 623 y Fc(launch)o Fh(\()p Fi(\002le)o Fh(\))208 723 y Fl(T)-6 b(ell)19 b(the)g(\002nder)f(to)g(launch)g Fi(\002le)p Fl(.)25 b(What)19 b(launching)d(means)j(depends)e(on)i(the) f(\002le:)25 b(applications)18 b(are)h(started,)f(folders)g(are)208 823 y(opened)g(and)i(documents)e(are)i(opened)f(in)h(the)g(correct)g (application.)0 969 y Fc(Print)o Fh(\()p Fi(\002le)o Fh(\))208 1069 y Fl(T)-6 b(ell)27 b(the)f(\002nder)g(to)h(print)f(a)h (\002le)g(\(again)e(speci\002ed)h(by)g(full)h(pathname)e(or)h (FSSpec\).)44 b(The)26 b(beha)n(viour)f(is)i(identical)f(to)208 1169 y(selecting)19 b(the)i(\002le)g(and)e(using)h(the)g(print)g (command)e(in)i(the)g(\002nder)-5 b(.)0 1316 y Fc(copy)o Fh(\()p Fi(\002le)o(,)20 b(destdir)r Fh(\))208 1415 y Fl(T)-6 b(ell)21 b(the)g(\002nder)g(to)g(cop)o(y)g(a)g(\002le)h(or)f (folder)f Fi(\002le)h Fl(to)h(folder)e Fi(destdir)q Fl(.)29 b(The)21 b(function)e(returns)i(an)g(Alias)h(object)e(pointing)g(to)208 1515 y(the)g(ne)n(w)g(\002le.)0 1662 y Fc(move)o Fh(\()p Fi(\002le)o(,)g(destdir)r Fh(\))208 1761 y Fl(T)-6 b(ell)20 b(the)h(\002nder)e(to)h(mo)o(v)o(e)f(a)i(\002le)g(or)f(folder)f Fi(\002le)h Fl(to)g(folder)g Fi(destdir)q Fl(.)26 b(The)20 b(function)e(returns)h(an)i(Alias)g(object)e(pointing)g(to)208 1861 y(the)h(ne)n(w)g(\002le.)0 2008 y Fc(sleep)o Fh(\(\))208 2107 y Fl(T)-6 b(ell)20 b(the)g(\002nder)g(to)g(put)g(the)g(Macintosh)g (to)g(sleep,)g(if)h(your)d(machine)h(supports)h(it.)0 2254 y Fc(restart)o Fh(\(\))208 2354 y Fl(T)-6 b(ell)20 b(the)g(\002nder)g(to)g(perform)e(an)j(orderly)d(restart)i(of)g(the)g (machine.)0 2501 y Fc(shutdown)o Fh(\(\))208 2600 y Fl(T)-6 b(ell)20 b(the)g(\002nder)g(to)g(perform)e(an)j(orderly)d(shutdo)n(wn)h (of)h(the)g(machine.)0 2928 y Fe(3.9)121 b(Built-in)32 b(Module)j Fd(macspeech)0 3161 y Fl(This)c(module)e(pro)o(vides)g(an)i (interf)o(ace)f(to)h(the)g(Macintosh)e(Speech)h(Manager)m(,)66 b(allo)n(wing)30 b(you)g(to)g(let)i(the)f(Macintosh)e(ut-)0 3260 y(ter)g(phrases.)52 b(Y)-9 b(ou)28 b(need)h(a)g(v)o(ersion)f(of)h (the)g(Speech)g(Manager)f(e)o(xtension)f(\(v)o(ersion)h(1)h(and)g(2)g (ha)n(v)o(e)g(been)f(tested\))h(in)g(your)0 3360 y(`)p Fm(Extensions)p Fl(')21 b(folder)h(for)g(this)h(to)g(w)o(ork.)32 b(The)22 b(module)g(does)g(not)h(pro)o(vide)d(full)j(access)g(to)g(all) g(features)f(of)h(the)g(Speech)f(Man-)0 3459 y(ager)e(yet.)25 b(It)20 b(may)g(not)g(be)g(a)n(v)n(ailable)f(in)i(all)g(Mac)f(Python)f (v)o(ersions.)0 3606 y Fc(Available)n Fh(\(\))208 3706 y Fl(T)-6 b(est)27 b(a)n(v)n(ailability)f(of)h(the)g(Speech)f(Manager)f (e)o(xtension)g(\(and,)j(on)e(the)h(Po)n(werPC,)f(the)h(Speech)f (Manager)g(shared)g(li-)208 3806 y(brary\).)d(Return)d Fh(0)g Fl(or)g Fh(1)p Fl(.)0 3952 y Fc(Version)o Fh(\(\))208 4052 y Fl(Return)f(the)i(\(inte)o(ger\))d(v)o(ersion)h(number)f(of)i (the)g(Speech)g(Manager)-5 b(.)0 4199 y Fc(SpeakString)n Fh(\()p Fi(str)r Fh(\))208 4299 y Fl(Utter)22 b(the)g(string)g Fi(str)j Fl(using)d(the)g(def)o(ault)f(v)n(oice,)h(asynchronously)-5 b(.)28 b(This)22 b(aborts)f(an)o(y)h(speech)f(that)i(may)e(still)j(be)e (acti)n(v)o(e)208 4398 y(from)d(prior)g Fh(SpeakString\(\))f Fl(in)m(v)n(ocations.)0 4545 y Fc(Busy)o Fh(\(\))208 4645 y Fl(Return)h(the)i(number)d(of)i(speech)f(channels)h(b)n(usy)-5 b(,)19 b(system-wide.)0 4792 y Fc(CountVoices)n Fh(\(\))208 4891 y Fl(Return)g(the)i(number)d(of)i(dif)n(ferent)e(v)n(oices)j(a)n (v)n(ailable.)0 5038 y Fc(GetIndVoice)n Fh(\()p Fi(num)o Fh(\))208 5138 y Fl(Return)e(a)i(V)-11 b(oice)20 b(object)g(for)f(v)n (oice)h(number)f Fi(num)o Fl(.)0 5423 y Fb(V)-8 b(oice)29 b(Objects)0 5626 y Fl(V)-11 b(oice)19 b(objects)f(contain)f(the)h (description)f(of)h(a)h(v)n(oice.)24 b(It)19 b(is)g(currently)e(not)h (yet)h(possible)f(to)g(access)h(the)g(parameters)e(of)h(a)h(v)n(oice.)0 5772 y Fc(GetGender)n Fh(\(\))p 0 5965 3761 4 v 0 6065 a Fg(3.9.)52 b(Built-in)25 b(Module)f Fh(macspeech)2456 b Fg(13)p eop %%Page: 14 20 14 19 bop 208 83 a Fl(Return)19 b(the)i(gender)d(of)i(the)g(v)n(oice:) 25 b Fh(0)c Fl(for)e(male,)h Fh(1)h Fl(for)e(female)h(and)g Fh(-1)g Fl(for)g(neuter)-5 b(.)0 230 y Fc(NewChannel)n Fh(\(\))208 330 y Fl(Return)19 b(a)i(ne)n(w)f(Speech)f(Channel)h (object)g(using)f(this)i(v)n(oice.)0 614 y Fb(Speech)30 b(Channel)f(Objects)0 817 y Fl(A)g(Speech)e(Channel)h(object)f(allo)n (ws)i(you)e(to)h(speak)g(strings)g(with)h(slightly)f(more)f(control)g (than)h Fh(SpeakString\(\))p Fl(,)g(and)0 917 y(allo)n(ws)d(you)f(to)g (use)h(multiple)f(speak)o(ers)g(at)h(the)g(same)g(time.)38 b(Please)25 b(note)f(that)h(channel)e(pitch)i(and)f(rate)g(are)h (interrelated)e(in)0 1017 y(some)d(w)o(ay)-5 b(,)20 b(so)g(that)g(to)h (mak)o(e)f(your)e(Macintosh)i(sing)g(you)f(will)i(ha)n(v)o(e)f(to)g (adjust)g(both.)0 1163 y Fc(SpeakText)n Fh(\()p Fi(str)s Fh(\))208 1263 y Fl(Start)g(uttering)f(the)h(gi)n(v)o(en)f(string.)0 1410 y Fc(Stop)o Fh(\(\))208 1510 y Fl(Stop)h(babbling.)0 1656 y Fc(GetPitch)o Fh(\(\))208 1756 y Fl(Return)f(the)i(current)d (pitch)i(of)g(the)g(channel,)f(as)i(a)g(\003oating-point)c(number)-5 b(.)0 1903 y Fc(SetPitch)o Fh(\()p Fi(pitc)o(h)n Fh(\))208 2003 y Fl(Set)20 b(the)h(pitch)e(of)h(the)h(channel.)0 2149 y Fc(GetRate)o Fh(\(\))208 2249 y Fl(Get)f(the)g(speech)g(rate)g (\(utterances)f(per)h(minute\))f(of)h(the)g(channel)f(as)i(a)g (\003oating)e(point)h(number)-5 b(.)0 2396 y Fc(SetRate)o Fh(\()p Fi(r)o(ate)o Fh(\))208 2496 y Fl(Set)20 b(the)h(speech)e(rate)h (of)g(the)h(channel.)0 2823 y Fe(3.10)121 b(Standard)36 b(Module)e Fd(EasyDialogs)0 3056 y Fl(The)17 b Fh(EasyDialogs)f Fl(module)g(contains)g(some)h(simple)h(dialogs)e(for)h(the)g (Macintosh,)g(modelled)f(after)h(the)g Fh(stdwin)g Fl(dialogs)0 3155 y(with)22 b(similar)h(names.)30 b(All)23 b(routines)e(ha)n(v)o(e)h (an)g(optional)f(parameter)f Fi(id)25 b Fl(with)d(which)g(you)f(can)h (o)o(v)o(erride)e(the)i(DLOG)g(resource)0 3255 y(used)e(for)f(the)i (dialog,)e(as)i(long)e(as)i(the)f(item)h(numbers)d(correspond.)23 b(See)d(the)g(source)g(for)f(details.)0 3402 y(The)h Fh(EasyDialogs)f Fl(module)f(de\002nes)i(the)h(follo)n(wing)d (functions:)0 3549 y Fc(Message)o Fh(\()p Fi(str)r Fh(\))208 3648 y Fl(A)e(modal)g(dialog)f(with)i(the)f(message)g(te)o(xt)g Fi(str)s Fl(,)h(which)f(should)f(be)h(at)h(most)g(255)e(characters)g (long,)h(is)i(displayed.)k(Control)208 3748 y(is)f(returned)d(when)i (the)g(user)g(clicks)g(\223OK\224.)0 3895 y Fc(AskString)n Fh(\()p Fi(pr)l(ompt)q Fa([)p Fi(,)g(default)13 b Fa(])o Fh(\))208 3995 y Fl(Ask)24 b(the)g(user)g(to)g(input)f(a)i(string)f(v)n (alue,)g(in)g(a)g(modal)f(dialog.)36 b Fi(pr)l(ompt)25 b Fl(is)g(the)f(promt)f(message,)i(the)f(optional)f Fi(default)208 4094 y Fl(ar)o(g)d(is)h(the)g(initial)h(v)n(alue)e(for)g(the)h(string.) 27 b(All)22 b(strings)f(can)f(be)h(at)h(most)f(255)f(bytes)g(long.)27 b Fh(AskString\(\))19 b Fl(returns)h(the)208 4194 y(string)f(entered)h (or)f Fh(None)h Fl(in)h(case)f(the)h(user)f(cancelled.)0 4341 y Fc(AskYesNoCancel)m Fh(\()p Fi(question)p Fa([)p Fi(,)f(default)13 b Fa(])o Fh(\))208 4440 y Fl(Present)20 b(a)g(dialog)g(with)g(te)o(xt)g Fi(question)f Fl(and)h(three)f(b)n (uttons)h(labelled)g(\223yes\224,)f(\223no\224)h(and)g(\223cancel\224.) k(Return)c Fh(1)g Fl(for)g(yes,)g Fh(0)208 4540 y Fl(for)h(no)h(and)f Fh(-1)h Fl(for)g(cancel.)30 b(The)21 b(def)o(ault)h(return)f(v)n(alue)g (chosen)g(by)h(hitting)f(return)g(is)i Fh(0)p Fl(.)31 b(This)22 b(can)g(be)g(changed)e(with)208 4640 y(the)g(optional)f Fi(default)i Fl(ar)o(gument.)0 4786 y Fc(ProgressBar)n Fh(\()p Fa([)p Fi(label)p Fa([)p Fi(,)e(maxval)12 b Fa(])g(])n Fh(\))208 4886 y Fl(Display)31 b(a)i(modeless)f(progress)f(dialog)g (with)h(a)g(thermometer)e(bar)-5 b(.)61 b Fi(label)32 b Fl(is)h(the)f(te)o(xt)g(string)f(displayed)g(\(def)o(ault)208 4986 y(\223W)-7 b(orking...)h(\224\),)26 b Fi(maxval)g Fl(is)i(the)f(v)n(alue)f(at)i(which)e(progress)g(is)i(complete)e(\(def) o(ault)g Fh(100)o Fl(\).)46 b(The)26 b(returned)g(object)g(has)208 5085 y(one)19 b(method,)g Fh(set\()p Fi(value)n Fh(\))p Fl(,)h(which)g(sets)h(the)f(v)n(alue)f(of)h(the)h(progress)d(bar)-5 b(.)25 b(The)20 b(bar)g(remains)f(visible)i(until)f(the)g(object)208 5185 y(returned)e(is)j(discarded.)208 5318 y(The)e(progress)g(bar)h (has)h(a)f(\223cancel\224)g(b)n(utton,)f(b)n(ut)h(it)h(is)g(currently)e (non-functional.)0 5465 y(Note)27 b(that)g Fh(EasyDialogs)f Fl(does)h(not)g(currently)e(use)i(the)g(noti\002cation)f(manager)-5 b(.)45 b(This)27 b(means)g(that)g(displaying)f(dialogs)0 5564 y(while)21 b(the)g(program)d(is)k(in)f(the)g(background)c(will)22 b(lead)e(to)h(une)o(xpected)d(results)k(and)e(possibly)g(crashes.)27 b(Also,)21 b(all)g(dialogs)f(are)0 5664 y(modeless)25 b(and)f(hence)g(e)o(xpect)g(to)i(be)f(at)g(the)g(top)g(of)g(the)g (stacking)f(order)-5 b(.)39 b(This)25 b(is)h(true)f(when)f(the)h (dialogs)g(are)g(created,)g(b)n(ut)0 5764 y(windo)n(ws)19 b(that)i(pop-up)d(later)i(\(lik)o(e)g(a)h(console)e(windo)n(w\))g(may)h (also)g(result)g(in)h(crashes.)p 0 5965 3761 4 v 0 6065 a Fg(14)2193 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r (vices)p eop %%Page: 15 21 15 20 bop 0 88 a Fe(3.11)121 b(Standard)36 b(Module)e Fd(FrameWork)0 321 y Fl(The)21 b Fh(FrameWork)g Fl(module)g(contains)g (classes)i(that)f(together)e(pro)o(vide)g(a)i(frame)n(w)o(ork)e(for)h (an)h(interacti)n(v)o(e)e(Macintosh)h(appli-)0 421 y(cation.)36 b(The)23 b(programmer)e(b)n(uilds)j(an)g(application)e(by)i(creating)f (subclasses)h(that)g(o)o(v)o(erride)e(v)n(arious)g(methods)h(of)h(the)g (bases)0 520 y(classes,)19 b(thereby)c(implementing)g(the)i (functionality)e(w)o(anted.)24 b(Ov)o(erriding)15 b(functionality)g (can)i(often)f(be)h(done)f(on)h(v)n(arious)f(dif-)0 620 y(ferent)21 b(le)n(v)o(els,)h(i.e.)31 b(to)22 b(handle)f(clicks)h(in)h (a)f(single)g(dialog)f(windo)n(w)g(in)h(a)h(non-standard)c(w)o(ay)j(it) g(is)h(not)f(necessary)f(to)h(o)o(v)o(erride)0 719 y(the)e(complete)f (e)n(v)o(ent)h(handling.)0 866 y(The)i Fh(FrameWork)g Fl(is)h(still)h(v)o(ery)d(much)h(w)o(ork-in-progress,)d(and)j(the)g (documentation)e(describes)i(only)g(the)g(most)h(important)0 966 y(functionality)-5 b(,)17 b(and)j(not)g(in)g(the)g(most)h(logical)e (manner)g(at)i(that.)k(Examine)19 b(the)h(source)f(or)h(the)h(e)o (xamples)e(for)g(more)h(details.)0 1113 y(The)g Fh(FrameWork)f Fl(module)g(de\002nes)h(the)g(follo)n(wing)e(functions:)0 1260 y Fc(Application)n Fh(\(\))208 1359 y Fl(An)23 b(object)g (representing)f(the)i(complete)e(application.)34 b(See)25 b(belo)n(w)e(for)g(a)h(description)e(of)h(the)h(methods.)35 b(The)23 b(def)o(ault)p 208 1459 25 4 v 237 1459 V 262 1459 a Fh(init)p 467 1459 V 496 1459 V 59 w(\(\))e Fl(routine)e (creates)h(an)g(empty)f(windo)n(w)h(dictionary)e(and)i(a)g(menu)f(bar)h (with)h(an)f(apple)f(menu.)0 1606 y Fc(MenuBar)o Fh(\(\))208 1705 y Fl(An)h(object)f(representing)g(the)h(menubar)-5 b(.)23 b(This)e(object)e(is)i(usually)f(not)g(created)f(by)h(the)g (user)-5 b(.)0 1852 y Fc(Menu)o Fh(\()p Fi(bar)c(,)20 b(title)p Fa([)p Fi(,)g(after)14 b Fa(])p Fh(\))208 1952 y Fl(An)21 b(object)g(representing)e(a)j(menu.)28 b(Upon)20 b(creation)h(you)f(pass)i(the)g Fh(MenuBar)f Fl(the)g(menu)g(appears)f (in,)i(the)f Fi(title)i Fl(string)208 2052 y(and)c(a)i(position)e (\(1-based\))f Fi(after)23 b Fl(where)c(the)i(menu)e(should)g(appear)g (\(def)o(ault:)24 b(at)d(the)f(end\).)0 2198 y Fc(MenuItem)o Fh(\()p Fi(menu,)f(title)p Fa([)p Fi(,)h(shortcut,)g(callbac)n(k)13 b Fa(])n Fh(\))208 2298 y Fl(Create)32 b(a)h(menu)e(item)h(object.)60 b(The)32 b(ar)o(guments)e(are)j(the)f(menu)f(to)h(crate)g(the)g(item)h (it,)i(the)e(item)f(title)h(string)f(and)208 2398 y(optionally)17 b(the)i(k)o(e)o(yboard)e(shortcut)h(and)g(a)i(callback)e(routine.)24 b(The)18 b(callback)h(is)h(called)f(with)g(the)g(ar)o(guments)e (menu-id,)208 2497 y(item)j(number)e(within)i(menu)f(\(1-based\),)f (current)h(front)h(windo)n(w)f(and)g(the)i(e)n(v)o(ent)e(record.)208 2628 y(In)h(stead)h(of)g(a)g(callable)f(object)h(the)f(callback)g(can)h (also)g(be)g(a)g(string.)27 b(In)20 b(this)i(case)f(menu)f(selection)g (causes)h(the)g(lookup)208 2728 y(of)30 b(a)h(method)f(in)h(the)g (topmost)f(windo)n(w)f(and)i(the)f(application.)56 b(The)30 b(method)g(name)g(is)i(the)f(callback)f(string)g(with)208 2828 y Fh('domenu)p 563 2828 V 28 w(')21 b Fl(prepended.)208 2959 y(Calling)f(the)g Fh(MenuBar)f(fixmenudimstate)f Fl(method)h(sets)i(the)f(correct)f(dimming)g(for)g(all)i(menu)e(items)i (based)f(on)208 3059 y(the)g(current)f(front)g(windo)n(w)-5 b(.)0 3205 y Fc(Separator)n Fh(\()p Fi(menu)o Fh(\))208 3305 y Fl(Add)19 b(a)i(separator)e(to)h(the)g(end)g(of)g(a)h(menu.)0 3452 y Fc(SubMenu)o Fh(\()p Fi(menu,)e(label)o Fh(\))208 3552 y Fl(Create)h(a)h(submenu)d(named)h Fi(label)h Fl(under)f(menu)g Fi(menu)o Fl(.)25 b(The)20 b(menu)g(object)f(is)i(returned.)0 3698 y Fc(Window)o Fh(\()p Fi(par)m(ent)p Fh(\))208 3798 y Fl(Creates)i(a)g(\(modeless\))e(windo)n(w)-5 b(.)31 b Fi(P)-7 b(ar)m(ent)24 b Fl(is)g(the)e(application)g(object)g(to)g (which)h(the)f(windo)n(w)g(belongs.)31 b(The)22 b(windo)n(w)208 3898 y(is)f(not)f(displayed)f(until)h(later)-5 b(.)0 4045 y Fc(DialogWindow)n Fh(\()p Fi(par)m(ent)p Fh(\))208 4144 y Fl(Creates)20 b(a)h(modeless)f(dialog)f(windo)n(w)-5 b(.)0 4291 y Fc(windowbounds)n Fh(\()p Fi(width,)20 b(height)p Fh(\))208 4391 y Fl(Return)g(a)h Fh(\(left,)49 b(top,)g(right,)f (bottom\))20 b Fl(tuple)g(suitable)h(for)f(creation)g(of)g(a)h(windo)n (w)f(of)g(gi)n(v)o(en)f(width)i(and)208 4490 y(height.)38 b(The)25 b(windo)n(w)f(will)i(be)f(staggered)f(with)h(respect)g(to)g (pre)n(vious)e(windo)n(ws,)j(and)e(an)h(attempt)g(is)h(made)e(to)i(k)o (eep)208 4590 y(the)f(whole)h(windo)n(w)e(on-screen.)40 b(The)26 b(windo)n(w)f(will)h(ho)n(we)n(v)o(er)e(al)o(w)o(ays)i(be)g(e) o(xact)f(the)h(size)g(gi)n(v)o(en,)g(so)g(parts)g(may)f(be)208 4690 y(of)n(fscreen.)0 4836 y Fc(setwatchcursor)m Fh(\(\))208 4936 y Fl(Set)20 b(the)h(mouse)e(cursor)g(to)i(a)f(w)o(atch.)0 5083 y Fc(setarrowcursor)m Fh(\(\))208 5183 y Fl(Set)g(the)h(mouse)e (cursor)g(to)i(an)f(arro)n(w)-5 b(.)0 5466 y Fb(Application)30 b(Objects)0 5669 y Fl(Application)19 b(objects)h(ha)n(v)o(e)f(the)i (follo)n(wing)d(methods,)h(among)g(others:)0 5816 y Fc(makeusermenus)n Fh(\(\))p 0 5965 3761 4 v 0 6065 a Fg(3.11.)52 b(Standard)24 b(Module)h Fh(FrameWork)2326 b Fg(15)p eop %%Page: 16 22 16 21 bop 208 83 a Fl(Ov)o(erride)18 b(this)j(method)e(if)h(you)f(need) h(menus)f(in)i(your)e(application.)k(Append)c(the)h(menus)g(to)g(the)g (attrib)n(ute)g Fh(menubar)p Fl(.)0 230 y Fc(getabouttext)n Fh(\(\))208 330 y Fl(Ov)o(erride)37 b(this)j(method)e(to)h(return)f(a)i (te)o(xt)f(string)g(describing)e(your)h(application.)81 b(Alternati)n(v)o(ely)-5 b(,)41 b(o)o(v)o(erride)c(the)208 429 y Fh(do)p 313 429 25 4 v 29 w(about\(\))20 b Fl(method)e(for)i (more)f(elaborate)g(\223about\224)g(messages.)0 576 y Fc(mainloop)o Fh(\()p Fa([)p Fi(mask)q Fa([)p Fi(,)g(wait)13 b Fa(])f(])p Fh(\))208 676 y Fl(This)24 b(routine)e(is)j(the)f(main)f (e)n(v)o(ent)g(loop,)h(call)g(it)g(to)g(set)h(your)e(application)f (rolling.)35 b Fi(Mask)25 b Fl(is)g(the)f(mask)f(of)h(e)n(v)o(ents)f (you)208 775 y(w)o(ant)k(to)h(handle,)f Fi(wait)j Fl(is)e(the)f(number) f(of)h(ticks)h(you)e(w)o(ant)i(to)f(lea)n(v)o(e)g(to)h(other)e (concurrent)f(application)h(\(def)o(ault)g(0,)208 875 y(which)h(is)h(probably)e(not)h(a)h(good)f(idea\).)47 b(While)28 b(raising)f Fh(self)h Fl(to)g(e)o(xit)f(the)h(mainloop)e(is) j(still)g(supported)c(it)k(is)g(not)208 975 y(recommended,)16 b(call)21 b Fh(self.)p 1115 975 V 29 w(quit)f Fl(instead.)208 1107 y(The)j(e)n(v)o(ent)g(loop)g(is)i(split)f(into)g(man)o(y)f(small)h (parts,)h(each)e(of)h(which)f(can)h(be)g(o)o(v)o(erridden.)33 b(The)23 b(def)o(ault)g(methods)g(tak)o(e)208 1207 y(care)j(of)h (dispatching)f(e)n(v)o(ents)g(to)i(windo)n(ws)e(and)g(dialogs,)i (handling)e(drags)g(and)h(resizes,)i(Apple)d(Ev)o(ents,)i(e)n(v)o(ents) f(for)208 1307 y(non-FrameW)-7 b(ork)17 b(windo)n(ws,)i(etc.)208 1439 y(In)28 b(general,)g(all)h(e)n(v)o(ent)f(handlers)f(should)g (return)g Fh(1)i Fl(if)f(the)g(e)n(v)o(ent)g(is)h(fully)e(handled)g (and)h Fh(0)g Fl(otherwise)g(\(because)f(the)208 1539 y(front)22 b(windo)n(w)h(w)o(as)h(not)f(a)i(FrameW)-7 b(ork)22 b(windo)n(w)-5 b(,)23 b(for)g(instance\).)35 b(This)23 b(is)i(needed)d(so)i(that)g(update)e(e)n(v)o(ents)h(and)g (such)208 1639 y(can)e(be)h(passed)g(on)f(to)h(other)f(windo)n(ws)h (lik)o(e)g(the)g(Sioux)f(console)g(windo)n(w)-5 b(.)28 b(Calling)22 b Fh(MacOS.HandleEvent\(\))d Fl(is)208 1738 y(not)j(allo)n(wed)h(within)f Fi(our)p 978 1738 V 29 w(dispatc)o(h)g Fl(or)h(its)h(callees,)g(since)f(this)g(may)g(result)g (in)g(an)g(in\002nite)g(loop)f(if)h(the)g(code)f(is)i(called)208 1838 y(through)18 b(the)i(Python)f(inner)n(-loop)f(e)n(v)o(ent)h (handler)-5 b(.)0 1985 y Fc(asyncevents)n Fh(\()p Fi(onof)o(f)10 b Fh(\))208 2084 y Fl(Call)23 b(this)g(method)f(with)g(a)i(nonzero)c (parameter)h(to)i(enable)f(asynchronous)e(e)n(v)o(ent)h(handling.)31 b(This)23 b(will)g(tell)g(the)g(inner)208 2184 y(interpreter)15 b(loop)i(to)g(call)h(the)f(application)f(e)n(v)o(ent)g(handler)g Fi(async)p 2119 2184 V 29 w(dispatc)o(h)g Fl(whene)n(v)o(er)g(e)n(v)o (ents)g(are)h(a)n(v)n(ailable.)24 b(This)17 b(will)208 2284 y(cause)j(FrameW)-7 b(ork)20 b(windo)n(w)g(updates)g(and)g(the)g (user)h(interf)o(ace)f(to)h(remain)f(w)o(orking)f(during)g(long)h (computations,)e(b)n(ut)208 2383 y(will)k(slo)n(w)g(the)f(interpreter)f (do)n(wn)h(and)g(may)g(cause)g(surprising)f(results)i(in)g (non-reentrant)c(code)j(\(such)g(as)h(FrameW)-7 b(ork)208 2483 y(itself\).)36 b(By)25 b(def)o(ault)e Fi(async)p 1030 2483 V 29 w(dispatc)o(h)g Fl(will)i(immedeately)d(call)j Fi(our)p 2232 2483 V 29 w(dispatc)o(h)e Fl(b)n(ut)h(you)f(may)h(o)o(v)o (erride)d(this)k(to)f(handle)208 2583 y(only)19 b(certain)h(e)n(v)o (ents)f(asynchronously)-5 b(.)21 b(Ev)o(ents)f(you)f(do)h(not)g(handle) f(will)i(be)f(passed)g(to)g(Sioux)g(and)g(such.)208 2715 y(The)f(old)h(on/of)n(f)f(v)n(alue)g(is)i(returned.)p 5 2862 V 30 2862 a Fc(quit)o Fh(\(\))208 2962 y Fl(T)-6 b(erminate)19 b(the)h(running)e Fh(mainloop\(\))h Fl(call)h(at)h(the)f (ne)o(xt)g(con)m(v)o(enient)d(moment.)0 3109 y Fc(do)p 105 3109 V 30 w(char)o Fh(\()p Fi(c,)j(e)o(vent)p Fh(\))208 3208 y Fl(The)27 b(user)h(typed)f(character)g Fi(c)p Fl(.)48 b(The)28 b(complete)f(details)h(of)g(the)g(e)n(v)o(ent)f(can)h (be)f(found)g(in)h(the)g Fi(e)o(vent)h Fl(structure.)47 b(This)208 3308 y(method)30 b(can)i(also)g(be)g(pro)o(vided)d(in)j(a)g Fh(Window)f Fl(object,)j(which)e(o)o(v)o(errides)d(the)j (application-wide)e(handler)g(if)i(the)208 3408 y(windo)n(w)19 b(is)i(frontmost.)0 3555 y Fc(do)p 105 3555 V 30 w(dialogevent)m Fh(\()p Fi(e)o(vent)q Fh(\))208 3654 y Fl(Called)h(early)f(in)h(the)g (e)n(v)o(ent)f(loop)g(to)h(handle)f(modeless)g(dialog)g(e)n(v)o(ents.) 29 b(The)22 b(def)o(ault)f(method)f(simply)i(dispatches)f(the)208 3754 y(e)n(v)o(ent)i(to)h(the)h(rele)n(v)n(ant)e(dialog)g(\(not)h (through)e(the)i(the)g Fh(DialogWindow)f Fl(object)h(in)m(v)n(olv)o (ed\).)34 b(Ov)o(erride)23 b(if)i(you)e(need)208 3853 y(special)d(handling)e(of)i(dialog)f(e)n(v)o(ents)h(\(k)o(e)o(yboard)d (shortcuts,)j(etc\).)0 4000 y Fc(idle)o Fh(\()p Fi(e)o(vent)p Fh(\))208 4100 y Fl(Called)k(by)g(the)g(main)g(e)n(v)o(ent)f(loop)h (when)f(no)h(e)n(v)o(ents)g(are)g(a)n(v)n(ailable.)36 b(The)24 b(null-e)n(v)o(ent)e(is)k(passed)e(\(so)g(you)f(can)h(look)g (at)208 4200 y(mouse)19 b(position,)g(etc\).)0 4484 y Fb(Windo)o(w)28 b(Objects)0 4687 y Fl(W)m(indo)n(w)19 b(objects)h(ha)n(v)o(e)g(the)g(follo)n(wing)f(methods,)f(among)h (others:)0 4834 y Fc(open)o Fh(\(\))208 4934 y Fl(Ov)o(erride)47 b(this)i(method)f(to)h(open)f(a)h(windo)n(w)-5 b(.)110 b(Store)49 b(the)g(MacOS)g(windo)n(w-id)e(in)i Fh(self.wid)f Fl(and)h(call)208 5033 y Fh(self.do)p 563 5033 V 28 w(postopen)19 b Fl(to)i(re)o(gister)e(the)h(windo)n(w)g(with)g(the)g(parent)f (application.)0 5180 y Fc(close)o Fh(\(\))208 5280 y Fl(Ov)o(erride)31 b(this)j(method)d(to)j(do)e(an)o(y)h(special)g (processing)f(on)g(windo)n(w)h(close.)63 b(Call)34 b Fh(self.do)p 3190 5280 V 29 w(postclose)e Fl(to)208 5380 y(cleanup)19 b(the)h(parent)f(state.)0 5526 y Fc(do)p 105 5526 V 30 w(postresize)n Fh(\()p Fi(width,)h(height,)f (macoswindowid)p Fh(\))208 5626 y Fl(Called)h(after)g(the)g(windo)n(w)f (is)i(resized.)k(Ov)o(erride)19 b(if)h(more)f(needs)h(to)h(be)f(done)f (than)h(calling)f Fh(InvalRect)o Fl(.)0 5773 y Fc(do)p 105 5773 V 30 w(contentclick)m Fh(\()p Fi(local,)h(modi\002er)o(s,)f(e) o(vent)q Fh(\))p 0 5965 3761 4 v 0 6065 a Fg(16)2193 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r(vices)p eop %%Page: 17 23 17 22 bop 208 83 a Fl(The)20 b(user)g(click)o(ed)g(in)h(the)g(content)f (part)g(of)g(a)h(windo)n(w)-5 b(.)25 b(The)20 b(ar)o(guments)f(are)i (the)f(coordinates)f(\(windo)n(w-relati)n(v)o(e\),)e(the)208 183 y(k)o(e)o(y)i(modi\002ers)h(and)f(the)h(ra)o(w)g(e)n(v)o(ent.)0 330 y Fc(do)p 105 330 25 4 v 30 w(update)n Fh(\()p Fi(macoswindowid,)f (e)o(vent)p Fh(\))208 429 y Fl(An)h(update)f(e)n(v)o(ent)g(for)h(the)g (windo)n(w)f(w)o(as)i(recei)n(v)o(ed.)i(Redra)o(w)d(the)g(windo)n(w)-5 b(.)0 576 y Fc(do)p 105 576 V 30 w(activate)n Fh(\()p Fi(activate)o(,)19 b(e)o(vent)q Fh(\))208 676 y Fl(The)26 b(windo)n(w)g(w)o(as)h(acti)n(v)n(ated)f(\()p Fh(activate==1)n Fl(\))h(or)f(deacti)n(v)n(ated)f(\()p Fh(activate==0)n Fl(\).)45 b(Handle)26 b(things)g(lik)o(e)h(focus)208 775 y(highlighting,)17 b(etc.)0 1060 y Fb(ControlsWindo)o(w)29 b(Object)0 1263 y Fl(ControlsW)m(indo)n(w)18 b(objects)i(ha)n(v)o(e)g (the)g(follo)n(wing)f(methods)g(besides)h(those)g(of)g Fh(Window)f Fl(objects:)0 1410 y Fc(do)p 105 1410 V 30 w(controlhit)n Fh(\()p Fi(window)-6 b(,)19 b(contr)l(ol,)h(pcode)o(,)f (e)o(vent)p Fh(\))208 1510 y Fl(P)o(art)h Fh(pcode)g Fl(of)g(control)f Fh(control)g Fl(w)o(as)i(hit)f(by)g(the)g(user)-5 b(.)26 b(T)m(racking)18 b(and)i(such)g(has)g(already)f(been)h(tak)o(en) g(care)f(of.)0 1794 y Fb(ScrolledWindo)o(w)30 b(Object)0 1997 y Fl(ScrolledW)m(indo)n(w)18 b(objects)i(are)g(ControlsW)m(indo)n (w)e(objects)i(with)h(the)f(follo)n(wing)e(e)o(xtra)i(methods:)0 2144 y Fc(scrollbars)n Fh(\()p Fa([)p Fi(wantx)p Fa([)p Fi(,)g(wanty)12 b Fa(])g(])n Fh(\))208 2244 y Fl(Create)31 b(\(or)f(destro)o(y\))g(horizontal)g(and)g(v)o(ertical)h(scrollbars.)57 b(The)31 b(ar)o(guments)e(specify)h(which)h(you)f(w)o(ant)h(\(def)o (ault:)208 2343 y(both\).)23 b(The)d(scrollbars)g(al)o(w)o(ays)g(ha)n (v)o(e)g(minimum)f Fh(0)h Fl(and)g(maximum)e Fh(32767)o Fl(.)0 2490 y Fc(getscrollbarvalues)m Fh(\(\))208 2590 y Fl(Y)-9 b(ou)21 b(must)h(supply)f(this)i(method.)29 b(It)22 b(should)f(return)g(a)h(tuple)g Fh(\()p Fi(x)p Fh(,)49 b Fi(y)p Fh(\))23 b Fl(gi)n(ving)d(the)i(current)f(position)g (of)h(the)g(scrollbars)208 2690 y(\(between)f Fh(0)i Fl(and)f Fh(32767)o Fl(\).)32 b(Y)-9 b(ou)22 b(can)g(return)f Fh(None)h Fl(for)g(either)g(to)h(indicate)f(the)g(whole)g(document)f (is)i(visible)f(in)h(that)208 2789 y(direction.)0 2936 y Fc(updatescrollbars)m Fh(\(\))208 3036 y Fl(Call)d(this)h(method)d (when)h(the)h(document)e(has)i(changed.)j(It)d(will)g(call)h Fh(getscrollbarvalues\(\))16 b Fl(and)j(update)g(the)208 3135 y(scrollbars.)0 3282 y Fc(scrollbar)p 455 3282 V 28 w(callback)o Fh(\()p Fi(whic)o(h,)g(what,)h(value)o Fh(\))208 3382 y Fl(Supplied)25 b(by)h(you)g(and)g(called)h(after)f (user)h(interaction.)43 b Fi(whic)o(h)26 b Fl(will)h(be)g Fh('x')g Fl(or)f Fh('y')p Fl(,)i Fi(what)g Fl(will)g(be)f Fh('-')o Fl(,)i Fh('--')o Fl(,)208 3481 y Fh('set')o Fl(,)20 b Fh('++')g Fl(or)g Fh('+')o Fl(.)26 b(F)o(or)20 b Fh('set')o Fl(,)g Fi(value)g Fl(will)h(contain)e(the)h(ne)n(w)g (scrollbar)g(position.)0 3628 y Fc(scalebarvalues)m Fh(\()p Fi(absmin,)g(absmax,)f(curmin,)g(curmax)p Fh(\))208 3728 y Fl(Auxiliary)d(method)g(to)i(help)f(you)f(calculate)h(v)n(alues)g(to) h(return)e(from)h Fh(getscrollbarvalues\(\))p Fl(.)k(Y)-9 b(ou)17 b(pass)h(docu-)208 3828 y(ment)i(minimum)f(and)g(maximum)g(v)n (alue)h(and)g(topmost)g(\(leftmost\))f(and)h(bottommost)f (\(rightmost\))f(visible)j(v)n(alues)f(and)208 3927 y(it)g(returns)g (the)g(correct)f(number)g(or)h Fh(None)o Fl(.)0 4074 y Fc(do)p 105 4074 V 30 w(activate)n Fh(\()p Fi(onof)o(f)o(,)f(e)o (vent)p Fh(\))208 4174 y Fl(T)-7 b(ak)o(es)23 b(care)f(of)g (dimming/highlighting)d(scrollbars)j(when)g(a)h(windo)n(w)f(becomes)f (frontmost)g(vv)-5 b(.)32 b(If)23 b(you)e(o)o(v)o(erride)g(this)208 4273 y(method)d(call)j(this)g(one)e(at)i(the)f(end)g(of)g(your)f (method.)0 4420 y Fc(do)p 105 4420 V 30 w(postresize)n Fh(\()p Fi(width,)h(height,)f(window)o Fh(\))208 4520 y Fl(Mo)o(v)o(es)g(scrollbars)g(to)i(the)f(correct)f(position.)24 b(Call)d(this)g(method)e(initially)h(if)g(you)g(o)o(v)o(erride)e(it.)0 4667 y Fc(do)p 105 4667 V 30 w(controlhit)n Fh(\()p Fi(window)-6 b(,)19 b(contr)l(ol,)h(pcode)o(,)f(e)o(vent)p Fh(\))208 4766 y Fl(Handles)k(scrollbar)f(interaction.)34 b(If)24 b(you)e(o)o(v)o(erride)g(it)i(call)g(this)g(method)e(\002rst,)j(a)f (nonzero)e(return)g(v)n(alue)h(indicates)g(the)208 4866 y(hit)d(w)o(as)h(in)f(the)h(scrollbars)e(and)h(has)g(been)g(handled.)0 5151 y Fb(DialogWindo)o(w)30 b(Objects)0 5354 y Fl(DialogW)m(indo)n(w) 18 b(objects)i(ha)n(v)o(e)g(the)g(follo)n(wing)f(methods)g(besides)h (those)g(of)g Fh(Window)f Fl(objects:)0 5501 y Fc(open)o Fh(\()p Fi(r)m(esid)r Fh(\))208 5600 y Fl(Create)d(the)g(dialog)f (windo)n(w)-5 b(,)16 b(from)f(the)h(DLOG)g(resource)f(with)h(id)g Fi(r)m(esid)s Fl(.)24 b(The)16 b(dialog)f(object)g(is)j(stored)d(in)h Fh(self.wid)o Fl(.)p 0 5965 3761 4 v 0 6065 a Fg(3.11.)52 b(Standard)24 b(Module)h Fh(FrameWork)2326 b Fg(17)p eop %%Page: 18 24 18 23 bop 0 83 a Fc(do)p 105 83 25 4 v 30 w(itemhit)n Fh(\()p Fi(item,)20 b(e)o(vent)q Fh(\))208 183 y Fl(Item)f(number)g Fi(item)i Fl(w)o(as)g(hit.)k(Y)-9 b(ou)19 b(are)h(responsible)f(for)h (redra)o(wing)e(toggle)h(b)n(uttons,)h(etc.)0 510 y Fe(3.12)121 b(Standard)36 b(Module)e Fd(MiniAEFrame)0 743 y Fl(The)c(module)e Fh(MiniAEFrame)h Fl(pro)o(vides)f(a)j(frame)n(w)o(ork)d(for)h(an)h (application)f(that)h(can)g(function)e(as)j(an)f(Open)f(Scripting)0 843 y(Architecture)17 b(\(OSA\))i(serv)o(er)m(,)e(i.e.)25 b(recei)n(v)o(e)18 b(and)g(process)g(AppleEv)o(ents.)23 b(It)c(can)f(be)h(used)f(in)h(conjunction)d(with)j Fh(FrameWork)0 942 y Fl(or)h(standalone.)0 1089 y(This)29 b(module)e(is)i(temporary)-5 b(,)28 b(it)h(will)g(e)n(v)o(entually)d(be)j(replaced)e(by)h(a)h (module)e(that)h(handles)g(ar)o(gument)e(names)i(better)g(and)0 1189 y(possibly)20 b(automates)f(making)g(your)g(application)f (scriptable.)0 1336 y(The)i Fh(MiniAEFrame)f Fl(module)f(de\002nes)i (the)h(follo)n(wing)d(classes:)0 1482 y Fc(AEServer)o Fh(\(\))208 1582 y Fl(A)29 b(class)i(that)e(handles)g(AppleEv)o(ent)e (dispatch.)52 b(Y)-9 b(our)29 b(application)f(should)g(subclass)i(this) g(class)g(together)e(with)i(ei-)208 1682 y(ther)c Fh(MiniApplication)f Fl(or)i Fh(FrameWork.Application)p Fl(.)43 b(Y)-9 b(our)p 2544 1682 V 2574 1682 V 86 w Fh(init)p 2804 1682 V 2833 1682 V 59 w(\(\))27 b Fl(method)f(should)h(call)g(the)p 208 1781 V 237 1781 V 262 1781 a Fh(init)p 467 1781 V 496 1781 V 59 w(\(\))21 b Fl(method)e(for)g(both)h(classes.)0 1928 y Fc(MiniApplication)m Fh(\(\))208 2028 y Fl(A)i(class)h(that)f (is)h(more)f(or)f(less)j(compatible)c(with)i Fh(FrameWork.Application)d Fl(b)n(ut)j(with)g(less)i(functionality)-5 b(.)28 b(Its)208 2127 y(e)n(v)o(ent)h(loop)h(supports)g(the)h(apple)f(menu,)i (command-dot)c(and)i(AppleEv)o(ents;)k(other)c(e)n(v)o(ents)g(are)h (passed)g(on)f(to)h(the)208 2227 y(Python)22 b(interpreter)g(and/or)g (Sioux.)33 b(Useful)24 b(if)f(your)f(application)g(w)o(ants)i(to)g(use) f Fh(AEServer)g Fl(b)n(ut)g(does)g(not)g(pro)o(vide)208 2327 y(its)e(o)n(wn)e(windo)n(ws,)h(etc.)0 2612 y Fb(AESer)s(v)n(er)29 b(Objects)0 2814 y Fc(installaehandler)m Fh(\()p Fi(classe)o(,)20 b(type)o(,)g(callbac)n(k)p Fh(\))208 2914 y Fl(Installs)28 b(an)f(AppleEv)o(ent)e(handler)-5 b(.)46 b Fi(classe)28 b Fl(and)f Fi(type)h Fl(are)f(the)h(four)n(-character)c(OSA)29 b(Class)g(and)e(T)-7 b(ype)27 b(designators,)208 3014 y Fh('****')20 b Fl(wildcards)h(are)g(allo)n(wed.)27 b(When)21 b(a)h(matching)e(AppleEv)o(ent)f(is)j(recei)n(v)o(ed)e(the)h (parameters)f(are)h(decoded)f(and)208 3113 y(your)e(callback)i(is)h(in) m(v)n(ok)o(ed.)0 3260 y Fc(callback)o Fh(\()p 454 3260 V 29 w Fi(object,)f(**kwar)m(gs)n Fh(\))208 3360 y Fl(Y)-9 b(our)21 b(callback)h(is)h(called)f(with)h(the)g(OSA)g(Direct)f(Object) h(as)g(\002rst)g(positional)f(parameter)-5 b(.)30 b(The)22 b(other)g(parameters)f(are)208 3459 y(passed)k(as)i(k)o(e)o(yw)o(ord)d (ar)o(guments,)h(with)h(the)g(4-character)e(designator)g(as)j(name.)41 b(Three)25 b(e)o(xtra)g(k)o(e)o(yw)o(ord)f(parameters)208 3559 y(are)18 b(passed:)p 602 3559 V 54 w Fh(class)g Fl(and)p 1039 3559 V 48 w Fh(type)g Fl(are)h(the)f(Class)i(and)e(T)-7 b(ype)18 b(designators)f(and)p 2585 3559 V 48 w Fh(attributes)g Fl(is)i(a)g(dictionary)e(with)208 3659 y(the)j(AppleEv)o(ent)e(attrib)n (utes.)208 3792 y(The)h(return)g(v)n(alue)h(of)g(your)f(method)g(is)i (pack)o(ed)e(with)h Fh(aetools.packevent\(\))d Fl(and)j(sent)g(as)h (reply)-5 b(.)0 3938 y(Note)29 b(that)f(there)h(are)f(some)h(serious)f (problems)f(with)i(the)g(current)e(design.)50 b(AppleEv)o(ents)27 b(which)h(ha)n(v)o(e)g(non-identi\002er)e(4-)0 4038 y(character)15 b(designators)g(for)h(ar)o(guments)e(are)i(not)g(implementable,)f(and)g (it)i(is)h(not)e(possible)g(to)g(return)f(an)h(error)f(to)i(the)f (originator)-5 b(.)0 4138 y(This)20 b(will)h(be)f(addressed)g(in)g(a)g (future)g(release.)p 0 5965 3761 4 v 0 6065 a Fg(18)2193 b(Chapter)24 b(3.)52 b(Macintosh)23 b(Speci\002c)g(Ser)r(vices)p eop %%Page: 19 25 19 24 bop 2188 567 a Fq(MODULE)57 b(INDEX)0 1318 y Fa(C)0 1441 y Fh(ctb)p Fl(,)20 b(6)0 1624 y Fa(E)0 1747 y Fh(EasyDialogs)p Fl(,)e(14)0 1930 y Fa(F)0 2053 y Fh(findertools)p Fl(,)g(12)0 2153 y Fh(FrameWork)p Fl(,)h(15)0 2335 y Fa(I)0 2459 y Fh(ic)p Fl(,)h(10)0 2641 y Fa(M)0 2765 y Fh(mac)p Fl(,)g(6)0 2864 y Fh(macfs)p Fl(,)g(7)0 2964 y Fh(MacOS)p Fl(,)g(11)0 3063 y Fh(macostools)p Fl(,)f(12)0 3163 y Fh(macpath)p Fl(,)g(6)0 3263 y Fh(macspeech)p Fl(,)g(13)0 3362 y Fh(MiniAEFrame)p Fl(,)f(18)p 0 5965 3761 4 v 3668 6065 a Fg(19)p eop %%Page: 20 26 20 25 bop 0 5965 3761 4 v 0 6065 a Fg(20)p eop %%Page: 21 27 21 26 bop 3129 564 a Fq(INDEX)0 1312 y Fa(Symbols)p 5 1435 25 4 v 30 1435 a Fh(quit\(\))20 b Fl(\(Application)e(method\),)g (16)0 1610 y Fa(A)0 1733 y Fh(Abort\(\))h Fl(\(connection)f(method\),)g (7)0 1832 y Fh(accept\(\))h Fl(\(connection)f(method\),)g(7)0 1932 y Fh(AEServer)h Fl(\(class)i(in)f(MiniAEFrame\),)f(18)0 2032 y(Alias)i(Manager)m(,)d(Macintosh,)h(8)0 2131 y(AppleEv)o(ents,)f (13,)i(18)0 2231 y Fh(Application\(\))e Fl(\(in)i(module)f(FrameW)-7 b(ork\),)19 b(15)0 2331 y Fh(as)p 105 2331 V 30 w(pathname\(\))f Fl(\(FSSpec)j(method\),)d(9)0 2430 y Fh(as)p 105 2430 V 30 w(tuple\(\))h Fl(\(FSSpec)h(method\),)e(9)0 2530 y Fh(AskString\(\))h Fl(\(in)h(module)f(EasyDialogs\),)f(14)0 2629 y Fh(AskYesNoCancel\(\))40 b Fl(\(in)i(module)f(EasyDialogs\),)332 2729 y(14)0 2829 y Fh(asyncevents\(\))18 b Fl(\(Application)h (method\),)f(16)0 2928 y Fh(Available\(\))h Fl(\(in)h(module)f (macspeech\),)f(13)0 3028 y Fh(available\(\))h Fl(\(in)h(module)f (ctb\),)g(6)0 3203 y Fa(B)0 3326 y Fh(Break\(\))g Fl(\(connection)f (method\),)g(7)0 3426 y Fh(BUFSIZ)i Fl(\(in)g(module)e(macostools\),)h (12)0 3525 y Fh(Busy\(\))h Fl(\(in)g(module)e(macspeech\),)h(13)0 3700 y Fa(C)0 3823 y Fh(callback)g Fl(\(connection)f(attrib)n(ute\),)h (6)0 3923 y Fh(callback\(\))g Fl(\(AEServ)o(er)f(method\),)h(18)0 4022 y Fh(Choose\(\))g Fl(\(connection)f(method\),)g(7)0 4122 y Fh(choose*)h Fl(\(in)h(module)f(ctb\),)h(6)0 4222 y Fh(Close\(\))f Fl(\(connection)f(method\),)g(7)0 4321 y Fh(close\(\))h Fl(\(W)m(indo)n(w)g(method\),)g(16)0 4421 y Fh(cmAttn)h Fl(\(in)g(module)e(ctb\),)i(6)0 4521 y Fh(cmCntl)g Fl(\(in)g(module)e(ctb\),)i(6)0 4620 y Fh(cmData)g Fl(\(in)g(module)e(ctb\),)i(6)0 4720 y Fh(cmFlagsEOM)f Fl(\(in)h(module)f(ctb\),)g(6)0 4819 y Fh(CMNew\(\))g Fl(\(in)h(module)f(ctb\),)h(6)0 4919 y Fh(cmStatus*)f Fl(\(in)h(module)f(ctb\),)g(6)0 5019 y(Communications)f(T)-7 b(oolbox,)18 b(Macintosh,)h(6)0 5118 y(Connection)g(Manager)m(,)f(6)0 5218 y Fh(copy\(\))166 5318 y Fl(in)i(module)f(\002ndertools,)g(13)166 5417 y(in)h(module)f(macostools,)g(12)0 5517 y Fh(copytree\(\))g Fl(\(in)h(module)f(macostools\),)f(12)0 5616 y Fh(CountVoices\(\))g Fl(\(in)i(module)f(macspeech\),)g(13)0 5716 y Fh(Creator)g Fl(\(FInfo)g(attrib)n(ute\),)h(9)0 5816 y Fh(ctb)g Fl(\(b)n(uilt-in)f (module\),)g Fj(6)2026 1312 y Fa(D)2026 1435 y Fh(data)2192 1534 y Fl(Alias)i(attrib)n(ute,)e(9)2192 1634 y(FSSpec)h(attrib)n(ute,) g(9)2026 1734 y Fh(DebugStr\(\))e Fl(\(in)i(module)f(MacOS\),)h(12)2026 1833 y Fh(DialogWindow\(\))e Fl(\(in)i(module)f(FrameW)-7 b(ork\),)18 b(15)2026 1933 y Fh(do)p 2131 1933 V 29 w(activate\(\))2192 2033 y Fl(ScrolledW)m(indo)n(w)g(method,)g(17)2192 2132 y(W)m(indo)n(w)h(method,)g(17)2026 2232 y Fh(do)p 2131 2232 V 29 w(char\(\))h Fl(\(Application)e(method\),)g(16)2026 2331 y Fh(do)p 2131 2331 V 29 w(contentclick\(\))g Fl(\(W)m(indo)n(w)h (method\),)f(16)2026 2431 y Fh(do)p 2131 2431 V 29 w(controlhit\(\)) 2192 2531 y Fl(ControlsW)m(indo)n(w)g(method,)h(17)2192 2630 y(ScrolledW)m(indo)n(w)f(method,)g(17)2026 2730 y Fh(do)p 2131 2730 V 29 w(dialogevent\(\))g Fl(\(Application)h (method\),)f(16)2026 2830 y Fh(do)p 2131 2830 V 29 w(itemhit\(\))h Fl(\(DialogW)m(indo)n(w)f(method\),)g(18)2026 2929 y Fh(do)p 2131 2929 V 29 w(postresize\(\))2192 3029 y Fl(ScrolledW)m (indo)n(w)g(method,)g(17)2192 3128 y(W)m(indo)n(w)h(method,)g(16)2026 3228 y Fh(do)p 2131 3228 V 29 w(update\(\))g Fl(\(W)m(indo)n(w)g (method\),)g(17)2026 3403 y Fa(E)2026 3526 y Fh(EasyDialogs)f Fl(\(standard)h(module\),)f Fj(14)2026 3626 y Fh(Error)h Fl(\(in)h(module)f(MacOS\),)h(11)2026 3725 y Fh(error)2192 3825 y Fl(in)g(module)f(ctb,)h(6)2192 3925 y(in)g(module)f(ic,)h(10) 2026 4099 y Fa(F)2026 4223 y Fh(FindApplication\(\))d Fl(\(in)j(module)f(macfs\),)g(8)2026 4322 y Fh(findertools)f Fl(\(standard)h(module\),)f Fj(12)2026 4422 y Fh(FindFolder\(\))g Fl(\(in)i(module)f(macfs\),)g(8)2026 4521 y Fh(FInfo\(\))g Fl(\(in)h(module)f(macfs\),)g(8)2026 4621 y Fh(Flags)g Fl(\(FInfo)g(attrib)n(ute\),)h(10)2026 4721 y Fh(Fldr)g Fl(\(FInfo)e(attrib)n(ute\),)i(10)2026 4820 y Fh(FrameWork)f Fl(\(standard)f(module\),)h Fj(15)p Fl(,)g(18)2026 4920 y Fh(FSSpec\(\))g Fl(\(in)h(module)f(macfs\),)g(8)2026 5095 y Fa(G)2026 5218 y Fh(getabouttext\(\))f Fl(\(Application)g (method\),)g(16)2026 5318 y Fh(GetConfig\(\))g Fl(\(connection)g (method\),)g(7)2026 5417 y Fh(GetCreatorType\(\))f Fl(\(FSSpec)j (method\),)f(9)2026 5517 y Fh(GetDates\(\))f Fl(\(FSSpec)j(method\),)d (9)2026 5616 y Fh(GetDirectory\(\))g Fl(\(in)i(module)f(macfs\),)g(8) 2026 5716 y Fh(GetErrorString\(\))e Fl(\(in)j(module)f(MacOS\),)h(12) 2026 5816 y Fh(GetFInfo\(\))e Fl(\(FSSpec)j(method\),)d(9)p 0 5965 3761 4 v 3668 6065 a Fg(21)p eop %%Page: 22 28 22 27 bop 0 83 a Fh(GetGender\(\))19 b Fl(\(V)-11 b(oice)20 b(method\),)e(13)0 183 y Fh(GetIndVoice\(\))g Fl(\(in)i(module)f (macspeech\),)g(13)0 282 y Fh(GetInfo\(\))g Fl(\(Alias)i(method\),)d(9) 0 382 y Fh(GetPitch\(\))h Fl(\(Speech)g(Channel)h(method\),)e(14)0 482 y Fh(GetRate\(\))h Fl(\(Speech)g(Channel)h(method\),)e(14)0 581 y Fh(getscrollbarvalues\(\))150 b Fl(\(ScrolledW)m(indo)n(w)332 681 y(method\),)18 b(17)0 863 y Fa(H)0 987 y Fh(HandleEvent\(\))g Fl(\(in)i(module)f(MacOS\),)h(12)0 1169 y Fa(I)0 1293 y Fh(IC)g Fl(\(class)h(in)g(ic\),)f(10)0 1392 y Fh(ic)g Fl(\(b)n(uilt-in)g(module\),)e Fj(10)0 1492 y Fh(icglue)i Fl(\(b)n(uilt-in)f(module\),)f(10)0 1591 y Fh(Idle\(\))i Fl(\(connection)d(method\),)i(7)0 1691 y Fh(idle\(\))h Fl(\(Application)e(method\),)g(16)0 1791 y Fh(installaehandler\(\))f Fl(\(AEServ)o(er)i(method\),)f(18)0 1973 y Fa(L)0 2097 y Fh(launch\(\))h Fl(\(in)h(module)f(\002ndertools\),)f(13)0 2196 y Fh(launchurl\(\))166 2296 y Fl(IC)j(method,)d(10)166 2395 y(in)i(module)f(ic,)i(10)0 2495 y Fh(Listen\(\))e Fl(\(connection)f(method\),)g(7)0 2595 y Fh(Location)h Fl(\(FInfo)g(attrib)n(ute\),)g(10)0 2777 y Fa(M)0 2901 y Fh(mac)h Fl(\(b)n(uilt-in)f(module\),)g Fj(6)0 3000 y Fh(macerrors)g Fl(\(standard)g(module\),)f(11)0 3100 y Fh(macfs)i Fl(\(b)n(uilt-in)f(module\),)f Fj(7)0 3200 y Fl(Macintosh)h(Alias)i(Manager)m(,)e(8)0 3299 y(Macintosh)g (Communications)f(T)-7 b(oolbox,)19 b(6)0 3399 y(Macintosh)g(Speech)h (Manager)m(,)e(13)0 3498 y Fh(MacOS)i Fl(\(b)n(uilt-in)f(module\),)f Fj(11)0 3598 y Fh(macostools)h Fl(\(standard)g(module\),)f Fj(12)0 3698 y Fh(macpath)h Fl(\(standard)g(module\),)f Fj(6)0 3797 y Fh(macspeech)h Fl(\(b)n(uilt-in)g(module\),)g Fj(13)0 3897 y Fh(mainloop\(\))g Fl(\(Application)f(method\),)h(16)0 3997 y Fh(makeusermenus\(\))f Fl(\(Application)g(method\),)h(15)0 4096 y Fh(mapfile\(\))166 4196 y Fl(IC)i(method,)d(11)166 4295 y(in)i(module)f(ic,)i(10)0 4395 y Fh(maptypecreator\(\))166 4495 y Fl(IC)g(method,)d(11)166 4594 y(in)i(module)f(ic,)i(10)0 4694 y Fh(Menu\(\))f Fl(\(in)g(module)e(FrameW)-7 b(ork\),)19 b(15)0 4794 y Fh(MenuBar\(\))g Fl(\(in)h(module)f(FrameW)-7 b(ork\),)19 b(15)0 4893 y Fh(MenuItem\(\))g Fl(\(in)h(module)f(FrameW) -7 b(ork\),)18 b(15)0 4993 y Fh(Message\(\))h Fl(\(in)h(module)f (EasyDialogs\),)g(14)0 5092 y Fh(MiniAEFrame)g Fl(\(standard)f (module\),)h Fj(18)0 5192 y Fh(MiniApplication)f Fl(\(class)j(in)f (MiniAEFrame\),)f(18)0 5292 y Fh(mkalias\(\))g Fl(\(in)h(module)f (macostools\),)g(12)0 5391 y Fh(move\(\))h Fl(\(in)g(module)e (\002ndertools\),)h(13)0 5574 y Fa(N)0 5697 y Fh(NewAlias\(\))g Fl(\(FSSpec)h(method\),)e(9)0 5797 y Fh(NewAliasMinimal\(\))g Fl(\(FSSpec)i(method\),)e(9)2026 83 y Fh (NewAliasMinimalFromFullPath\(\))192 b Fl(\(in)2358 183 y(module)19 b(macfs\),)g(8)2026 282 y Fh(NewChannel\(\))f Fl(\(V)-11 b(oice)20 b(method\),)e(14)2026 465 y Fa(O)2026 588 y Fl(Open)h(Scripting)g(Architecture,)g(18)2026 688 y Fh(Open\(\))g Fl(\(connection)f(method\),)g(7)2026 787 y Fh(open\(\))2192 887 y Fl(DialogW)m(indo)n(w)g(method,)g(17)2192 987 y(W)m(indo)n(w)h(method,)g(16)2026 1086 y Fh(openrf\(\))g Fl(\(in)h(module)f(MacOS\),)g(12)2026 1186 y Fh(os)h Fl(\(standard)f(module\),)f(6)2026 1369 y Fa(P)2026 1492 y Fh(parseurl\(\))2192 1591 y Fl(IC)i(method,)f(11)2192 1691 y(in)h(module)f(ic,)h(10)2026 1791 y Fh(posix)f Fl(\(b)n(uilt-in)h(module\),)e(6)2026 1890 y Fh(posixpath)h Fl(\(standard)f(module\),)h(6)2026 1990 y Fh(Print\(\))g Fl(\(in)h(module)f(\002ndertools\),)f(13)2026 2090 y Fh(ProgressBar\(\))g Fl(\(in)i(module)f(EasyDialogs\),)g(14)2026 2189 y Fh(PromptGetFile\(\))f Fl(\(in)i(module)e(macfs\),)i(8)2026 2372 y Fa(R)2026 2495 y Fh(RawAlias\(\))e Fl(\(in)i(module)f(macfs\),)h (8)2026 2595 y Fh(RawFSSpec\(\))e Fl(\(in)i(module)f(macfs\),)h(8)2026 2694 y Fh(Read\(\))f Fl(\(connection)f(method\),)g(7)2026 2794 y Fh(Reset\(\))h Fl(\(connection)f(method\),)g(7)2026 2894 y Fh(Resolve\(\))h Fl(\(Alias)h(method\),)f(9)2026 2993 y Fh(ResolveAliasFile\(\))e Fl(\(in)j(module)f(macfs\),)g(8)2026 3093 y Fh(restart\(\))g Fl(\(in)h(module)e(\002ndertools\),)h(13)2026 3276 y Fa(S)2026 3399 y Fh(scalebarvalues\(\))24 b Fl(\(ScrolledW)m (indo)n(w)h(method\),)2358 3498 y(17)2026 3598 y Fh(SchedParams\(\))18 b Fl(\(in)i(module)f(MacOS\),)h(11)2026 3698 y Fh(scrollbar)p 2481 3698 25 4 v 28 w(callback\(\))172 b Fl(\(ScrolledW)m(indo)n(w)2358 3797 y(method\),)18 b(17)2026 3897 y Fh(scrollbars\(\))g Fl(\(ScrolledW)m(indo)n(w)g(method\),)g(17)2026 3997 y Fh(Separator\(\))g Fl(\(in)i(module)f(FrameW)-7 b(ork\),)19 b(15)2026 4096 y Fh(setarrowcursor\(\))14 b Fl(\(in)j(module)f(FrameW) -7 b(ork\),)16 b(15)2026 4196 y Fh(SetConfig\(\))i Fl(\(connection)g (method\),)g(7)2026 4295 y Fh(SetCreatorType\(\))f Fl(\(FSSpec)j (method\),)f(9)2026 4395 y Fh(SetDates\(\))f Fl(\(FSSpec)j(method\),)d (9)2026 4495 y Fh(SetEventHandler\(\))f Fl(\(in)j(module)f(MacOS\),)h (11)2026 4594 y Fh(SetFInfo\(\))e Fl(\(FSSpec)j(method\),)d(9)2026 4694 y Fh(SetFolder\(\))g Fl(\(in)i(module)f(macfs\),)h(8)2026 4794 y Fh(SetPitch\(\))e Fl(\(Speech)i(Channel)f(method\),)f(14)2026 4893 y Fh(SetRate\(\))h Fl(\(Speech)g(Channel)g(method\),)g(14)2026 4993 y Fh(settypecreator\(\))2192 5092 y Fl(IC)h(method,)f(11)2192 5192 y(in)h(module)f(ic,)h(10)2026 5292 y Fh(setwatchcursor\(\))14 b Fl(\(in)j(module)f(FrameW)-7 b(ork\),)16 b(15)2026 5391 y Fh(shutdown\(\))i Fl(\(in)i(module)f(\002ndertools\),)g(13)2026 5491 y Fh(sleep\(\))g Fl(\(in)h(module)f(\002ndertools\),)f(13)2026 5591 y Fh(SpeakString\(\))g Fl(\(in)i(module)f(macspeech\),)f(13)2026 5690 y Fh(SpeakText\(\))g Fl(\(Speech)h(Channel)h(method\),)e(14)2026 5790 y(Speech)h(Manager)m(,)f(Macintosh,)h(13)p 0 5965 3761 4 v 0 6065 a Fg(22)3468 b(Inde)n(x)p eop %%Page: 23 29 23 28 bop 0 83 a Fh(splash\(\))19 b Fl(\(in)h(module)f(MacOS\),)h(12)0 183 y(Standard)f(File,)i(8)0 282 y Fh(StandardGetFile\(\))d Fl(\(in)i(module)e(macfs\),)i(8)0 382 y Fh(StandardPutFile\(\))e Fl(\(in)i(module)e(macfs\),)i(8)0 482 y Fh(Status\(\))f Fl(\(connection)f(method\),)g(7)0 581 y Fh(Stop\(\))i Fl(\(Speech)f(Channel)g(method\),)f(14)0 681 y Fh(SubMenu\(\))h Fl(\(in)h(module)f(FrameW)-7 b(ork\),)19 b(15)0 863 y Fa(T)0 987 y Fh(touched\(\))g Fl(\(in)h(module)f(macostools\),)g(12)0 1086 y Fh(Type)h Fl(\(FInfo)f(attrib)n(ute\),)g(10)0 1269 y Fa(U)0 1392 y Fh(Update\(\))g Fl(\(Alias)i(method\),)d(9)0 1492 y Fh(updatescrollbars\(\))250 b Fl(\(ScrolledW)m(indo)n(w)332 1591 y(method\),)18 b(17)0 1774 y Fa(V)0 1897 y Fh(Version\(\))h Fl(\(in)h(module)f(macspeech\),)f(13)0 2080 y Fa(W)0 2203 y Fh(Window\(\))h Fl(\(in)h(module)f(FrameW)-7 b(ork\),)19 b(15)0 2303 y Fh(windowbounds\(\))f Fl(\(in)i(module)f(FrameW)-7 b(ork\),)19 b(15)0 2402 y Fh(Write\(\))g Fl(\(connection)f(method\),)g (7)p 0 5965 3761 4 v 0 6065 a Fg(Inde)n(x)3467 b(23)p eop %%Trailer end userdict /end-hook known{end-hook}if %%EOF .