vo_opengl: remove most of the "inline" documentation

There's no point duplicating all the text that is already in the man
pages, and synchronizing them is a pain. Place a link to the github
generated pages instead.

Unfortunately, the anchor '#vo-opengl' does not work. Maybe github's
rst converter just sucks, as the actually generated HTML contains
links using that anchor too, but does not generate the anchor itself.
Too bad.

1 files changed, 8 insertions, 86 deletions

diff --git a/video/out/vo_opengl.c b/video/out/vo_opengl.c
index 2bc71a30e4..35ea0cebb0 100644
--- a/video/out/vo_opengl.c
+++ b/video/out/vo_opengl.c
@@ -415,7 +415,7 @@ static const char help_text[] =
 "Example: mpv --vo=opengl:scale-sep:lscale=lanczos2\n"
 "\nOptions:\n"
 "  lscale=<filter>\n"
-"    Set the scaling filter. Possible choices:\n"
+"    Set the scaling filter. Includes, but is not limited to:\n"
 "    bilinear: bilinear texture filtering (fastest).\n"
 "    bicubic_fast: bicubic filter (without lookup texture).\n"
 "    sharpen3: unsharp masking (sharpening) with radius=3.\n"
@@ -432,91 +432,13 @@ static const char help_text[] =
 "     kaiser: (defaults: 6.33 6.33)\n"
 "     sharpen3: lparam1 sets sharpening strength (default: 0.5)\n"
 "     sharpen5: as with sharpen3\n"
-"  stereo=<n>\n"
-"    0: normal display\n"
-"    1: side-by-side to red-cyan stereo\n"
-"    2: side-by-side to green-magenta stereo\n"
-"    3: side-by-side to quadbuffer stereo\n"
-"  srgb\n"
-"    Enable gamma-correct scaling by working in linear light. This\n"
-"    makes use of sRGB textures and framebuffers.\n"
-"    This option forces the options 'indirect' and 'gamma'.\n"
-"    NOTE: For YUV colorspaces, gamma 1/0.45 is assumed. RGB input is always\n"
-"    assumed to be in sRGB.\n"
-"  pbo\n"
-"    Enable use of PBOs. This is faster, but can sometimes lead to\n"
-"    sporadic and temporary image corruption.\n"
-"  dither-depth=<n>\n"
-"    Positive non-zero values select the target bit depth.\n"
-"     no:   Disable any dithering done by mpv.\n"
-"     auto: Automatic selection. If output bit depth can't be detected,\n"
-"           8 bits per component are assumed.\n"
-"     8:    Dither to 8 bit output.\n"
-"    Default: no.\n"
-"  debug\n"
-"    Check for OpenGL errors, i.e. call glGetError(). Also request a\n"
-"    debug OpenGL context.\n"
-"Less useful options:\n"
-"  swapinterval=<n>\n"
-"    Interval in displayed frames between to buffer swaps.\n"
-"    1 is equivalent to enable VSYNC, 0 to disable VSYNC.\n"
-"  no-scale-sep\n"
-"    When using a separable scale filter for luma, usually two filter\n"
-"    passes are done. This is often faster. However, it forces\n"
-"    conversion to RGB in an extra pass, so it can actually be slower\n"
-"    if used with fast filters on small screen resolutions. Using\n"
-"    this options will make rendering a single operation.\n"
-"    Note that chroma scalers are always done as 1-pass filters.\n"
 "  cscale=<n>\n"
-"    As lscale but for chroma (2x slower with little visible effect).\n"
-"    Note that with some scaling filters, upscaling is always done in\n"
-"    RGB. If chroma is not subsampled, this option is ignored, and the\n"
-"    luma scaler is used instead. Setting this option is often useless.\n"
-"  fancy-downscaling\n"
-"    When using convolution based filters, extend the filter size\n"
-"    when downscaling. Trades quality for reduced downscaling performance.\n"
-"  no-npot\n"
-"    Force use of power-of-2 texture sizes. For debugging only.\n"
-"    Borders will look discolored due to filtering.\n"
-"  glfinish\n"
-"    Call glFinish() before swapping buffers\n"
-"  backend=<sys>\n"
-"    auto: auto-select (default)\n"
-"    cocoa: Cocoa/OSX\n"
-"    win: Win32/WGL\n"
-"    x11: X11/GLX\n"
-"    wayland: Wayland/EGL\n"
-"  indirect\n"
-"    Do YUV conversion and scaling as separate passes. This will\n"
-"    first render the video into a video-sized RGB texture, and\n"
-"    draw the result on screen. The luma scaler is used to scale\n"
-"    the RGB image when rendering to screen. The chroma scaler\n"
-"    is used only on YUV conversion, and only if the video uses\n"
-"    chroma-subsampling.\n"
-"    This mechanism is disabled on RGB input.\n"
-"  fbo-format=<fmt>\n"
-"    Selects the internal format of any FBO textures used.\n"
-"    fmt can be one of: rgb, rgba, rgb8, rgb10, rgb16, rgb16f, rgb32f\n"
-"    Default: rgb.\n"
-"  gamma\n"
-"    Always enable gamma control. (Disables delayed enabling.)\n"
-"Color management:\n"
-"  icc-profile=<file>\n"
-"    Load an ICC profile and use it to transform linear RGB to\n"
-"    screen output. Needs LittleCMS2 support compiled in.\n"
-"  icc-cache=<file>\n"
-"    Store and load the 3D LUT created from the ICC profile in\n"
-"    this file. This can be used to speed up loading, since\n"
-"    LittleCMS2 can take a while to create the 3D LUT.\n"
-"    Note that this file will be up to ~100 MB big.\n"
-"  icc-intent=<value>\n"
-"    0: perceptual\n"
-"    1: relative colorimetric\n"
-"    2: saturation\n"
-"    3: absolute colorimetric (default)\n"
-"  3dlut-size=<r>x<g>x<b>\n"
-"    Size of the 3D LUT generated from the ICC profile in each\n"
-"    dimension. Default is 128x256x64.\n"
-"    Sizes must be a power of two, and 256 at most.\n"
+"    As lscale but for chroma (Much slower with little visible effect).\n"
+"    For details, refer to the man-pages (see link below).\n"
+"\n"
 "Note: all defaults mentioned are for 'opengl', not 'opengl-hq'.\n"
+"    'opengl-hq' is merely 'opengl' with different default settings applied.\n"
+"\n"
+"There are many more options. Read:\n"
+"    https://github.com/mpv-player/mpv/blob/master/DOCS/man/en/vo.rst#vo-opengl\n"
 "\n";