1IDT(1NCARG) NCAR GRAPHICS IDT(1NCARG)
2
6 idt - X window interactive image display tool
7
9 idt [ -toolkitoption ... ] [ -background color ] [ -f font ] [ -fore‐
10 ground color ] [ -history ] [ -lmin min ] [ -lmax max ] [ -lscale scale
11 ] [ -oldidt ] [ -pal pal_fname ] [ -reverse ] [ -soft ] [ -Version ] [
12 metafile ]
13
15 idt provides a graphical user interface to the NCAR View interactive
16 metafile translator ictrans. idt supports a subset of the ictrans com‐
17 mand interface.
18 idt provides two types of command panels for interacting with imagery.
20 The first type is the control panel, which you see when you initially
21 invoke idt. The control panel displays messages from the translators,
22 provides a metafile selection utility and is responsible for instanti‐
23 ating the second type of command panel, the display panel. The display
24 panel provides mechanisms for controlling translators. Each display
25 panel manages a single metafile translator. There can be multiple dis‐
26 play panels in existence at the same time but only one control panel.
27
29 idt accepts all of the standard X Toolkit command line options (see
30 X(1)). idt also accepts the following options:
31 -f fontcap
33 Fontcap file to be used for stroking text. When interpreting
34 CGM TEXT command elements use fontcap as the default font for
35 textual translation. Note: CGMs may contain textual descriptions
36 which are not embedded in CGM TEXT elements. Hence they are not
37 influenced by fontcap specifications. Note also that a CGM may
38 explicitly specify a named font which may override a font pro‐
39 vided on the command line. The environment variable FONTCAP may
40 also be used to specify a default fontcap.
41 If fontcap is preceded by a UNIX directory path then ctrans will
43 look in that directory for the specified fontcap. Otherwise idt
44 searches the directory $NCARG_ROOT/lib/ncarg/fontcaps for the
45 fontcap.
46 See fontcap(5NCARG) for a description of the available fontcaps.
48 See fcap(1NCARG) for a list of the fontcaps installed on your
49 system.
50 This option overrides the FONTCAP environment variable.
52 -history
54 Write a record of all commands sent to the translator to the
55 file ./.idthist.
56 -Version
58 Print the version number and then exit.
59 The following options are ignored by idt and are passed on to the
61 metafile translator ictrans. See ictrans(1NCARG) for a description of
62 their use.
63 -soft
65 -lmin linewidth
67 -lmax linewidth
69 -lscale linewidth
71 -pal pal_fname
73 -foreground color
75 -background color
77 -reverse
79
81 The control panel provides a text widget for displaying messages from
82 the translators and a row of command buttons. Messages are preceded
83 with the string "Display[X]", where "X" is an integer id associated
84 with the translator sending the message. The first translator spawned
85 is "Display[0]", the second is "Display[1]", etc.
86 select file
88 Selects a file for translation. This button brings up a popup
89 menu containing a file selection box. The uppermost dialog box
90 of the file selection box is used for specifying a filter for
91 searching for files. For example, the filter
92 "/usr/local/lib/*.cgm" finds all files in the directory
93 /usr/local/lib whose names end with ".cgm". The finder under‐
94 stands standard shell metacharacters.
95 The bottom dialog box displays the currently selected file. The
97 user may enter a file name here or select one with the mouse
98 from the list of files displayed in the middle text widget.
99 display
101 Popup a display panel. A display panel is popped up ready for
102 translation of the file most recently selected with the file
103 selector. This command will fail if a file has not been
104 selected.
105 quit Quits the application and terminates all translators.
107
109 The display panel provides a mechanism for manipulating the translator
110 associated with a particular metafile. On most systems the name of the
111 metafile appears in the title bar at the top of the panel. The first
112 row in the panel contains a scroll bar for randomly selecting a frame
113 to be translated. The label bar to the right displays the number of the
114 frame scrolled to. The panel is intended to resemble a video tape edi‐
115 tor. Thus, the second row contains play back, jog back, stop, jog and
116 play buttons, respectively. The third and forth rows contain more com‐
117 plex display commands.
118 loop Toggle the looping mode on or off. When loop is on pressing the
120 play (playback) button causes the translator to process all the
121 frames in the segment sequentially (reverse sequentially) and
122 then start over from the beginning (end). The process continues
123 until the "stop" button is selected. By default loop mode is
124 off.
125 dup Sets duplication variable. If dup is set to 1 each frame is dis‐
127 played once, if dup is set to 2 each frame is displayed twice,
128 etc. The default value of dup is 1.
129 goto Go to the specified frame and translate it. goto provides ran‐
131 dom access to the frames contained in the metafile.
132 skip Set the skip variable. If skip is set to 1 every other frame is
134 displayed during subsequent plays, if skip is set to 2 every
135 third frame is displayed, etc. The default value for skip is 0.
136 delay Set the between-frame animation delay-time. When idt is in ani‐
138 mation mode you may request that idt pause for a period of time
139 between the display of each image. The effect of setting a
140 delay time is to govern the speed at which idt "plays" imagery.
141 start segment
143 Define the first frame in the segment. This button and the stop
144 segment button define a segment which is a subset of the frames
145 contained in the metafile. When in play (playback) mode only the
146 frames contained within the defined segment are translated. The
147 default value for start segment is 1, the first frame in the
148 file.
149 stop segment
151 Define the last frame in the segment. The default frame is the
152 last frame in the file. Hence, by default the segment is the
153 entire metafile.
154 set window
156 Specify the workstation window (in the GKS sense). Four coordi‐
157 nates are specified which define a rectangular window which is a
158 subset of normalized VDC rectangle with corner points (0,0) and
159 (1.0,1.0). The specified window is then mapped onto the entire
160 viewport. For example, if the workstation window is defined by
161 the corner points (0,0) and (0.5 0.5) then the lower left quar‐
162 ter of a plot would be blown up to fill the largest rectangle
163 which fits in the drawing window while retaining the aspect
164 ratio described by the normalized coordinates. Specification of
165 such a window can be used for zooming and panning.
166 done Terminate processing of current metafile.
168 current frame
170 Update the "Scrolled to Frame ->" label box with the number of
171 the current frame.
172 print Send the current frame to the printer. The print command brings
174 up a menu of all devices configured for accepting translator
175 output. This list is created dynamically in response to changes
176 in the spooler configuration file (see ncarv_spool(5NCARG)).
177 Selecting an item from the menu causes the current frame to be
178 sent to that device.
179 save Save a frame to a file. This command allows you to write the
181 metacode for the current frame to a file. The result is a com‐
182 plete NCAR Computer Graphics Metafile (CGM) containing a single
183 frame.
184 unzoom Reset windowing transformations previously set by the zoom com‐
186 mand back to their default.
187 zoom Zoom in on an area of a plot. The function of this command is
189 identical to that of the window command. The zoom command, how‐
190 ever, allows you to select the area of interest interactively
191 with the mouse.
192 animate
194 Toggle animation mode on or off. When idt is put into animation
195 mode the currently defined segment is rasterized with the trans‐
196 lator and loaded into the X server memory. Subsequent idt com‐
197 mands operate on the memory-resident images. Not all idt com‐
198 mands are available in animation mode. By default animation is
199 off.
200
202 As with all standard X applications, idt may be customized through
203 entries in the resource manager. In the following list of application
204 resources provided by idt the resource name is given followed by its
205 class in parentheses. These resources supplement the resources pro‐
206 vided by the widgets themselves.
207 history (Class History)
209 Specify whether a history of commands sent to the metafile
210 translators is recorded to the file "./.idthist" or not. The
211 default for this resource is "False".
212 fileSelectAction (Class FileSelectAction)
214 Set the default action to be executed after a file has been
215 selected with the file selection box. Currently the only value
216 this resource understands is "display".
217 messageHeight (Class MessageHeight)
219 Set the height in lines of text of the message display panel.
220 oldIdt (Class OldIdt)
222 Specifies the "-oldidt" option.
223 translatorDevice (Class TranslatorDevice)
225 Specify the output device for metafile translation. The default
226 for this resource is "X11".
227 translatorFont (Class TranslatorFont)
229 Specify the name of the fontcap to use for stroking text during
230 metafile translation. The default value for this resource is
231 "font1".
232 translatorSoft (Class TranslatorSoft)
234 Specifies the ictrans "-soft" option.
235 translatorLmin (Class TranslatorLmin)
237 Specifies the ictrans "-lmin" option.
238 translatorLmax (Class TranslatorLmax)
240 Specifies the ictrans "-lmax" option.
241 translatorLscale (Class TranslatorLscale)
243 Specifies the ictrans "-lscale" option.
244 translatorForeground (Class TranslatorForeground)
246 Specifies the ictrans "-foreground" option.
247 translatorBackground (Class TranslatorBackground)
249 Specifies the ictrans "-background" option.
250 translatorReverse (Class TranslatorReverse)
252 Specifies the ictrans "-reverse" option.
253
255 idt provides the following actions for use in event translation:
256 FinderTranslation()
258 This action causes the file selector popup to search for files
259 using the key supplied in the file finder text box.
260 OkFinderTranslation()
262 This action notifies the file selector that a selection has been
263 made.
264 SelectFileTranslation()
266 This action updates the text box in the file selector which dis‐
267 plays the currently selected file.
268 OkSDTranslation()
270 This action confirms a selection made in one of the display
271 panel popup dialog boxes.
272
274 In order to specify resources, it is useful to know the hierarchy of
275 the widgets which make up idt. In the notation below, indentation
276 indicates hierarchal structure. The widget class name is given first,
277 followed by the widget instance name.
278 Idt idt
280 Paned paned
281 Text text
282 Form form
283 Command select file
284 Command display
285 TopLevelShell <???>
286 Paned paned
287 Core canvas /* This is the drawing canvas
288 Form form
289 Scrollbar scrollbar
290 Label Scrolled to Frame ->
291 Form form
292 Command playback
293 Command jogback
294 Command stop
295 Command jog
296 Command play
297 Form form
298 Toggle loop
299 Command dup
300 Command goto
301 Command skip
302 Command delay
303 Command start segment
304 Command stop segment
305 Command set window
306 Form form
307 Command done
308 Command current frame
309 MenuButton print
310 SimpleMenu menu
311 SmeBSB <???>
312 SmeBSB <???>
313 SmeBSB <???>
314 |
315 |
316 dynamically configured
317 |
318 |
319 SmeBSB <???>
320 SmeBSB <???>
321 Command save
322 Command zoom
323 Command unzoom
324 Toggle animate
325 Grip grip
326 Grip grip
327 Grip grip
328 Grip grip
329 Grip grip
330 Command quit
331 Grip grip
332 Grip grip
333 Paned
335
337 The following resource specification can be used to set the default
338 size of the graphics display window to 200 by 200 pixels:
339 Idt*canvas.width: 200
341 Idt*canvas.height: 200
342 If you want to place the control panel in the top right corner insert
344 the following into your .Xdefaults file:
345 idt.geometry: -0+0
347
349 DISPLAY
350 This is the standard X environment variable for specifying dis‐
351 play name. If the translation output device is X11 this variable
352 MUST be set.
353 FONTCAP
355 Default fontcap specifier.
356 NCARG_ROOT
358 Path to root of NCAR Graphics installation.
359 NCARG_LIB
361 If set this variable contains the path to the installed NCAR
362 Graphics libraries. NCARG_LIB overrides NCARG_ROOT.
363 NCARG_TMP
365 If set, this environment variable contains a directory path to
366 be used for temporary files. On most systems the default is
367 /tmp. On some systems the default is /usr/tmp.
368 SHELL Specifies the UNIX shell that the file selector is to use for
370 expanding metacharacters. /bin/sh is used by default.
371 XENVIRONMENT
373 Specifies the name of a resource file that overrides the global
374 resources stored in the RESOURCE_MANAGER property.
375
377 \.idthist - Translator command history
378 file
379 $NCARG_ROOT/lib/ncarg/xapp/Idt - Default resource file for idt
381 $HOME/.ncarv_spool - User spooler configuration
383 file
384 $NCARG_ROOT/lib/ncarg/ncarv_spool - System spooler configuration
386 file
387
389 ctrans(1NCARG), fcaps(1NCARG), gcaps(1NCARG), ictrans(1NCARG),
390 ncarv_spool(5NCARG), X(1), xrdb(1)
391 Hardcopy: NCAR Graphics Fundamentals, UNIX Version
393
395 Zooming in on large cell arrays causes the translator to crash.
396
398 The metafile file translation process is performed by spawning the
399 ictrans translator. ictrans does not understand standard X Toolkit
400 options. Hence, the DISPLAY environment variable must be set when
401 translating a metafile to be displayed in a window.
402 You can not save "zoomed" plots to a file. More precisely, you may save
404 a "zoomed" plot, however, the resultant plot will not be "zoomed".
405 The "Scrolled to Frame" label is not continuously updated.
407 The range with which one may zoom in on a plot with either the zoom or
409 window command is severely limited by Xlibs use of 'short' integers for
410 containing screen coordinate data.
411 IRIX 4.x users should not set use the shared memory connection to their
413 X server. i.e don't use the display shm:0.
414 Background color changes don't work when idt is in animate mode. idt
416 will use whatever color was most recently set in the animation segment
417 for the entire segment.
418
420 Copyright (C) 1987-2009
421 University Corporation for Atmospheric Research
422 The use of this Software is governed by a License Agreement.
424NCARG January 1993 IDT(1NCARG)