|Welcome to the G'MIC command line interface (cli) cheatsheet directory. Cheats consist of pithy recipes for common tasks and/or ways to avoid typical gaffes.|
G'MIC is a command line interface tool. Use your operating system's CLI to:
1. put images on an image list,
2. apply an image processing pipeline to image list items,
3. output results in a well-understood manner.
If you have not used the G'MIC cli at all! (as in: never!), then visit Tutorial Introduction and Basics. Can’t cheat unless you know what you’re cheating at.
In G'MIC, pipelines
— ordered command sequences — operate on image lists
. A gmic
pipeline typically has these parts:
|gmic||<input list items>||<commands>||<output adaptors>||output[ <selection> ] <filename template>|
|Start the interpreter||Populate the image list with -input variants||operate on selections of image list items||Use -cut or -normalize and friends to adapt list items in a well understood manner.||-output a selection of adapted list items to storage.|
Apart from starting the interpreter, the remaining pipeline parts may be broken up and interleaved. There may be other less vital parts as well. Example: display intermediary list items
. When pipeline proof-reading, be comfortable identifying which part does what. No? Then go to the more prolix tutorials
Skip to Cheats
if you know what you are doing.
| 1. ||Installed the G'MIC Command Line Interface ( Tell me how )?|| □|
| 2. ||Know the difference between the cli and gmic-qt ?|| □|
| 3. ||Know how to access and use your operating system shell?|| □|
| 4. ||Understand what output in a well understood manner means?|| □|
If you miss a check then you are on the wrong page. Bail. Out. Now.
Good to Go
With G’MIC cli
| 1. ||Put images on the image list|
| 2. ||Apply a set of image processing commands|
| 3. ||Output results in a well-understood manner|
Put these three injunctions on a yellow sticky pad. Paste it within eyesight. Until it becomes muscle memory, be able to identify:
| 1. ||Where and how you populate the image list,|
| 2. ||Apply image processing commands,|
| 3. ||Output results in a well-understood manner.|
for any cli
command you write. Basic Pipeline Anatomy: Populate. Apply. Output.
The well-understood manner
injunction delineates G’MIC cli
from paint programs. The cli
provides vast image processing freedoms. Even the freedom to be silly. To provide freedom efficiently — including freedom from nagging software!
("Are You Sure You Want To Do That? OK
") the cli
removes all guard rails. Sans
guard rails, one may output signed floating point data to Portable Network Graphics (.png
) containers. The cli
trusts you have your reasons. Corollary: Know what output you want and how you are going to use it.
Updated: 07-May 2023 18:53 UTC Commit: 79f1223f76abc9d217cab05bf38ca89560b76ee6
G'MIC is an open-source software distributed under the
CeCILL free software licenses (LGPL-like and/or
Copyrights (C) Since July 2008,
David Tschumperlé - GREYC UMR CNRS 6072, Image Team.