xv_common.h

Go to the documentation of this file.

/*
 * Copyright (C) 2008-2017 the xine project
 *
 * This file is part of xine, a free video player.
 *
 * xine is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 *
 * xine is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110, USA
 *
 * xv_common.h: X11 Xv common bits
 */

#include <xine/video_out.h>

#define VIDEO_DEVICE_XV_COLORKEY_HELP \
        _("video overlay colour key"), \
        _("The colour key is used to tell the graphics card where to " \
          "overlay the video image. Try different values, if you "\
          "experience windows becoming transparent.")

#define VIDEO_DEVICE_XV_AUTOPAINT_COLORKEY_HELP \
        _("autopaint colour key"), \
        _("Make Xv autopaint its colour key.")

#define VIDEO_DEVICE_XV_FILTER_HELP \
        _("bilinear scaling mode"), \
        _("Selects the bilinear scaling mode for Permedia cards. " \
          "The individual values are:\n\n" \
          "Permedia 2\n" \
          "0 - disable bilinear filtering\n" \
          "1 - enable bilinear filtering\n\n" \
          "Permedia 3\n" \
          "0 - disable bilinear filtering\n" \
          "1 - horizontal linear filtering\n" \
          "2 - enable full bilinear filtering")

#define VIDEO_DEVICE_XV_DOUBLE_BUFFER_HELP \
        _("enable double buffering"), \
        _("Double buffering will synchronize the update of the video " \
          "image to the repainting of the entire screen (\"vertical " \
          "retrace\"). This eliminates flickering and tearing artifacts, " \
          "but will use more graphics memory.")

#define VIDEO_DEVICE_XV_PORT_HELP \
        _("Xv port number"), \
        _("Selects the Xv port number to use (0 to autodetect).")

#define VIDEO_DEVICE_XV_PITCH_ALIGNMENT_HELP \
        _("pitch alignment workaround"), \
        _("Some buggy video drivers need a workaround to function properly.")

#define VIDEO_DEVICE_XV_DECL_SYNC_ATOMS \
        static const char *const sync_atoms[] = \
                { "XV_SYNC_TO_VBLANK", "XV_VSYNC" };

#define VIDEO_DEVICE_XV_DECL_PREFER_TYPES \
        typedef enum { \
          xv_prefer_none, xv_prefer_overlay, xv_prefer_textured, xv_prefer_blitter, \
        } xv_prefertype; \
        static const char *const prefer_labels[] = \
                { "Any", "Overlay", "Textured Video", "Blitter", NULL }; \
        static const char prefer_substrings[][8] = \
                { "", "Overlay", "Texture", "Blitter" };
#define VIDEO_DEVICE_XV_PREFER_TYPE_HELP \
        _("video display method preference"), \
        _("Selects which video output method is preferred. " \
          "Detection is done using the reported Xv adaptor names.\n" \
          "(Only applies when auto-detecting which Xv port to use.)")

#define VIDEO_DEVICE_XV_DECL_BICUBIC_TYPES \
        static const char *const bicubic_types[] = { "Off", "On", "Auto", NULL };
#define VIDEO_DEVICE_XV_BICUBIC_HELP \
        _("bicubic filtering"), \
        _("This option controls bicubic filtering of the video image. " \
          "It may be used instead of, or as well as, xine's deinterlacers.")

#ifdef XV_PROPS

/* port attributes that dont map to a standard vo prop */
typedef enum {
  XV_PROP_ITURBT_709 = VO_NUM_PROPERTIES,
  XV_PROP_COLORSPACE,
  XV_PROP_COLORKEY,
  XV_PROP_AUTOPAINT_COLORKEY,
  XV_PROP_FILTER,
  XV_PROP_DOUBLE_BUFFER,
  XV_PROP_SYNC_TO_VBLANK,
  XV_PROP_BICUBIC,
  XV_NUM_PROPERTIES
} xv_prop_enum_t;

typedef struct {
  const char *name;
  int         index;
  int         caps;
} xv_prop_list_t;

static const xv_prop_list_t xv_props_list[] = {
  { "XV_HUE",                VO_PROP_HUE,                 VO_CAP_HUE                },
  { "XV_SATURATION",         VO_PROP_SATURATION,          VO_CAP_SATURATION         },
  { "XV_BRIGHTNESS",         VO_PROP_BRIGHTNESS,          VO_CAP_BRIGHTNESS         },
  { "XV_CONTRAST",           VO_PROP_CONTRAST,            VO_CAP_CONTRAST           },
  { "XV_GAMMA",              VO_PROP_GAMMA,               VO_CAP_GAMMA              },
  { "XV_ITURBT_709",         XV_PROP_ITURBT_709,          VO_CAP_COLOR_MATRIX       },
  { "XV_COLORSPACE",         XV_PROP_COLORSPACE,          VO_CAP_COLOR_MATRIX       },
  { "XV_COLORKEY",           XV_PROP_COLORKEY,            VO_CAP_COLORKEY           },
  { "XV_AUTOPAINT_COLORKEY", XV_PROP_AUTOPAINT_COLORKEY,  VO_CAP_AUTOPAINT_COLORKEY },
  { "XV_FILTER",             XV_PROP_FILTER,              0                         },
  { "XV_DOUBLE_BUFFER",      XV_PROP_DOUBLE_BUFFER,       0                         },
  { "XV_SYNC_TO_VBLANK",     XV_PROP_SYNC_TO_VBLANK,      0                         },
  { "XV_VSYNC",              XV_PROP_SYNC_TO_VBLANK,      0                         },
  { "XV_BICUBIC",            XV_PROP_BICUBIC,             0                         }
};

static const xv_prop_list_t *xv_find_prop (const char *name) {
  int i;
  for (i = 0; i < sizeof (xv_props_list) / sizeof (xv_prop_list_t); i++) {
    if (!strcmp (name, xv_props_list[i].name))
      return &xv_props_list[i];
  }
  return NULL;
}

#endif /* XV_PROPS */