G'MIC - GREYC's Magic for Image Computing: A Full-Featured Open-Source Framework for Image Processing
Banner Institutions GREYC CNRS ENSICAEN UNICAEN

A Full-Featured Open-Source Framework for Image Processing

Latest stable version: 3.6.1 (2025/08/26)

Reference
Table of Contents  ▸  List of Commands  ▸  Values Manipulation  ▸  discard◀  decompress_rle    |    eigen2tensor  ▶

discard

Built-in command

Arguments:

  • _value1,_value2,...    or
  • { x | y | z | c}...{ x | y | z | c},_value1,_value2,...    or
  • (no arg)

Description:

Discard specified values in selected images or discard neighboring duplicate values,

optionally only for the values along the first of a specified axis.
If no arguments are specified, neighboring duplicate values are discarded.
If all pixels of a selected image are discarded, an empty image is returned.

Examples of use:

• Example #1

(1;2;3;4;3;2;1) +discard 2

Command: (1;2;3;4;3;2;1) +discard 2
Command: (1;2;3;4;3;2;1) +discard 2

• Example #2

(1,2,2,3,3,3,4,4,4,4) +discard x

Command: (1,2,2,3,3,3,4,4,4,4) +discard x
Command: (1,2,2,3,3,3,4,4,4,4) +discard x
G'MIC - GREYC's Magic for Image Computing: A Full-Featured Open-Source Framework for Image Processing

G'MIC is an open-source software distributed under the CeCILL free software licenses (LGPL-like and/or
GPL-compatible). Copyrights (C) Since July 2008, David Tschumperlé - GREYC UMR CNRS 6072, Image Team.