GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  ITERM (1)

.ds Aq ’

NAME

iterm - the interactive tool for IPA library

CONTENTS

DESCRIPTION

iterm 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

o IPA - the image processing library
o Prima - perl graphic toolkit

AUTHOR

Dmitry Karasik <dmitry@karasik.eu.org>
Search for    or go to Top of page |  Section 1 |  Main Index


perl v5.20.3 ITERM (1) 2011-05-08

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.