home *** CD-ROM | disk | FTP | other *** search
/ The Net: Ultimate Internet Guide / WWLCD1.ISO / pc / amovie / readme.txt < prev   
Encoding:
Text File  |  1996-06-28  |  12.7 KB  |  328 lines
  1.  ******************************************************************************
  2.  *                                                                            *
  3.  *   THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY    *
  4.  *   KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE      *
  5.  *   IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR    *
  6.  *   PURPOSE. IT IS CONFIDENTIAL MATERIAL AND IS NOT TO BE REDISTRIBUTED.     *
  7.  *                                                                            *
  8.  *   Copyright (c) 1992 - 1996 Microsoft Corporation. All Rights Reserved.    *
  9.  *                                                                            *
  10.  ******************************************************************************
  11.  
  12.  
  13.                      ActiveMovie 1 (Build 1.0.96.0626)
  14.                     ===================================
  15.  
  16. Introduction
  17.  
  18. This software and information is considered pre-release (beta) software and is 
  19. unsupported by Microsoft Product Support.
  20.  
  21. Please read the LICENSE.DOC in the root of the CD, and EULA.DOC in the Runtime
  22. or SDK\Redist directories.
  23.  
  24. This Beta of ActiveMovie is the latest update of the product previously
  25. code named Quartz.
  26.  
  27. Please read the Feature Set section of this ReadMe for an outline of what is
  28. included, and the Known Problems section for any last minute issues and bugs.
  29.  
  30.  
  31. --------------------------------------------------------------------------------
  32.  
  33. CD Layout
  34.  
  35. +---Docs              Documents and articles in printable form
  36. +---Movies            MPEG sample
  37. +---runtime           Runtime setup for Windows NT and Windows 95
  38. +---sdk               Software Developers Kit
  39. |   +---help          Help files (for the SDK)
  40. |   +---Redist        Redistributable runtime ("silent" setup)
  41. |   +---_alpha
  42. |   +---_directx
  43. |   +---_mips
  44. |   +---_ppc
  45. |   +---_setup       SDK setup, using the various _directories
  46. |   \---_x86
  47. |   +---vbfix        Updated sample code for samples\vb\docs\ocx 
  48.  
  49.  
  50. ------------------------------------------------------------------------------
  51.  
  52. Feature Set
  53.  
  54. - .AVI, .MOV and MPEG playback support
  55.  
  56. - Indeo4-compressed AVI playback support
  57.  
  58. - Callable from Visual Basic, including the ability to embed the ActiveMovie
  59.   Control in a Visual Basic form
  60.  
  61. - The GraphEdt visual graph builder tool is included with the SDK tools. It
  62.   allows one to build, test and save filter graphs for subsequent reuse
  63.  
  64. - DirectX 2 for Windows 95, providing DirectDraw support
  65.  
  66. - MCI support for both 16 and 32-bit applications
  67.  
  68. - Multiple setups:
  69.  
  70. -- Full SDK with (user selectable) DirectX, samples, Help et cetera
  71. -- SDK setup of just the runtime and DirectX support
  72. -- Runtime only setup without DirectX
  73. -- Redistributable runtime without DirectX or any user informational pop-ups
  74.  
  75. - Samples, headers and libraries for developers to use and modify
  76.  
  77. - Additional developer tools
  78.  
  79.  
  80. --------------------------------------------------------------------------------
  81.  
  82. Installing ActiveMovie
  83.  
  84. ActiveMovie requires Windows NT 3.51 or Windows 95 or higher.
  85.  
  86. This beta should NOT be installed OVER previous Quartz/ActiveMovie betas.
  87. Please uninstall any previously installed Quartz or ActiveMovie betas by either
  88. double clicking on the Uninstall icon or using the Control Panel Add/Remove
  89. Programs selection on Windows 95 and Windows NT SUR Beta 1 or 2.
  90.  
  91. Note that the Tee filter may show up in GraphEdt, but has been replaced
  92. by the InfTee filter.  If you run the Quartz Beta 1 Refresh uninstall utility
  93. it will delete some of your MSVC files such as MFC30.DLL and MSVCRT20.DLL
  94. (which you may wish to reinstall).
  95.  
  96. You may install this Beta in one of three ways:
  97.  
  98. -- Via the SDK Setup, selecting Runtime and SDK
  99.  
  100. In the \SDK directory type SETUP, and select the "Runtime and SDK (Custom)"
  101. option. You may then choose which components to install from the next screen
  102. and in which directory to install the samples if you wish to install them.
  103.  
  104. -- Via the SDK Setup selecting Runtime only
  105.  
  106. As above, selecting "Runtime only". This will provide the runtime without
  107. developer tools and samples and with DirectX installed automatically on Windows 95.
  108.  
  109. -- Via the Runtime directory
  110.  
  111. Select the \Runtime\AMovie<type>.exe for your platform type. AMovie.exe
  112. installs the x86 runtimes on either Windows NT or Windows 95, while AMovieA,
  113. AMovieM and AMovieP install on Windows NT Alpha, MIPS and PowerPC respectively.
  114.  
  115. PLEASE NOTE:
  116.  
  117. When installing via the SDK Setup if you choose "Runtime only" or "Runtime and
  118. SDK (Custom)" with the "DirectX 2 components" option you MUST reboot
  119. your system before using ActiveMovie.
  120.  
  121.  
  122. --------------------------------------------------------------------------------
  123.  
  124. Using ActiveMovie
  125.  
  126. To play an .AVI, .MOV or MPEG movie via ActiveMovie as an end-user you can do
  127. one of two things:
  128.  
  129. 1. Double click on a movie (in File Manager on Windows NT or the Explorer on
  130.    Windows 95) to play it via the ActiveMovie Control
  131.  
  132. 2. Start MediaPlayer and select ActiveMovie from the Devices menu
  133.  
  134.                                       -==-
  135.  
  136.  
  137. If you install the SDK tools you also have the choice to use the ActiveMovie 
  138. Graph Editor (GraphEdt) tool
  139.  
  140. -- Start GraphEdt, and use File.Open to open media files such as .MPG and 
  141.    build your first filter graph automatically, or drag and drop files 
  142.    from File Manager or the Explorer onto the GraphEdt workspace.
  143.  
  144. -- Press the Play, Pause, or Stop buttons to control the filter graph.
  145.  
  146. -- Now right-click on the filters and the links between them to view each 
  147.    object's properties. (The properties dialogs are modeless.)
  148.  
  149. -- Now insert more filters via Graph.Insert Filters, break some links using the 
  150.    Delete key, and create new links by dragging to connect in the new filters. 
  151.    Note: filters must agree to connect before the connection can occur. For 
  152.    example an audio filter will not connect to a video filter. GraphEdt displays 
  153.    an error if filters cannot connect.
  154.  
  155. -- Use the "Infinite Pin Tee (InfTee)" filter on video. Insert the "Video 
  156.    Contrast (Contrast)" filter and suitable renderers. Use the "Contrast"
  157.    property page while the movie is running.
  158.  
  159. -- If you've still got CPU cycles left, insert two movie files and play them
  160.    both sync'ed to the same clock.
  161.  
  162. -- Choose File.New. Insert the "Bouncing Ball (Ball)" filter and the "Video 
  163.    Renderer" filter.
  164.  
  165. -- You can right-click on un-linked output pins, and choose "Render" to
  166.    attempt to auto-render, letting the mapper add and connect filters for you.
  167.  
  168. PLEASE NOTE:
  169.  
  170. MSVCRT40.DLL and MFC40.DLL have been provided and will be installed (if not
  171. already present) so that GraphEdt can be run without first having to install
  172. Microsoft Visual C++.
  173.  
  174. Please note that the REG files that come with each sample filter are for your
  175. information, and should NOT be used with an installed system. Therefore please
  176. do NOT double click on a .REG file in any of the sample directories, as it may
  177. cause the related filter to work incorrectly.
  178.  
  179.  
  180. --------------------------------------------------------------------------------
  181.  
  182. Building the ActiveMovie Samples
  183.  
  184. To build the samples, you will need to install Microsoft Visual C++ version 4.0
  185. or greater (for Windows 95 and for x86 and RISC Windows NT). Combined with the
  186. header files and libraries from this SDK this is sufficient to build all the
  187. samples.
  188.  
  189. Versions of Visual C++ earlier than 4.0 are no longer sufficient to build the
  190. ActiveMovie samples.
  191.  
  192. To build all the samples run NMAKE in the \SAMPLES directory. Debug versions
  193. will be built by default. To produce non-debug versions set the 'nodebug'
  194. environment variable (i.e. set nodebug=1), or type NMAKE NODEBUG=1.
  195.  
  196. PLEASE NOTE:
  197.  
  198. The samples shipped with previous releases of the Quartz SDK will NOT build
  199. with this release. Updated versions of all the samples ship with this SDK, so
  200. please delete any previous SDK samples, headers and libraries you may have on
  201. your computer.
  202.  
  203.  
  204. ------------------------------------------------------------------------------
  205.  
  206. Known issues with this Beta release
  207.  
  208. -- The Quartz Beta 1 uninstall utility will delete some of your MSVC files
  209.    such as MFC30.DLL and MSVCRT20.DLL.  These files will need to be replaced if
  210.    you are using a version of Visual C++ earlier than 4.0.
  211.  
  212. -- The "Runtime and SDK (Custom)" setup may fail on RISC machines running
  213.    Windows NT SUR Beta (build 1234) or Beta 2 (build 1314). The "Runtime only"
  214.    setup will work fine, but you will no be able to install the SDK on RISC
  215.    systems for this release.
  216.  
  217. -- Some of the properties exposed by the ActiveMovie Control for use by VB
  218.    programmers are not fully functional.
  219.  
  220. -- MOV files containing edit lists are not currently supported.
  221.  
  222. -- MOV files containing two or more video streams will play each stream in a
  223.    separate window.
  224.  
  225. -- MOV files compressed in the RPZA format are not supported.
  226.  
  227. -- MOV files do not play on NT PowerPC systems with this release.
  228.  
  229. -- The VB sample installed in the <msamovdk>\samples\vb\docs\ocx directory on
  230.    your hard drive is out of date for this release.  An updated version can be 
  231.    found on the CD in the \sdk\vbfix directory.  Just copy these updated files
  232.    over the files installed by setup.
  233.  
  234. -- The ActiveMovie SDK installation program does not currently correctly check
  235.    for necessary disk space before installing.  If you run low on disk space 
  236.    during the install, the setup program will abort.  The full install requires
  237.    around 35 MB.
  238.  
  239. -- The EZRGB24 sample filter can cause hang in GraphEdt on NT 3.51 in some cases.
  240.  
  241. -- The Dump sample filter doesnÆt dump the collected data until you close the running
  242.    graph on Windows 95.
  243.  
  244. -- The Effect sample filter is known to fault under certain graph configurations, 
  245.    especially in conjunction with the ball sample.
  246.  
  247. --------------------------------------------------------------------------------
  248.  
  249. Changes from previous ActiveMovie Betas.
  250.  
  251. -- ActiveMovie does not support DirectSound or MIDI in this release.
  252.  
  253. -- ActiveMovie Streaming will be shipped separately.
  254.  
  255. -- ActiveMovie is not currently the default player for .WAV files.
  256.  
  257. -- The VideoMix sample has been withdrawn.
  258.  
  259.  
  260. Developer Issues:
  261.  
  262. IMediaEvent has a new method, FreeEventParams. Be sure to call this after
  263. every event you receive or your app will leak memory.
  264.  
  265. IMediaPosition has two new methods, CanSeekForwards and CanSeekBackwards.
  266.  
  267. IVideoWindow has two new methods, HideCursor and IsCursorHidden.
  268.  
  269. IReferenceClock::ConvertRealTime has been removed because of concerns that
  270. it was not possible to implement it accurately. In previous betas, all
  271. IReferenceClock implementations of this method returned E_NOTIMPL.
  272.  
  273. IMemAllocator::GetBuffer now has a DWORD dwFlags parameter instead of the
  274. BOOL.
  275.  
  276. IGraphBuilder has two new methods to allow cancellation of lengthy
  277. graph building operations. These are used when building a graph involves reading
  278. a file over a slow network link. IGraphBuilder::Abort can be called by an
  279. application to request an abort. IGraphBuilder::ShouldOperationContinue
  280. should be checked from time to time by a filter that is performing a lengthy
  281. operation as part of a Connect request.
  282.  
  283. A new interface IStreamBuilder has been defined to allow custom stream
  284. building. Pins that expose IStreamBuilder will be asked to complete the Render
  285. or RenderFile operation themselves. See the SDK documentation for more detail.
  286.  
  287. There is a new interface, IMediaSeeking, that although not fully implemented
  288. in this release, will replace IMediaSelection in the next release.
  289. IMediaSelection will continue to be exposed to applications for backwards
  290. compatibility. 
  291.  
  292.  
  293. --------------------------------------------------------------------------------
  294.  
  295. How to invoke ActiveMovie setup from your application
  296.  
  297. -==-
  298.  
  299. Performing an ActiveMovie setup from within your product
  300.  
  301. For x86 Windows NT and Windows 95 use the following command line:
  302.  
  303. AMovie.exe /Q:1 /R:N /C:"amremove /setup_q"
  304.  
  305. For Alpha, MIPS and PowerPC Windows NT use the following command line:
  306.  
  307. AMovieA.exe /Q:1 /R:N /C"rundll32 amsetup.dll,Install QUIET"
  308. AMovieM.exe /Q:1 /R:N /C"rundll32 amsetup.dll,Install QUIET"
  309. AMovieP.exe /Q:1 /R:N /C"rundll32 amsetup.dll,Install QUIET"
  310.  
  311. Please note that the parameters ARE case sensitive.
  312.  
  313. /Q:1 disables the startup message
  314. /R:N disables automatic rebooting
  315. /C:  passes the quoted command to the embedded setup to disable its interactive
  316.      dialogs
  317.  
  318. The self-installing cabinets are still under development, and these parameters
  319. may change for the final product.
  320.  
  321. -==-
  322.  
  323. --------------------------------------------------------------------------------
  324.  
  325. Thank you.
  326.  
  327. "The ActiveMovie Team"
  328.