gimp/gimp-remote.1.in

52 lines
1.4 KiB
Groff

.TH GIMP-REMOTE 1 "8 August 2000" "Version @GIMP_VERSION@" "GIMP Manual Pages"
.SH NAME
gimp-remote - tells a running gimp to open a (local or remote) image file.
.SH SYNOPSIS
.B gimp-remote
[\-h] [\-\-help] [-v] [\-\-version] [\-n] [\-\-new] \fIfilename\fP...
.SH DESCRIPTION
.PP
\fIgimp-remote\fP is a small utility that tells a running gimp to open a
(local or remote) image file. It does so by searching a gimp toolbox on the
active display. If it can identify a gimp toolbox, a synthetic drop event is
created which makes gimp think the files would have been dropped onto the
toolbox. More than one filename or URL can be specified on the commandline.
.SH OPTIONS
.l
\fIgimp-remote\fP accepts the following options:
.TP 8
.B \-h, \-\-help
Display a list of all commandline options.
.TP 8
.B \-v, \-\-version
Output the version info.
.TP 8
.B \-n, \-\-new
If no running gimp is found, a new instance of gimp is started.
The files to open are passed to the new gimp.
.SH EXAMPLES
.TP
.BI gimp-remote \ http://www.gimp.org/icons/frontpage-small.gif
Loads an image from the gimp webpage into a running gimp.
.TP
.BI gimp-remote\ \-n \ wilber.xcf\ \ wilma.xcf
Loads the local files wilber.xcf and wilma.xcf into a running gimp.
If no gimp is running, a new one is started.
.SH ENVIRONMENT
.PP
.TP 8
.B DISPLAY
to get the default host and display number.
.SH AUTHORS
Sven Neumann and Simon Budig.
.SH "SEE ALSO"
.BR gimp (1),
.BR gimprc (5),
.BR gimptool (1)