1IDT(1NCARG)                      NCAR GRAPHICS                     IDT(1NCARG)
2
3
4

NAME

6       idt - X window interactive image display tool
7

SYNOPSIS

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

DESCRIPTION

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
19       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

OPTIONS

29       idt  accepts  all  of  the standard X Toolkit command line options (see
30       X(1)).  idt also accepts the following options:
31
32       -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
42              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
47              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
51              This option overrides the FONTCAP environment variable.
52
53       -history
54              Write a record of all commands sent to  the  translator  to  the
55              file ./.idthist.
56
57       -Version
58              Print the version number and then exit.
59
60       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
64       -soft
65
66       -lmin linewidth
67
68       -lmax linewidth
69
70       -lscale linewidth
71
72       -pal pal_fname
73
74       -foreground color
75
76       -background color
77
78       -reverse
79

CONTROL PANEL COMMANDS

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
87       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
96              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
100       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
106       quit   Quits the application and terminates all translators.
107

DISPLAY PANEL COMMANDS

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
119       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
126       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
130       goto   Go  to the specified frame and translate it.  goto provides ran‐
131              dom access to the frames contained in the metafile.
132
133       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
137       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
142       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
150       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
155       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
167       done   Terminate processing of current metafile.
168
169       current frame
170              Update  the  "Scrolled to Frame ->" label box with the number of
171              the current frame.
172
173       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
180       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
185       unzoom Reset windowing transformations previously set by the zoom  com‐
186              mand back to their default.
187
188       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
193       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

RESOURCES

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
208       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
213       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
218       messageHeight (Class MessageHeight)
219              Set the height in lines of text of the message display panel.
220
221       oldIdt (Class OldIdt)
222              Specifies the "-oldidt" option.
223
224       translatorDevice (Class TranslatorDevice)
225              Specify  the output device for metafile translation. The default
226              for this resource is "X11".
227
228       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
233       translatorSoft (Class TranslatorSoft)
234              Specifies the ictrans "-soft" option.
235
236       translatorLmin (Class TranslatorLmin)
237              Specifies the ictrans "-lmin" option.
238
239       translatorLmax (Class TranslatorLmax)
240              Specifies the ictrans "-lmax" option.
241
242       translatorLscale (Class TranslatorLscale)
243              Specifies the ictrans "-lscale" option.
244
245       translatorForeground (Class TranslatorForeground)
246              Specifies the ictrans "-foreground" option.
247
248       translatorBackground (Class TranslatorBackground)
249              Specifies the ictrans "-background" option.
250
251       translatorReverse (Class TranslatorReverse)
252              Specifies the ictrans "-reverse" option.
253

ACTIONS

255       idt provides the following actions for use in event translation:
256
257       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
261       OkFinderTranslation()
262              This action notifies the file selector that a selection has been
263              made.
264
265       SelectFileTranslation()
266              This action updates the text box in the file selector which dis‐
267              plays the currently selected file.
268
269       OkSDTranslation()
270              This  action  confirms  a  selection  made in one of the display
271              panel popup dialog boxes.
272

WIDGETS

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
279       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
334       Paned
335

EXAMPLES

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
340                 Idt*canvas.width:   200
341            Idt*canvas.height:  200
342
343       If you want to place the control panel in the top right  corner  insert
344       the following into your .Xdefaults file:
345
346                 idt.geometry:        -0+0
347

ENVIRONMENT

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
354       FONTCAP
355              Default fontcap specifier.
356
357       NCARG_ROOT
358              Path to root of NCAR Graphics installation.
359
360       NCARG_LIB
361              If  set  this  variable  contains the path to the installed NCAR
362              Graphics libraries.  NCARG_LIB overrides NCARG_ROOT.
363
364       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
369       SHELL  Specifies the UNIX shell that the file selector is  to  use  for
370              expanding metacharacters. /bin/sh is used by default.
371
372       XENVIRONMENT
373              Specifies  the name of a resource file that overrides the global
374              resources stored in the RESOURCE_MANAGER property.
375

FILES

377       \.idthist                               -  Translator  command  history
378                                               file
379
380       $NCARG_ROOT/lib/ncarg/xapp/Idt          - Default resource file for idt
381
382       $HOME/.ncarv_spool                      -  User  spooler  configuration
383                                               file
384
385       $NCARG_ROOT/lib/ncarg/ncarv_spool       - System spooler  configuration
386                                               file
387

SEE ALSO

389       ctrans(1NCARG),    fcaps(1NCARG),    gcaps(1NCARG),    ictrans(1NCARG),
390       ncarv_spool(5NCARG), X(1), xrdb(1)
391
392       Hardcopy: NCAR Graphics Fundamentals, UNIX Version
393

BUGS

395       Zooming in on large cell arrays causes the translator to crash.
396

CAVEATS

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
403       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
406       The "Scrolled to Frame" label is not continuously updated.
407
408       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
412       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
415       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
423       The use of this Software is governed by a License Agreement.
424
425
426
427NCARG                            January 1993                      IDT(1NCARG)
Impressum