
                     MediaWare Solutions
                     MPEG SDK Software Development Kit for Visual C++ (v6)
                     95/98/ME/NT4/2000

***************************************************************************
This SDK may only be used by users holding a current valid MPEG SDK license
agreement for this SDK. Use of this SDK must comply with the terms and 
conditions of that license agreement.

Third party libraries (Tiff, Jpeg) are provided with this SDK under the 
terms and conditions of the licenses provided with those libraries. 
These licenses may be found in the .\doc folder following installation.
***************************************************************************

Installation
============
MediaWare Solutions MPEG SDKs are distributed in self-extracting archive format.
Executing the distribution file will take you through the InstallShield
installation process.

After installation you will have the following sub-tree on your hard-disk under 
the installation folder (default is c:\Program Files\MediaWare Solutions\MPEG SDK):

.\doc               (licences, readme files, release notes)
.\doc\help          (manual pages describing the API)
.\examples          (some sample console programs and DSP project files you can build)
.\include           (MPEG SDK header files)          
.\ippistub\lib      (third party libs required for all SDK apps)
.\jpeg              (third party JPEG header files required for all SDK apps)
.\jpeg\mt           (third party JPEG libs compiled for all Multi-threaded SDK apps)
.\jpeg\mtdll        (third party JPEG libs compiled for all Multi-threaded DLL SDK apps)
.\jpeg\st           (third party JPEG libs compiled for all Single-threaded SDK apps)
.\m1sdk\mt          (MPEG SDK libraries compiled for MPEG-1 Multi-threaded apps)          
.\m1sdk\mtdll       (MPEG SDK libraries compiled for MPEG-1 Multi-threaded DLL apps)          
.\m1sdk\st          (MPEG SDK libraries compiled for MPEG-1 Single-threaded apps)
.\m2sdk\mt          (MPEG SDK libraries compiled for MPEG-1/2 Multi-threaded apps)          
.\m2sdk\mtdll       (MPEG SDK libraries compiled for MPEG-1/2 Multi-threaded DLL apps)          
.\m2sdk\st          (MPEG SDK libraries compiled for MPEG-1/2 Single-threaded apps)
.\tiff              (third party TIFF header files required for all SDK apps)
.\tiff\mt           (third party TIFF libs compiled for all Multi-threaded SDK apps)
.\tiff\mtdll        (third party TIFF libs compiled for all Multi-threaded DLL SDK apps)
.\tiff\st           (third party TIFF libs compiled for all Single-threaded SDK apps)

Differences between versions of the MPEG SDK
============================================
The MPEG SDK is licensed in various configurations:
* Decoder
* Editor             (includes Decoder)
* Analyzer           (includes Decoder)
* Analyzer + Editor  (includes Decoder)

Depending on the SDK options licensed from MediaWare Solutions you may not 
have all the SDK includes and libraries listed above. However the full
documentation set and sample applications are included in all configurations.

Under the Windows taskbar at Start|Program Files|MediaWare Solutions|MPEG SDK 
you will have access to:

     On-line Help Manual  (API manual pages you can read with your web browser)
     Read Me First        (this file)
     Release Notes        (information on the latest enhancements and bug fixes)

The SDK libraries are provided in three static library versions to suit 
your runtime environment:

     (ST)    - Single-threaded 
     (MT)    - Multi-threaded 
     (MTDLL) - Multi-threaded DLL

Link with the m1sdk libraries to build MPEG-1-only applications.

Link with the m2sdk libraries to build applications requiring support for
both MPEG-2 and MPEG-1.
 
Example Applications
====================
The following sample console applications are provided:
   Decoder:
     - test_info
     - test_thumb
     - test_decode
   Editor:
     - test_fx
     - test_edit
   Analyzer;
     - test_analyze

Getting Started
===============
1. Read this file carefully.

2. Read the Release Notes by selecting "Release Notes" from the Windows
   taskbar under Start|Program Files|MediaWare Solutions|MPEG SDK

3. Go to the top level API of the manual by selecting "On-line Help Manual". 
   This should start your web browser. Bookmark this page for future reference.

4. Try out the sample programs. Use the build instructions in 4A or 4B below
   and then run the program(s) from a command prompt window.

   A. Double click on the VC++ project files for one of the example 
      applications e.g. "test_info.dsp". This should bring up VC++ with 
      the test_info project already loaded. Simply build the application
      as normal.

   B. Start the Visual Studio/VC++ IDE as normal.
     - create a new workspace e.g. "MPEG_SDK".
     - create a new project "test_info" (Win32 console application, 
         add to current workspace).
     - under "Add File to Project", add "test_info.cpp", "Getopt.cpp" and the
         four lib files in ippistub/lib: "ippcvmerged.lib", "ippimerged.lib",
         "ippsmerged.lib" and "ippsrmerged.lib". 
     - under Project Settings | C/C++ | Preprocessor, add the required path, e.g.
         "c:\program files\Mediaware Solutions\MPEG sdk\include" 
         to include the MPEG SDK headers.
     - under Project Settings | C/C++ | Preprocessor, add the
         Preprocessor definitions NO_THREADS for st.
     - under Project Settings | Link | Additional Library Path append 
         "m1sdk_decoder.lib", "jpeg.lib" and "tiff.lib"
         to the Object/Library modules. Add the appropriate library paths,
         for example
         c:\program files\Mediaware Solutions\MPEG sdk\jpeg\mt
         c:\program files\Mediaware Solutions\MPEG sdk\tiff\mt
         c:\program files\Mediaware Solutions\MPEG sdk\m1sdk\mt 
         to link with the multi threaded libraries. This must match your
         selection under the "Use run-time library" selected under 
         Project Settings | C/C++ | Code Generation.
     - make (compile and link) the test_info executable.

5. To build the other sample applications, create new projects for each 
   application following the same steps as outlined above. Remember to add 
   the extra lib files as appropriate.

6. Note that the supplied Visual C++ projects by default link with the 
   MPEG-1 SDK libraries. If you have licensed the MPEG-2 SDK and want to 
   use these projects with MPEG-2 videos, you must change each project's 
   link options to link instead with the MPEG-2 SDK libraries.

Notes: - building your own applications using the MPEG SDK
========================================================
1. Include the following code at in all applications:
   e.g. #include <iostream>
        using namespace std;
        ......

2. When building Win32 and/or MFC applications, make sure to link with the 
   appropriate MPEG SDK run-time libraries 
   * MT, MTDLL, or ST
   * MPEG-1 or MPEG-2

Build Environment
=================
Microsoft VC++ ver 6.0
NT4/2000 and Windows 95/98/ME

Support
=======
For installation problems please email support@MediawareSolutions.com

If you have a maintenance agreement with MediaWare Solutions you
may contact Priority Support for post installation support. Please
refer to your Priority Support documentation for details.

Copyright
=========
MediaWare Solutions Pty Ltd
GPO Box 1985
Canberra
ACT 2601
Australia

Tel: +61 26247 4438
Fax: +61 26247 4557
URL: http://www.MediawareSolutions.com

=====================================
File: ReadMe.txt 18-Jan-2002