ITERM(1) User Contributed Perl Documentation ITERM(1)NAMEiterm - the interactive tool for IPA library
DESCRIPTIONiterm is a mostly command-line tool for basic image processing. It has
terminal representation, where the main window is capable of viewing
the image and accepting commands. The command syntax is pure perl, plus
all functions available in the IPA library ( see IPA ) and Prima
toolkit ( see Prima), and some specific iterm commands.
USAGE
Design
iterm defines several scalars for the user needs. The main window
shows the content of the scalar $i, if it is an image. If the
additional windows are opened, they correspond to images in array @i.
The array @i is filled automatically, and the index is shown on the
additional new window titles. The additional windows are stored in
array @windows, under same indexes. The main window is stored in scalar
$w.
The input line is used to enter perl code. If the code returns and
newly created image, it is stored into $i, and the old value of $i is
discarded. If the code returns more than on image, the additional
windows opened automatically. If the code throws an exception, its
first line is shown on the status line, and the whole message is
printed to stderr.
To see pixel value under mouse cursor, hold the Shift key.
Interactive commands
There are several interactive commands, present on the window menus.
The main and the additional windows have different sets of interactive
commands.
Open
Presents a file selection dialog, where the image file is to be
selected and its content loaded into variable $i and displayed in
the main window.
Save as
Opens a file save dialog, where the content of $i can be stored on
disk.
Duplicate
Creates a new additional window and copies $i into it. The newly
created image is stored into @i array, and the new window into
@windows array. The indexes of these are equal and shown on the
window's title.
Export
Note: only for additional windows
Copies the content of the image into $i
Import
Note: only for additional windows
Copies content of $i into the image.
iterm commands
These are commands, specific to iterm.
new VAR
Assigns new variable $VAR to an empty image
show IMAGE
Assigns IMAGE to $i and displays it.
clearhistory
Flushes the command history
load FILE [ options ]
Loads image FILE into $i and displays the image. FILE must be a
quoted string.
reverse IMAGE
Reverses image
stretch IMAGE
Stretches image data to fit the whole range. For the histogram
equalization see IPA::Point::equalize
save IMAGE, FILE [ options ]
Stores IMAGE object into FILE.
quit
Exits iterm.
zoom SCALE
Selects zoom for window $w. There are no shortcuts for selecting
zoom for the additional windows, but this can be achieved by
entering the following code:
$windows[$NUM]-> Image-> zoom($SCALE)
window
Opens a new, empty additional window.
dup See Duplicate
undo
Reverts $i to its last value
my VARIABLE [ = VALUE ]
Declare lexical VARIABLE and assign VALUE to it.
Example
To load an image:
load 'image.gif'
Convert to 8-bit grayscale:
$i-> type( im::Byte)
Perform dilation:
dilate $i
Copy to new window
dup
Erode the new image
erode $i[0]
Display the difference
subtract $i, $i[0]
Note: iterm never asks if the changed images are to be saved.
FILES
~/.iterm-list - the command history
SEE ALSO
· IPA - the image processing library
· Prima - perl graphic toolkit
AUTHOR
Dmitry Karasik <dmitry@karasik.eu.org>
perl v5.20.2 2011-05-08 ITERM(1)
