/** \page index<pre>                       -= SKLMP4 =-                       VERSION 0.23    home: http://skal.planet-d.net/coding/mpeg4codec.html--------------------------------------------------------------------I) DescriptionSklmp4 consists in portable C++ sources of a library capable of encodingand decoding MPEG-4 video bitstream. Bitstreams conforming to ISO/IEC 14496-2(version 2) Advance Simple Profile are fully supported by thedecoder. Partial support for MPEG-1/2 bitstreams (ISO/IEC 13818-2)is also supplied.Encoding utilizes a sub-set of Advance Simple Profile.The coding tools supported by the decoder are:    *  I/P/B/S VOP, with interlacing.    * H263 and MPEG4 quantization (+custom matrix).    * Half and Quarter Pixel motion compensation    * Reduced Resolution.    * GMC (3 warp points)    * NEWPRED and resynchronizations    * Partial MPEG1/2 support (frame only)Are not supported: Data partitioning, reversible VLC.Encoder can use the following features by default:    * I/P/S frames (+interlaced mode).    * H263 and MPEG4 quantization (+custom matrix).    * Half and Quarter pixel motion compensation    * Trellis-based adaptive quantization    * Reduced Resolution.    * GMC (3 warp points), rather experimental.    * Several ME methods are available.    * Luminance maskingNot supported: B-frames, data partitioning.Sklmp4 targets very high performances on x86-basedPC platforms, thanks to hand-optimized assemblycode. Other platforms (Sparcs, Dec alpha, HP,...)can nevertheless use the C++-only version.Simple video drivers for various X11 flavor and DirectDraw arealso provided for convenience, but are not required for handlingMPEG4 bitstreams.--------------------------------------------------------------------II) Requirements and installationOn Unix, a Perl interpreter is required for generating the makefile.For x86 platform (Linux and Win32), a recent version of NASM (>=0.98.35) is required for using assembly langage. NASM is available fromthe site http://nasm.sourceforge.net/ .Otherwise, any C++ compiler will fit, notwithstanding minor porting problems.Documentation can be generated using Doxygen tool (www.doxygen.org).Main supported platforms are:  x86-Linux-gcc  x86-Win32  MSVC6, MSVC7, .NET2003.Tested platforms:  Sun, HP, Dec Alpha, SGI...As seen, 64-bits platforms are supported, provided you definethe symbol SKL_64BITS in some makefile or in the main header (skl.h)After decompression of the archive, the following directoriesshould contain:include/			all the headers  include/skl_syst		the core headers for MPEG4 and system code.  include/skl_2d		headers for bitmaps and graphics (not mandatory)  include/skl.h			the library's main header  include/skl_video.h		video header  include/skl_syst/skl_mpg4.h   MPEG-4 main header. This is the only one to include.src/				all the sources  src/mpg_src			MPEG4 (de)coding sources  src/dsp_src			low-level DSP-like functions (mostly in ASM)  src/syst_src			system-related sources (memory, dynamic loading,...)  src/ex_src			front-end example (tmp4.cpp)  src/video_src			the video drivers  src/util_src			some helpful tools  src/test_src			some testsutil/				some setup scripts and common makefiles (Unix)build/				platform-dependent sample makefiles and projects (win32)  build/linux-gcc3		x86-linux makefile  build/msvc			MSVC6/7 ready-to-use workspaces  build/dot_net			.NET2003 (7.1) ready-to-use "solution"doc/				Location of documentation  doc/html			HTML API documentation, generated by Doxygen--------------------------------------------------------------------III) Software overview<img src="../fig1.gif"><p><br>Figure 1 (fig1.gif) describes the main classes. Plain boxes are public abstractclasses (interfaces), mostly subclassed into internal classes (dotted box).The three main classes are:class SKL_MP4_DEC:class SKL_MP4_ENC:These classes can only be constructed through proxies C-functions.This allows dynamic-loading or linking with dll or .so versionof the core library.class SKL_MP4_ANALYZER:This class performs most of the work during encoding, by performpicture analysis prior to bitstream coding.A default implementation is supplied, but alternate implementationscan be plugged instead in the encoding instance of SKL_MP4_ENC.The main protocalar API used to access or set internal data of theanalyzer is: Set_Param() and Get_Param(). The core bitstreamcoder (SKL_MP4_ENC) expect somes mandatory syntax parameter to besupplied by the analyzer when calling Get_Param(). Other parameters only pertain to frame analysis strategy, and are publicly available for the user.Auxiliary data structures:Some satellite data structures are required for interfacingwith user's data, e.g. Namely:SKL_MEM_I, SKL_MP4_PIC, SKL_MP4_INFOS, SKL_MP4_SLICERand SKL_CPU_FEATURE.Please refer to the HTML documentation availablefrom doc/html/index.html--------------------------------------------------------------------IV) Decoding APIBitstream decoding are performed by instances of the interfaceSKL_MP4_DEC, declared in the header include/skl_syst/skl_mpg4.h.Construction:Instances of SKL_MP4_DEC should be created calling theproxy function: SKL_MP4_DEC *Skl_MP4_New_Decoder();This function will return a null pointer in case of error(no more memory, e.g.). The instances are allocated onthe C++ heap.Destruction:Instances of SKL_MP4_DEC should be deleted calling theproxy function: void Skl_MP4_Delete_Decoder(SKL_MP4_DEC *);When using a dynamic library, or the built-in dynamic loadingmecanism (see SKL_USE_DYN_LOAD flag), these two proxies are to be found in the .dll or .so library.API Synopsis:  virtual int Decode(const SKL_BYTE *Buf, int Len);  virtual int Decode_MPEG12(const SKL_BYTE *Buf, int Len);  virtual int Is_Frame_Ready() const;  virtual void Consume_Frame(SKL_MP4_PIC *Pic);  virtual int Get_Frame_Number() const;  virtual SKL_MEM_I *Set_Memory_Manager(SKL_MEM_I *Mem=0);  virtual void Set_CPU(SKL_CPU_FEATURE Cpu = SKL_CPU_DETECT);  virtual void Set_Slicer(SKL_MP4_SLICER Slicer, SKL_ANY Slicer_Data=0);API description:Please refer to the HTML documentation availablefrom doc/html/index.html--------------------------------------------------------------------V) Encoding APIBitstream encoding are performed by instances of the interfaceSKL_MP4_ENC, declared in the header include/skl_syst/skl_mpg4.h.Construction:Instances of SKL_MP4_ENC should be created calling theproxy function: SKL_MP4_ENC *Skl_MP4_New_Encoder();This function will return a null pointer in case of error(no more memory, e.g.). The instances are allocated onthe C++ heap.Destruction:Instances of SKL_MP4_ENC should be deleted calling theproxy function: void Skl_MP4_Delete_Enccoder(SKL_MP4_ENC *);When using a dynamic library, or the built-in dynamic loadingmecanism (see SKL_USE_DYN_LOAD flag), these two proxies are to be found in the .dll or .so library.API Synopsis:  virtual const SKL_MP4_PIC *Prepare_Next_Frame(int Width, int Height);  virtual const SKL_MP4_PIC *Get_Next_Frame() const;  virtual int Encode();  virtual int Finish_Encoding();  virtual const SKL_BYTE *Get_Bits() const;  virtual int Get_Bits_Length() const;  virtual SKL_MEM_I *Set_Memory_Manager(SKL_MEM_I *Mem=0);  virtual void Set_CPU(SKL_CPU_FEATURE Cpu = SKL_CPU_DETECT);  virtual void Set_Custom_Matrix(int Intra, SKL_BYTE *M=0);  virtual SKL_MP4_ANALYZER_I *Set_Analyzer(SKL_MP4_ANALYZER_I *Analyzer=0);  virtual SKL_MP4_ANALYZER_I *Get_Analyzer() const;  virtual void Set_Slicer(SKL_MP4_SLICER Slicer, SKL_ANY Slicer_Data=0);API description:Please refer to the HTML documentation availablefrom doc/html/index.html--------------------------------------------------------------------VI) ISO-C APIAll the above API is also wrapped in a Plain-C API,available in the standalone header file include/skl_mpg4_c.h.--------------------------------------------------------------------VII) Contacting the authorNon-bug reports should be sent to:         skal@planet-d.net        http://skal.planet-d.netHome + additional details + online documentation: 	http://skal.planet-d.net/coding/mpeg4codec.htmlHaf phun!--------------------------------------------------------------------</pre> */