[FFmpeg-cvslog] doc: add libswscale.texi and ffmpeg-scaler.texi files

[Stefano Sabatini]

ffmpeg | branch: master | Stefano Sabatini <stefasab at gmail.com> | Tue Nov 13 23:49:09 2012 +0100| [cf6c6134cd61e5ef19932cdba6cb00c1d89d554e] | committer: Stefano Sabatini

doc: add libswscale.texi and ffmpeg-scaler.texi files

> http://git.videolan.org/gitweb.cgi/ffmpeg.git/?a=commit;h=cf6c6134cd61e5ef19932cdba6cb00c1d89d554e
---

 doc/Makefile           |    3 +-
 doc/ffmpeg-scaler.texi |  136 ++++++++++++++++++++++++++++++++++++++++++++++++
 doc/libswscale.texi    |   55 ++++++++++++++++++++
 3 files changed, 193 insertions(+), 1 deletion(-)

diff --git a/doc/Makefile b/doc/Makefile
index afe361f..85ca978 100644
--- a/doc/Makefile
+++ b/doc/Makefile
@@ -1,9 +1,10 @@
 DOCLIBS-$(CONFIG_AVUTIL)  += libavutil
+DOCLIBS-$(CONFIG_SWSCALE) += libswscale
 DOCLIBS-$(CONFIG_SWRESAMPLE) += libswresample
 DOCLIBS-$(CONFIG_AVCODEC) += libavcodec
 DOCLIBS-$(CONFIG_AVFILTER) += libavfilter
 
-COMPONENTS=$(PROGS-yes) ffmpeg-codecs ffmpeg-filters ffmpeg-resampler
+COMPONENTS=$(PROGS-yes) ffmpeg-codecs ffmpeg-filters ffmpeg-resampler ffmpeg-scaler
 
 MANPAGES    = $(COMPONENTS:%=doc/%.1)    $(DOCLIBS-yes:%=doc/%.3)
 PODPAGES    = $(COMPONENTS:%=doc/%.pod)  $(DOCLIBS-yes:%=doc/%.pod)
diff --git a/doc/ffmpeg-scaler.texi b/doc/ffmpeg-scaler.texi
new file mode 100644
index 0000000..2d1bc95
--- /dev/null
+++ b/doc/ffmpeg-scaler.texi
@@ -0,0 +1,136 @@
+\input texinfo @c -*- texinfo -*-
+
+ at settitle FFmpeg Scaler Documentation
+ at titlepage
+ at center @titlefont{FFmpeg Scaler Documentation}
+ at end titlepage
+
+ at top
+
+ at contents
+
+ at chapter Description
+ at c man begin DESCRIPTION
+
+The FFmpeg rescaler provides an high-level interface to the libswscale
+library image conversion utilities. In particular it allows to perform
+image rescaling and pixel format conversion.
+
+ at c man end DESCRIPTION
+
+ at chapter Scaler Options
+ at c man begin SCALER OPTIONS
+
+The video scaler supports the following named options.
+
+Options may be set by specifying - at var{option} @var{value} in the
+FFmpeg tools. For programmatic use, they can be set explicitly in the
+ at code{SwsContext} options or through the @file{libavutil/opt.h} API.
+
+ at table @option
+
+ at item sws_flags
+Set the scaler flags. This is also used to set the scaling
+algorithm. Only a single algorithm should be selected.
+
+It accepts the following values:
+ at table @samp
+ at item fast_bilinear
+Select fast bilinear scaling algorithm.
+
+ at item bilinear
+Select bilinear scaling algorithm.
+
+ at item bicubic
+Select bicubic scaling algorithm.
+
+ at item experimental
+Select experimental scaling algorithm.
+
+ at item neighbor
+Select nearest neighbor rescaling algorithm.
+
+ at item area
+Select averaging area rescaling algorithm.
+
+ at item bicubiclin
+Select bicubic scaling algorithm for the luma component, bilinear for
+chroma components.
+
+ at item gauss
+Select Gaussian rescaling algorithm.
+
+ at item sinc
+Select sinc rescaling algorithm.
+
+ at item lanczos
+Select lanczos rescaling algorithm.
+
+ at item spline
+Select natural bicubic spline rescaling algorithm.
+
+ at item print_info
+Enable printing/debug logging.
+
+ at item accurate_rnd
+Enable accurate rounding.
+
+ at item full_chroma_int
+Enable full chroma interpolation.
+
+ at item full_chroma_inp
+Select full chroma input.
+
+ at item bitexact
+Enable bitexact output.
+ at end table
+
+ at item srcw
+Set source width.
+
+ at item srch
+Set source height.
+
+ at item dstw
+Set destination width.
+
+ at item dsth
+Set destination height.
+
+ at item src_format
+Set source pixel format (must be expressed as an integer).
+
+ at item dst_format
+Set destination pixel format (must be expressed as an integer).
+
+ at item src_range
+Select source range.
+
+ at item dst_range
+Select destination range.
+
+ at item param0, param1
+Set scaling algorithm parameters. The specified values are specific of
+some scaling algorithms and ignored by others. The specified values
+are floating point number values.
+
+ at end table
+
+ at c man end SCALER OPTIONS
+
+ at ignore
+
+ at setfilename ffmpeg-scaler
+ at settitle FFmpeg video scaling and pixel format converter
+
+ at c man begin SEEALSO
+ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1), libswscale(3)
+ at c man end
+
+ at c man begin AUTHORS
+See Git history (git://source.ffmpeg.org/ffmpeg)
+ at c man end
+
+ at end ignore
+
+ at bye
diff --git a/doc/libswscale.texi b/doc/libswscale.texi
new file mode 100644
index 0000000..a8c08e6
--- /dev/null
+++ b/doc/libswscale.texi
@@ -0,0 +1,55 @@
+\input texinfo @c -*- texinfo -*-
+
+ at settitle Libswscale Documentation
+ at titlepage
+ at center @titlefont{Libswscale Documentation}
+ at end titlepage
+
+ at top
+
+ at contents
+
+ at chapter Description
+ at c man begin DESCRIPTION
+
+The libswscale library performs highly optimized image scaling and
+colorspace and pixel format conversion operations.
+
+Specifically, this library performs the following conversions:
+
+ at itemize
+ at item
+ at emph{Rescaling}: is the process of changing the video size. Several
+rescaling options and algorithms are available. This is usually a
+lossy process.
+
+ at item
+ at emph{Pixel format conversion}: is the process of converting the image
+format and colorspace of the image, for example from planar YUV420P to
+RGB24 packed. It also handles packing conversion, that is converts
+from packed layout (all pixels belonging to distinct planes
+interleaved in the same buffer), to planar layout (all samples
+belonging to the same plane stored in a dedicated buffer or "plane").
+
+This is usually a lossy process in case the source and destination
+colorspaces differ.
+ at end itemize
+
+ at c man end DESCRIPTION
+
+ at ignore
+
+ at setfilename libswscale
+ at settitle video scaling and pixel format conversion library
+
+ at c man begin SEEALSO
+ffmpeg(1), ffplay(1), ffprobe(1), ffserver(1), ffmpeg-scaler(1), libavutil(3)
+ at c man end
+
+ at c man begin AUTHORS
+See Git history (git://source.ffmpeg.org/ffmpeg)
+ at c man end
+
+ at end ignore
+
+ at bye