### Namespace

# Gimp – 3.0

GIMP library

Version | 3.2.4
Authors | GIMP contributors
License | GPL-3.0-or-later
Website | https://www.gimp.org
Source | https://gitlab.gnome.org/GNOME/gimp/

#### Build

C headers | `libgimp/gimp.h`
pkg-config files | `gimp-3.0`

#### Dependencies

Babl—0.1 | Pixel encoding and color space conversion engine
| Browse documentation
GLib—2.0 | C Utility Library
| Browse documentation
GObject—2.0 | The base type system library
| Browse documentation
Gio—2.0 | GObject interfaces and objects
| Browse documentation
GdkPixbuf—2.0 | Image loading and scaling
| Browse documentation
Gegl—0.4 | Generic Graphics Library
| Browse documentation
cairo—1.0 | A 2D graphics library with support for multiple output devices
| Browse documentation
Pango—1.0 | Internationalized text layout and rendering
| Browse documentation

#### Additional documentation

- Classes Hierarchy

#### Classes

BatchProcedure | Batch procedures implement an interpreter able to run commands as input.
Brush | Installable object used by painting and stroking tools.
Channel | Functions for manipulating channels.
Choice |
ColorConfig | Color management settings.
ColorProfile | Definitions and Functions relating to LCMS.
ColorTransform | Definitions and Functions relating to LCMS.
ConfigPath |
Curve |
Display | Functions to create, delete and flush displays (views) on an image.
Drawable | Functions to manipulate drawables.
DrawableFilter | Operations on drawable filters: creation, editing.
DrawableFilterConfig | The base class for `GimpDrawableFilter` specific config objects. since: 3.0
ExportOptions | A class holding generic export options.
ExportProcedure | Export procedures implement image export.
FileProcedure | File procedures implement file support. They cannot be created directly. Instead, you will create an instance of one of the subclasses (such as export or load procedures). This provides a common interface for file-related functions on these objects.
Font | Installable object used by text tools.
Gradient | Installable object used by the gradient rendering tool.
GroupLayer | Operations on a group layer.
Image | Operations on complete images: creation, resizing/rescaling, and operations involving multiple layers.
ImageProcedure | A `GimpProcedure` subclass that makes it easier to write standard plug-in procedures that operate on drawables.
Item | Functions to manipulate items.
Layer | Operations on a single layer.
LayerMask |
LinkLayer | Functions for querying and manipulating link layers.
LoadProcedure | A `GimpProcedure` subclass that makes it easier to write file load procedures.
Memsize | Functions to (de)serialize a given memory size.
Metadata | Basic functions for handling `GimpMetadata` objects.
Module | `GimpModule` is a generic mechanism to dynamically load modules into GIMP. It is a `GTypeModule` subclass, implementing module loading using `GModule`. `GimpModule` does not know which functionality is implemented by the modules, it just provides a framework to get arbitrary `GType` implementations loaded from disk.
ModuleDB | Keeps a list of `GimpModule`‘s found in a given searchpath.
Palette | Installable object, a small set of colors a user can choose from.
ParamArray |
ParamBrush |
ParamChannel |
ParamChoice |
ParamColor |
ParamConfigPath |
ParamCoreObjectArray |
ParamCurve |
ParamDisplay |
ParamDoubleArray |
ParamDrawable |
ParamDrawableFilter |
ParamExportOptions |
ParamFile |
ParamFont |
ParamGradient |
ParamGroupLayer |
ParamImage |
ParamInt32Array |
ParamItem |
ParamLayer |
ParamLayerMask |
ParamLinkLayer |
ParamMatrix2 |
ParamMatrix3 |
ParamMemsize |
ParamObject |
ParamPalette |
ParamParasite |
ParamPath |
ParamPattern |
ParamRasterizable |
ParamResource |
ParamSelection |
ParamTextLayer |
ParamUnit |
ParamValueArray |
ParamVectorLayer |
Path | Functions for querying and manipulating path.
Pattern | Installable object used by fill and clone tools.
PDB | Provides access to the Procedural DataBase (PDB).
PlugIn | The base class for plug-ins to derive from. since: 3.0
Procedure | Procedures are registered functions which can be run across GIMP ecosystem. They can be created by plug-ins and can then run by the core application when called from menus (or through other interaction depending on specific procedure subclasses).
ProcedureConfig | The base class for `GimpProcedure` specific config objects and the main interface to manage aspects of `GimpProcedure`‘s arguments such as persistency of the last used arguments across GIMP sessions. since: 3.0
Resource | Functions to manipulate resources.
Selection | Functions for manipulating selections.
TextLayer | Functions for querying and manipulating text layers.
ThumbnailProcedure |
Unit | Provides operations on units, a collection of predefined units and functions to create new units.
VectorLayer | Functions for querying and manipulating vector layers.
VectorLoadProcedure | A `GimpProcedure` subclass that makes it easier to write load procedures for vector image formats.

#### Interfaces

ColorManaged | An interface dealing with color profiles.
ConfigInterface |
Rasterizable | Functions for querying and manipulating rasterizable items.

#### Structs

Array |
Config |
ConfigWriter | Functions for writing config info to a file for libgimpconfig.
EnumDesc | This structure is used to register translatable descriptions and help texts for enum values. See gimp_enum_set_value_descriptions().
FlagsDesc | This structure is used to register translatable descriptions and help texts for flag values. See gimp_flags_set_value_descriptions().
Matrix2 | A two by two matrix.
Matrix3 | A three by three matrix.
Matrix4 | A four by four matrix.
ModuleInfo | This structure contains information about a loadable module.
ParamSpecObject |
ParamSpecObjectClass |
Parasite | Arbitrary pieces of data which can be attached to various GIMP objects.
PixPipeParams | PLease somebody help documenting this.
ProgressVtable |
Scanner | A wrapper around `GScanner` with some convenience API.
ValueArray | The prime purpose of a `GimpValueArray` is for it to be used as an object property that holds an array of values. A `GimpValueArray` wraps an array of `GValue` elements in order for it to be used as a boxed type through `GIMP_TYPE_VALUE_ARRAY`. since: 2.10
Vector2 | A two dimensional vector.
Vector3 | A three dimensional vector.
Vector4 | A four dimensional vector.
VectorLoadData |

#### Aliases

BablFormat | This type is simply a wrapper around `Babl` when used as a color format.
ColorArray | A boxed type which is nothing more than an alias to a `NULL`-terminated array of `GeglColor`.
CoreObjectArray | A boxed type which is nothing more than an alias to a `NULL`-terminated array of `GObject`. No reference is being hold on contents because core objects are owned by `libgimp`.

#### Enumerations

AddMaskType | Modes of initialising a layer mask.
ArgumentSync | Methods of syncing procedure arguments. since: 3.0
BrushApplicationMode | Extracted from app/paint/paint-enums.h.
BrushGeneratedShape | Shapes of generated brushes.
CapStyle | Style of line endings.
ChannelOps | Operations to combine channels and selections.
ChannelType | Channels (as in color components).
CheckSize | Size of the checkerboard indicating transparency.
CheckType | Color/Brightness of the checkerboard indicating transparency.
CloneType | Clone sources.
ColorManagementMode | Modes of color management.
ColorRenderingIntent | Intents for color management.
ColorTag | Possible tag colors. since: 2.10
ColorTransformFlags | Flags for modifying `GimpColorTransform`‘s behavior.
ComponentType | Encoding types of image components. since: 2.10
ConfigPathType | Types of config paths.
ConvertDitherType | Extracted from app/core/core-enums.h.
ConvertPaletteType | Types of palettes for indexed conversion.
ConvolveType | Types of convolutions.
CpuAccelFlags | Types of detectable CPU accelerations.
CurvePointType | Extracted from app/core/core-enums.h.
CurveType | Extracted from app/core/core-enums.h.
DesaturateMode | Grayscale conversion methods.
DodgeBurnType | Methods for the dodge/burn operation.
ExportReturn | Possible return values of `gimp_export_options_get_image()`.
FileChooserAction | A type of file to choose from when actions are expected to choose a file. This is basically a mapping to %GtkFileChooserAction except for `GIMP_FILE_CHOOSER_ACTION_ANY` which should not be used for any GUI functions since we can’t know what you are looking for.
FillType | Types of filling.
ForegroundExtractMode | Foreground extract engines.
GradientBlendColorSpace | Color space for blending gradients. since: 2.10
GradientSegmentColor | Coloring types for gradient segments.
GradientSegmentType | Transition functions for gradient segments.
GradientType | Gradient shapes.
GridStyle | Rendering types for the display grid.
HistogramChannel | Extracted from app/core/core-enums.h.
HueRange | Hue ranges.
IconType | Icon types for plug-ins to register.
ImageBaseType | Image color models.
ImageType | Possible drawable types.
InkBlobType | Ink tool tips.
InterpolationType | Interpolation types.
JoinStyle | Line join styles.
LayerColorSpace | Extracted from app/operations/operations-enums.h.
LayerCompositeMode | Extracted from app/operations/operations-enums.h.
LayerMode | Extracted from app/operations/operations-enums.h.
MaskApplyMode | Layer mask apply modes.
MergeType | Types of merging layers.
MessageHandlerType | How to present messages.
MetadataColorspace | Well-defined colorspace information available from metadata.
ModuleError | Types of errors returned by modules.
ModuleState | The possible states a `GimpModule` can be in.
OffsetType | Background fill types for the offset operation.
OrientationType | Orientations for various purposes.
PaintApplicationMode | Paint application modes.
PathStrokeType | Possible type of strokes in path objects.
PDBErrorHandler | PDB error handlers.
PDBProcType | Types of PDB procedures.
PDBStatusType | Return status of PDB calls.
PixbufTransparency | How to deal with transparency when creating thubnail pixbufs from images and drawables.
Precision | Precisions for pixel encoding. since: 2.10
ProgressCommand | Commands for the progress API.
RepeatMode | Repeat modes for example for gradients.
RotationType | Types of simple rotations.
RunMode | Run modes for plug-ins.
SelectCriterion | Criterions for color similarity.
SizeType | Size types for the old-style text API.
StackTraceMode | When to generate stack traces in case of an error.
StrokeMethod | Methods of stroking selections and paths.
TextDirection | Text directions.
TextHintStyle | Text hint strengths.
TextJustification | Text justifications.
TextOutline | Settings for text stroke and fill.
TextOutlineDirection | Options for how the text outline’s stroke is drawn.
TransferMode | For choosing which brightness ranges to transform.
TransformDirection | Transform directions.
TransformResize | Ways of clipping the result when transforming drawables.
TRCType | Extracted from app/core/core-enums.h.
UnitID | Integer IDs of built-in units used for dimensions in images. These IDs are meant to stay stable but user-created units IDs may change from one session to another.

#### Bitfields

ExportCapabilities | The types of images and layers an export procedure can handle.
MetadataLoadFlags | What metadata to load when importing images.
MetadataSaveFlags | What kinds of metadata to save when exporting images.
ProcedureSensitivityMask | The cases when a `GimpProcedure` should be shown as sensitive.

#### Error Domains

ConfigError | The possible values of a `GError` thrown by libgimpconfig.

#### Callbacks

BatchFunc | The batch function is run during the lifetime of the GIMP session, each time a plug-in batch procedure is called. since: 3.0
ExportGetCapabilitiesFunc | This function returns the capabilities requested by your export procedure, depending on `config` or `options`. since: 3.0
ExtractVectorFunc | Loading a vector image happens in 2 steps:. since: 3.0
ModuleQueryFunc | The signature of the query function a loadable GIMP module must implement. In the module, the function must be called `gimp_module_query()`.
ModuleRegisterFunc | The signature of the register function a loadable GIMP module must implement. In the module, the function must be called `gimp_module_register()`.
ProgressFunc |
ProgressVtableEndFunc | Ends the progress.
ProgressVtableGetWindowFunc |
ProgressVtablePulseFunc | Makes the progress pulse.
ProgressVtableSetTextFunc | Sets a new text on the progress.
ProgressVtableSetValueFunc | Sets a new percentage on the progress.
ProgressVtableStartFunc | Starts the progress.
PutPixelFunc |
RenderFunc |
RunExportFunc | The export function is run during the lifetime of the GIMP session, each time a plug-in export procedure is called. since: 3.0
RunFunc | The run function is run during the lifetime of the GIMP session, each time a plug-in procedure is called. since: 3.0
RunImageFunc | The image function is run during the lifetime of the GIMP session, each time a plug-in image procedure is called. since: 3.0
RunLoadFunc | The load function is run during the lifetime of the GIMP session, each time a plug-in load procedure is called. since: 3.0
RunThumbnailFunc | The thumbnail function is run during the lifetime of the GIMP session, each time a plug-in thumbnail procedure is called. since: 3.0
RunVectorLoadFunc | The load function is run during the lifetime of the GIMP session, each time a plug-in load procedure is called. since: 3.0

#### Functions

adaptive_supersample_area |
airbrush | Paint in the current brush with varying pressure. Paint application is time-dependent.
airbrush_default | Paint in the current brush with varying pressure. Paint application is time-dependent.
any_to_utf8 | This function takes any string (UTF-8 or not) and always returns a valid UTF-8 string.
attach_parasite | Add a global parasite. since: 2.8
babl_format_get_type |
bilinear |
bilinear_16 |
bilinear_32 |
bilinear_8 |
bilinear_rgb |
bind_text_domain | This function wraps bindtextdomain on UNIX and wbintextdomain on Windows. `dir_name` is expected to be in the encoding used by the C library on UNIX and UTF-8 on Windows. since: 3.0
brushes_close_popup | Close the brush selection dialog.
brushes_get_list | Retrieve a complete listing of the available brushes.
brushes_popup | Invokes the GIMP brush selection dialog.
brushes_refresh | Refresh current brushes. This function always succeeds.
brushes_set_popup | Sets the selected brush in a brush selection dialog.
buffer_delete | Deletes a named buffer. since: 2.4
buffer_get_bytes | Retrieves the specified buffer’s bytes. since: 2.4
buffer_get_height | Retrieves the specified buffer’s height. since: 2.4
buffer_get_image_type | Retrieves the specified buffer’s image type. since: 2.4
buffer_get_width | Retrieves the specified buffer’s width. since: 2.4
buffer_rename | Renames a named buffer. since: 2.4
buffers_get_name_list | Retrieve a complete listing of the available buffers. since: 2.4
cache_directory | Returns the default top directory for GIMP cached files. If the environment variable GIMP3_CACHEDIR exists, that is used. It should be an absolute pathname. Otherwise, a subdirectory of the directory returned by `g_get_user_cache_dir()` is used. since: 2.10.10
cairo_checkerboard_create | Create a repeating checkerboard pattern. since: 2.6
cairo_surface_create_buffer | This function returns a `GeglBuffer` which wraps `surface`‘s pixels. It must only be called on image surfaces, calling it on other surface types is an error. deprecated: 3.0.8 since: 2.10
cairo_surface_get_buffer | This function returns a `GeglBuffer` containing `surface`‘s pixels. It must only be called on image surfaces, calling it on other surface types is an error. since: 3.0.8
cairo_surface_get_format | This function returns a `Babl` format that corresponds to `surface`‘s pixel format. since: 2.10
canonicalize_identifier | Turns any input string into a canonicalized string. since: 2.4
check_custom_color1 | Returns the first checkerboard custom color that can be used in previews. since: 3.0
check_custom_color2 | Returns the second checkerboard custom color that can be used in previews. since: 3.0
check_size | Returns the size of the checkerboard to be used in previews. since: 2.2
check_type | Returns the type of the checkerboard to be used in previews. since: 2.2
checks_get_colors | Retrieves the colors to use when drawing a checkerboard for a certain `GimpCheckType` and custom colors. If `type` is `GIMP_CHECK_TYPE_CUSTOM_CHECKS`, then `color1` and `color2` will remain untouched, which means you must initialize them to the values expected for custom checks. since: 3.0
clone | Clone from the source to the dest drawable using the current brush.
clone_default | Clone from the source to the dest drawable using the current brush.
color_array_copy | Creates a new `GimpColorArray` containing a deep copy of a `NULL`-terminated array of `GeglColor`.
color_array_free | Frees a `NULL`-terminated array of `GeglColor`.
color_array_get_length |
color_array_get_type |
color_is_out_of_gamut | Determine whether `color` is out of its `space` gamut. A small error of margin is accepted, so that for instance a component at -0.0000001 is not making the whole color to be considered as out-of-gamut while it may just be computation imprecision. since: 3.0

color_is_out_of_self_gamut

Determine whether `color` is out of its own space gamut. This can only happen if the color space is unbounded and any of the color component is out of the `[0; 1]` range. A small error of margin is accepted, so that for instance a component at -0.0000001 is not making the whole color to be considered as out-of-gamut while it may just be computation imprecision.

since: 3.0

color_is_perceptually_identical | Determine whether `color1` and `color2` can be considered identical to the human eyes, by computing the distance in a color space as perceptually uniform as possible. since: 3.0
color_list_names | Returns the list of SVG 1.0 color keywords that is recognized by `gimp_color_parse_name()`. since: 2.2
color_parse_css | Attempts to parse a string describing an sRGB color in CSS notation. This can be either a numerical representation (`rgb(255,0,0)` or `rgb(100%,0%,0%)`) or a hexadecimal notation as parsed by `gimp_color_parse_hex()` (`##ff0000`) or a color name as parsed by `gimp_color_parse_css()` (`red`).
color_parse_css_substring | Attempts to parse a string describing an sRGB color in CSS notation. This can be either a numerical representation (`rgb(255,0,0)` or `rgb(100%,0%,0%)`) or a hexadecimal notation as parsed by `gimp_color_parse_hex()` (`##ff0000`) or a color name as parsed by `gimp_color_parse_name()` (`red`). since: 2.2
color_parse_hex | Attempts to parse a string describing a sRGB color in hexadecimal notation (optionally prefixed with a ‘#’).
color_parse_hex_substring | Attempts to parse a string describing an RGB color in hexadecimal notation (optionally prefixed with a ‘#’). since: 2.2
color_parse_name | Attempts to parse a color name. This function accepts SVG 1.1 color keywords.
color_parse_name_substring | Attempts to parse a color name. This function accepts SVG 1.1 color keywords. since: 2.2
color_set_alpha | Update the `alpha` channel, and any other component if necessary (e.g. in case of premultiplied channels), without changing the format of `color`. since: 3.0
context_are_dynamics_enabled | Whether the currently active paint dynamics will be applied to painting. since: 3.0
context_enable_dynamics | Enables paint dynamics using the active paint dynamics. since: 3.0
context_get_antialias | Get the antialias setting. since: 2.8
context_get_background | Get the current GIMP background color. since: 2.2
context_get_brush | Get the currently active brush. since: 2.2
context_get_brush_angle | Get brush angle in degrees. since: 2.8
context_get_brush_aspect_ratio | Get brush aspect ratio. since: 2.8
context_get_brush_force | Get brush force in paint options. since: 2.10
context_get_brush_hardness | Get brush hardness in paint options. since: 2.10
context_get_brush_size | Get brush size in pixels. since: 2.8
context_get_brush_spacing | Get brush spacing as percent of size. since: 2.10
context_get_diagonal_neighbors | Get the diagonal neighbors setting. since: 2.10
context_get_distance_metric | Get the distance metric used in some computations. since: 2.10
context_get_dynamics_name | Get the currently active paint dynamics. since: 2.8
context_get_emulate_brush_dynamics | Retrieve the currently active stroke option’s emulate brush dynamics setting. since: 3.0
context_get_feather | Get the feather setting. since: 2.8
context_get_feather_radius | Get the feather radius setting. since: 2.8
context_get_font | Get the currently active font. since: 2.2
context_get_foreground | Get the current GIMP foreground color. since: 2.2
context_get_gradient | Get the currently active gradient. since: 2.2
context_get_gradient_blend_color_space | Get the gradient blend color space. since: 2.10
context_get_gradient_repeat_mode | Get the gradient repeat mode. since: 2.10
context_get_gradient_reverse | Get the gradient reverse setting. since: 2.10
context_get_ink_angle | Get ink angle in degrees. since: 2.8
context_get_ink_blob_angle | Get ink blob angle in degrees. since: 2.8
context_get_ink_blob_aspect_ratio | Get ink blob aspect ratio. since: 2.8
context_get_ink_blob_type | Get ink blob type. since: 2.8
context_get_ink_size | Get ink blob size in pixels. since: 2.8
context_get_ink_size_sensitivity | Get ink size sensitivity. since: 2.8
context_get_ink_speed_sensitivity | Get ink speed sensitivity. since: 2.8
context_get_ink_tilt_sensitivity | Get ink tilt sensitivity. since: 2.8
context_get_interpolation | Get the interpolation type. since: 2.8
context_get_line_cap_style | Get the line cap style setting. since: 2.10
context_get_line_dash_offset | Get the line dash offset setting. since: 2.10
context_get_line_dash_pattern | Get the line dash pattern setting. since: 2.10
context_get_line_join_style | Get the line join style setting. since: 2.10
context_get_line_miter_limit | Get the line miter limit setting. since: 2.10
context_get_line_width | Get the line width setting. since: 2.10
context_get_line_width_unit | Get the line width unit setting. since: 2.10
context_get_mypaint_brush | Get the currently active MyPaint brush. since: 2.10
context_get_opacity | Get the opacity. since: 2.2
context_get_paint_fade_length | Get the paint fade length. since: 3.2
context_get_paint_fade_repeat | Get the paint fade repeat type. since: 3.2
context_get_paint_method | Get the currently active paint method. since: 2.4
context_get_paint_mode | Get the paint mode. since: 2.2
context_get_palette | Get the currently active palette. since: 2.2
context_get_pattern | Get the currently active pattern. since: 2.2
context_get_sample_criterion | Get the sample criterion setting. since: 2.8
context_get_sample_merged | Get the sample merged setting. since: 2.8
context_get_sample_threshold | Get the sample threshold setting. since: 2.8
context_get_sample_threshold_int | Get the sample threshold setting as an integer value. since: 2.8
context_get_sample_transparent | Get the sample transparent setting. since: 2.8
context_get_stroke_method | Get the currently active stroke method. since: 2.10
context_get_transform_direction | Get the transform direction. since: 2.8
context_get_transform_resize | Get the transform resize type. since: 2.8
context_list_paint_methods | Lists the available paint methods. since: 2.4
context_pop | Pops the topmost context from the plug-in’s context stack. since: 2.2
context_push | Pushes a context onto the top of the plug-in’s context stack. since: 2.2
context_set_antialias | Set the antialias setting. since: 2.8
context_set_background | Set the current GIMP background color. since: 2.2
context_set_brush | Set the active brush. since: 2.2
context_set_brush_angle | Set brush angle in degrees. since: 2.8
context_set_brush_aspect_ratio | Set brush aspect ratio. since: 2.8
context_set_brush_default_hardness | Set brush spacing to its default. since: 2.10
context_set_brush_default_size | Set brush size to its default. since: 2.8
context_set_brush_default_spacing | Set brush spacing to its default. since: 2.10
context_set_brush_force | Set brush application force. since: 2.10
context_set_brush_hardness | Set brush hardness. since: 2.10
context_set_brush_size | Set brush size in pixels. since: 2.8
context_set_brush_spacing | Set brush spacing as percent of size. since: 2.10
context_set_default_colors | Set the current GIMP foreground and background colors to black and white. since: 2.2
context_set_defaults | Reset context settings to their default values. since: 2.8
context_set_diagonal_neighbors | Set the diagonal neighbors setting. since: 2.10
context_set_distance_metric | Set the distance metric used in some computations. since: 2.10
context_set_dynamics_name | Set the active paint dynamics. since: 2.8
context_set_emulate_brush_dynamics | Set the stroke option’s emulate brush dynamics setting. since: 3.0
context_set_feather | Set the feather setting. since: 2.8
context_set_feather_radius | Set the feather radius setting. since: 2.8
context_set_font | Set the active font. since: 2.2
context_set_foreground | Set the current GIMP foreground color. since: 2.2
context_set_gradient | Sets the active gradient. since: 2.2
context_set_gradient_blend_color_space | Set the gradient blend color space. since: 2.10
context_set_gradient_fg_bg_hsv_ccw | Sets the built-in FG-BG HSV (ccw) gradient as the active gradient. since: 2.10
context_set_gradient_fg_bg_hsv_cw | Sets the built-in FG-BG HSV (cw) gradient as the active gradient. since: 2.10
context_set_gradient_fg_bg_rgb | Sets the built-in FG-BG RGB gradient as the active gradient. since: 2.10
context_set_gradient_fg_transparent | Sets the built-in FG-Transparent gradient as the active gradient. since: 2.10
context_set_gradient_repeat_mode | Set the gradient repeat mode. since: 2.10
context_set_gradient_reverse | Set the gradient reverse setting. since: 2.10
context_set_ink_angle | Set ink angle in degrees. since: 2.8
context_set_ink_blob_angle | Set ink blob angle in degrees. since: 2.8
context_set_ink_blob_aspect_ratio | Set ink blob aspect ratio. since: 2.8
context_set_ink_blob_type | Set ink blob type. since: 2.8
context_set_ink_size | Set ink blob size in pixels. since: 2.8
context_set_ink_size_sensitivity | Set ink size sensitivity. since: 2.8
context_set_ink_speed_sensitivity | Set ink speed sensitivity. since: 2.8
context_set_ink_tilt_sensitivity | Set ink tilt sensitivity. since: 2.8
context_set_interpolation | Set the interpolation type. since: 2.8
context_set_line_cap_style | Set the line cap style setting. since: 2.10
context_set_line_dash_offset | Set the line dash offset setting. since: 2.10
context_set_line_dash_pattern | Set the line dash pattern setting. since: 2.10
context_set_line_join_style | Set the line join style setting. since: 2.10
context_set_line_miter_limit | Set the line miter limit setting. since: 2.10
context_set_line_width | Set the line width setting. since: 2.10
context_set_line_width_unit | Set the line width unit setting. since: 2.10
context_set_mypaint_brush | Set a MyPaint brush as the active MyPaint brush. since: 2.10
context_set_opacity | Set the opacity. since: 2.2
context_set_paint_fade_length | Set the paint fade length. since: 3.2
context_set_paint_fade_repeat | Set the paint fade repeat type. since: 3.2
context_set_paint_method | Set the active paint method. since: 2.4
context_set_paint_mode | Set the paint mode. since: 2.2
context_set_palette | Set the active palette. since: 2.2
context_set_pattern | Set the active pattern. since: 2.2
context_set_sample_criterion | Set the sample criterion setting. since: 2.8
context_set_sample_merged | Set the sample merged setting. since: 2.8
context_set_sample_threshold | Set the sample threshold setting. since: 2.8
context_set_sample_threshold_int | Set the sample threshold setting as an integer value. since: 2.8
context_set_sample_transparent | Set the sample transparent setting. since: 2.8
context_set_stroke_method | Set the active stroke method. since: 2.10
context_set_transform_direction | Set the transform direction. since: 2.8
context_set_transform_resize | Set the transform resize type. since: 2.8
context_swap_colors | Swap the current GIMP foreground and background colors. since: 2.2
convolve | Convolve (Blur, Sharpen) using the current brush.
convolve_default | Convolve (Blur, Sharpen) using the current brush.
core_object_array_get_length |
core_object_array_get_type |
cpu_accel_get_support | Query for CPU acceleration support. since: 2.4
data_directory | Returns the default top directory for GIMP data. If the environment variable GIMP3_DATADIR exists, that is used. It should be an absolute pathname. Otherwise, on Unix the compile-time defined directory is used. On Windows, the installation directory as deduced from the executable’s full filename is used.
data_directory_file | Returns a `GFile` in the data directory, or the data directory itself if `first_element` is `NULL`. since: 2.10
debug_timer_end | Finishes measuring elapsed time.
debug_timer_start | Starts measuring elapsed time.
default_display | Returns the default display ID. This corresponds to the display the running procedure’s menu entry was invoked from.
detach_parasite | Removes a global parasite. since: 2.8
directory | Returns the user-specific GIMP settings directory. If the environment variable GIMP3_DIRECTORY exists, it is used. If it is an absolute path, it is used as is. If it is a relative path, it is taken to be a subdirectory of the home directory. If it is a relative path, and no home directory can be determined, it is taken to be a subdirectory of gimp_data_directory().
directory_file | Returns a `GFile` in the user’s GIMP directory, or the GIMP directory itself if `first_element` is `NULL`. since: 2.10
displays_flush | Flush all internal changes to the user interface.
displays_reconnect | Reconnect displays from one image to another image.
dodgeburn | Dodgeburn image with varying exposure.
dodgeburn_default | Dodgeburn image with varying exposure. This is the same as the `gimp_dodgeburn()` function except that the exposure, type and mode are taken from the tools option dialog. If the dialog has not been activated then the defaults as used by the dialog will be used.
double_array_get_values |
double_array_set_values |
drawables_close_popup | Close the drawable selection dialog. deprecated: 3.2
drawables_popup | Invokes the drawable selection dialog. deprecated: 3.2
drawables_set_popup | Sets the selected drawable in a drawable selection dialog. deprecated: 3.2
dynamics_get_name_list | Retrieve the list of loaded paint dynamics. since: 2.8
dynamics_refresh | Refresh current paint dynamics. This function always succeeds. since: 2.8
edit_copy | Copy from the specified drawables.
edit_copy_visible | Copy from the projection. since: 2.2
edit_cut | Cut from the specified drawables.
edit_named_copy | Copy into a named buffer. since: 2.4
edit_named_copy_visible | Copy from the projection into a named buffer. since: 2.4
edit_named_cut | Cut into a named buffer. since: 2.4
edit_named_paste | Paste named buffer to the specified drawable. since: 2.4
edit_named_paste_as_new_image | Paste named buffer to a new image. since: 2.10
edit_paste | Paste buffer to the specified drawable.
edit_paste_as_new_image | Paste buffer to a new image. since: 2.10
enum_get_desc | Retrieves `GimpEnumDesc` associated with the given value, or `NULL`. since: 2.2
enum_get_value | Checks if `value` is valid for the enum registered as `enum_type`. If the value exists in that enum, its name, nick and its translated description and help are returned (if `value_name`, `value_nick`, `value_desc` and `value_help` are not `NULL`). since: 2.2
enum_get_value_descriptions | Retrieves the array of human readable and translatable descriptions and help texts for enum values. since: 2.2
enum_set_value_descriptions | Sets the array of human readable and translatable descriptions and help texts for enum values. since: 2.2
enum_value_get_abbrev | Retrieves the translated abbreviation for a given `enum_value`. since: 2.10
enum_value_get_desc | Retrieves the translated description for a given `enum_value`. since: 2.2
enum_value_get_help | Retrieves the translated help for a given `enum_value`. since: 2.2
enums_get_type_names | This function gives access to the list of enums registered by libgimp. The returned array is static and must not be modified. since: 2.2
enums_init | This function makes sure all the enum types are registered with the `GType` system. This is intended for use by language bindings that need the symbols early, before gimp_main is run. It’s not necessary for plug-ins to call this directly, because the normal plug-in initialization code will handle it implicitly. since: 2.4
eraser | Erase using the current brush.
eraser_default | Erase using the current brush.
escape_uline | This function returns a copy of `str` with all underline converted to two adjacent underlines. This comes in handy when needing to display strings with underlines (like filenames) in a place that would convert them to mnemonics. since: 2.2
export_color_profile | Returns whether file plug-ins should default to exporting the image’s color profile. since: 2.10.4
export_comment | Returns whether file plug-ins should default to exporting the image’s comment. since: 3.0
export_exif | Returns whether file plug-ins should default to exporting Exif metadata, according preferences (original settings is `FALSE` since metadata can contain sensitive information). since: 2.10
export_iptc | Returns whether file plug-ins should default to exporting IPTC metadata, according preferences (original settings is `FALSE` since metadata can contain sensitive information). since: 2.10
export_thumbnail | Returns whether file plug-ins should default to exporting the image’s comment. since: 3.0
export_xmp | Returns whether file plug-ins should default to exporting XMP metadata, according preferences (original settings is `FALSE` since metadata can contain sensitive information). since: 2.10
file_create_thumbnail | Creates a thumbnail of `image` for the given `file`.
file_get_config_path | Unexpands `file`‘s path using `gimp_config_path_unexpand()` and returns the unexpanded path. since: 2.10
file_get_utf8_name | This function works like `gimp_filename_to_utf8()` and returns a UTF-8 encoded string that does not need to be freed. since: 2.10
file_has_extension | This function checks if `file`‘s URI ends with `extension`. It behaves like `g_str_has_suffix()` on g_file_get_uri(), except that the string comparison is done case-insensitively using g_ascii_strcasecmp(). since: 2.10
file_load | Loads an image file by invoking the right load handler.
file_load_layer | Loads an image file as a layer for an existing image. since: 2.4
file_load_layers | Loads an image file as layers for an existing image. since: 2.4
file_new_for_config_path | Expands `path` using `gimp_config_path_expand()` and returns a `GFile` for the expanded path. since: 2.10
file_save | Saves to XCF or export `image` to any supported format by extension.
file_show_in_file_manager | Shows `file` in the system file manager. since: 2.10
filename_to_utf8 | Convert a filename in the filesystem’s encoding to UTF-8 temporarily. The return value is a pointer to a string that is guaranteed to be valid only during the current iteration of the main loop or until the next call to gimp_filename_to_utf8().
flags_get_first_desc | Retrieves the first `GimpFlagsDesc` that matches the given value, or `NULL`. since: 2.2
flags_get_first_value | Checks if `value` is valid for the flags registered as `flags_type`. If the value exists in that flags, its name, nick and its translated description and help are returned (if `value_name`, `value_nick`, `value_desc` and `value_help` are not `NULL`). since: 2.2
flags_get_value_descriptions | Retrieves the array of human readable and translatable descriptions and help texts for flags values. since: 2.2
flags_set_value_descriptions | Sets the array of human readable and translatable descriptions and help texts for flags values. since: 2.2
flags_value_get_abbrev | Retrieves the translated abbreviation for a given `flags_value`. since: 2.10
flags_value_get_desc | Retrieves the translated description for a given `flags_value`. since: 2.2
flags_value_get_help | Retrieves the translated help for a given `flags_value`. since: 2.2
floating_sel_anchor | Anchor the specified floating selection to its associated drawable.
floating_sel_attach | Attach the specified layer as floating to the specified drawable.
floating_sel_remove | Remove the specified floating selection from its associated drawable.
floating_sel_to_layer | Transforms the specified floating selection into a layer.
fonts_close_popup | Close the font selection dialog.
fonts_get_list | Retrieve the list of loaded fonts.
fonts_popup | Invokes the Gimp font selection dialog.
fonts_refresh | Refresh current fonts. This function always succeeds.
fonts_set_popup | Sets the current font in a font selection dialog.
get_color_configuration | Retrieve a copy of the current color management configuration. since: 2.4
get_default_comment | Get the default image comment as specified in the Preferences.
get_default_unit | Get the default unit (taken from the user’s locale). since: 2.4
get_images | Returns the list of images currently open.
get_module_load_inhibit | Get the list of modules which should not be loaded.
get_monitor_resolution | Get the monitor resolution as specified in the Preferences.
get_num_processors | Returns the number of threads set explicitly by the user in the preferences. This information can be used by plug-ins wishing to follow user settings for multi-threaded implementations. since: 3.0
get_parasite | Look up a global parasite. since: 2.8
get_parasite_list | List all parasites. since: 2.8
get_pdb | This function returns the plug-in’s `GimpPDB` instance, which is a singleton that can exist exactly once per running plug-in. since: 3.0
get_plug_in | This function returns the plug-in’s `GimpPlugIn` instance, which is a a singleton that can exist exactly once per running plug-in. since: 3.0
get_progname | Returns the plug-in’s executable name.
getpid | Returns the PID of the host GIMP process. since: 2.4
gimprc_query | Queries the gimprc file parser for information on a specified token.
gimprc_set | Sets a gimprc token to a value and saves it in the gimprc.
gradients_close_popup | Close the gradient selection dialog.
gradients_get_list | Retrieve the list of loaded gradients.
gradients_popup | Invokes the Gimp gradients selection dialog.
gradients_refresh | Refresh current gradients. This function always succeeds.
gradients_set_popup | Sets the current gradient in a gradient selection dialog.
heal | Heal from the source to the dest drawable using the current brush. since: 2.4
heal_default | Heal from the source to the dest drawable using the current brush. since: 2.4
help | Load a help page.
icon_theme_dir | Returns the directory of the current icon theme. since: 2.10.4
images_close_popup | Close the image selection dialog.
images_popup | Invokes the image selection dialog.
images_set_popup | Sets the selected image in a image selection dialog.
installation_directory | Returns the top installation directory of GIMP. On Unix the compile-time defined installation prefix is used. On Windows, the installation directory as deduced from the executable’s full filename is used. On OSX we ask [NSBundle mainBundle] for the resource path to check if GIMP is part of a relocatable bundle. since: 2.8
installation_directory_file | Returns a `GFile` in the installation directory, or the installation directory itself if `first_element` is `NULL`. since: 2.10.10
int32_array_get_values |
int32_array_set_values |
is_canonical_identifier | Checks if `identifier` is canonical and non-`NULL`. since: 3.0
items_close_popup | Close the item selection dialog.
items_popup | Invokes the item selection dialog.
items_set_popup | Sets the selected item in a item selection dialog.
list_images | Returns the list of images currently open. since: 3.0
locale_directory | Returns the top directory for GIMP locale files. If the environment variable GIMP3_LOCALEDIR exists, that is used. It should be an absolute pathname. Otherwise, on Unix the compile-time defined directory is used. On Windows, the installation directory as deduced from the executable’s full filename is used.
locale_directory_file | Returns a `GFile` in the locale directory, or the locale directory itself if `first_element` is `NULL`. since: 2.10
main | The main plug-in function that must be called with the plug-in’s `GimpPlugIn` subclass `GType` and the ‘argc’ and ‘argv’ that are passed to the platform’s `main()`. since: 3.0
message | Displays a dialog box with a message.
message_get_handler | Returns the current state of where warning messages are displayed.
message_set_handler | Controls where warning messages are displayed.
monitor_number | Returns the monitor number to be used for plug-in windows.
paintbrush | Paint in the current brush with optional fade out parameter and pull colors from a gradient.
paintbrush_default | Paint in the current brush. The fade out parameter and pull colors from a gradient parameter are set from the paintbrush options dialog. If this dialog has not been activated then the dialog defaults will be used.
palettes_close_popup | Close the palette selection dialog.
palettes_get_list | Retrieves a list of all of the available palettes.
palettes_popup | Invokes the Gimp palette selection dialog.
palettes_refresh | Refreshes current palettes. This function always succeeds.
palettes_set_popup | Sets the current palette in a palette selection dialog.
param_spec_array | Creates a new `GimpParamSpecArray` specifying a `GimpArray` property. since: 3.0
param_spec_brush | Creates a new `GimpParamSpecBrush` specifying a `GimpBrush` property. See also `gimp_param_spec_resource()`. since: 3.0
param_spec_channel | Creates a new `GimpParamSpecChannel` specifying a `GimpChannel` property. since: 3.0

param_spec_choice

Creates a new `GimpParamSpecChoice` specifying a

# G_TYPE_STRING property.

This %GimpParamSpecChoice takes ownership of the reference on `choice`.

since: 3.0

param_spec_choice_get_choice | since: 3.0
param_spec_choice_get_default | since: 3.0
param_spec_color | Creates a new `GParamSpec` instance specifying a `GeglColor` property. Note that the `default_color` is duplicated, so reusing object will not change the default color of the returned %GimpParamSpecColor.
param_spec_color_from_string | Creates a new `GParamSpec` instance specifying a `GeglColor` property.
param_spec_color_has_alpha | since: 2.4
param_spec_config_path | Creates a param spec to hold a filename, dir name, or list of file or dir names. See `g_param_spec_internal()` for more information. since: 2.4
param_spec_config_path_type | Tells whether the path param encodes a filename, dir name, or list of file or dir names. since: 2.4
param_spec_core_object_array | Creates a new `GimpParamSpecCoreObjectArray` specifying a `GimpCoreObjectArray` property. since: 3.0
param_spec_core_object_array_get_object_type | since: 3.0
param_spec_curve | Creates a new `GimpParamSpecCurve` specifying a `GimpCurve` property. since: 3.2
param_spec_display | Creates a new `GimpParamSpecDisplay` specifying a `GimpDisplay` property. since: 3.0
param_spec_display_none_allowed | since: 3.0
param_spec_double_array | Creates a new `GimpParamSpecDoubleArray` specifying a `GIMP_TYPE_DOUBLE_ARRAY` property. since: 3.0
param_spec_drawable | Creates a new `GimpParamSpecDrawable` specifying a `GimpDrawable` property. since: 3.0
param_spec_drawable_filter | Creates a new `GimpParamSpecDrawableFilter` specifying a `GimpDrawableFilter` property. since: 3.0
param_spec_drawable_filter_none_allowed | since: 3.0

param_spec_export_options

Creates a new `GimpParamSpecExportOptions` specifying a

# G_TYPE_INT property.

since: 3.0

param_spec_file | Creates a param spec to hold a file param. See `g_param_spec_internal()` for more information. since: 3.0
param_spec_file_get_action | since: 3.0
param_spec_file_none_allowed | since: 3.0
param_spec_file_set_action | Change the file action tied to `pspec`. since: 3.0
param_spec_font | Creates a new `GimpParamSpecFont` specifying a `GimpFont` property. See also `gimp_param_spec_resource()`. since: 3.0
param_spec_gradient | Creates a new `GimpParamSpecGradient` specifying a `GimpGradient` property. See also `gimp_param_spec_resource()`. since: 3.0
param_spec_group_layer | Creates a new `GimpParamSpecGroupLayer` specifying a `GimpGroupLayer` property. since: 3.0
param_spec_image | Creates a new `GimpParamSpecImage` specifying a `GimpImage` property. since: 3.0
param_spec_image_none_allowed | since: 3.0
param_spec_int32_array | Creates a new `GimpParamSpecInt32Array` specifying a `GIMP_TYPE_INT32_ARRAY` property. since: 3.0
param_spec_item | Creates a new `GimpParamSpecItem` specifying a `GimpItem` property. since: 3.0
param_spec_item_none_allowed | since: 3.0
param_spec_layer | Creates a new `GimpParamSpecLayer` specifying a `GimpLayer` property. since: 3.0
param_spec_layer_mask | Creates a new `GimpParamSpecLayerMask` specifying a `GimpLayerMask` property. since: 3.0
param_spec_link_layer | Creates a new `GimpParamSpecLinkLayer` specifying a `GimpLinkLayer` property. since: 3.2
param_spec_matrix2 | Creates a param spec to hold a `GimpMatrix2` value. See `g_param_spec_internal()` for more information. since: 2.4
param_spec_matrix3 | Creates a param spec to hold a `GimpMatrix3` value. See `g_param_spec_internal()` for more information. since: 2.8
param_spec_memsize | Creates a param spec to hold a memory size value. See `g_param_spec_internal()` for more information. since: 2.4
param_spec_palette | Creates a new `GimpParamSpecPalette` specifying a `GimpPalette` property. See also `gimp_param_spec_resource()`. since: 3.0
param_spec_parasite | Creates a new `GimpParamSpecParasite` specifying a `GimpParasite` property. since: 2.4
param_spec_path | Creates a new `GimpParamSpecPath` specifying a `GimpPath` property. since: 3.0
param_spec_pattern | Creates a new `GimpParamSpecPattern` specifying a `GimpPattern` property. See also `gimp_param_spec_resource()`. since: 3.0
param_spec_rasterizable | Creates a new `GimpParamSpecRasterizable` specifying a `GimpRasterizable` property. since: 3.2
param_spec_resource | Creates a new `GimpParamSpecResource` specifying a `GimpResource` property. See `g_param_spec_internal()` for details on property names. since: 3.0
param_spec_resource_defaults_to_context |
param_spec_resource_none_allowed |
param_spec_selection | Creates a new `GimpParamSpecSelection` specifying a `GimpSelection` property. since: 3.0
param_spec_text_layer | Creates a new `GimpParamSpecTextLayer` specifying a `GimpTextLayer` property. since: 3.0
param_spec_unit | Creates a param spec to hold a units param. See `g_param_spec_internal()` for more information. since: 2.4
param_spec_unit_percent_allowed | since: 3.0
param_spec_unit_pixel_allowed | since: 3.0
param_spec_value_array | Creates a new `GimpParamSpecValueArray` specifying a `GValueArray` property. since: 3.0
param_spec_value_array_get_element_spec | since: 3.0
param_spec_vector_layer | Creates a new `GimpParamSpecVectorLayer` specifying a `GimpVectorLayer` property. since: 3.2
patterns_close_popup | Close the pattern selection dialog.
patterns_get_list | Retrieve a complete listing of the available patterns.
patterns_popup | Invokes the Gimp pattern selection.
patterns_refresh | Refresh current patterns. This function always succeeds.
patterns_set_popup | Sets the current pattern in a pattern selection dialog.
pencil | Paint in the current brush without sub-pixel sampling.
pixbuf_create_buffer | Returns a `GeglBuffer` that’s either backed by the `pixbuf`‘s pixels, or a copy of them. This function tries to not copy the `pixbuf`‘s pixels. If the pixbuf’s rowstride is a multiple of its bpp, a simple reference to the `pixbuf`‘s pixels is made and `pixbuf` will be kept around for as long as the buffer exists; otherwise the pixels are copied. since: 2.10
pixbuf_get_format | Returns the Babl format that corresponds to the `pixbuf`‘s pixel format. since: 2.10
pixbuf_get_icc_profile | Returns the ICC profile attached to the `pixbuf`, or `NULL` if there is none. since: 2.10
pixels_to_units | Converts a `value` specified in pixels to `unit`. since: 2.8
pixpipe_params_build | Do not use this function. It is deprecated and will be removed eventually. deprecated: 3.2
pixpipe_params_free | Do not use this function. It is deprecated and will be removed eventually. deprecated: 3.2
pixpipe_params_init | Do not use this function. It is deprecated and will be removed eventually. deprecated: 3.2
pixpipe_params_parse | Do not use this function. It is deprecated and will be removed eventually. deprecated: 3.2
progress_cancel | Cancels a running progress. since: 2.2
progress_end | Ends the progress bar for the current plug-in. since: 2.4
progress_get_window_handle | Returns the native handle of the toplevel window this plug-in’s progress is or would be displayed in. since: 2.2
progress_init | Initializes the progress bar for the current plug-in.
progress_init_printf | Initializes the progress bar for the current plug-in. since: 2.4
progress_install_vtable | since: 2.4
progress_pulse | Pulses the progress bar for the current plug-in. since: 2.4
progress_set_text | Changes the text in the progress bar for the current plug-in. since: 2.4
progress_set_text_printf | Changes the text in the progress bar for the current plug-in. since: 2.4
progress_uninstall | Uninstalls a temporary progress procedure that was installed using gimp_progress_install(). since: 2.2
progress_update | Updates the progress bar for the current plug-in.
quit | Forcefully causes the GIMP library to exit and close down its connection to main gimp application. This function never returns. deprecated: Unknown
range_estimate_settings | This function proposes reasonable settings for increments and display digits. These can be used for instance on `GtkRange` or other widgets using a `GtkAdjustment` typically. Note that it will never return `digits` with value 0. If you know that your input needs to display integer values, there is no need to set `digits`.
rectangle_intersect | Calculates the intersection of two rectangles. since: 2.4
rectangle_union | Calculates the union of two rectangles. since: 2.8
resources_loaded | Returns whether the resource with the given `resource_type` were loaded. since: 3.2.4
show_help_button | Returns whether or not GimpDialog should automatically add a help button if help_func and help_id are given. since: 2.2
smudge | Smudge image with varying pressure.
smudge_default | Smudge image with varying pressure.
stack_trace_available | Returns `TRUE` if we have dependencies to generate backtraces. If `optimal` is `TRUE`, the function will return `TRUE` only when we are able to generate optimal traces (i.e. with GDB or LLDB); otherwise we return `TRUE` even if only `backtrace()` API is available. since: 2.10

stack_trace_print

Attempts to generate a stack trace at current code position in `prog_name`. `prog_name` is mostly a helper and can be set to NULL. Nevertheless if set, it has to be the current program name (argv[0]). This function is not meant to generate stack trace for third-party programs, and will attach the current process id only. Internally, this function uses `gdb` or `lldb` if they are available, or the `stacktrace()` API on platforms where it is available. It always fails on Win32.

since: 2.10

stack_trace_query | This is mostly the same as `g_on_error_query()` except that we use our own backtrace function, much more complete. `prog_name` must be the current program name (argv[0]). It does nothing on Win32. since: 2.10
strip_uline | This function returns a copy of `str` stripped of underline characters. This comes in handy when needing to strip mnemonics from menu paths etc.
sysconf_directory | Returns the top directory for GIMP config files. If the environment variable GIMP3_SYSCONFDIR exists, that is used. It should be an absolute pathname. Otherwise, on Unix the compile-time defined directory is used. On Windows, the installation directory as deduced from the executable’s full filename is used.
sysconf_directory_file | Returns a `GFile` in the sysconf directory, or the sysconf directory itself if `first_element` is `NULL`. since: 2.10
temp_directory | Returns the default top directory for GIMP temporary files. If the environment variable `GIMP3_TEMPDIR` exists, that is used. It should be an absolute pathname. Otherwise, a subdirectory of the directory returned by `g_get_tmp_dir()` is used. since: 2.10.10
temp_file | Generates a unique temporary file.
text_font | Add text at the specified location as a floating selection or a new layer.
text_get_extents_font | Get extents of the bounding box for the specified text.
tile_height | Returns the tile height GIMP is using.
tile_width | Returns the tile width GIMP is using.
type_get_translation_context | Retrieves the translation context that has been previously set using gimp_type_set_translation_context(). You should not need to use this function directly, use `gimp_enum_get_value()` or `gimp_enum_value_get_desc()` instead. since: 2.8
type_get_translation_domain | Retrieves the gettext translation domain identifier that has been previously set using gimp_type_set_translation_domain(). You should not need to use this function directly, use `gimp_enum_get_value()` or `gimp_enum_value_get_desc()` instead. since: 2.2
type_set_translation_context | This function attaches a constant string as a translation context to a `GType`. The only purpose of this function is to use it when registering a #G_TYPE_ENUM with translatable value names. since: 2.8
type_set_translation_domain | This function attaches a constant string as a gettext translation domain identifier to a `GType`. The only purpose of this function is to use it when registering a #G_TYPE_ENUM with translatable value names. since: 2.2
units_to_pixels | Converts a `value` specified in `unit` to pixels. since: 2.8
units_to_points | Converts a `value` specified in `unit` to points. since: 2.8
update_metadata | Returns whether file plug-ins should update the image’s metadata. since: 3.1
user_time | Returns the timestamp of the user interaction that should be set on the plug-in window. This is handled transparently, plug-in authors do not have to care about it. since: 2.6
utf8_strtrim | Creates a (possibly trimmed) copy of `str`. The string is cut if it exceeds `max_chars` characters or on the first newline. The fact that the string was trimmed is indicated by appending an ellipsis.
value_dup_double_array | Gets the contents of a `GIMP_TYPE_DOUBLE_ARRAY` `GValue`.
value_dup_int32_array | Gets the contents of a `GIMP_TYPE_INT32_ARRAY` `GValue`.
value_get_double_array | Gets the contents of a `GIMP_TYPE_DOUBLE_ARRAY` `GValue`.
value_get_int32_array | Gets the contents of a `GIMP_TYPE_INT32_ARRAY` `GValue`.
value_set_double_array | Sets the contents of `value` to `data`.
value_set_int32_array | Sets the contents of `value` to `data`.
value_set_static_double_array | Sets the contents of `value` to `data`, without copying the data.
value_set_static_int32_array | Sets the contents of `value` to `data`, without copying the data.
value_take_double_array | Sets the contents of `value` to `data`, and takes ownership of `data`.
value_take_int32_array | Sets the contents of `value` to `data`, and takes ownership of `data`.
vector_2d_to_3d | "Compute screen (sx, sy) - (sx + w, sy + h) to 3D unit square mapping. The plane to map to is given in the z field of p. The observer is located at position vp (vp->z != 0.0).".
vector_2d_to_3d_val | This function is identical to `gimp_vector_2d_to_3d()` but the position of the `observer` and the resulting point `p` are passed by value rather than by reference.
vector_3d_to_2d | Convert the given 3D point to 2D (project it onto the viewing plane, (sx, sy, 0) - (sx + w, sy + h, 0). The input is assumed to be in the unit square (0, 0, z) - (1, 1, z). The viewpoint of the observer is passed in vp.
version | Returns the host GIMP version.
wm_class | Returns the window manager class to be used for plug-in windows.

#### Function Macros

CAIRO_ARGB32_SET_PIXEL | Sets a single pixel in an Cairo image surface in `CAIRO_FORMAT_ARGB32`. since: 2.6
CAIRO_RGB24_SET_PIXEL | Sets a single pixel in an Cairo image surface in `CAIRO_FORMAT_RGB24`. since: 2.6
CHECK_VERSION |
CONFIG_PROP_BOOLEAN |
CONFIG_PROP_BOXED |
CONFIG_PROP_COLOR |
CONFIG_PROP_DOUBLE |
CONFIG_PROP_ENUM |
CONFIG_PROP_FONT |
CONFIG_PROP_INT |
CONFIG_PROP_INT64 |
CONFIG_PROP_MATRIX2 |
CONFIG_PROP_MEMSIZE |
CONFIG_PROP_OBJECT |
CONFIG_PROP_PATH |
CONFIG_PROP_POINTER |
CONFIG_PROP_RESOLUTION |
CONFIG_PROP_STRING |
CONFIG_PROP_UINT |
CONFIG_PROP_UINT64 |
CONFIG_PROP_UNIT |
DEPRECATED_FOR |
MAIN | A macro that expands to the appropriate `main()` function for the platform being compiled for. since: 3.0
UNAVAILABLE |
VALUE_HOLDS_ARRAY |
VALUE_HOLDS_BABL_FORMAT |
VALUE_HOLDS_BRUSH |
VALUE_HOLDS_CHANNEL |
VALUE_HOLDS_COLOR |
VALUE_HOLDS_COLOR_ARRAY |
VALUE_HOLDS_CONFIG_PATH |
VALUE_HOLDS_CORE_OBJECT_ARRAY |
VALUE_HOLDS_CURVE |
VALUE_HOLDS_DISPLAY |
VALUE_HOLDS_DOUBLE_ARRAY |
VALUE_HOLDS_DRAWABLE |
VALUE_HOLDS_DRAWABLE_FILTER |
VALUE_HOLDS_EXPORT_OPTIONS |
VALUE_HOLDS_FILE |
VALUE_HOLDS_FONT |
VALUE_HOLDS_GRADIENT |
VALUE_HOLDS_GROUP_LAYER |
VALUE_HOLDS_IMAGE |
VALUE_HOLDS_INT32_ARRAY |
VALUE_HOLDS_ITEM |
VALUE_HOLDS_LAYER |
VALUE_HOLDS_LAYER_MASK |
VALUE_HOLDS_LINK_LAYER |
VALUE_HOLDS_MATRIX2 |
VALUE_HOLDS_MATRIX3 |
VALUE_HOLDS_MEMSIZE |
VALUE_HOLDS_PALETTE |
VALUE_HOLDS_PARASITE |
VALUE_HOLDS_PATH |
VALUE_HOLDS_PATTERN |
VALUE_HOLDS_RASTERIZABLE |
VALUE_HOLDS_RESOURCE |
VALUE_HOLDS_SELECTION |
VALUE_HOLDS_TEXT_LAYER |
VALUE_HOLDS_UNIT |
VALUE_HOLDS_VALUE_ARRAY |
VALUE_HOLDS_VECTOR_LAYER |
VALUES_DUP_BYTES |
VALUES_DUP_CORE_OBJECT_ARRAY |
VALUES_DUP_CURVE |
VALUES_DUP_DOUBLE_ARRAY |
VALUES_DUP_FILE |
VALUES_DUP_INT32_ARRAY |
VALUES_DUP_PARAM |
VALUES_DUP_PARASITE |
VALUES_DUP_STRING |
VALUES_DUP_STRV |
VALUES_SET_BOOLEAN |
VALUES_SET_BRUSH |
VALUES_SET_BYTES |
VALUES_SET_CHANNEL |
VALUES_SET_CHOICE |
VALUES_SET_COLOR |
VALUES_SET_CORE_OBJECT_ARRAY |
VALUES_SET_CURVE |
VALUES_SET_DISPLAY |
VALUES_SET_DOUBLE |
VALUES_SET_DOUBLE_ARRAY |
VALUES_SET_DRAWABLE |
VALUES_SET_DRAWABLE_FILTER |
VALUES_SET_ENUM |
VALUES_SET_FILE |
VALUES_SET_FONT |
VALUES_SET_GRADIENT |
VALUES_SET_GROUP_LAYER |
VALUES_SET_IMAGE |
VALUES_SET_INT |
VALUES_SET_INT32_ARRAY |
VALUES_SET_ITEM |
VALUES_SET_LAYER |
VALUES_SET_LAYER_MASK |
VALUES_SET_LINK_LAYER |
VALUES_SET_PALETTE |
VALUES_SET_PARAM |
VALUES_SET_PARASITE |
VALUES_SET_PATH |
VALUES_SET_PATTERN |
VALUES_SET_RASTERIZABLE |
VALUES_SET_RESOURCE |
VALUES_SET_SELECTION |
VALUES_SET_STRING |
VALUES_SET_STRV |
VALUES_SET_TEXT_LAYER |
VALUES_SET_UCHAR |
VALUES_SET_UINT |
VALUES_SET_UNIT |
VALUES_SET_VECTOR_LAYER |
VALUES_TAKE_BYTES |
VALUES_TAKE_CORE_OBJECT_ARRAY |
VALUES_TAKE_CURVE |
VALUES_TAKE_DOUBLE_ARRAY |
VALUES_TAKE_FILE |
VALUES_TAKE_INT32_ARRAY |
VALUES_TAKE_PARAM |
VALUES_TAKE_PARASITE |
VALUES_TAKE_STRING |
VALUES_TAKE_STRV |

#### Constants

API_VERSION |
CHECK_DARK | The dark gray value for the default checkerboard pattern.
CHECK_LIGHT | The dark light value for the default checkerboard pattern.
CHECK_SIZE | The default checkerboard size in pixels. This is configurable in the core but GIMP plug-ins can’t access the user preference and should use this constant instead.
CHECK_SIZE_SM | The default small checkerboard size in pixels.
CONFIG_PARAM_AGGREGATE | The object property is to be treated as part of the parent object.
CONFIG_PARAM_CONFIRM | Changes to this property should be confirmed by the user before being applied.
CONFIG_PARAM_DEFAULTS | Don’t serialize this property if it has the default value.
CONFIG_PARAM_DONT_COMPARE | Ignore this property when comparing objects.
CONFIG_PARAM_FLAG_SHIFT | Minimum shift count to be used for core application defined `GParamFlags`.
CONFIG_PARAM_FLAGS | The default flags that should be used for serializable `GimpConfig` properties.
CONFIG_PARAM_IGNORE | This property exists for obscure reasons or is needed for backward compatibility. Ignore the value read and don’t serialize it.
CONFIG_PARAM_RESTART | Changes to this property take effect only after a restart.
CONFIG_PARAM_SERIALIZE | A property that can and should be serialized and deserialized.
MAJOR_VERSION | The major GIMP version number.
MAX_IMAGE_SIZE | The maximum width and height of a GIMP image in pixels. This is a somewhat arbitrary value that can be used when an upper value for pixel sizes is needed; for example to give a spin button an upper limit.
MAX_MEMSIZE | A large but arbitrary value that can be used when an upper limit for a memory size (in bytes) is needed. It is smaller than `G_MAXDOUBLE` since the `GimpMemsizeEntry` doesn’t handle larger values.
MAX_RESOLUTION | The maximum resolution of a GIMP image in pixels per inch. This is a somewhat arbitrary value that can be used to when an upper value for a resolution is needed. GIMP will not accept resolutions larger than this value.
MICRO_VERSION | The micro GIMP version number.
MIN_IMAGE_SIZE | The minimum width and height of a GIMP image in pixels.
MIN_RESOLUTION | The minimum resolution of a GIMP image in pixels per inch. This is a somewhat arbitrary value that can be used when a lower value for a resolution is needed. GIMP will not accept resolutions smaller than this value.
MINOR_VERSION | The minor GIMP version number.
MODULE_ABI_VERSION | The version of the module system’s ABI. Modules put this value into `GimpModuleInfo`‘s `abi_version` field so the code loading the modules can check if it was compiled against the same module ABI the modules are compiled against.
PARAM_DONT_SERIALIZE | This property will be ignored when serializing and deserializing. This is useful for GimpProcedure arguments for which you never want the last run values to be restored.
PARAM_FLAG_SHIFT | Minimum shift count to be used for libgimpconfig defined `GParamFlags` (see libgimpconfig/gimpconfig-params.h).
PARAM_NO_VALIDATE | Since 3.0.
PARAM_READABLE |
PARAM_READWRITE |
PARAM_STATIC_STRINGS |
PARAM_WRITABLE |
PARASITE_ATTACH_GRANDPARENT |
PARASITE_ATTACH_PARENT |
PARASITE_GRANDPARENT_PERSISTENT |
PARASITE_GRANDPARENT_UNDOABLE |
PARASITE_PARENT_PERSISTENT |
PARASITE_PARENT_UNDOABLE |
PARASITE_PERSISTENT | A persistent parasite will be saved to XCF and can be used again after reloading. A non persistent parasite will only be available during the current session. See `GimpParasite`.
PARASITE_UNDOABLE | An undoable parasite that was added, can be removed using the Undo action. If this flag is not set, undoing will not change the parasite. See `GimpParasite`.
PIXPIPE_MAXDIM |
VERSION | The GIMP version as a string.