scaler.texi 3.2 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149
  1. @anchor{scaler_options}
  2. @chapter Scaler Options
  3. @c man begin SCALER OPTIONS
  4. The video scaler supports the following named options.
  5. Options may be set by specifying -@var{option} @var{value} in the
  6. FFmpeg tools, with a few API-only exceptions noted below.
  7. For programmatic use, they can be set explicitly in the
  8. @code{SwsContext} options or through the @file{libavutil/opt.h} API.
  9. @table @option
  10. @anchor{sws_flags}
  11. @item sws_flags
  12. Set the scaler flags. This is also used to set the scaling
  13. algorithm. Only a single algorithm should be selected. Default
  14. value is @samp{bicubic}.
  15. It accepts the following values:
  16. @table @samp
  17. @item fast_bilinear
  18. Select fast bilinear scaling algorithm.
  19. @item bilinear
  20. Select bilinear scaling algorithm.
  21. @item bicubic
  22. Select bicubic scaling algorithm.
  23. @item experimental
  24. Select experimental scaling algorithm.
  25. @item neighbor
  26. Select nearest neighbor rescaling algorithm.
  27. @item area
  28. Select averaging area rescaling algorithm.
  29. @item bicublin
  30. Select bicubic scaling algorithm for the luma component, bilinear for
  31. chroma components.
  32. @item gauss
  33. Select Gaussian rescaling algorithm.
  34. @item sinc
  35. Select sinc rescaling algorithm.
  36. @item lanczos
  37. Select Lanczos rescaling algorithm. The default width (alpha) is 3 and can be
  38. changed by setting @code{param0}.
  39. @item spline
  40. Select natural bicubic spline rescaling algorithm.
  41. @item print_info
  42. Enable printing/debug logging.
  43. @item accurate_rnd
  44. Enable accurate rounding.
  45. @item full_chroma_int
  46. Enable full chroma interpolation.
  47. @item full_chroma_inp
  48. Select full chroma input.
  49. @item bitexact
  50. Enable bitexact output.
  51. @end table
  52. @item srcw @var{(API only)}
  53. Set source width.
  54. @item srch @var{(API only)}
  55. Set source height.
  56. @item dstw @var{(API only)}
  57. Set destination width.
  58. @item dsth @var{(API only)}
  59. Set destination height.
  60. @item src_format @var{(API only)}
  61. Set source pixel format (must be expressed as an integer).
  62. @item dst_format @var{(API only)}
  63. Set destination pixel format (must be expressed as an integer).
  64. @item src_range @var{(boolean)}
  65. If value is set to @code{1}, indicates source is full range. Default value is
  66. @code{0}, which indicates source is limited range.
  67. @item dst_range @var{(boolean)}
  68. If value is set to @code{1}, enable full range for destination. Default value
  69. is @code{0}, which enables limited range.
  70. @anchor{sws_params}
  71. @item param0, param1
  72. Set scaling algorithm parameters. The specified values are specific of
  73. some scaling algorithms and ignored by others. The specified values
  74. are floating point number values.
  75. @item sws_dither
  76. Set the dithering algorithm. Accepts one of the following
  77. values. Default value is @samp{auto}.
  78. @table @samp
  79. @item auto
  80. automatic choice
  81. @item none
  82. no dithering
  83. @item bayer
  84. bayer dither
  85. @item ed
  86. error diffusion dither
  87. @item a_dither
  88. arithmetic dither, based using addition
  89. @item x_dither
  90. arithmetic dither, based using xor (more random/less apparent patterning that
  91. a_dither).
  92. @end table
  93. @item alphablend
  94. Set the alpha blending to use when the input has alpha but the output does not.
  95. Default value is @samp{none}.
  96. @table @samp
  97. @item uniform_color
  98. Blend onto a uniform background color
  99. @item checkerboard
  100. Blend onto a checkerboard
  101. @item none
  102. No blending
  103. @end table
  104. @end table
  105. @c man end SCALER OPTIONS