home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / mmoshead.zip / mm4emx.doc < prev    next >
Text File  |  1994-02-23  |  6KB  |  195 lines
  1.  --============--
  2.     mm4emx 1.0
  3.  --============--
  4.  
  5.  
  6. Welcome to Multimedia for emx 1.0!
  7. ----------------------------------
  8.  
  9. This package enables you to use the OS/2 Multimedia Presentation Manager/2
  10. (MMPM/2) API from the emx development environment.
  11.  
  12. It provides import libraries and header files to link your emx applications
  13. against the MMPM/2 DLLs.
  14.  
  15. Also some sample programms are provided.
  16.  
  17.  
  18. The mm4emx10.zip archive contains:
  19. ----------------------------------
  20.  
  21.     samples/      samples directory
  22.     makefile      makefile for use with dmake
  23.     os2me.a       multimedia extensions import library (UNIX style)
  24.     mm4emx.doc    the file you're just reading :-)
  25.    *codec.h       multimedia header (coding/decoding)
  26.    *mciapi.h      multimedia header (multimedia control interface)
  27.    *mcios2.h      multimedia header (multimedia control interface)
  28.    *meerror.h     multimedia header (error definitions)
  29.    *mmdrvos2.h    multimedia header (multimedia drivers)
  30.    *mmioos2.h     multimedia header (multimedia I/O)
  31.    *os2me.h       multimedia header (main header)
  32.    *os2medef.h    multimedia header (misc. definitions)
  33.    *ssm.h         multimedia header (synchronization and streaming)
  34.    *sw.h          multimedia header (secondary windows PM extensions)
  35.     mciapi.imp    import list file (mciapi.dll)
  36.     mdm.imp       import list file (mdm.dll)
  37.     mmio.imp      import list file (mmio.imp)
  38.     ssm.imp       import list file (ssm.imp)
  39.     sw.imp        import list file (sw.imp)
  40.    *os2me.lib     multimedia extensions import library (OS/2 OMF style)
  41.     makefile.use  makefile usage info
  42.  
  43. An asterisk (*) indicates a necessary file
  44.  
  45.  
  46. How to install this package:
  47. ----------------------------
  48.  
  49. The easiest way to install it is to use the fine dmake 3.8 make utility
  50. (ported to OS/2 by Kai Uwe Rommel). Type
  51.  
  52.     dmake
  53.  
  54. to get some hints. And type
  55.  
  56.     dmake inst
  57.  
  58. to install the libraries and header files into the emx directory tree.
  59. The makefile allows easy reconfiguration if you want to change the path from
  60. c:\emx to some other location.
  61.  
  62. Please note that nmake won't digest this makefile. (Sorry, folks :-)
  63.  
  64.  
  65. Old vs. new:
  66. ------------
  67.  
  68. I decided to drop the 16-bit ballast, supporting only the 32-bit API,
  69. and to use only the new, OS/2 conforming MMPM/2 naming conventions.
  70.  
  71. So you have to 
  72.  
  73.     #define INCL_OS2MM 
  74.  
  75. before including the os2me.h header file.
  76.  
  77.  
  78. Does it work?
  79. -------------
  80.  
  81. I cannot (and won't) guarantee the functionality of the mm4emx package, but
  82. the parts I've tested so far, seem to work pretty good.
  83.  
  84. If you spot an error please send me e-mail (please nothing bigger than 16kb)!
  85.  
  86. For testing I used commands like these:
  87.  
  88.     set include = c:\emx\include.cpp;c:\emx\include
  89.  
  90.     rc -r terzet.rc
  91.     gcc -o terzet.exe terzet.c terzet.def terzet.res -Zomf -Zsys -los2me -s
  92.  
  93.  
  94. About the Samples:
  95. ------------------
  96.  
  97. 1. mci        This program should help to understand the textual media
  98.               control interface. (mciSendString API)
  99.               You can put MCI string commands into a file and execute these
  100.               MCI scripts through mci.exe.
  101.               Several script samples (*.mci) are provided.
  102.  
  103. 2. cdtoc      This program demonstrates the use of the procedural media
  104.               control interface. (mciSendCommand API)
  105.               It displays the Table of Contents (TOC) of an audio CD.
  106.  
  107. 3. mmpmvals   The MMPM/2 system values are queried by this programm.
  108.               (mciQuerySysValue API)
  109.  
  110. 4. mmiofmts   Demonstration of the multimedia I/O (MMIO) API.
  111.               This utility displays all currently registered MMIO procedures.
  112.  
  113. 5. rhythm     A great rhythm implemented with playlists.
  114.               (Don't overlook test.mci - for a comparision! :-)
  115.  
  116.  
  117. Note: I intend to describe these examples in detail in one of the upcoming
  118.       EDM/2 issues (about March/April '94).
  119.  
  120.  
  121. Things left to do:
  122. ------------------
  123.  
  124.   o Counting arguments :-)
  125.  
  126.     The import list files (*.imp) lack argument counts.
  127.     However, this seems to matter only if you want to use method (I1).
  128.     Please confer the emx documentation (e.g. emxdev.inf) for more details.
  129.  
  130.   o More examples and testing (e.g. the PM extensions deserve some examples)
  131.  
  132.  
  133. On MMPM/2 programming:
  134. ----------------------
  135.  
  136. Perhaps you noticed already that there is no MMPM/2 programming introduction
  137. in this package, nor a API description useful enough for serious programming.
  138.  
  139. This is intended! :-)
  140.  
  141. IBM does a very good information politics concerning OS/2 2.x programming.
  142. They provide the technical manuals on paper or in electronic form for low
  143. charges. (You don't even get the manuals xeroxed for the same price :-)
  144. So please use this offer.
  145.  
  146. Look for these manuals:
  147.  
  148.     MMPM/2 Programming Guide, IBM Doc. S41G-2919
  149.     MMPM/2 Programming Reference, IBM Doc. S41G-2920
  150.  
  151. The MMPM/2 reference is contained in .inf format in the MMPM/2 Toolkit, which
  152. itself is now part of version 2.1 of the Developer's Toolkit.
  153. The package also contains important tools like the IPF and SOM compilers,
  154. dialog and font editors and is rich of programming examples.
  155.  
  156. Another source of the MMPM/2 manuals is the
  157.  
  158.     IBM OS/2 Online Book Collection CD-ROM, IBM Doc. S53G-2166
  159.  
  160.  
  161. Last not least, I recommend the EDM/2 to you, i.e. the Electronic OS/2
  162. Developers Magazine.
  163.  
  164. This monthly periodical on OS/2 programming is published in .inf format and
  165. can be obtained from
  166.  
  167.     ftp.cdrom.com  (in /pub/os2/2_x/program/newsltr)
  168.  
  169. or from better sorted BBS's.
  170.  
  171. If you have an article or questions about EDM/2, please contact the editor:
  172.  
  173.     Larry Salomon, Jr. (os2man@panix.com)
  174.  
  175. You'll find introductions on MMPM/2 programming e.g. in the January '94 issue
  176. of the EDM/2 (edmi2-1a.zip).
  177.  
  178.  
  179. Special thanks to:
  180. ------------------
  181.  
  182. John J. McDonough (YCWP92A@prodigy.com) for pointing out to me the way how
  183. to attack mdm.dll and providing examples, inspiring me to do this package.
  184.  
  185.  
  186. Enjoy!
  187.  
  188.  
  189.     Marc E.E. van Woerkom    (Usenet: marc_van-woerkom@ac3.maus.de)
  190.  
  191.  
  192. ----------------------------------------------------------------------------
  193. Copyright note: This package is free but copyrighted. (Like the GNU stuff)
  194.  
  195.