*************************************************************************                                                                ******              MPEG-4 Audio Reference Software                   ******                                                                *************************************************************************Content of README_refsoft=========================1   About MPEG-4 Audio Reference Software2   Further Information3   ISO Copyright Header4   How to compile and run this software5   Audio File I/O1   About MPEG-4 Audio Reference Software=========================================This is the MPEG-4 Audio Version 1 Reference Software for NaturalAudio and Speech Coding.  It was developed by many contributors in thecourse of development of the MPEG-2 AAC / MPEG-4 Audio standardISO/IEC 13818-7, 14496-3.  This software is an implementation of apart of one or more MPEG-4 Audio tools as specified by the standard.2   Further Information=======================Further information about MPEG-4 Audio is available on the followingsites:The official MPEG Home Page:  http://www.cselt.it/mpegMPEG Audio Web Page:  http://www.tnt.uni-hannover.de/project/mpeg/audio/MPEG Audio ftp server:  ftp://ftp.tnt.uni-hannover.de/pub/MPEG/audio/3   ISO Copyright Header========================All files of the Reference Software have the following copyrightheader:This software module was originally developed byFirstName LastName (CompanyName)and edited byFirstName LastName (CompanyName)FirstName LastName (CompanyName)in the course of development of the MPEG-2 NBC/MPEG-4 Audio standardISO/IEC 13818-7, 14496-1,2 and 3. This software module is animplementation of a part of one or more MPEG-2 NBC/MPEG-4 Audio toolsas specified by the MPEG-2 NBC/MPEG-4 Audio standard. ISO/IEC givesusers of the MPEG-2 NBC/MPEG-4 Audio standards free license to thissoftware module or modifications thereof for use in hardware orsoftware products claiming conformance to the MPEG-2 NBC/ MPEG-4 Audiostandards. Those intending to use this software module in hardware orsoftware products are advised that this use may infringe existingpatents. The original developer of this software module and his/hercompany, the subsequent editors and their companies, and ISO/IEC haveno liability for use of this software module or modifications thereofin an implementation. Copyright is not released for non MPEG-2NBC/MPEG-4 Audio conforming products. The original developer retainsfull right to use the code for his/her own purpose, assign or donatethe code to a third party and to inhibit third party from using thecode for non MPEG-2 NBC/MPEG-4 Audio conforming products. Thiscopyright notice must be included in all copies or derivative works.Copyright (c) 1999.4   How to compile and run this software========================================The Reference Software is written in ANSI C and is C++ compilable.  Itcan be compiled and linked on UNIX/Linux platforms using GNU's gcc/g++and GNU's make.  For other compilers and platforms, the makefile mightrequire adaption to your local environment.4.1   Directory structure-------------------------vm/	README_refsoft			(this file)	README_usage			HOWTO use the executables	makefile*			makefiles	src_frame/*			frame work source code (decoder)	src_frame_enc/*			frame work source code (encoder)	src_par*/*			PARA core source code	src_lpc*/*			CELP core source code	src_tf*/*			T/F core source code	include/			library include files (decoder)	include_enc/			library include files (encoder)	tables/				runtime data tables (decoder)	tables_enc/			runtime data tables (encoder)	linux/				platform: Linux		lib/			libraries	linux_v1_g++/			platform: Linux with g++		mp4auenc		encoder executable		mp4audec		decoder executable		obj/			object files	sgi/				platform: SGI (IRIX)	sol/				platform: Solaris	cdk/				platform: Cygnus's cygwin4.2   Making the executables----------------------------Before making the Reference Software executables, set the environmentvariable SYSTEM_NAME according to your software platform (e.g.: IRIX,Linux, Solaris, cdk):  setenv SYSTEM_NAME LinuxNow make can be invoked:  cd vm  makeThe executables are placed into a platform- and compiler-dependentdirectory, e.g.  linux_v1_g++for Linux using the g++ compiler.  Such directories are generatedautomatically by the makefile if required.To make use of the AFsp library supporting various audio file formats(see Section 5.1 for further details), invoke make with the appropriateoption:  make clean  make USE_AFSP=1Instead of specifying this option on the command line, you can alsowrite it as  USE_AFSP = 1into the configuration file:  makefile.cfgFor further available options, check the makefile and its sub-makefiles:  makefile.par  makefile.lpc  makefile.tf4.3   Running the encoder and decoder-------------------------------------Before running the Reference Software, you can set the followingenvironment variables according to your local path names, audio fileformats etc.:MP4_ORI_PATH       path for original audio filesMP4_BIT_PATH       path for bit stream filesMP4_DEC_PATH       path for decoded audio filesMP4_ORI_FORMAT     format of original audio filesMP4_DEC_FORMAT     format of decoded audio filesMP4_RAWAUDIOFILE   raw audio file format - to read headerless files                   using the AFsp library                   (sample format, num header bytes, sampling rate,                   byte order, num channels, gain factor)Example:  setenv MP4_ORI_PATH /data/mp4/ori/  setenv MP4_BIT_PATH /data/mp4/bit/  setenv MP4_DEC_PATH /data/mp4/dec/  setenv MP4_ORI_FORMAT .au  setenv MP4_DEC_FORMAT .au  setenv MP4_RAWAUDIOFILE "integer16, 0, 8000.0, native, 1, 1.0"Invoke the encoder and decoder with the option -h to get a list of thecommand line options available, e.g.:  linux_v1_g++/mp4auenc -h  linux_v1_g++/mp4audec -hThe following example encodes the file test.au (mono, 8 kHz samplingrate) to the bit stream file test_hvx.mp4 and then decodes this bitstream to the file test_hvx.au using the HVXC mode (parametric speechcoding) at 2 kbit/s:  linux_v1_g++/mp4auenc -d 1 -m hvxc -r 2000 test -o test_hvx  linux_v1_g++/mp4audec -d 1 -ed .au test_hvxFurther information about the operation of the encoder and decoder isavailable in the file:  README_usage5   Audio File I/O==================All audio file i/o of the Reference Software is handled via theaudio.h interface.  The current implementation of audio.c uses theaustream.c module included in the Reference Software to providesupport for 16-bit ".au" files.  To provide support for other commonaudio file formats (like ".wav" and ".aiff"), the audio.c module canmake use of the AFsp library.5.1   The AFsp Audio File I/O Package-------------------------------------The AFsp package provides audio file routines and is written by PeterKabal <kabal@TSP.EE.McGill.CA>.  It is available via ftp:WWW site:		http://www.TSP.EE.McGill.CA/software.htmlftp site:		ftp://ftp.TSP.EE.McGill.CA/pub/AFspmirror site:		ftp://ftp.tnt.uni-hannover.de/pub/audio/AFspThe Natural Audio Reference Software has been tested with thefollowing AFsp versions:  AFsp-V3R2.tar.Z  AFsp-v4r1.tar.gzTo make the libtsp library, unpack the AFsp distribution, change intothe directory "libtsp" and start make.  Then you can install libtsp inyour default include and library paths or set the environmentvariables AFSP_INCLUDE_PATH and AFSP_LIBRARY_PATH to the appropriatedirectories, e.g.:  setenv AFSP_INCLUDE_PATH /usr/AFsp-v4r1/include  setenv AFSP_LIBRARY_PATH /usr/AFsp-v4r1/libTo build the Reference Software with AFsp support, use the USE_AFSP=1makefile option:  make clean  make USE_AFSP=15.2   Excerpt from the AFsp Copying file----------------------------------------Copyright (C) 1998 Peter Kabal The AFsp audio file routines are provided free of charge without warranty ofany kind.  All components are copyrighted.  They may be distributed free ofcharge provided that the recipients also acquire the right to distribute them.In no case can this software be incorporated into a work which is distributedfor a fee. --$Id: README_refsoft,v 1.5 1999/07/26 13:17:56 purnhage Exp $