xvattr - Query/Set X11 XVideo Setting(s)

xvattr [options...]

This program is used for getting and setting X11 Xv attributes such as XV_BRIGHTNESS, XV_CONTRAST, XV_SATURATION, XV_HUE, XV_COLORKEY, ...

For this program to work, you must have a version of X11 with the XVideo extension and a graphics card that has Xv graphics acceleration.

Note: On some cards XV_BRIGHTNESS and XV_CONTRAST are not listed among the available attributes, but they can still be set/changed.

With no options, all parameters are displayed.

Long options are handled by GNU getopts and follow those rules. In particular, options that are specified with a double dash (--) rather than a single dash (-), can be abbreviated as long as they are unique. Long parameters that need a value specified may have the parameter and the value separated with blank space or an optional equals sign (and no intervening space).

For example the following are all equivalent:

xvattr -a XV_BRIGHTNESS xvattr --attribute XV_BRIGHTNESS xvattr --att XV_BRIGHTNESS xvattr --att=XV_BRIGHTNESS

Example:

  > xvattr
  Adaptor: 0
  Name: Matrox G-Series Backend Scaler
   Port: 46
    Name: XV_COLORKEY
     Flags: XvGettable XvSettable 
     Min value: 0
     Max value: 16777215
     Current value: 66046

{-a | --attribute} attribute name

Show value of attribute attribute name Example:

  > xvattr -a XV_BRIGHTNESS
  XV_BRIGHTNESS = 24

{-a | --attribute} attribute name [-v | --value] value

Set attribute attribute name to value value. Example:

  > xvattr -a XV_COLORKEY -v 10
  XV_COLORKEY set to 10

{-p | --port} port number

Get the attribute on the specified port. If -p is not set, the first available port is used. Example:

  > xvattr -p 66
  Found Xv 2.2
  Adaptor: 0
  Name: SIS Video Overlay
   Port: 66
    Name: XV_COLORKEY
     Flags: XvGettable XvSettable 
     Min value: 0
     Max value: 16777215
     Current value: 66046
    Name: XV_BRIGHTNESS
     Flags: XvGettable XvSettable 
     Min value: -128
     Max value: 127
     Current value: 0
    Name: XV_CONTRAST
     Flags: XvGettable XvSettable 
     Min value: 0
     Max value: 255
     Current value: 128

Björn Englund. Send bug reports to CWd4bjorn@dtek.chalmers.se CWrocky@panix.com turned the README into this document.

See also xvinfo and XvQueryAdaptors, XvSetPortAttribute, and XvGetPortAttribute.

  Copyright (C) 2001-2002 Björn Englund

  This program 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.

  This program 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., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA