Readme.txt
上传用户:hjq518
上传日期:2021-12-09
资源大小:5084k
文件大小:5k
源码类别:

Audio

开发平台:

Visual C++

  1. JM Reference Software README
  2. ============================
  3. The latest version of this software can be obtained from:
  4.   http://iphome.hhi.de/suehring/tml
  5. For reporting bugs please use the JM bug tracking system located at:
  6.   https://ipbt.hhi.de
  7. Please send comments and additions to suehring@hhi.de and alexis.tourapis@dolby.com
  8. ======================================================================================
  9. NOTE: This file contains only a quick overview.
  10.       More detailed information can be found the "JM Reference Software Manual" in the
  11.       doc/ subdirectory of this package.
  12. ======================================================================================
  13. 1. Compilation
  14. 2. Command line parameters
  15. 3. Input/Output file format
  16. 4. Configuration files
  17. 5. Platform specific notes
  18. 1. Compilation
  19. --------------
  20. 1.1 Windows
  21. -----------
  22.   
  23.   Workspaces for MS Visual C++ 2003/2005 are provided with the names 
  24.     jm_vc7.sln  - MS Visual C++ 2003
  25.     jm_vc8.sln  - MS Visual C++ 2005
  26.   These contain encoder and decoder projects.
  27. 1.2 Unix
  28. -----------
  29.   Before compiling in a UNIX environment please run the "unixprep.sh" script which
  30.   will remove the DOS LF characters from the files and create object directories.
  31.   Makefiles for GNU make are provided in the lencod and ldecod directory.
  32. 2. Command line parameters
  33. --------------------------
  34. 2.1 Encoder
  35. -----------
  36.     lencod.exe [-h] [-d default-file] [-f file] [-p parameter=value]
  37.   All Parameters are initially taken from DEFAULTCONFIGFILENAME, defined in 
  38.   configfile.h (typically: "encoder.cfg")
  39.   -h
  40.              Show help on parameters.
  41.   -d default-file    
  42.              Use the specified file as default configuration instead of the file in 
  43.              DEFAULTCONFIGFILENAME.  
  44.   -f file    
  45.              If an -f <config> parameter is present in the command line then 
  46.              this file is used to update the defaults of DEFAULTCONFIGFILENAME.  
  47.              There can be more than one -f parameters present.  
  48.   -p parameter=value 
  49.              If -p <ParameterName = ParameterValue> parameters are present then 
  50.              these overide the default and the additional config file's settings, 
  51.              and are themselfes overridden by future -p parameters.  There must 
  52.              be whitespace between -f and -p commands and their respecitive 
  53.              parameters.
  54. 2.2 Decoder
  55. -----------
  56.     ldecod.exe decoder.cfg
  57.   The decoder configuration file name must be provided as the first parameter. All
  58.   decoding parameters are read from this file.
  59. 3. Input/Output file format
  60. ---------------------------
  61.   The source video material is read from raw YUV 4:2:0 data files.
  62.   For output the same format is used.
  63. 4. Configuration files
  64. ----------------------
  65.   Sample encoder and decode configuration files are provided in the bin/ directory.
  66.   These contain explanatory comments for each parameter.
  67.   
  68.   The generic structure is explained here.
  69. 4.1 Encoder
  70. -----------
  71.   <ParameterName> = <ParameterValue> # Comments
  72.   Whitespace is space and t
  73.   <ParameterName>  are the predefined names for Parameters and are case sensitive.
  74.                    See configfile.h for the definition of those names and their 
  75.                    mapping to configinput->values.
  76.  <ParameterValue> are either integers [0..9]* or strings.
  77.                   Integers must fit into the wordlengths, signed values are generally 
  78.                   assumed. Strings containing no whitespace characters can be used directly.
  79.                   Strings containing whitespace characters are to be inclosed in double 
  80.                   quotes ("string with whitespace")
  81.                   The double quote character is forbidden (may want to implement something 
  82.                   smarter here).
  83.   Any Parameters whose ParameterName is undefined lead to the termination of the program
  84.   with an error message.
  85.   Known bug/Shortcoming:  zero-length strings (i.e. to signal an non-existing file
  86.                           have to be coded as "".
  87.  
  88. 4.2 Decoder
  89. -----------
  90.   <value>    #comment
  91.   The values are read in a predefined order. See the example file for details.
  92. 5. Platform specific notes
  93. --------------------------
  94.   This section contains hints for compiling and running the JM software on different 
  95.   operating systems.
  96. 5.1 MacOS X
  97. -----------
  98.   MacOs X has a UNIX core so most of the UNIX compile process will work. You might need 
  99.   the following modifications:
  100.   a) in Makefile change "CC = $(shell which gcc)" to "CC = gcc"
  101.      (it seems "which" doesn't work)
  102.   b) MacOS X (before "Tiger") doesn't come with ftime. We suggest using a third party ftime 
  103.      implementation, e.g. from:
  104.      http://darwinsource.opendarwin.org/10.3.4/OpenSSL096-3/openssl/crypto/ftime.c
  105. 5.2 FreeBSD
  106. -----------
  107.   You might need to add "-lcompat" to LIBS in the Makefiles for correct linking.