Installation instructions for GPAC 0.4.4 on Symbian 9.1 (S60 3rd Edition) platform
last modified: Mai 2007

0 Foreword
	Compilation has only been tested with GCCE & Nokia S60 SDK
	In order to fully compile, you must get:
  - the complete S60 3rd edition SDK (maintainance release) 
  - the MMF SDK update
	
	IMPORTANT NOTE:
	 You must install the SDK and the code you will compile with it (be it GPAC or anything else) 
        !! ON THE SAME LOGICAL DRIVE !!
   If you do not do so, compilation will simply fail due to some misbehavior of the SDK's environment variables.
           
	
	What is currently supported on symbian:
    * all GPAC core, with audio and video output
    * MP4 demux, AAC demux, MP3 demux, AMR demux
    * native audio media codec from the phone through MMF
    * MPEG-4 ASP video decoding through xvid
    * JPEG and PNG decoding through libjpeg and libpng    
    * MP3 decoding through MAD
    * TrueType fonts through FreeType
    * Scripting with JS32 (not fully tested yet)

	What is currently NOT supported on symbian:
    * networking 
    * AVC/H264 video decoding
    * H263 video decoding        

  TIP:
    Global compiler options are located in SDKRoot\Epoc32\tools\compilation_config\ - you may edit the default C++ rules to remove some 
    warnings during C compil. 

I Extra lib installation
	Please follow the instructions in gpac_extra_lib/00_README_FIRST

II GPAC compilation

  Go to gpac/build/symbian
  
  II.1 Configuring extra libs
    * If you don't have freetype for symbian, comment ft_font.mmp in file bld.inf
    * If you don't have libpng or libjpeg for symbian, comment indicated lines in img_in.mmp
    * If you don't have libmad for symbian, comment indicated lines in mp3_in.mmp
    * If you don't have libjs for symbian, comment indicated lines in libgpac.mmp

  II.2 Compiling GPAC
   	cd gpac/build/symbian
  	bldmake bldfiles
    abld build gcce urel
    cd sis
    makesis osmo4_gcce.pkg
    signsis osmo4_gcce.SIS osmo4_gcce.SIS gpac.cer gpac.key password
  
You will get a .SIS package that installs properly on a symbian device.
NOTES:
* The app and plugins are all installed in \sys\bin on the device. DO NOT change this path, since it won't work otherwise (due to symbian 9.1 caged data stuff) 
* If you create/succeed to compile a new plugin for GPAC, you must:
    - edit /build/symbian/sis/osmo4_gcce.pkg to add your plugin in the installer
    - edit /build/symbian/sis/GPAC.cfg to instruct the player of this new plugin (enumeration of DLLs on Symbian 9.1 is just not possible without a good amount of $$)