              IM-1 Two-Dimensional Compositor

                        Version 3.5
		MPEG-4 Systems FDIS version			
                     March 12, 1999

                          CSELT

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

Franco Casalino     <Franco.Casalino@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  

  DMIFClient      DMIF services directory

  DMIFCommon      common core of the DMIF services

  IM1Decoders     decoders dll

  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. WHAT IS NEW WITH THIS VERSION

DEF USE support.
Improved scene redrawing. 
Improved nodes deletion support.
Improved sensors handling. 
Window resizing, minimize ecc.
BIFS window size signaling enabled.
Document Reopening.

Nodes:

Anchor node, html support (continued from Ananda Allys  work)
Bitmap
CoordinateInterpolator2D
Curve2D    (from Frederic Bouilhaguet)  
DiscSensor
Form node
ImageTexture
Layout (Gianluca - Frederic)
MovieTexture
OrderedGroup
PlaneSensor2D 
ProximitySensor
Text
TermCap 
Valuator  (from Law Chee Yong original implementation)
WorldInfo 

3. MORE INFORMATION

HTML documentation will be provided soon at the Systems ftp site.

4. COMPILING THE SOFTWARE

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

IM1_2D main project
DMIFClientStack lib - common part of all DMIF services.
File Service dll    - implementation of the DMIF file service. 
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.

5. 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.

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

