Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
SLOP(1)				 slop man page			       SLOP(1)

NAME
       slop - select operation,	either mark screen region or pick window

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.  Set-
	      ting  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  in-
	      put.  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 (x
	      offset), %y (y offset), %w (width), %h (height), %i (window id),
	      %c (1 if cancelled, 0 otherwise),	%g (geometry - `%wx%h+%x+%y'),
	      and %% for a literal percent sign.

       -n, --nodecorations=INT
	      Sets the level of	aggressiveness when trying  to	remove	window
	      decorations.  `0'	is off,	`1' will try lightly to	remove decora-
	      tions, and `2' will recursively descend into the root tree until
	      it gets the deepest available visible child under	the mouse. De-
	      faults to	`0'. Supplying slop with just `-n`  is	equivalent  to
	      supplying	`-n1`.

       -l, --highlight
	      Instead  of  outlining  a	 selection, slop will highlight	it in-
	      stead. This is particularly useful if the	color  is  set	to  an
	      opacity lower than 1.

       -D, --nodrag
	      Allows  you  to click twice to indicate a	selection, rather than
	      click-dragging.

       -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 ren-
	      dering 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")

SEE ALSO
       maim(1)

BUGS
       No known	bugs.

AUTHOR
       Dalton Nell (naelstrof@gmail.com)

Linux				  2021-02-03			       SLOP(1)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=slop&sektion=1&manpath=FreeBSD+Ports+15.0.quarterly>

home | help