slop(1) - f33

1SLOP(1)                          slop man page                         SLOP(1)
2
3
4

NAME

6       slop - select operation
7

SYNOPSIS

9       slop [-klqn] [OPTIONS]
10

DESCRIPTION

12       slop  is  an application that queries for a selection from the user and
13       prints the region to stdout. It grabs the mouse and  turns  it  into  a
14       crosshair,  lets  the user click and drag to make a selection (or click
15       on a window) while drawing a pretty box around it, then finally  prints
16       the selection's dimensions to stdout.
17

OPTIONS

19       -h, --help
20              Print help and exit.
21
22       -v, --version
23              Print version and exit.
24
25       -x, --xdisplay=hostname:number.screen_number
26              Sets the xdisplay to use.
27
28       -b, --bordersize=FLOAT
29              Sets the selection rectangle's thickness.
30
31       -p, --padding=FLOAT
32              Sets the padding size for the selection, this can be negative.
33
34       -t, --tolerance=FLOAT
35              How  far  in pixels the mouse can move after clicking, and still
36              be detected as a normal click instead of a click-and-drag.  Set‐
37              ting  this  to  0  will disable window selections. Alternatively
38              setting it to 9999999 would force a window selection.
39
40       -c, --color=FLOAT,FLOAT,FLOAT,FLOAT
41              Sets the selection  rectangle's  color.  Supports  RGB  or  RGBA
42              input.  Depending on the system's window manager/OpenGL support,
43              the opacity may be ignored.
44
45       -r, --shader=STRING
46              This sets the vertex shader, and fragment shader  combo  to  use
47              when drawing the final framebuffer to the screen. This obviously
48              only works when OpenGL is enabled. The shaders are  loaded  from
49              ~/.config/slop.  See  https://github.com/naelstrof/slop for more
50              information on how to create your own shaders.
51
52       -f, --format=STRING
53              Sets the output format for slop. Format  specifiers  are  %x  (x
54              offset), %y (y offset), %w (width), %h (height), %i (window id),
55              %c (1 if cancelled, 0 otherwise), %g (geometry - `%wx%h+%x+%y'),
56              and %% for a literal percent sign.
57
58       -n, --nodecorations=INT
59              Sets  the  level  of aggressiveness when trying to remove window
60              decorations. `0' is off, `1' will try lightly to remove  decora‐
61              tions, and `2' will recursively descend into the root tree until
62              it gets the deepest available visible  child  under  the  mouse.
63              Defaults  to `0'. Supplying slop with just `-n` is equivalent to
64              supplying `-n1`.
65
66       -l, --highlight
67              Instead  of  outlining  a  selection,  slop  will  highlight  it
68              instead.  This  is particularly useful if the color is set to an
69              opacity lower than 1.
70
71       -q, --quiet
72              Disable any unnecessary cerr output. Any warnings  simply  won't
73              print.
74
75       -k, --nokeyboard
76              Disables the ability to cancel selections with the keyboard.
77
78       -o, --noopengl
79              Disables  graphics acceleration. Might be useful if you get ren‐
80              dering bugs.
81

EXAMPLES

83       To emulate a windows XP selection, you can use something like this:
84
85              slop --highlight --tolerance=0 --color=0.3,0.4,0.6,0.4
86
87       In order to avoid using eval(1) in your scripts  (pretty  big  security
88       issue), you can use slop like this instead:
89
90              read -r X Y W H G ID < <(slop -f "%x %y %w %h %g %i")
91

BUGS

96       No known bugs.
97

AUTHOR

99       Dalton Nell (naelstrof@gmail.com)
100
101
102
103Linux                             2017-03-21                           SLOP(1)