0. Table of Contents
   =================
   
   1.   Compiling from source
   1.1    Compiling using Microsoft Visual C++
   1.2    Compiling using gcc 3.2 (eg. MINGW, MSYS)
   
   2.   Installing and Recording
   
   3.   Playing recorded WMF Files

1. Compiling from source
   =====================

Before compiling CamIt, you need to download and install the 
Windows Media Format SDK from 

  http://wmlicense.smdisp.net/v9sdk/

CamIt can be compiled using Microsoft Visual C++ (MSVC) or GCC 3.2 or later.

1.1 Compiling using Microsoft Visual C++:
    -------------------------------------
  
  After installing the Windows Media Format SDK, add the include path
  (eg. C:\WMSDK\WMFSDK9\include) to the list of include directories
  searched by MSVC, and the lib path (C:\WMSDK\WMFSDK9\lib) to the 
  list of searched library directories.
  
  If using MSVC 6, you MUST install the latest compiler service pack, 
  or you will receive compilation errors !
  
  Two configurations are provided, "Debug" and "Release".
  
 
1.2 Compiling using gcc 3.2 (eg. MINGW, MSYS)
    -----------------------------------------
  
  Build CamIt by running (see below for release build) :
  
    make depends
    make

  The make file expects the Windows Media Format SDK headers to be installed
  in /WMSDK/WMFSDK9/include . If you installed the SDK in a different location,
  pass the SDK path (ie. the path to the *parent* directory of the SDK include
  directory) to "make" by setting the variable "WMFSDK" :
  
    make WMFSDK=\somepath\WMSDK\WMFSDK9
    
  To build the release version, set the "CFG" variable to "Release" :
  
    make depends
    make CFG=Release
    


2. Installing and Recording
   ========================

On all platforms, you first need to install the Windows Media Format SDK support
files (see the "redist" directory of the Windows Media Format SDK) by running 
"WMFDist.exe". This setup file supports several command line options,
see "http://support.microsoft.com/default.aspx?scid=kb;en-us;Q197147" for a
complete list. This setup is all that's required for *recording*.

Example (silent install, no reboot at the end):

  WMFDist.exe /Q:A /R:N
 
 
Note that the setup will fail if COM support is missing (early Windows 95, NT
4.0). COM support is usually installed with InternetExplorer 4.0 or any of the
more recent Office packages.
 
 

3. Playing recorded WMF Files
   ==========================

Windows Media Player 7.0 and later play the generated WMF files without 
problems. 

Window 98 (2nd Edition / SE) comes with Windows Media Player 6.0 preinstalled.
Unfortunately, this version does not recognize the .wmv extension. The solution
is to either rename the .wmv files to .asf (which is the old extension for this
format), or to open the file by selecting "All Files (*.*)" in the player's Open
File Dialog.

Window NT 4.0 doesn't include the MediaPlayer.

WMP 6.0 and 6.4 does not include the screen codec used by camit. If connected
to the Internet, it will automatically download and install the codec. The
codecs can also be installed manually, be running the "wmpcdcs8.exe"
installation (the same command line options as are supported).

Example:

  wmpcdcs8.exe /Q:A /R:N
 

The Windows MediaPlayer can be downloaded from
http://www.microsoft.com/windows/windowsmedia/download/default.asp.
