home *** CD-ROM | disk | FTP | other *** search
/ CLIX - Fazer Clix Custa Nix / CLIX-CD.cdr / mac / lib / Mac / Toolbox.pod < prev    next >
Text File  |  1997-10-05  |  2KB  |  155 lines
  1. =head1 NAME
  2.  
  3. Mac::Toolbox - Introduction to the Macintosh Toolbox Modules
  4.  
  5. =head1 SYNOPSIS
  6.  
  7. =over 4
  8.  
  9. =item Mac::AppleEvents
  10.  
  11. Apple Event Manager.
  12.  
  13. =item Mac::Components
  14.  
  15. Component Manager.
  16.  
  17. =item Mac::Controls
  18.  
  19. Control Manager.
  20.  
  21. =item Mac::Dialogs
  22.  
  23. Dialog Manager.
  24.  
  25. =item Mac::Events
  26.  
  27. Event Manager.
  28.  
  29. =item Mac::Files
  30.  
  31. File Manager.
  32.  
  33. =item Mac::Fonts
  34.  
  35. Font Manager.
  36.  
  37. =item Mac::Gestalt
  38.  
  39. Gestalt Manager.
  40.  
  41. =item Mac::InternetConfig
  42.  
  43. InternetConfig System.
  44.  
  45. =item Mac::Lists
  46.  
  47. List Manager.
  48.  
  49. =item Mac::Memory
  50.  
  51. Memory Manager.
  52.  
  53. =item Mac::Menus
  54.  
  55. Menu Manager.
  56.  
  57. =item Mac::MoreFiles
  58.  
  59. More File Manager related routines.
  60.  
  61. =item Mac::Movies
  62.  
  63. Movie Manager.
  64.  
  65. =item Mac::OSA
  66.  
  67. Open Scripting Architecture.
  68.  
  69. =item Mac::Processes
  70.  
  71. Processe Manager.
  72.  
  73. =item Mac::QDOffscreen
  74.  
  75. Offscreen QuickDraw.
  76.  
  77. =item Mac::QuickDraw
  78.  
  79. QuickDraw.
  80.  
  81. =item Mac::Resources
  82.  
  83. Resource Manager.
  84.  
  85. =item Mac::Speech
  86.  
  87. Speech Manager.
  88.  
  89. =item Mac::SpeechRecognition
  90.  
  91. Speech Recognition Manager.
  92.  
  93. =item Mac::StandardFile
  94.  
  95. Standard File Dialogs.
  96.  
  97. =item Mac::Types
  98.  
  99. Toolbox Types.
  100.  
  101. =item Mac::Windows
  102.  
  103. Window Manager.
  104.  
  105. =back
  106.  
  107. =head1 DESCRIPTION
  108.  
  109. The Macintosh Operating System provides a rich API with thousands of I<toolbox>
  110. calls. The MacPerl toolbox modules aim to make as much as possible of this
  111. functionality available to MacPerl programmers. The mapping of the toolbox 
  112. interfaces into MacPerl is intended to be
  113.  
  114. =over 4
  115.  
  116. =item 1.
  117.  
  118. Convenient to use for Perl programmers.
  119.  
  120. =item 2.
  121.  
  122. As close as possible to the C interfaces.
  123.  
  124. =back
  125.  
  126. This translates into a mapping strategy which is discussed in the following 
  127. sections.
  128.  
  129. =head2 Function mappings
  130.  
  131. MacPerl toolbox calls take their input arguments in the same order as the 
  132. corresponding toolbox functions. Output arguments are never passed by reference, 
  133. but returned from the calls. If there are several output arguments, a list is
  134. returned. If an error occurs, the function returns C<undef> or C<()> and the 
  135. error code is available in the C<$^E> variable.
  136.  
  137.     $port = GetPort;
  138.     SetPort $port;
  139.     $desc = AECreateDesc("TEXT", "Hello, World") or die $^E;
  140.  
  141. =head2 Data structure mappings
  142.  
  143. Complex data structures are mapped into blessed references. Data fields are 
  144. available through member functions which return the value of a field if called
  145. without an argument and change the value if called with an argument.
  146.  
  147.     $rect = new Rect(10, 20, 110, 220);
  148.     $rect->top;
  149.     $rect->right(250);
  150.  
  151. =head1 AUTHOR(S)
  152.  
  153. Matthias Ulrich Neeracher <neeri@iis.ee.ethz.ch> 
  154.  
  155.