              Osmo4 Two-Dimensional Compositor

                        Version 1.2
                     March 25, 2003

                          ENST

Jean Le Feuvre <jean.lefeuvre@enst.fr>
Jean-Claude Dufourd <Jean-Claude.Dufourd@enst.fr>

1. INTRODUCTION

Osmo4 is a nearly complete2D MPEG-4 compositor running on top of the MPEG-4 Systems framework 
("core") as developped by MPEG Systems Group.

The project should compile on Windows systems under VisualC++ 6.0 equiped with Gdiplus framework 
(win98 and later)


2. COMPILING THE SOFTWARE

The following software packages need to be installed prior to compilation:
* Microsoft DirectX 7 or later
	www.microsoft.com/windows/directx/downloads/default.asp 

* Microsoft Gdiplus Development package 
	www.microsoft.com/msdownload
 
To install the SDK unpack the zip and setup your compiler's path to the headers and lib directories.
Copy Gdiplus.dll to your debug/release directory (recommended by Microsoft) or to your system directory 
(more risky but works for me :)

* Mozilla SpiderMonkey engine
	The release version of SpiderMonkey JS interpretor is /Script/JSWrap/js32.dll
You shall copy it to your release/debug directory in porder to run the software

* All project dependencies and settings are already in place, so you should just have to compile Osmo4

3. RUNNING THE SOFTWARE

To run the player you should have a good CPU (> Pentium 200), audio board installed and running
and of course a Video Card (Millenium, Millenium II, ATI 3D RAGE PRO have been tested) 
Before launching the player remember to update the registry double clicking the im1.reg file, in 
./_Registry directory

It is also important you copy DLLs located in ./IM1Decoders/DLLs directory in the build directory 
in order to have all decoders running


Known problems:

- it may happen that a message "Fatal Error: DirectX : bad bounding rect" pops up at start-up. 
This is actually not fatal, just press OK and go on 
- other bugs less annoying...

- For other problems please refer to the attached ReadMe


4. ADDITIONAL FEATURES

The following preprocessor macros can be defined:

ANIMATION:
	enables BIFS-Anim in the player. BIFS-Anim implementation is 100% tested in the core and it is possible
that you get unexpected behaviour

NOTE: it may happens that the VC linker fails when one of the macros is not defined. In order to link successfully 
recompile the project by explicitely undefining the desired macro in the project settings
