From 6117a87ef86c1ae4fe889fd8872d86e6cb48fa76 Mon Sep 17 00:00:00 2001 From: diego Date: Thu, 29 Aug 2002 00:47:22 +0000 Subject: [PATCH] Plugin descriptions were moved to the man page. git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@7130 b3059339-0415-0410-9bf9-f77b7e298cf2 --- DOCS/documentation.html | 246 +--------------------------------------- 1 file changed, 1 insertion(+), 245 deletions(-) diff --git a/DOCS/documentation.html b/DOCS/documentation.html index 2e93295eec..bb6cf724a1 100644 --- a/DOCS/documentation.html +++ b/DOCS/documentation.html @@ -202,25 +202,6 @@
  • 2.5.4 Examples
    • -
  • 2.6 Video filters - -
  • 3. Usage @@ -602,7 +583,7 @@

    Non-YUV cards

    Fullscreen playing can be achieved by either enabling software scaling - (use the -zoom or -vop scale + (use the -zoom or -vop scale option, but I warn you: this is slow), or switching to a small resolution video mode, for example 352x288. If you don't have YUV acceleration, the latter method is recommended. Video mode switching can be enabled by @@ -1061,231 +1042,6 @@ TV tuner.

        mplayer -tv on:noaudio:driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv

    -

    2.6 Video filters

    - -

    Both MPlayer and MEncoder support using a universal - video filter layer, which comprises numerous plugins that are listed and - explained below. These plugins can perform various actions on the image, - such as rescaling, cropping black borders (useful not only for encoding but - for playback, too, since black borders increase bus usage and cropping these - can boost playback speed on slow boards) and expanding the image (for SVCDs).

    - -

    With this filter layer it's possible to perform fast image format conversion - between the various RGB and YUV formats when necessary. This enables for - example playing RGB data on xv and xmga video output - drivers among other things (see the Scale filter).

    - -

    The filter layer also does Direct Rendering between the plugins, to - maximize the speed. - -

    Note that the postprocessing code is now also a part of the layer. It - will be explained below.

    - - -

    2.6.1 Usage

    - -

      mplayer/mencoder -vop filter1,filter2,filter3,... -

    - -

    This sets up a filter pipeline (you can use any number of filters). Their - parameters are optional and if omitted, some of them are set to default - values, e.g. x and y are both set to the center of - the screen and width and height will be set to - the width and height of the movie.

    - -

    Filters are queued starting from libvo, so filter1 will be the - last filter called (after that comes libvo, or when using MEncoder, - encoding).

    - -

    You can get the list of available video filters with the command

    - -

      mplayer -vop help

    - - -

    2.6.2 Crop

    - -

    Description:

    - -

    Crops the given part of the image and discards the rest. Useful for removing - black bands from widescreen movies.

    - -

    Usage:

    - -

      -vop crop[=width:height:x:y]

    - - -

    2.6.3 Expand

    - -

    Description:

    - -

    Expands (not scales) movie resolution to the given value and places - the unscaled original at coordinates x y. For movies - not containing black bands, this can be used to add them. This is good when - creating SVCDs or for placing subtitles or the OSD in these bands.

    - -

    Usage:

    - -

      -vop expand[=width:height:x:y]

    - - -

    2.6.4 Fame/Lavc

    - -

    Description:

    - -

    Realtime MPEG1 encoder (using libfame or libavcodec) (for use with - DVB/DXR3).

    - -

    Usage:

    - -

      -vop fame

    - -

      -vop lavc

    - - -

    2.6.5 Flip

    - -

    Description:

    - -

    Simply flips the image upside down. Useful for some old codecs which can only - output a flipped image (these are autodetected).

    - -

    Usage:

    - -

      -vop flip

    - - -

    2.6.6 Format

    - -

    Description:

    - -

    This filter is not an image format converter. It just forces the next - filter (or libvo) to use the given format. Useful for cards with slow YV12, - like tdfx and Savage4. For real conversion, use the scale filter.

    - -

    Usage:

    - -

      -vop format[=format] (where - format can be for example: rgb32, yuy2, etc...)

    - - -

    2.6.7 Postprocess

    - -

    Description:

    - -

    This is our good old postprocess, just converted to the filter layer. - Performs image quality enhancement, deinterlacing, etc, see - -npp help for available options.

    - -

    Usage:

    - -

      -vop pp[=postprocess options/keywords]

    - - -

    2.6.8 RGB2BGR

    - -

    Description:

    - -

    Performs RGB 24/32 <-> BGR 24/32 colorspace conversion (default behavior) - or RGB 24/32 <-> RGB 24/32 conversion with R <-> B swapping (with the 'swap' - option).

    - -

    Usage:

    - -

      -vop rgb2bgr[=swap]

    - - -

    2.6.9 Rotate

    - -

    Description:

    - -

    Rotates (flips) the image. The parameter x (values: 0-3) - controls horizontal and vertical mirroring.

    - -

    Usage:

    - -

      -vop rotate[=x]

    - - -

    2.6.10 Scale

    - -

    Description:

    - -

    Scales the image with the software scaler (slow). You can adjust the - quality of the scaler with the -sws option, see the man page. - Nice quality implies speed loss.

    - -

    Note: Calling this filter with no options means colorspace - conversion! This is useful for codecs which can't output in the needed - format for the specified video output device. These are hopefully - autodetected and scale filter is called to convert. In other cases, you - can use it manually.

    - -

    Usage:

    - -

      -vop scale[=width:height]

    - - -

    2.6.11 YUY2

    - -

    Description:

    - -

    Forced software YV12/I420 to YUY2 conversion.

    - -

    Usage:

    - -

      -vop yuy2

    - - -

    2.6.12 Mirror

    - -

    Description:

    - -

    Flips the image on Y axis.

    - -

    Usage:

    - -

      -vop mirror

    - - -

    2.6.13 DVBscale

    - -

    Description:

    - -

    Calculates Y scaling for DVB card.

    - -

    Usage:

    - -

      -vop dvbscale

    - - -

    2.6.14 Cropdetect

    - -

    Description:

    - -

    Calculates necessary cropping parameters. It will print the recommended - -vop crop parameters to stdout. You can adjust the threshold of - what is detected as border and what as picture with the limit - parameter. limit is a number from 0 to 255 that defaults to 24. - At 0 it detects everything as picture, at 255 everything as border.

    - -

    Usage:

    - -

      -vop cropdetect[=limit]

    - - -

    2.6.15 Rectangle

    - -

    Description:

    - -

    Draws a rectangle of the requested width and height at the designated - coordinates over the image. Useful to get visual feedback for the parameters - of -vop crop before applying them.

    - -

    Usage:

    - -

      -vop rectangle[=width:height:x:y]

    - -

    3. Usage