415b6d08be
- remove -c abbrv. for --vips-concurrency - better desc for insert - revise vips.1 man page
77 lines
2.2 KiB
Groff
77 lines
2.2 KiB
Groff
.TH VIPS 1 "30 June 1993"
|
|
.SH NAME
|
|
vips \- run vips operations from the command line
|
|
.SH SYNOPSIS
|
|
.B vips [options] [command] [command-options] [command-args]
|
|
.SH DESCRIPTION
|
|
.B vips(1)
|
|
is the VIPS universal main program. You can use it to run any VIPS operation
|
|
from the command line, to query the VIPS class hierarchy, and to
|
|
maintain parts of the VIPS library.
|
|
|
|
To run a VIPS function, the first argument should be the name of the function
|
|
and following arguments should be the function parameters. For example:
|
|
|
|
$ vips invert lena.v lena2.v
|
|
|
|
.SH OPTIONS
|
|
.TP
|
|
.B -p PLUGIN, --plugin=PLUGIN
|
|
Load PLUGIN. Note that plugins in $VIPSHOME/lib are loaded automatically.
|
|
|
|
.TP
|
|
.B -v, --version
|
|
Show VIPS version.
|
|
|
|
.SH COMMANDS
|
|
|
|
.TP
|
|
.B list PACKAGE
|
|
List operations defined in PACKAGE. PACKAGE can also be "classes", "packages"
|
|
or "all".
|
|
|
|
.TP
|
|
.B cpph PACKAGE
|
|
Print C++ header for PACKAGE. PACKAGE can also be a function name, or "all".
|
|
|
|
.TP
|
|
.B cppc PACKAGE
|
|
Print C++ binding for PACKAGE. PACKAGE can also be a function name, or "all".
|
|
|
|
.TP
|
|
.B operation-name operation-arguments
|
|
Execute a named operation, for example im_invert, or add. Names prefixed with
|
|
"im_" are called via the vips7 interface, names without the prefix use the new
|
|
vips8 interface.
|
|
|
|
.SH EXAMPLES
|
|
|
|
Run a vips8 operation. Operation options must follow the operation name.
|
|
|
|
$ vips insert lena.v lena2.v out.v 0 0 --background "128 0 0"
|
|
|
|
Get a "usage" message for an operation
|
|
|
|
$ vips insert
|
|
insert image @sub into @main at @x, @y
|
|
usage:
|
|
insert main sub out x y
|
|
where:
|
|
main - Main input image, input VipsImage
|
|
sub - Sub-image to insert into main image, input VipsImage
|
|
out - Output image, output VipsImage
|
|
x - Left edge of sub in main, input gint
|
|
y - Top edge of sub in main, input gint
|
|
optional arguments:
|
|
expand - Expand output to hold all of both inputs, input gboolean
|
|
background - Colour for new pixels, input VipsArrayDouble
|
|
operation flags: sequential-unbuffered
|
|
insert: too few arguments
|
|
|
|
.SH RETURN VALUE
|
|
returns 0 on success and non-zero on error.
|
|
.SH SEE ALSO
|
|
header(1)
|
|
.SH COPYRIGHT
|
|
The National Gallery and Birkbeck College, 1989-1996.
|