"Fossies" - the Fresh Open Source Software Archive  

Source code changes of the file "man/scrot.1" between
scrot-1.6.tar.bz2 and scrot-1.7.tar.bz2

About: scrot (SCReenshOT) is a simple command line screen capture utility using imlib2 to grab and save images.

scrot.1  (scrot-1.6.tar.bz2)	:	scrot.1  (scrot-1.7.tar.bz2)
scrot(1) command line screen capture utility scrot(1)		scrot(1) command line screen capture utility scrot(1)
NAME		NAME
scrot - command line screen capture utility		scrot - command line screen capture utility
SYNOPSIS		SYNOPSIS
scrot [options] [file]		scrot [-bcfhikmopsuvz] [-a X,Y,W,H] [-C NAME] [-D DISPLAY] [-d SEC] [-e C
		MD]
		[-F FILE] [-l STYLE] [-n OPTS] [-q NUM] [-S CMD] [-t NUM | GEOM] [F
		ILE]
DESCRIPTION		DESCRIPTION
scrot (SCReenshOT) is a simple command line screen capture utility t		scrot (SCReenshOT) is a simple command line screen capture utility,
hat uses imlib2 to grab and save		it uses imlib2 to grab and save
images. Multiple image formats are supported through imlib2's dynamic sav		images.
er modules.
Some features of the scrot:		scrot has many useful features:
· support to multiple image formats (JPG, PNG, GIF, etc.).		· Support for multiple image formats: JPG, PNG, GIF, and others.
· optimization of the screen shots image quality.		· The screenshot's quality is configurable.
· capture a specific window or a rectangular area on the screen w ith the help of switch.		· It is possible to capture a specific window or a rectangular ar ea on the screen.
scrot also can be used to monitor a desktop PC in admin absent and regist		Because scrot is a command line utility, it can easily be scripted and pu
er unwanted activities.		t to novel uses. For instance,
		scrot can be used to monitor an X server in absence.
		scrot is free software under the MIT-advertising license.
OPTIONS		OPTIONS
-h, --help		-a, --autoselect X,Y,W,H
Display help output and exit.		Non-interactively choose a rectangle starting at position X,Y and
		of W by H resolution.
-v, --version		-b, --border
Output version information and exit.		When selecting a window, grab the WM's border too. Use with -s to
		raise the focus of the window.
-D, --display		-C, --class NAME
Specify the display to use; see X(7).		NAME is a window class name. Associative with -k.
-a, --autoselect		-c, --count
Non-interactively choose a rectangle of x,y,w,h.		Display a countdown when used with -d.
-b, --border		-D, --display DISPLAY
When selecting a window, grab wm border too. Use with --select to		DISPLAY is the display to use; see X(7).
raise the focus of the window.
-c, --count		-d, --delay SEC
Display a countdown when used with delay.		Wait SEC seconds before taking a shot.
-d, --delay NUM		-e, --exec CMD
Wait NUM seconds before taking a shot.		Execute CMD on the saved image.
-e, --exec APP		-F, --file
Exec APP on the saved image.		File name. See SPECIAL STRINGS.
-q, --quality NUM		-f, --freeze
Image quality (1-100) high value means high size, low compression		Freeze the screen when -s is used.
. Default: 75. (Effect differs
depending on file format chosen).		-h, --help
		Display help and exit.
		-i, --ignorekeyboard
		Don't exit for keyboard input. ESC still exits.
		-k, --stack OPT
		Capture stack/overlapped windows and join them. A running Compo
		site Manager is needed. OPT it's
		optional join letter: v/h (vertical/horizontal). Default: h
		-l, --line STYLE
		STYLE indicates the style of the line when the -s option is used;
		see SELECTION STYLE.
-m, --multidisp		-m, --multidisp
For multiple heads, grab shot from each and join them together.		For multiple heads, screenshot all of them in order.
-s, --select		-n, --note OPTS
Interactively select a window or rectangle with the mouse (use th		OPTS is a collection of options which specify notes to bake into t
e arrow keys to resize). See -l		he image. See NOTE FORMAT.
and -f options.
-l, --line		-o, --overwrite
Indicates the style of the line when the -s option is used. See S		By default scrot does not overwrite the output FILE, use this opti
ELECTION STYLE.		on to enable it.
-f, --freeze		-p, --pointer
Freeze the screen when the -s option is used.		Capture the mouse pointer.
		-q, --quality NUM
		NUM must be between 1 and 100. For lossless output formats, a high
		er value represents better but
		slower compression. For lossy output formats, a higher value repr
		esents higher quality and larger
		file size. Default: 75.
		-S, --script CMD
		CMD is an imlib2 script.
		-s, --select OPT
		Interactively select a window or rectangle with the mouse, use the
		arrow keys to resize. See the
		-l and -f options. OPT it's optional; see SELECTION MODE
		-t, --thumb NUM | GEOM
		Also generate a thumbnail. The argument is the resolution of the t
		humbnail, it may be a percentage
		NUM or a resolution GEOM. Examples: 10, 25, 320x240, 500x200.
-u, --focused		-u, --focused
Use the currently focused window.		Use the currently focused window.
-t, --thumb NUM|GEOM		-v, --version
Generate thumbnail too. NUM is the percentage of the original size		Output version information and exit.
for the thumbnail to be. Alter-
natively, a GEOMetry can be specified, example: 300x200.
-z, --silent		-z, --silent
Prevent beeping.		Prevent beeping.
-p, --pointer		- Redirection to standard output. The output image format is PNG.
Capture the mouse pointer.
-o, --overwrite		SPECIAL STRINGS
By default scrot does not overwrite the files, use this option to		-e, -F and FILE parameters can take format specifiers that are expanded b
allow it.		y scrot when encountered. There
		are two types of format specifier: Characters preceded by a '%' are inte
		rpreted by strftime(2). The sec-
		ond kind are internal to scrot and are prefixed by '$'. The following spe
		cifiers are recognised by scrot:
		$$ A literal '$'.
		$a The system's hostname.
		$f The image's full path (ignored when used in the filename).
		$h The image's height.
		$m The thumbnail's full path (ignored when used in the filename).
		$n The image's basename (ignored when used in the filename).
		$p The image's pixel size.
		$s The image's size in bytes (ignored when used in the filename).
		$t The image's file format (ignored when used in the filename).
		$w The image's width.
		\n A literal newline (ignored when used in the filename).
-n, --note		Example:
Draw a text note. See NOTE FORMAT.
-k, --stack		$ scrot '%Y-%m-%d_$wx$h.png' -e 'optipng $f'
Capture stack/overlapped windows and join them together. A runnin
g Composite Manager is needed.
-C, --class NAME		This would create a PNG file with a name similar to 2000-10-30_2560x1
Window class name. Associative with options: -k.		024.png and optimize it with
		optipng(1).
-S, --script CMD		SELECTION MODE
Imlib2 script commands.		When using -s, optionally you can indicate the action to perform with t
		he selection area. Some actions
		allow optional parameters too.
SPECIAL STRINGS		capture Capture the selection area, this action is by def
Both the --exec and filename parameters can take format specifiers		ault and
that are expanded by scrot when		does not need to be specified.
encountered. There are two types of format specifier. Characters precede
d by a '%' are interpreted by
strftime(2). See man strftime for examples. These options may be used
to refer to the current date and
time. The second kind are internal to scrot and are prefixed by '$' The f
ollowing specifiers are recog-
nised:
$a hostname
$f image path/filename (ignored when used in the filename)
$m thumb image path/filename (ignored when used in the filename)
$n image name (ignored when used in the filename)
$s image size (bytes) (ignored when used in the filename)
$p image pixel size
$w image width
$h image height
$t image format (ignored when used in the filename)
$$ print a literal '$'
\n print a newline (ignored when used in the filename)
Example:		hole Highlight the selected area overshadowing the res t of the capture.
$ scrot '%Y-%m-%d_$wx$h.png' -e 'mv $f ~/shots/'		hide,IMAGE Hide the selection area by drawing an area of col
		or (or image) over it.
		Optionally indicate name of the image to use as c
		over.
		Image has priority over color.
This would create a file called something like 2000-10-30_2560x1024.png		blur,AMOUNT Blurs the selection area.
and move it to your shots direc-		Optionally you can specify the amount of blur.
tory.		Amount,range: 1..30, default: 18
SELECTION STYLE		In modes 'hole' and 'hide' the color of the area is indicated by 'color'
When using --select you can indicate the style of the line with --line.		property of the line style and
		the opacity of the color (or image) is indicated by property 'opacity', S
		ELECTION STYLE
The following specifiers are recognised:		If the 'hide' mode uses an image that does not have an alpha channe
		l, the opacity parameter will be
		ignored and it will be drawn fully opaque.
style=(solid,dash),width=(range 1 to 8),color="value",		Examples:
opacity=(range 10 to 100),mode=(edge,classic)
The default style is:		$ scrot --select=hide
		$ scrot -shole --line color="Dark Salmon",opacity=200
		$ scrot -sblur,10
		$ scrot -shide,stamp.png --line opacity=120
mode=classic,style=solid,width=1,opacity=100		SELECTION STYLE
		When using -s, you can indicate the style of the line with -l.
		-l takes a comma-separated list of specifiers as argument:
		style=STYLE STYLE is either "solid" or "dash" without quotes.
Mode 'edge' ignore: style, --freeze		width=NUM NUM is a pixel count between 1 and 8 inclusive.
Mode 'classic' ignore: opacity		color="COLOR" Color is a hexadecimal HTML color code or the name of
		a color. HTML color codes are composed of a pound
		sign '#' followed by a sequence of 3 2-digit
		hexadecimal numbers which represent red, green, and
		blue respectively. Examples: #FF0000 (red), #E0FFFF
		(light cyan), #000000 (black).
The 'opacity' specifier is only effective if a Composite Manager is runni		opacity=NUM NUM is between 0 and 255 inclusive. 255 means
ng.		100% opaque, 0 means 100% transparent. For the
		opacity of the line this is only effective if a
		Composite Manager is running.
For the color you can use a name or a hexadecimal value.		mode=MODE MODE is either "edge" or "classic" without quotes.
		edge is the new selection, classic uses the old one.
		"edge" ignores the style specifier and the -f flag,
		"classic" ignores the opacity specifier.
color="red" or color="#ff0000"		Without the -l option, a default style is used:
		mode=classic,style=solid,width=1,opacity=100
Example:		Example:
$ scrot --line style=dash,width=3,color="red" --select		$ scrot -l style=dash,width=3,color="red" -s
NOTE FORMAT		NOTE FORMAT
The following specifiers are recognised for the option --note:		The -n option's argument is more arguments:
-f 'FontName/size'		-f 'FontName/size'
-t 'text'		-t 'text'
-x position (optional)		-x position (optional)
-y position (optional)		-y position (optional)
-c color(RGBA) (optional)		-c color(RGBA, range 0..255) (optional)
-a angle (optional)		-a angle (optional)
Example:		Example:
$ scrot --note "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10 -y		$ scrot -n "-f '/usr/share/fonts/TTF/DroidSans-Bold/40' -x 10
20 -c 255,0,0,255 -t 'Hi'"		-y 20 -c 255,0,0,255 -t 'Hi'"
AUTHOR		AUTHOR
scrot was originally developed by Tom Gilbert under MIT-advertising licen		scrot was originally developed by Tom Gilbert.
se and is maintained by some
people.
Currently, source code and newer versions are available at https://gith		Currently, source code is maintained by volunteers. Newer
ub.com/resurrecting-open-source-		versions are available at
projects/scrot		https://github.com/resurrecting-open-source-projects/scrot
scrot-1.6 25 Jul 2021 scrot(1)		scrot-1.7 09 Nov 2021 scrot(1)
End of changes. 48 change blocks.
116 lines changed or deleted		173 lines changed or added

---