%!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([email protected])-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