gimptool1

Usage

Overview

gimptool is a tool that can, among other things, build plug-ins or scripts and install them if they are distributed in one source file.

gimptool can also be used by programs that need to know what libraries and include-paths GIMP was compiled with. gimptool uses pkg-config for this task. For use in Makefiles, it is recommended that you use pkg-config directly instead of calling gimptool.

Options

gimptool accepts the following options:

--version

Print the currently installed version of GIMP on the standard output.

--help

Print out the help blurb, showing commonly used commandline options.

--quiet

Run quietly without echoing any of the build commands.

--silent

Run silently without echoing any of the build commands. Same as --quiet.

-n

Test mode. Print the commands but don't actually execute them. Useful for making dry runs for testing.

--just-print

Test mode. Print the commands but don't actually execute them. Same as -n.

--dry-run

Test mode. Print the commands but don't actually execute them. Same as -n.

--recon

Test mode. Print the commands but don't actually execute them. Same as -n.

--msvc-syntax

Useful on Windows. Outputs the compiler and linker flags in the syntax used by Microsoft's toolchain. Passed to the pkg-config command that does most of gimptool's work.

--bindir

Outputs the bindir used to install the GIMP.

--sbindir

Outputs the sbindir used to install the GIMP.

--libexecdir

Outputs the libexecdir used to install the GIMP.

--datadir

Outputs the datadir used to install the GIMP.

--sysconfdir

Outputs the sysconfdir used to install the GIMP.

--sharedstatedir

Outputs the sharedstatedir used to install the GIMP.

--localstatedir

Outputs the localstatedir used to install the GIMP.

--libdir

Outputs the libdir used to install the GIMP.

--infodir

Outputs the infodir used to install the GIMP.

--mandir

Outputs the mandir used to install the GIMP.

--includedir

Outputs the includedir used to install the GIMP.

--gimpdatadir

Outputs the actual directory where the GIMP data files were installed.

--gimpplugindir

Outputs the actual directory where the GIMP plug-ins were installed.

--build plug-in.c

Compile and link plug-in.c into a GIMP plug-in.

--build-strip plug-in.c

Compile,link, and strip plug-in.c into a GIMP plug-in.

--install plug-in.c

Compile, link, and install plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins)

--install-strip plug-in.c

Compile, link,strip, and install plug-in.c into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins)

--install-admin plug-in.c

Compile, link, and install plug-in.c into the system-wide GIMP plug-in directory (/usr/lib/gimp/3.0/plug-ins)

--install-bin plug-in

Install plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins)

--install-admin-bin plug-in

Install plug-in into the system-wide GIMP plug-in directory (/usr/lib/gimp/3.0/plug-ins)

--install-bin-strip plug-in

Install stripped plug-in into the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins)

--install-admin-bin-strip plug-in

Install stripped plug-in into the system-wide GIMP plug-in directory (/usr/lib/gimp/3.0/plug-ins)

--install-script script.scm

Install script.scm into the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/3.2/scripts)

--install-admin-script script.scm

Install script.scm into the system-wide GIMP script directory (/usr/share/gimp/3.0/scripts)

--uninstall-bin plug-in

Uninstall plug-in from the user's personal GIMP plug-in directory ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins)

--uninstall-admin-bin plug-in

Uninstall plug-in from the system-wide GIMP plug-in directory (/usr/lib/gimp/3.0/plug-ins)

--uninstall-script script.scm

Uninstall script.scm from the user's personal GIMP script directory ($XDG_CONFIG_HOME/GIMP/3.2/scripts)

--uninstall-admin-script script.scm

Uninstall script.scm from the system-wide GIMP script directory (/usr/share/gimp/3.0/scripts)

--libs

Print the linker flags that are necessary to link a GIMP plug-in.

--libs-noui

Print the linker flags that are necessary to link a GIMP plug-in, for plug-ins that do not require the GTK libraries.

--libs-geglop

Print the linker flags that are necessary to link a GEGL filter.

--cflags

Print the compiler flags that are necessary to compile a GIMP plug-in.

--clags-noui

Print the compiler flags that are necessary to compile a GIMP plug-in for plug-ins that do not require the GTK libraries.

--clags-geglop

Print the compiler flags that are necessary to compile a GEGL filter.

--prefix=PREFIX

If specified, use PREFIX instead of the installation prefix that GIMP was built with when computing the output for the --cflags and --libs options. This option is also used for the exec prefix if --exec-prefix was not specified. This option must be specified before any --libs or --cflags options.

--exec-prefix=PREFIX

If specified, use PREFIX instead of the installation exec prefix that GIMP was built with when computing the output for the --cflags and --libs options. This option must be specified before any --libs or --cflags options.

Environment

CC

to get the name of the desired C compiler.

CFLAGS

to get the preferred flags to pass to the C compiler for plug-in building.

LDFLAGS

to get the preferred flags for passing to the linker.

LIBS

for passing extra libs that may be needed in the build process. For example, LIBS=-lintl .

PKG_CONFIG

to get the location of the pkg-config program that is used to determine details about your glib, pango, gtk and gimp installation.