2004-03-24 02:31:35 +08:00
|
|
|
.TH GIMP-REMOTE 1 "March 23 2004" "Version @GIMP_VERSION@" "GIMP Manual Pages"
|
2000-08-09 00:23:03 +08:00
|
|
|
.SH NAME
|
2003-01-23 21:39:29 +08:00
|
|
|
gimp-remote - tells a running GIMP to open a (local or remote) image file.
|
2000-08-09 00:23:03 +08:00
|
|
|
.SH SYNOPSIS
|
|
|
|
|
.B gimp-remote
|
2003-11-01 02:36:11 +08:00
|
|
|
[\-h] [\-\-help] [-v] [\-\-version] [\-\-display \fIdisplay\fP]
|
2004-11-22 06:47:43 +08:00
|
|
|
[\-e] [\-\-existing] [-q] [\-\-query] [\-s] [\-\-no\-splash]
|
|
|
|
|
\fIfilename\fP ...
|
2000-08-09 00:23:03 +08:00
|
|
|
|
|
|
|
|
.SH DESCRIPTION
|
|
|
|
|
.PP
|
2003-01-23 21:39:29 +08:00
|
|
|
\fIgimp-remote\fP is a small utility that tells a running GIMP to open
|
2004-01-20 21:00:17 +08:00
|
|
|
one or more (local or remote) image files. It does so by searching
|
|
|
|
|
for a GIMP toolbox on the active display. If it can find 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.
|
|
|
|
|
|
|
|
|
|
.PP
|
|
|
|
|
If no GIMP window is found, \fIgimp-remote\fP will start a new GIMP
|
|
|
|
|
instance and ask it to load the specified images. If no filename or
|
2004-01-21 04:09:32 +08:00
|
|
|
URL is given, \fIgimp-remote\fP will start a new GIMP. This behaviour
|
|
|
|
|
can be altered using the command-line options described below.
|
2004-01-20 21:00:17 +08:00
|
|
|
|
2000-08-09 00:23:03 +08:00
|
|
|
|
|
|
|
|
.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
|
2003-11-01 02:36:11 +08:00
|
|
|
.B \-\-display \fIdisplay\fP
|
|
|
|
|
Use the designated X display.
|
2004-01-21 04:09:32 +08:00
|
|
|
.TP 8
|
|
|
|
|
.B \-e, \-\-existing
|
|
|
|
|
If no running GIMP instance is found, don't start a new one but exit.
|
|
|
|
|
.TP 8
|
|
|
|
|
.B \-q, \-\-query
|
|
|
|
|
Check if GIMP is running and exit. A status code of 0 indicates that
|
|
|
|
|
a GIMP toolbox window has been found on this display.
|
2004-11-22 06:47:43 +08:00
|
|
|
.TP 8
|
|
|
|
|
.B \-s, \-\-no\-splash
|
|
|
|
|
When starting GIMP, do not show the splash screen.
|
2000-08-09 00:23:03 +08:00
|
|
|
|
|
|
|
|
.SH EXAMPLES
|
|
|
|
|
.TP
|
2004-04-10 22:23:22 +08:00
|
|
|
.BI gimp-remote\ http://www.gimp.org/images/wilber_the_gimp.png
|
2004-01-20 20:07:26 +08:00
|
|
|
Loads the image from the GIMP website into a running GIMP or starts
|
|
|
|
|
a new one.
|
2000-08-09 00:23:03 +08:00
|
|
|
.TP
|
2004-01-20 20:07:26 +08:00
|
|
|
.BI gimp-remote\ wilber.xcf\ wilma.xcf
|
|
|
|
|
Loads the local files wilber.xcf and wilma.xcf into a running GIMP
|
|
|
|
|
or starts a new one.
|
2000-08-09 00:23:03 +08:00
|
|
|
|
|
|
|
|
.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)
|
