12:26pm 04-13-2024
pols
slop - select operation
SYNOPSIS
slop [-klqn] [OPTIONS]
DESCRIPTION
slop is an application that queries for a selection from the user and prints the region to
stdout. It grabs the mouse and turns it into a crosshair, lets the user click and drag to
make a selection (or click on a window) while drawing a pretty box around it, then finally
prints the selection's dimensions to stdout.
OPTIONS
-h, --help
Print help and exit.
-v, --version
Print version and exit.
-x, --xdisplay=hostname:number.screen_number
Sets the xdisplay to use.
-b, --bordersize=FLOAT
Sets the selection rectangle's thickness.
-p, --padding=FLOAT
Sets the padding size for the selection, this can be negative.
-t, --tolerance=FLOAT
How far in pixels the mouse can move after clicking, and still be detected as a
normal click instead of a click-and-drag. Setting this to 0 will disable window
selections. Alternatively setting it to 9999999 would force a window selection.
-c, --color=FLOAT,FLOAT,FLOAT,FLOAT
Sets the selection rectangle's color. Supports RGB or RGBA input. Depending on the
system's window manager/OpenGL support, the opacity may be ignored.
-r, --shader=STRING
This sets the vertex shader, and fragment shader combo to use when drawing the
final framebuffer to the screen. This obviously only works when OpenGL is enabled.
The shaders are loaded from ~/.config/slop. See https://github.com/naelstrof/slop
for more information on how to create your own shaders.
-f, --format=STRING
Sets the output format for slop. Format specifiers are %x, %y, %w, %h, %i, %c, and
%g. If actual percentage signs are desired in output, use a double percentage sign
like so `%%`.
-n, --nodecorations=INT
Sets the level of aggressiveness when trying to remove window decroations. `0' is
off, `1' will try lightly to remove decorations, and `2' will recursively descend
into the root tree until it gets the deepest available visible child under the
mouse. Defaults to `0'. Supplying slop with just `-n` is equivalent to supplying
`-n1`.
-l, --highlight
Instead of outlining a selection, slop will highlight it instead. This is
particularly useful if the color is set to an opacity lower than 1.
-q, --quiet
Disable any unnecessary cerr output. Any warnings simply won't print.
-k, --nokeyboard
Disables the ability to cancel selections with the keyboard.
-o, --noopengl
Disables graphics acceleration. Might be useful if you get rendering bugs.
EXAMPLES
To emulate a windows XP selection, you can use something like this:
slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4
In order to avoid using eval(1) in your scripts (pretty big security issue), you can use
slop like this instead:
read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i"
