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 <a href="image.jpg" class="highslide" onclick="return hs.expand(this)">image.jpg</a>

Command: input <a href="image.jpg" class="highslide" onclick="return hs.expand(this)">image.jpg</a>

• 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

<a href="image.jpg" class="highslide" onclick="return hs.expand(this)">image.jpg</a> (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'

Command: <a href="image.jpg" class="highslide" onclick="return hs.expand(this)">image.jpg</a> (1,2,3;4,5,6;7,8,9) (255^128^64) 400,400,1,3,'(x>w/2?x:y)*c'

A Full-Featured Open-Source Framework for Image Processing

Latest stable version: 3.6.3 (2025/10/13)