Command Guide

G'MIC command documentation follows the classifcation scheme of the G'MIC Handbook which has pretty much set everyone's expectations of where various commands are. These links will bring you to various tables; the tables will bring you to the commands themselves.

If you are not sure where a command falls in this classification scheme, try '-<command>' in this site's search facility. That is, put the command in single quotes, use the hyphen (which usually means 'not this' in that search box, but the single quotes escape that behavior), and substitute <command> with the command name you think you want.

You may also Google It. the form 'gmic command <command>' will get you content from this site and gmic.eu and, sometimes points in between; these last are (sometimes) gems.

G'MIC Command Classifications

Global Options These work anywhere and everywhere Inputs/Outputs Loads media into and off of the image list
List Manipulation Reorders items on the image list Mathematical Operators Trigs. Logs. Powers. Basics.
Values Manipulation Manipulates luminance rather than color, though color can be affected Color Manipulation Manipulates color rather than luminance, though luminance can be affected.
Geometry Manipulation Alter the structure or shape of the image itself, though image content may be collaterally affected. Filtering A large class (80+) which alter the content of images in myriad ways.
Feature Extraction A technical class generally supporting the field of computer vision, commands singly (or in groups) search for, identify and sometimes mark pixels which exhibit particular characteristics.  Image Drawing Commands here draw on images, altering or replacing original content.
Matrix Computation Recall that G'MIC images need not depict things like flowers or cats, but may be numerical data sets. For those data sets that look like tensors or tensor fields, these commands perform basic (or not so basic) linear alebra on them. Linear least squares, Singular Value Decompositions — if you don't know what these are, these commands will be largely mysterious. 3D Rendering All the commands which work on objects in three-space. These commands (80+) constitute an application within an application.
Program Control These commands support program flow control, branching, looping, argument query and checking or managing the runtime environment (thread control). These are what you need to write gmic or gmic-Gimp filter scripts. Arrays Tiles Frames

Puts a myriad of frames around images, or carves them into tiles or arrays

Artistic Filters images so that they seemed to have been drawn or painted with particular tools (sketchbw), made by artists in particular schools (cubism), made with historic or hysteric imaging devices (polaroid) or are workalikes of filters with expensive licenses or which are found only in expensive programs. Warpings Commands that stretch, convolute, ripple or distort images, or remap images from one kind of surface to another (like planes to spheres and back)
Degradations Mezzoscale noise and structured noise, the kind that alters noticably large clusters of pixels in particular ways. Blending and Fading Combines images, but through using blurred or uncertain borders
Image Sequences Makes animations or volumes from select images. Interactive Demos That's what these are!
PINK Library Operators Commands based on the PINK image processing library. These will fail in various ways without the PINK library and executables installed. Convenience Functions  Mainly scripting support, and run the gamut: communication with file systems and operating systems, number conversion utilities, image metrics and more.

Alas, the command documentation on this site largely reflects the Handbook. As time permits, we'll augment the canonical stubs, furnish extended examples and applications. This will proceed no particular order; those that we use a good deal tend to migrate to the top of the priority stack.

Garry Osgood