ffmpeg.h
上传用户:riyaled888
上传日期:2009-03-27
资源大小:7338k
文件大小:11k
源码类别:

多媒体

开发平台:

MultiPlatform

  1. /*****************************************************************************
  2.  * ffmpeg.h: decoder using the ffmpeg library
  3.  *****************************************************************************
  4.  * Copyright (C) 2001 VideoLAN
  5.  * $Id: ffmpeg.h 8806 2004-09-26 13:39:00Z gbazin $
  6.  *
  7.  * Authors: Laurent Aimar <fenrir@via.ecp.fr>
  8.  *
  9.  * This program is free software; you can redistribute it and/or modify
  10.  * it under the terms of the GNU General Public License as published by
  11.  * the Free Software Foundation; either version 2 of the License, or
  12.  * (at your option) any later version.
  13.  *
  14.  * This program is distributed in the hope that it will be useful,
  15.  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  16.  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  17.  * GNU General Public License for more details.
  18.  *
  19.  * You should have received a copy of the GNU General Public License
  20.  * along with this program; if not, write to the Free Software
  21.  * Foundation, Inc., 59 Temple Place - Suite 330, Boston, MA  02111, USA.
  22.  *****************************************************************************/
  23. #include "codecs.h"                                      /* BITMAPINFOHEADER */
  24. #if LIBAVCODEC_BUILD >= 4663
  25. #   define LIBAVCODEC_PP
  26. #else
  27. #   undef  LIBAVCODEC_PP
  28. #endif
  29. struct picture_t;
  30. struct AVFrame;
  31. struct AVCodecContext;
  32. struct AVCodec;
  33. void E_(InitLibavcodec)( vlc_object_t * );
  34. int E_(GetFfmpegCodec) ( vlc_fourcc_t, int *, int *, char ** );
  35. int E_(GetVlcFourcc)   ( int, int *, vlc_fourcc_t *, char ** );
  36. int E_(GetFfmpegChroma)( vlc_fourcc_t );
  37. vlc_fourcc_t E_(GetVlcChroma)( int );
  38. /* Video decoder module */
  39. int  E_( InitVideoDec )( decoder_t *, AVCodecContext *, AVCodec *,
  40.                          int, char * );
  41. void E_( EndVideoDec ) ( decoder_t * );
  42. picture_t *E_( DecodeVideo ) ( decoder_t *, block_t ** );
  43. /* Audio decoder module */
  44. int  E_( InitAudioDec )( decoder_t *, AVCodecContext *, AVCodec *,
  45.                          int, char * );
  46. void E_( EndAudioDec ) ( decoder_t * );
  47. aout_buffer_t *E_( DecodeAudio ) ( decoder_t *, block_t ** );
  48. /* Chroma conversion module */
  49. int  E_(OpenChroma)( vlc_object_t * );
  50. void E_(CloseChroma)( vlc_object_t * );
  51. /* Video encoder module */
  52. int  E_(OpenEncoder) ( vlc_object_t * );
  53. void E_(CloseEncoder)( vlc_object_t * );
  54. /* Audio encoder module */
  55. int  E_(OpenAudioEncoder) ( vlc_object_t * );
  56. void E_(CloseAudioEncoder)( vlc_object_t * );
  57. /* Demux module */
  58. int  E_(OpenDemux) ( vlc_object_t * );
  59. void E_(CloseDemux)( vlc_object_t * );
  60. /* Video filter module */
  61. int  E_(OpenFilter)( vlc_object_t * );
  62. void E_(CloseFilter)( vlc_object_t * );
  63. int  E_(OpenDeinterlace)( vlc_object_t * );
  64. void E_(CloseDeinterlace)( vlc_object_t * );
  65. /* Postprocessing module */
  66. void *E_(OpenPostproc)( decoder_t *, vlc_bool_t * );
  67. int E_(InitPostproc)( decoder_t *, void *, int, int, int );
  68. int E_(PostprocPict)( decoder_t *, void *, picture_t *, AVFrame * );
  69. void E_(ClosePostproc)( decoder_t *, void * );
  70. /*****************************************************************************
  71.  * Module descriptor help strings
  72.  *****************************************************************************/
  73. #define DR_TEXT N_("Direct rendering")
  74. #define ERROR_TEXT N_("Error resilience")
  75. #define ERROR_LONGTEXT N_( 
  76.     "ffmpeg can do error resilience.n" 
  77.     "However, with a buggy encoder (such as the ISO MPEG-4 encoder from M$) " 
  78.     "this can produce a lot of errors.n" 
  79.     "Valid values range from 0 to 4 (0 disables all errors resilience).")
  80. #define BUGS_TEXT N_("Workaround bugs")
  81. #define BUGS_LONGTEXT N_( 
  82.     "Try to fix some bugsn" 
  83.     "1  autodetectn" 
  84.     "2  old msmpeg4n" 
  85.     "4  xvid interlacedn" 
  86.     "8  ump4 n" 
  87.     "16 no paddingn" 
  88.     "32 ac vlcn" 
  89.     "64 Qpel chroma")
  90. #define HURRYUP_TEXT N_("Hurry up")
  91. #define HURRYUP_LONGTEXT N_( 
  92.     "Allow the decoder to partially decode or skip frame(s) " 
  93.     "when there is not enough time. It's useful with low CPU power " 
  94.     "but it can produce distorted pictures.")
  95. #define PP_Q_TEXT N_("Post processing quality")
  96. #define PP_Q_LONGTEXT N_( 
  97.     "Quality of post processing. Valid range is 0 to 6n" 
  98.     "Higher levels require considerable more CPU power, but produce " 
  99.     "better looking pictures." )
  100. #define DEBUG_TEXT N_( "Debug mask" )
  101. #define DEBUG_LONGTEXT N_( "Set ffmpeg debug mask" )
  102. #define VISMV_TEXT N_( "Visualize motion vectors" )
  103. #define VISMV_LONGTEXT N_( "Set motion vectors visualization mask.n" 
  104.     "1 - visualize forward predicted MVs of P framesn" 
  105.     "2 - visualize forward predicted MVs of B framesn" 
  106.     "4 - visualize backward predicted MVs of B frames" )
  107. #define LOWRES_TEXT N_( "Low resolution decoding" )
  108. #define LOWRES_LONGTEXT N_( "Will only decode a low resolution version of " 
  109.     "the video." )
  110. #define LIBAVCODEC_PP_TEXT N_("ffmpeg post processing filter chains")
  111. /* FIXME (cut/past from ffmpeg */
  112. #define LIBAVCODEC_PP_LONGTEXT 
  113. "<filterName>[:<option>[:<option>...]][[,|/][-]<filterName>[:<option>...]]...n" 
  114. "long form example:n" 
  115. "vdeblock:autoq/hdeblock:autoq/linblenddeint    default,-vdeblockn" 
  116. "short form example:n" 
  117. "vb:a/hb:a/lb de,-vbn" 
  118. "more examples:n" 
  119. "tn:64:128:256n" 
  120. "Filters                        Optionsn" 
  121. "short  long name       short   long option     Descriptionn" 
  122. "*      *               a       autoq           cpu power dependant enablern" 
  123. "                       c       chrom           chrominance filtring enabledn" 
  124. "                       y       nochrom         chrominance filtring disabledn" 
  125. "hb     hdeblock        (2 Threshold)           horizontal deblocking filtern" 
  126. "       1. difference factor: default=64, higher -> more deblockingn" 
  127. "       2. flatness threshold: default=40, lower -> more deblockingn" 
  128. "                       the h & v deblocking filters share thesen" 
  129. "                       so u cant set different thresholds for h / vn" 
  130. "vb     vdeblock        (2 Threshold)           vertical deblocking filtern" 
  131. "h1     x1hdeblock                              Experimental h deblock filter 1n" 
  132. "v1     x1vdeblock                              Experimental v deblock filter 1n" 
  133. "dr     dering                                  Deringing filtern" 
  134. "al     autolevels                              automatic brightness / contrastn" 
  135. "                       f       fullyrange      stretch luminance to (0..255)n" 
  136. "lb     linblenddeint                           linear blend deinterlacern" 
  137. "li     linipoldeint                            linear interpolating deinterlacen" 
  138. "ci     cubicipoldeint                          cubic interpolating deinterlacern" 
  139. "md     mediandeint                             median deinterlacern" 
  140. "fd     ffmpegdeint                             ffmpeg deinterlacern" 
  141. "de     default                                 hb:a,vb:a,dr:a,aln" 
  142. "fa     fast                                    h1:a,v1:a,dr:a,aln" 
  143. "tn     tmpnoise        (3 Thresholds)          Temporal Noise Reducern" 
  144. "                       1. <= 2. <= 3.          larger -> stronger filteringn" 
  145. "fq     forceQuant      <quantizer>             Force quantizern"
  146. /*
  147.  * Encoder options
  148.  */
  149. #define ENC_CFG_PREFIX "sout-ffmpeg-"
  150. #define ENC_KEYINT_TEXT N_( "Ratio of key frames" )
  151. #define ENC_KEYINT_LONGTEXT N_( "Allows you to specify the number of frames " 
  152.   "that will be coded for one key frame." )
  153. #define ENC_BFRAMES_TEXT N_( "Ratio of B frames" )
  154. #define ENC_BFRAMES_LONGTEXT N_( "Allows you to specify the number of " 
  155.   "B frames that will be coded between two reference frames." )
  156. #define ENC_VT_TEXT N_( "Video bitrate tolerance" )
  157. #define ENC_VT_LONGTEXT N_( "Allows you to specify the video bitrate " 
  158.   "tolerance in kbit/s." )
  159. #define ENC_INTERLACE_TEXT N_( "Enable interlaced encoding" )
  160. #define ENC_INTERLACE_LONGTEXT N_( "Allows you to enable dedicated " 
  161.   "algorithms for interlaced frames." )
  162. #define ENC_PRE_ME_TEXT N_( "Enable pre motion estimation" )
  163. #define ENC_PRE_ME_LONGTEXT N_( "Allows you to enable the pre motion " 
  164.   "estimation." )
  165. #define ENC_RC_STRICT_TEXT N_( "Enable strict rate control" )
  166. #define ENC_RC_STRICT_LONGTEXT N_( "Allows you to enable the strict rate " 
  167.   "control algorithm." )
  168. #define ENC_RC_BUF_TEXT N_( "Rate control buffer size" )
  169. #define ENC_RC_BUF_LONGTEXT N_( "Allows you to specify the rate control " 
  170.   "buffer size." )
  171. #define ENC_RC_BUF_AGGR_TEXT N_( "Rate control buffer aggressiveness" )
  172. #define ENC_RC_BUF_AGGR_LONGTEXT N_( "Allows you to specify the rate control "
  173.   "buffer aggressiveness." )
  174. #define ENC_IQUANT_FACTOR_TEXT N_( "I quantization factor" )
  175. #define ENC_IQUANT_FACTOR_LONGTEXT N_( "Allows you to specify the " 
  176.   "quantization factor of I frames, compared with P frames (for instance " 
  177.   "1.0 => same qscale for I and P frames)." )
  178. #define ENC_NOISE_RED_TEXT N_( "Noise reduction" )
  179. #define ENC_NOISE_RED_LONGTEXT N_( "Allows you to enable a simple noise " 
  180.   "reduction algorithm to lower the encoding length and bitrate, at the " 
  181.   "expense of lower quality frames." )
  182. #define ENC_MPEG4_MATRIX_TEXT N_( "Enable MPEG4 quantization matrix" )
  183. #define ENC_MPEG4_MATRIX_LONGTEXT N_( "Allows you to use the MPEG4 " 
  184.   "quantization matrix for mpeg2 encoding. This generally yields a " 
  185.   "better looking picture, while still retaining the compatibility with " 
  186.   "standard MPEG-2 decoders.")
  187. #define ENC_HQ_TEXT N_( "Quality level" )
  188. #define ENC_HQ_LONGTEXT N_( "Allows you to specify the quality level " 
  189.   "for the encoding of motions vectors (this can slow down the encoding " 
  190.   "very much)." )
  191. #define ENC_HURRYUP_TEXT N_( "Hurry up" )
  192. #define ENC_HURRYUP_LONGTEXT N_( "Allows you to specify if the encoder " 
  193.   "should make on-the-fly quality tradeoffs if your CPU can't keep up with " 
  194.   "the encoding rate. It will disable trellis quantization, then the rate " 
  195.   "distortion of motion vectors (hq), and raise the noise reduction " 
  196.   "threshold to ease the encoder's task." )
  197. #define ENC_QMIN_TEXT N_( "Minimum video quantizer scale" )
  198. #define ENC_QMIN_LONGTEXT N_( "Allows you to specify the minimum video " 
  199.   "quantizer scale." )
  200. #define ENC_QMAX_TEXT N_( "Maximum video quantizer scale" )
  201. #define ENC_QMAX_LONGTEXT N_( "Allows you to specify the maximum video " 
  202.   "quantizer scale." )
  203. #define ENC_TRELLIS_TEXT N_( "Enable trellis quantization" )
  204. #define ENC_TRELLIS_LONGTEXT N_( "Allows you to enable trellis " 
  205.   "quantization (rate distortion for block coefficients)." )
  206. #define ENC_QSCALE_TEXT N_( "Use fixed video quantizer scale" )
  207. #define ENC_QSCALE_LONGTEXT N_( "Allows you to specify a fixed video " 
  208.   "quantizer scale for VBR encoding (accepted values: 0.01 to 255.0)." )
  209. #define ENC_STRICT_TEXT N_( "Strict standard compliance" )
  210. #define ENC_STRICT_LONGTEXT N_( "Allows you to force a strict standard " 
  211.   "compliance when encoding (accepted values: -1, 0, 1)." )