XVATTR(1)

📦
version 1.3 · 4 versions
, in ubuntu noble, ubuntu resolute, ubuntu stonking

💖 NAME 💖

okay so bestie, this is xvattr — the little icon that queries and sets X11 XVideo setting(s). yes that's the whole name. short queen. 💅

✨ SYNOPSIS ✨

xvattr [options...]

so basically this program is your go-to for getting and setting X11 Xv attributes, like XV_BRIGHTNESS, XV_CONTRAST, XV_SATURATION, XV_HUE, XV_COLORKEY, ... (yes, the ... means there's more, we're not going to pretend otherwise 🦋).

for this to actually work bestie, you need a version of X11 that has the XVideo extension, and a graphics card with Xv graphics acceleration. no accel, no vibes. it's giving "no card, no party" 😭

Note: on some cards, XV_BRIGHTNESS and XV_CONTRAST are not listed among the available attributes, but they can still be set/changed. so don't panic if you don't see them in the list — they're just shy, not gone. 🫶

🎀 OPTIONS 🎀

with no options at all, all parameters are displayed. that's it, that's the default behavior, she just dumps everything. 👑

long options are handled by GNU getopts and they follow those rules. specifically:

  • options specified with a double dash (--) rather than a single dash (-) can be abbreviated as long as they're unique. so you can be lazy, but only unambiguously lazy. ✨
  • 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, all four of these are equivalent:

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

(that's the original line, wrapped and everything, no cap. four ways to say the same thing. the way that she's flexible 💅)

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

look at her go. adaptor 0, that's the Matrox G-Series Backend Scaler, on port 46, and there's XV_COLORKEY sitting pretty with its flags, min, max and current value. iconic. 🔥

  • -a, --attribute attribute name — show the value of the attribute attribute name. that's the whole thing, queen of reading.

Example:

  > xvattr -a XV_BRIGHTNESS
  XV_BRIGHTNESS = 24

just tells you the brightness. 24. noted. ⭐

  • -a, --attribute attribute name -v, --value value — set the attribute attribute name to the value value. now we're writing, not just reading. main character energy fr fr.

Example:

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

and she confirms it: XV_COLORKEY set to 10. slay. 🎀

  • -p, --port port number — get the attribute on the specified port. if -p is not set, the first available port is used. (so like, default vibes, but you can pick your fave.)

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

okay so: Found Xv 2.2, adaptor 0, SIS Video Overlay, port 66, and then the whole glow-up list — XV_COLORKEY (0 to 16777215, currently 66046), XV_BRIGHTNESS (-128 to 127, currently 0) and XV_CONTRAST (0 to 255, currently 128). full reveal, no crumbs. 💖

👑 AUTHOR 👑

Björn Englund. send bug reports to "d4bjorn@dtek.chalmers.se" — like actually send them, don't just think about it bestie 🫶

and "rocky@panix.com" turned the README into this document. thank you for your service, legend.

🌈 SEE ALSO 🌈

go look at xvinfo, and also XvQueryAdaptors, XvSetPortAttribute, and XvGetPortAttribute. the whole friend group, together. iykyk. 💜

  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

no warranty, bestie — say it with me — no warranty, without even the implied warranty of merchantability or fitness for a particular purpose. read the GPL for the details, it's long but it's iconic. 📜

and that's the whole page! this one's from perl v5.38.2 and it's dated 2024-04-01. go forth and set your XV_BRIGHTNESS, gorgeous. 🌸💅🦋

📦 where this page comes from