home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: 10 Tools / 10-Tools.zip / amiiprog.zip / README.TXT < prev   
Text File  |  1992-12-23  |  7KB  |  153 lines
  1.  
  2.                   *************************************
  3.                   *                                   *
  4.                   *         ActionMedia (tm) II       *
  5.                   *  Media Control Driver for MMPM/2  *
  6.                   *                                   *
  7.                   *              Read Me              *
  8.                   *                                   *
  9.                   *************************************
  10.  
  11.  
  12.  
  13.      Welcome to ActionMedia II.  This is the second release of the
  14.      ActionMedia II Media Control Driver for MMPM/2 Version 1.0. and
  15.      MMPM/2 Version 1.1.
  16.  
  17.      ------------------------------------------------------------------------
  18.      MMPM/2 Updates
  19.  
  20.      If you have MMPM/2 Version 1.0 on your system the installation of 
  21.      the ActionMedia II Media Control Driver will update MDM.DLL in the
  22.      \MMOS2\DLL subdirectory. If you have a later version of MMPM/2 then
  23.      MDM.DLL will not be updated.
  24.  
  25.      If you have the MMPM/2 Toolkit Version 1.0 installed, the following
  26.      files will also be updated:
  27.  
  28.                      MCISTRNG.C
  29.                      MCISTRNG.RC
  30.                      MCISTRNG.EXE
  31.                      MCISTRNG.H
  32.                      MCIDRV.H
  33.                      MEERROR.H
  34.                      MMSYSTEM.H
  35.  
  36.      If you have a later version of the MMPM/2 Toolkit then these files 
  37.      will not be updated.
  38.  
  39.      ------------------------------------------------------------------------
  40.      Release Notes
  41.  
  42.  
  43.      1.  When maximizing the ActionMedia II MCI default window while
  44.          recording, cued for output, or displaying a small still image
  45.          (less than full screen default size), the maximize icon
  46.          becomes corrupted. Functionality is not restricted in any
  47.          way.
  48.  
  49.  
  50.      2.  Issuing the MCI_RECORD command causes any loaded video and
  51.          still image elements in the same instance to be unloaded.
  52.          If the record fails during processing of the message (e.g.
  53.          there are not enough driver resources available due to other
  54.          still image instances), the video element will be reloaded,
  55.          but the still image element will not be reloaded. An image
  56.          captured prior to the record, but not saved, will be lost.
  57.  
  58.  
  59.      3.  When an AVSS file is saved by the  MCI device driver, no
  60.          Extended Attributes are created with the file.  If you use
  61.          the ActionMedia II Player/Recorder from the WorkPlace Shell
  62.          Desktop, AVSS files created by the ActionMedia II Player/Recorder
  63.          will not automatically have WorkPlace Shell icons associated with
  64.          them.
  65.  
  66.          A standard icon for AVSS data files will be available for the
  67.          user to use after the ActionMedia II Player/Recorder has created
  68.          the AVSS file. Users can manually add icons to their AVSS files
  69.          using the OS/2 icon editor.  The user can 'Open' the 'Settings'
  70.          for the AVSS file, and click on the 'General' setting, in order
  71.          to give their AVSS files a WorkPlace Shell icon.  A standard AVSS
  72.          data file icon can be found in the \MMOS2\INSTALL subdirectory.
  73.          You can 'Find' this icon under the Icon Editor in order to add
  74.          this icon to your AVSS data files.
  75.  
  76.          The exact process is as follows:  Create your AVSS data file, and
  77.          view it in the WorkPlace Shell.  Click on it using the right
  78.          mouse button, then click on the arrow next to 'Open', then on the
  79.          word 'Settings'.  Now, click on the word 'General' and 'Find',
  80.          then 'Locate'.  You can then use either 'Path' to type in the path
  81.          "C:\MMOS2\INSTALL" (assuming you installed your MMOS2 system on
  82.          your C: drive) or use 'Drives' to find that path using the
  83.          icons presented.  Then click on 'Find', and you will be presented
  84.          with a list of MultiMedia Icons to choose from.  Select the AM2FILE
  85.          icon, and it should now be associated with your data file.  You can
  86.          now close the settings, and see the new icon on your data file.
  87.  
  88.  
  89.      4.  The following sequence of MCI commands could cause an error
  90.          when closing the device.
  91.  
  92.                  MCI_OPEN
  93.                  MCI_LOAD  <video file>
  94.                  MCI_PLAY  <with notify>
  95.                  MCI_CUE   <for output, with notify>
  96.                  MCI_CLOSE
  97.  
  98.          The MCI_CLOSE command takes several seconds to complete and
  99.          returns the error code MCIERR_INVALID_MODE. This can be
  100.          avoided by issuing an MCI_STOP command before the MCI_CLOSE.
  101.          This problem is also evident when using the string interface.
  102.  
  103.  
  104.      5.  The following sequence of MCI commands do not execute
  105.          correctly.
  106.  
  107.                  MCI_OPEN
  108.                  MCI_LOAD <video file>
  109.                  MCI_PLAY <to target frame, with notify>
  110.                  MCI_PLAY <to target frame, with wait>
  111.  
  112.          The second play supersedes the first, but does not wait.
  113.  
  114.  
  115.      6.  The following command does not execute correctly
  116.  
  117.                  MCI_PLAY <to target frame 0>
  118.  
  119.          This should return the error code MCIERR_OUTOFRANGE, but
  120.          actually cues the playback for output. Developers should
  121.          not rely on this action occurring in future releases.
  122.  
  123.      7.  The problems with user-defined windows in the first realese
  124.          have now been rectified. For user-defined windows that are
  125.          NOT children of the PM desktop there is no longer any require-
  126.          ment that a parent handle is specified at MCI_OPEN time. The
  127.          parent handle at MCI_OPEN time should ONLY be used when 
  128.          specifying the parent of the default video window.
  129.  
  130.      8.  The following sequence of MCI commands could cause an error
  131.          when closing the device.
  132.  
  133.                  MCI_OPEN
  134.                  MCI_LOAD  <video file>
  135.                  MCI_PLAY  <with notify>
  136.                  MCI_CLOSE <issued before the play finishes>
  137.  
  138.          Under conditions of heavy system load (e.g. several other
  139.          applications accessing the disk during the MCI_PLAY command)
  140.          the notify from the MCI_PLAY command will be lost. The 
  141.          MCI_CLOSE command will also take up to 30 seconds to execute 
  142.          as it times-out waiting for the lost notification.
  143.  
  144.      9.  PLV AVSS files created with stereo audio are now correctly
  145.          supported by the driver. However, RTV stereo files created
  146.          by the ActionMedia II Toolkit Version 1.1 Capture Sample
  147.          Program (or by software utilizing source code from that prog-
  148.          ram) will not play back correctly. This is due to a problem 
  149.          with the ActionMedia II Toolkit Version 1.1 Capture Sample 
  150.          Program.
  151.  
  152.      ------------------------------------------------------------------------
  153.