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.5.5        Current pre-release: 3.6.0 (2025/08/04)

Reference
Table of Contents  ▸  List of Commands  ▸  Input / Output  ▸  input◀  identity    |    input_565  ▶

input

Built-in command

Arguments:

  • [type:]filename    or
  • [type:]http://URL    or
  • [selection]x_nb_copies>0    or
  • { width[%]>0 | [image_w] },{ _height[%]>0 | [image_h] },{ _depth[%]>0 | [image_d] },{ _spectrum[%]>0 | [image_s] },_{ value1,_value2,... | 'formula' }    or
  • (value1{,|;|/|^}value2{,|;|/|^}...[:{x|y|z|c|,|;|/|^}])    or
  • 0

Description:

Insert a new image taken from a filename or from a copy of an existing image [index],

or insert new image with specified dimensions and values. Single quotes may be omitted in
formula. Specifying argument 0 inserts an empty image.

(equivalent to shortcut command i).

Default values:

nb_copies=1, height=depth=spectrum=1 and value1=0.

This command has a tutorial page.

Examples of use:

• Example #1

input image.jpg

Command: input image.jpg

• Example #2

input (1,2,3;4,5,6;7,8,9^9,8,7;6,5,4;3,2,1)

Command: input (1,2,3;4,5,6;7,8,9^9,8,7;6,5,4;3,2,1)

• Example #3

image.jpg (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'

Command: image.jpg (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'
Command: image.jpg (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'
Command: image.jpg (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'
Command: image.jpg (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'
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.