              IM-1 Two-Dimensional Compositor

                        Version 3.8
		MPEG-4 Systems FDIS version			
                     December 20, 1999

                          CSELT

Gianluca Di Cagno   <Gianluca.Dicagno@cselt.it>
Guido Franceschini  <Guido.Franceschini@cselt.it>

1. INTRODUCTION

This file describes the implementation of the IM-1 two dimensional
compositor that is included in this directory.  The project currently
compiles on Windows95/NT under VisualC++ 6.0.
The player is built on top of the MPEG-4 Systems framework ("core") from  
Zvi Lifshits.

There are a number of directories included in this release:

  2DPlayer-CSELT  frame application, renderers, nodes, presenter.

  Animation   	  Animation Stream stuff. 

  BifsEnc     	  the files from Zvi to build the BIFS encoder.
	
  Core  	  the core code from Zvi Lifshitz (zvil@csi.com).

  Decoder         Decoder base implementation from Zvi  

  DMIF		  DMIF services directory (TRIF from Zvi and MP4 from Mike Coleman)

  IM1Decoders     decoder dlls

  Include	
  
  IPMP            IPMP stuff

  lib             libraries for the decoders (includes the DLLs needed)

  mux             Zvi mux source code

  script          script stuff

  ZTL             Zvi library	


2. COMPILING THE SOFTWARE

The workspace file is under the directory 2DPlayer-CSELT.
It includes the following project files:

IM1_2D main project
DMIFClientFilter lib   - common part of all DMIF services.
FileTrivInstance dll   - implementation of the DMIF file service. 
libisomp4              - mp4 reader dll
MP4Service             - IM1 mp4 plug in 
Decoder             
AAC  decoder dll     
G723 decoder dll     
H263 decoder dll    
JPEG decoder dll     
IPMP dll                 
ZTL  dll

You will need to have DirectX installed (I use version 3 and Windows NT 4.0 service pack3).

The pack contains also the bifs enc and the multiplexer projects (BifsEnc and Mux directories)
from Zvi.

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 mpeg.reg
file, and copy the IM1-2D.ini file under the c:\winNt directory if you are running Windows NT
It is also important you unzip the additionaldlls.zip file in the debug or release directory the
compiler has produced.

4. File Format

The player accepts by default the mp4 file format. Trif files are still supported,
just name them using the ".trif" extension.

IMPORTANT - 

Don't try to run old samples:  they don't work anymore since bifs encoder and multiplexer
have changed.

Known problems:


-Sometimes the player remains in the Process list even if you have closed the window. Remove 
 the process before running the player again.

 

Support:

gianluca.dicagno@cselt.it

