4 Known Problems and Workarounds
- 1 -
1. Introduction
IRIS ImageVision Tools is a set of image generation and
manipulation utilities. They include
o a tool for altering and enhancing images
o a tool for viewing images
o a tool for converting image files to other formats
o a tool for reading information about the image from the
file
o a tool for enumerating the supported file formats
Note: Packaged with these release notes is a separate sheet
that contains the Software License Agreement. This
software is provided to you solely under the terms
and conditions of the Software License Agreement.
Please take a few moments to review the Agreement.
Note in particular paragraphs 1 and 2 under the
heading ``Terms and Conditions of Software License.''
This software may be used only by you on one
workstation, computer, or server at one time, and may
be copied only as necessary for backup or archival
purposes.
This document contains the following chapters:
1. Introduction
2. Configuration Information
3. Changes and Additions
4. Known Problems and Workarounds
5. Documentation Errors
- 2 -
1.1 Release_Identification_Information
Following is the release identification information for IRIS
ImageVision Utilities:
Software Product ImageVision Tools
Version 2.1
System Software Requirements IRIX 5.2
1.2 Online_Release_Notes
When you install the online documentation for a product, you
can view the release notes on your screen as you would an
online manual page.
Refer to the relnotes(1) manual page for how to access the
online release notes.
1.3 Product_Support
Silicon Graphics, Inc., provides a comprehensive product
support maintenance program for IRIS-4D Series products.
For further information, please contact the Technical
Assistance Center at 1-800-800-4SGI.
- 1 -
2. Configuration_Information
The IRIS ImageVision Utilities software is included in the
standard operating system software. It is installed by
default when you install the standard operating system
software. You must explicitly deselect the imgtools
subsystem to prevent it from being installed. Follow the
instructions in the IRIS Software Installation Guide.
2.1 IRIS_ImageVision_Utilities_Subsystems
IRIS ImageVision Utilities includes these subsystems:
imgtools.sw.tools The IRIS ImageVision Utilities
executable files
imgtools.books.tools The IRIS ImageVision Utilities
User's Guide
imgtools.man.tools The IRIS ImageVision Utilities
manual pages
imgtools.man.relnotes The IRIS ImageVision Utilities
release notes
2.2 Installation_Method
All of the subsystems for IRIS ImageVision Utilities can be
installed using IRIX. You do not need to use the miniroot.
Refer to the IRIS Software Installation Guide for complete
installation instructions.
2.3 IRIS ImageVision Utilities Subsystem Disk Space
Requirements
This section lists the subsystems of the IRIS ImageVision
Utilities option, along with their sizes and whether they
are installed by default. If you are installing this option
for the first time, the subsystems marked ``default'' are
installed if you use the ``go'' menu item. To install a
different set of subsystems, use the ``install,''
``remove,'' ``keep,'' and ``step'' commands in inst to
customize the list of subsystems to be installed, before you
select the ``go'' menu item.
Note: The listed subsystem sizes are approximate. Refer to
the IRIS Software Installation Guide for information
on finding exact sizes.
Subsystem Name Subsystem Size
(512-byte blocks)
- 2 -
imgtools.sw.tools 4087
(default)
imgtools.man.tools 19
(default)
imgtools.man.relnotes 17
(default)
imgtools.books.tools 873
(default)
2.4 Prerequisites
You must be running version 5.2 of the IRIX operating system
to use release 2.1 of the IRIS ImageVision Utilities. Also,
you must have the ImageVision Library release 2.3 executable
software installed (il_eoe.sw).
The utilities imgview and imgworks require IRIS Insight
Viewer 2.2.1 and the IRIS Utilities Guide in order to use
the help facility.
- 1 -
3. Changes_and_Additions
This chapter lists changes and additions new to this release
of IRIS ImageVision Utilities.
3.1 PhotoCD:_New_Supported_File_Format
ImageVision Utilities fully supports PhotoCD. Images stored
in PhotoCD format can now be read, displayed, manipulated,
and converted to one of the other supported file formats:
TIFF, SGI, or FIT. To specify a given resolution from
PhotoCD, append to the filename a colon and index number of
the desired resolution. Indices are as follows:
__________________
__________________
0 64x96
1 128x192
2 256x384
3 512x768
4 1024x1536
5 2048x3072
For example, to display the 512x768 resolution in image
img0063.pcd, you would type imgview img0063.pcd:3.
3.2 GIF:_New_Supported_File_Format
ImageVision Utilities supports access to GIF files. Images
stored in GIF format can now be read, displayed,
manipulated, and converted to one of the other supported
file formats: TIFF, SGI, or FIT.
3.3 Image_View_Features
imgview has been rewritten to include features for cropping,
wiping, zooming-in, roaming, and panning about the image.
Additionally, imgview now has the ability to alter the
images color table. Also, the autoScale mode has been added
to allow for color scaling. By default, images are scaled
from the minimum and maximum pixel range to 0 to 255. For
additional information on these features, use the ``Help''
option when running the imgview tool.
- 2 -
3.4 Image_Formats
A new tool, imgformats, has been added to query what file
formats are supported by your system.
3.5 Image_Works_Crop
imgworks now supports interactive cropping. The crop
operation includes handles in the form of an animated border
around the image with yellow squares at each image corner.
The cursor changes to a corner shape as you move the cursor
towards any corner. To crop the image, press the left mouse
button and drag to strech the image border to the newly
desired size. The crop gizmo also allows you to add margin
space to images. Margin color can also be selected by
selecting the ``Choose Color'' option.
3.6 Image_Works_Scale_and_Stretch
Similar to cropping, imgworks now supports interactive
scaling or streching. The image is highlighted with a
border and four yellow squares, one at each image corner.
The cursor changes to a corner shape as you move the cursor
towards any corner. To scale or stretch the image, press
the left mouse button and drag to strech the image border to
the newly desired size. Additionally, the scale and stretch
gizmos allow for resizing by desired size as well as by
percentage.
3.7 Image_Works_Find_Edges
imgworks now has a ``Find Edges'' command. This operation
is useful for giving you a head start on generating masks
for compositing operations or for special effects. Edges
can be extracted by using one of the selected filters:
Roberts, Sobel, Laplace 1, or Laplace 2.
3.8 Image_Works_Saturate
imgworks now supports image saturation. You can control the
vividness of color in an image.
3.9 Image_Works_Print_Options
imgworks now has a ``Print'' option. When you select
``Print'' from the ``File'' menu bar, you can choose from
one of the installed PostScript printers. The ``Print''
option no longer supports imgprint.
- 3 -
3.10 Obsoleted_Tools
The tools imgscan, imgprint, and imgsnap have been obsoleted
in this release. The tools provided by Impressario replace
the functionality previously provided by imgscan, imgprint,
and imgsnap.
- 1 -
4. Known_Problems_and_Workarounds
This chapter lists known problems in this release of IRIS
ImageVision Utilities.
4.1 Image_Works_Color_Chooser
Image Works leaks memory when applying colors from the color
chooser repeatedly. To avoid growing your process memory,
apply colors judiciously.
4.2 Image_Works_File_Dialog
Image Works puts up a dialog when opening a file. The left
side of the dialog has a sub-region that pertains only to
PhotoCD images. This sub-region will display properly when
a PhotoCD image is selected, to allow the resolution to be
selected.
4.3 Image_Works_Enhancement
Image Works has several enhancement operations, such as
contrast and brightness. These operations do not properly
work on RealityEngine if IL hardware acceleration is on
(default). See the IL(1) man page for more information on
controlling the IL environment.
4.4 Image_Works_Find_Edges
Image Works has several edge operators under the ``Effects''
menu. All are all broken, except for Roberts.
4.5 Image_Works_Undo
Image Works supports only two levels of undo. Only the last
two operations can be undone.
4.6 Image_View_RGB_Mode_and_Double_Buffer_Toggle
The GUI toolkit used by Image View gets confused when the
RGB mode and/or Double Buffer mode is toggled and then the
window is resized. This sequence causes problems with the
colormap. To work around this problem, iconify and then
reopen the window.
4.7 Image_View_AutoScale
Image View automatically scales images (by default) to the
range 0-255. This automatic scaling can be turned off by
using the AutoScale toggle (per view) or AutoScale mode (new
views). The scale min/max values do not propagate correctly
- 2 -
if hardware acceleration is disabled. Therefore, the detail
view may not track the main window if autoscale is toggled.
4.8 Image_View_LUT_Editor
The Image View lookup table (LUT) editor is difficult to use
when manipulating images with ilBit data type or images
whose min/max range is much smaller than the range of the
data type.
4.9 Image_View_Detail_View
Image View detail view has a small square showing the pixel
of interest. On some low-end systems, the rectangle is
filled. If the detail view is resized, the rectangle can
become misaligned.
- 1 -
5. Documentation_Errors
None are currently known in this release of the IRIS
ImageVision Utilities.