idt(1NCARG)
NAME
idt - X window interactive image display tool
SYNOPSIS
idt [ -toolkitoption ... ] [ -background color ] [ -f font ] [ -foreground color ] [ -history ] [ -lmin min ] [ -lmax max ] [ -lscale scale ] [ -oldidt ] [ -pal pal_fname ] [ -reverse ] [ -soft ] [ -Version ] [ metafile ]
DESCRIPTION
idt provides a graphical user interface to the NCAR View interactive metafile translator ictrans. idt supports a subset of the ictrans command interface. idt provides two types of command panels for interacting with imagery. The first type is the control panel, which you see when you initially invoke idt. The control panel displays messages from the translators, provides a metafile selection utility and is responsible for instantiating the second type of command panel, the display panel. The display panel provides mechanisms for controlling translators. Each display panel manages a single metafile translator. There can be multiple display panels in existence at the same time but only one control panel.
OPTIONS
idt accepts all of the standard X Toolkit command line options (see
X(1)). idt also accepts the following options:
-f fontcap
Fontcap file to be used for stroking text. When interpreting
CGM TEXT command elements use fontcap as the default font for
textual translation. Note: CGMs may contain textual descriptions
which are not embedded in CGM TEXT elements. Hence they are not
influenced by fontcap specifications. Note also that a CGM may
explicitly specify a named font which may override a font
provided on the command line. The environment variable FONTCAP
may also be used to specify a default fontcap.
If fontcap is preceded by a UNIX directory path then ctrans will
look in that directory for the specified fontcap. Otherwise idt
searches the directory $NCARG_ROOT/lib/ncarg/fontcaps for the
fontcap.
See fontcap(5NCARG) for a description of the available fontcaps.
See fcap(1NCARG) for a list of the fontcaps installed on your
system.
This option overrides the FONTCAP environment variable.
-history
Write a record of all commands sent to the translator to the
file ./.idthist.
-Version
Print the version number and then exit.
The following options are ignored by idt and are passed on to the
metafile translator ictrans. See ictrans(1NCARG) for a description of
their use.
-soft
-lmin linewidth
-lmax linewidth
-lscale linewidth
-pal pal_fname
-foreground color
-background color
-reverse
CONTROL PANEL COMMANDS
The control panel provides a text widget for displaying messages from
the translators and a row of command buttons. Messages are preceded
with the string "Display[X]", where "X" is an integer id associated
with the translator sending the message. The first translator spawned
is "Display[0]", the second is "Display[1]", etc.
select file
Selects a file for translation. This button brings up a popup
menu containing a file selection box. The uppermost dialog box
of the file selection box is used for specifying a filter for
searching for files. For example, the filter
"/usr/local/lib/*.cgm" finds all files in the directory
/usr/local/lib whose names end with ".cgm". The finder
understands standard shell metacharacters.
The bottom dialog box displays the currently selected file. The
user may enter a file name here or select one with the mouse
from the list of files displayed in the middle text widget.
display
Popup a display panel. A display panel is popped up ready for
translation of the file most recently selected with the file
selector. This command will fail if a file has not been
selected.
quit Quits the application and terminates all translators.
DISPLAY PANEL COMMANDS
The display panel provides a mechanism for manipulating the translator
associated with a particular metafile. On most systems the name of the
metafile appears in the title bar at the top of the panel. The first
row in the panel contains a scroll bar for randomly selecting a frame
to be translated. The label bar to the right displays the number of the
frame scrolled to. The panel is intended to resemble a video tape
editor. Thus, the second row contains play back, jog back, stop, jog
and play buttons, respectively. The third and forth rows contain more
complex display commands.
loop Toggle the looping mode on or off. When loop is on pressing the
play (playback) button causes the translator to process all the
frames in the segment sequentially (reverse sequentially) and
then start over from the beginning (end). The process continues
until the "stop" button is selected. By default loop mode is
off.
dup Sets duplication variable. If dup is set to 1 each frame is
displayed once, if dup is set to 2 each frame is displayed
twice, etc. The default value of dup is 1.
goto Go to the specified frame and translate it. goto provides
random access to the frames contained in the metafile.
skip Set the skip variable. If skip is set to 1 every other frame is
displayed during subsequent plays, if skip is set to 2 every
third frame is displayed, etc. The default value for skip is 0.
delay Set the between-frame animation delay-time. When idt is in
animation mode you may request that idt pause for a period of
time between the display of each image. The effect of setting a
delay time is to govern the speed at which idt "plays" imagery.
start segment
Define the first frame in the segment. This button and the stop
segment button define a segment which is a subset of the frames
contained in the metafile. When in play (playback) mode only the
frames contained within the defined segment are translated. The
default value for start segment is 1, the first frame in the
file.
stop segment
Define the last frame in the segment. The default frame is the
last frame in the file. Hence, by default the segment is the
entire metafile.
set window
Specify the workstation window (in the GKS sense). Four
coordinates are specified which define a rectangular window
which is a subset of normalized VDC rectangle with corner points
(0,0) and (1.0,1.0). The specified window is then mapped onto
the entire viewport. For example, if the workstation window is
defined by the corner points (0,0) and (0.5 0.5) then the lower
left quarter of a plot would be blown up to fill the largest
rectangle which fits in the drawing window while retaining the
aspect ratio described by the normalized coordinates.
Specification of such a window can be used for zooming and
panning.
done Terminate processing of current metafile.
current frame
Update the "Scrolled to Frame ->" label box with the number of
the current frame.
print Send the current frame to the printer. The print command brings
up a menu of all devices configured for accepting translator
output. This list is created dynamically in response to changes
in the spooler configuration file (see ncarv_spool(5NCARG)).
Selecting an item from the menu causes the current frame to be
sent to that device.
save Save a frame to a file. This command allows you to write the
metacode for the current frame to a file. The result is a
complete NCAR Computer Graphics Metafile (CGM) containing a
single frame.
unzoom Reset windowing transformations previously set by the zoom
command back to their default.
zoom Zoom in on an area of a plot. The function of this command is
identical to that of the window command. The zoom command,
however, allows you to select the area of interest interactively
with the mouse.
animate
Toggle animation mode on or off. When idt is put into animation
mode the currently defined segment is rasterized with the
translator and loaded into the X server memory. Subsequent idt
commands operate on the memory-resident images. Not all idt
commands are available in animation mode. By default animation
is off.
RESOURCES
As with all standard X applications, idt may be customized through
entries in the resource manager. In the following list of application
resources provided by idt the resource name is given followed by its
class in parentheses. These resources supplement the resources
provided by the widgets themselves.
history (Class History)
Specify whether a history of commands sent to the metafile
translators is recorded to the file "./.idthist" or not. The
default for this resource is "False".
fileSelectAction (Class FileSelectAction)
Set the default action to be executed after a file has been
selected with the file selection box. Currently the only value
this resource understands is "display".
messageHeight (Class MessageHeight)
Set the height in lines of text of the message display panel.
oldIdt (Class OldIdt)
Specifies the "-oldidt" option.
translatorDevice (Class TranslatorDevice)
Specify the output device for metafile translation. The default
for this resource is "X11".
translatorFont (Class TranslatorFont)
Specify the name of the fontcap to use for stroking text during
metafile translation. The default value for this resource is
"font1".
translatorSoft (Class TranslatorSoft)
Specifies the ictrans "-soft" option.
translatorLmin (Class TranslatorLmin)
Specifies the ictrans "-lmin" option.
translatorLmax (Class TranslatorLmax)
Specifies the ictrans "-lmax" option.
translatorLscale (Class TranslatorLscale)
Specifies the ictrans "-lscale" option.
translatorForeground (Class TranslatorForeground)
Specifies the ictrans "-foreground" option.
translatorBackground (Class TranslatorBackground)
Specifies the ictrans "-background" option.
translatorReverse (Class TranslatorReverse)
Specifies the ictrans "-reverse" option.
ACTIONS
idt provides the following actions for use in event translation:
FinderTranslation()
This action causes the file selector popup to search for files
using the key supplied in the file finder text box.
OkFinderTranslation()
This action notifies the file selector that a selection has been
made.
SelectFileTranslation()
This action updates the text box in the file selector which
displays the currently selected file.
OkSDTranslation()
This action confirms a selection made in one of the display
panel popup dialog boxes.
WIDGETS
In order to specify resources, it is useful to know the hierarchy of
the widgets which make up idt. In the notation below, indentation
indicates hierarchal structure. The widget class name is given first,
followed by the widget instance name.
Idt idt
Paned paned
Text text
Form form
Command select file
Command display
TopLevelShell <???>
Paned paned
Core canvas /* This is the drawing canvas
Form form
Scrollbar scrollbar
Label Scrolled to Frame ->
Form form
Command playback
Command jogback
Command stop
Command jog
Command play
Form form
Toggle loop
Command dup
Command goto
Command skip
Command delay
Command start segment
Command stop segment
Command set window
Form form
Command done
Command current frame
MenuButton print
SimpleMenu menu
SmeBSB <???>
SmeBSB <???>
SmeBSB <???>
|
|
dynamically configured
|
|
SmeBSB <???>
SmeBSB <???>
Command save
Command zoom
Command unzoom
Toggle animate
Grip grip
Grip grip
Grip grip
Grip grip
Grip grip
Command quit
Grip grip
Grip grip
Paned
EXAMPLES
The following resource specification can be used to set the default
size of the graphics display window to 200 by 200 pixels:
Idt*canvas.width: 200
Idt*canvas.height: 200
If you want to place the control panel in the top right corner insert
the following into your .Xdefaults file:
idt.geometry: -0+0
ENVIRONMENT
DISPLAY
This is the standard X environment variable for specifying
display name. If the translation output device is X11 this
variable MUST be set.
FONTCAP
Default fontcap specifier.
NCARG_ROOT
Path to root of NCAR Graphics installation.
NCARG_LIB
If set this variable contains the path to the installed NCAR
Graphics libraries. NCARG_LIB overrides NCARG_ROOT.
NCARG_TMP
If set, this environment variable contains a directory path to
be used for temporary files. On most systems the default is
/tmp. On some systems the default is /usr/tmp.
SHELL Specifies the UNIX shell that the file selector is to use for
expanding metacharacters. /bin/sh is used by default.
XENVIRONMENT
Specifies the name of a resource file that overrides the global
resources stored in the RESOURCE_MANAGER property.
FILES
\.idthist - Translator command history
file
$NCARG_ROOT/lib/ncarg/xapp/Idt - Default resource file for idt
$HOME/.ncarv_spool - User spooler configuration
file
$NCARG_ROOT/lib/ncarg/ncarv_spool - System spooler configuration
file
SEE ALSO
ctrans(1NCARG), fcaps(1NCARG), gcaps(1NCARG), ictrans(1NCARG), ncarv_spool(5NCARG), X(1), xrdb(1) Hardcopy: NCAR Graphics Fundamentals, UNIX Version
BUGS
Zooming in on large cell arrays causes the translator to crash.
CAVEATS
The metafile file translation process is performed by spawning the ictrans translator. ictrans does not understand standard X Toolkit options. Hence, the DISPLAY environment variable must be set when translating a metafile to be displayed in a window. You can not save "zoomed" plots to a file. More precisely, you may save a "zoomed" plot, however, the resultant plot will not be "zoomed". The "Scrolled to Frame" label is not continuously updated. The range with which one may zoom in on a plot with either the zoom or window command is severely limited by Xlibs use of 'short' integers for containing screen coordinate data. IRIX 4.x users should not set use the shared memory connection to their X server. i.e don't use the display shm:0. Background color changes don't work when idt is in animate mode. idt will use whatever color was most recently set in the animation segment for the entire segment.
COPYRIGHT
Copyright (C) 1987-2009 University Corporation for Atmospheric Research The use of this Software is governed by a License Agreement.
Opportunity
Personal Opportunity - Free software gives you access to billions of dollars of software at no cost. Use this software for your business, personal use or to develop a profitable skill. Access to source code provides access to a level of capabilities/information that companies protect though copyrights. Open source is a core component of the Internet and it is available to you. Leverage the billions of dollars in resources and capabilities to build a career, establish a business or change the world. The potential is endless for those who understand the opportunity.
Business Opportunity - Goldman Sachs, IBM and countless large corporations are leveraging open source to reduce costs, develop products and increase their bottom lines. Learn what these companies know about open source and how open source can give you the advantage.
Free Software
Free Software provides computer programs and capabilities at no cost but more importantly, it provides the freedom to run, edit, contribute to, and share the software. The importance of free software is a matter of access, not price. Software at no cost is a benefit but ownership rights to the software and source code is far more significant.
Free Office Software - The Libre Office suite provides top desktop productivity tools for free. This includes, a word processor, spreadsheet, presentation engine, drawing and flowcharting, database and math applications. Libre Office is available for Linux or Windows.
Free Books
The Free Books Library is a collection of thousands of the most popular public domain books in an online readable format. The collection includes great classical literature and more recent works where the U.S. copyright has expired. These books are yours to read and use without restrictions.
Source Code - Want to change a program or know how it works? Open Source provides the source code for its programs so that anyone can use, modify or learn how to write those programs themselves. Visit the GNU source code repositories to download the source.
Education
Study at Harvard, Stanford or MIT - Open edX provides free online courses from Harvard, MIT, Columbia, UC Berkeley and other top Universities. Hundreds of courses for almost all major subjects and course levels. Open edx also offers some paid courses and selected certifications.
Linux Manual Pages - A man or manual page is a form of software documentation found on Linux/Unix operating systems. Topics covered include computer programs (including library and system calls), formal standards and conventions, and even abstract concepts.
