Read Me

DawnLightPlayer README
-------------

1) Documentation
----------------

* No doc, here is software flow:

* input(avin_*.c)
	 |
	\|/
* avinput.c
	 |
	\|/
* video packet queue
* audio packet queue
	 |
	\|/
* avdecode.c
	 |
	\|/
* picture queue
* samples queue
	 |
	\|/
* avoutput.c
	 |
	\|/
* output(vo_*.c and ao_*.c)


2) Licensing
------------

* Read the file COPYING.LGPL. DawnLightPlayer are licensed
  under the GNU Lesser General Public License.

3) Compile for Linux
------------

* 1. install ffmpeg, libfaad, libsdl
	$ apt-get install libfaad2-dev
	$ apt-get install libavcodec-dev libavformat-dev libavutil-dev
	$ apt-get install libpostproc-dev libswscale-dev
	$ apt-get install libsdl1.2-dev

* 2. make
	$ cd <DawnLightPlayer dir>
	$ cp Makefile.debian Makefile
	$ make

  If you want to compile ffmpeg yourself, follow the steps:

  * 1. download libfaad2 source
	$ cd <faad2 source dir>
	$ ./configure
	$ make
	$ make install

  * 2. download ffmpeg source
	$ svn co svn://svn.mplayerhq.hu/ffmpeg/trunk ffmpeg
	$ cd <ffmpeg source dir>
	$ ./configure --disable-muxers --disable-ffmpeg --disable-ffserver --disable-ffplay --enable-libfaad --enable-gpl
	$ make

  * 3. make
	$ cd <DawnLightPlayer source dir>
	$ cp Makefile.linux Makefile
	$ modify Makefile, change FFMPEG_DIR var to your ffmpeg dir
	$ make

3) Compile for WIN32
------------

  * 1. install MINGW32 development eviroment
	$ apt-get install mingw32 mingw32-binutils mingw32-runtime
	look for your mingw32 CC dir, maybe /usr/i586-mingw32msvc/

  * 2. cross compile libfaad2 and ffmpeg
	$ cd <faad2 source dir>
	$ ./configure --enable-static --build=mingw32 --host=i586-mingw32msvc
	$ make
	$ cp libfaad/.libs/libfaad.a <mingw32 CC dir>/lib/
	$ cp include/*.h <mingw32 CC dir>/include/
	
	$ cd <ffmpeg source dir>
	$ ./configure --disable-muxers --cross-prefix=i586-mingw32msvc- --target-os=win --enable-memalign-hack --enable-libfaad --enable-gpl
	$ make

  * 3. cross compile DawnLightPlayer
	$ cp Makefile.mingw Makefile
	$ modify Makefile, change FFMPEG_DIR var to your ffmpeg dir
	$ make

  If you use SDL lib for video or audio output, must install
  SDL lib first, download SDL-devel-1.2.xx-mingw32.tar.gz and 
  install it to your mingw32 CC dir.


4) Add new source file
------------

* $ ./GenNewFile.py filename authorname
  $ svn propset svn:keywords "Id" filename
  $ svn add filename
  $ svn ci filename -m "add filename for xxx function"