ENVISION commands


PROGRAM NAME

putpixel - Display Pixel Values Associated with Region of Image

DESCRIPTION

Putpixel is a visualization program that displays value data as a grid of values. These value data points may be pixels in an image.

The number of map pixel values that are displayed along width and height can be specified using the [-valuewidth] and [-valueheight] arguments. These options control the number of pixel values that are displayed in the horizontal and vertical directions of the display.

It is possible to specify the map pixel background color using the [-showcolormap] argument. When set to "TRUE", the pixel under the pointer will be displayed as the background color for the label object in which the map values are displayed. When set to "FALSE", the background color is displayed as black.

By default, the visualization display will share its colormap will all other applications running at the same time; that is, it does not not use a "private colormap", but rather makes use of the "default colormap". It is possible to specify that the visualization display allocate its own private colormap or "grab" all available colors for its own use. This is done using the [-priv] argument. When [-priv] is specified, moving the mouse pointer into the display window will cause the display to have its private colormap installed; moving the pointer out of the display window will cause the private colormap to be de-installed. This results in the "technoflashing" phenomenon characteristic of private colormap installation.

Color allocation can also be controlled and set to either "read-only" or "read/write" using the [-alloc] argument. When set to "read-only", once a color cell has been allocated, it can have its color set only once; from then on, the color cell can be shared by multiple applications, but not changed. If the visualization display requires the color displayed to change, it must re-allocate the color cell, forcing a re-display of data. This can be an expensive procedure. In contrast, after a "read/write" color cell is allocated, it can have its color changed at any time without re-allocation; the data being displayed does not need to be redisplayed, and the color update process is much more efficient. However, the colors used in the visualization display cannot be shared by other applications.

The input file containing the data values to be displayed is monitored by default; the file is checked every 2 seconds for change, and if it has been modified, the displayed values are updated accordingly. The interval at which the input file is checked for modification may be specified using the [-update] argument.

On creation, the window which displays the value data may be placed manually (the default method), or placed automatically. For automatic placement of the window which displays the value data, specify the desired location in device (screen) coordinates using the [-x] and [-y] arguments.

While the display window should be created with a default size that is appropriate to display the data, a width and height for the window can be specified explicitly using the [-width] and [-height] arguments. Alternatively, you may allow the display window to size itself initially, and then use the window manager to interactively modify its size as desired.

REQUIRED ARGUMENTS

-i
type: infile
desc: File containing pixels to display

OPTIONAL ARGUMENTS

-valuewidth
type: integer
desc: Specifies the number of pixel values along width
default: 7
bounds: value >= 0
-valueheight
type: integer
desc: Specifies the number of pixel values along height
default: 7
bounds: value >= 0
-showcolorvalue
type: boolean
desc: Specifies the background color of the pixel
default: true
-priv
type: boolean
desc: Use private colormap
default: false
-alloc
type: cycle
desc: Color allocation policy
default: 1 "Read Only"
-x
type: integer
desc: X location for GUI autoplacement
default: -1
bounds: -1 < [-x] < 1000
-width
type: integer
desc: Window width
default: 256
bounds: -1 < [-width] < 1000
-y
type: integer
desc: Y location for GUI autoplacement
default: -1
bounds: -1 < [-y] < 1000
-height
type: integer
desc: Window height
default: 256
bounds: -1 < [-height] < 1000
-update
type: float
desc: How often to check input file for modification
default: 2
bounds: value >= 0.0

EXAMPLES

% putpixel -i image:mandril

% putpixel -i image:ball

SEE ALSO

putdata(1)

RESTRICTIONS

REFERENCES

COPYRIGHT

Copyright (C) 1993 - 1997, Khoral Research, Inc. ("KRI") All rights reserved.