MAN page from RedHat Other XITE-3.3-3.i386.rpm

XSHOW

Section: User Commands (1)
Updated: 16 Mar 1998
Index

 

NAME

xshow - XITE X11 displayprogram for images and GUI for imageprocessing

 

SYNTAX

xshow[<option>...] [<BIFF-file>...] [+] [+<BIFF-file>...]

 

DESCRIPTION

xshowworks under the X Window System and displays acontrol window, a menu window and optionally one or moreimage windows. The image data are read from BIFF(Blab Image File Format) files. The menu-interface givesaccess to a large number of image processing algorithms.

Several popular image formats may be imported to andexported from xshow.

 

DISPLAY REQUIREMENTS

xshowwas originally developed for color workstationswith 8-bit PseudoColor displays, capable of showing 256different colors at the same time. Some work has been donealso for other visual types, especially for24-bit DirectColor and to a certain extent 24-bit TrueColor.xshowwill give a warning message if it does not likethe kind of visual you are using.

You can choose the visual type for the windows used to displayimages. Refer to ximage(3)and Visual(3)for informationon how to choose the visual type. The default behaviour is touse the PseudoColor visual type for image windows and thedefault visual type for menus, buttons etc.

 

OPTIONS

xshowaccepts all of the standard X Toolkit command lineoptions as well as the options defined by the ximagetoolkit.Refer to ximage(3)for information on the ximageoptions.

Additionally, xshowsupports the options listed below.

-i chan

Use input channel chan.This option may be used whenxshowis forked out of other programs. Refer tostart_xshow(3)and fork_xshow(1).

-m filename

This file contains the menu layout. No other menufilesare read. Default: $Dir/xshow_menues and $Dir/.xshowrc,where $Dir represents each directory in XSHOWPATH.See also the section Program menusbelow.

 

ARGUMENTS

Image files or colortable files in BIFF format.

A + in front of an image filename indicates that theimage is an overlay. A space-delimited + indicates an emptyoverlay. The overlay will be written to the image listedin front of it on the command-line. A + sign in front of acolortable filename indicates an overlay colortable.

All colortables given as arguments will be available from theColors popup menu within the images and from the menubar aboveeach image (see below). This resembles the -ctoption fromthe ximagetoolkit. However, an image will be displayed withthe last non-option colortable argument given to the left ofthe image argument on the command-line. With no suchnon-option colortable argument, the initial colortable for allcommand-line arguments is determined by the -ctoption fromthe ximagetoolkit. Without this option, the images aredisplayed initially with a gray-scale colortable.

Arguments which are overlay colortables, are treated thesame way as ordinary colortables, except that they becomeavailable from the OverlayColors menu and that the resemblingximagetoolkit option is -ovt.

See the section Examplesfurther down.

 

X TOOLKIT OPTIONS

The X Toolkit Intrinsics automatically accepts the followingoptions.

-display display

This option specifies the name of the X server to use.

-geometry geometry

This option specifies the initial size and location of thewindow.

-bg color, -background color

Either option specifies the color to use for the windowbackground.

-bd color, -bordercolor color

Either option specifies the color to use for the window border.

-bw number, -borderwidth number

Either option specifies the width in pixels of the windowborder.

-fg color, -foreground color

Either option specifies the color to use for text or graphics.

-fn font, -font font

Either option specifies the font to use for displaying text.

-iconic

This option indicates that the user would prefer that theapplication's windows initially are not visible, as if thewindows had been immediately iconified by the user. Windowmanagers may choose not to honor the application's request.

-name

This option specifies the name under which resources for theapplication should be found. This option is useful in shellaliases to distinguish between invocations of an application,without resorting to creating links to alter the executablefile name.

-rv, -reverse

Either option indicates that the program should simulatereverse video if possible, often by swapping the foregroundand background colors. Not all programs honor this orimplement it correctly. It is usually only used on monochromedisplays.

+rv

This option indicates that the program should not simulatereverse video. This is used to override any defaults sincereverse video doesn't always work properly.

-selectionTimeout

This option specifies the timeout in milliseconds within whichtwo communicating applications must respond to one another fora selection request.

-synchronous

This option indicates that requests to the X server should besent synchronously, instead of asynchronously. Since Xlibnormally buffers requests to the server, errors do notnecessarily get reported immediately after they occur. Thisoption turns off the buffering so that the application can bedebugged. It should never be used with a working program.

-title string

This option specifies the title to be used for this window.This information is sometimes used by a window manager toprovide some sort of header identifying the window.

-xnllanguage language[_territory][.codeset]

This option specifies the language, territory, and codeset foruse in resolving resource and other filenames.

-xrm resourcestring

This option specifies a resource name and value to overrideany defaults. It is also very useful for setting resourcesthat don't have explicit command line arguments.

 

RUN A PROGRAM FROM XSHOW

From the menu window it is possible to start programs/jobs.Parameters to these jobs may be existing images, andthe result may appear as new images.

1.

Select your choice of menu entry in the menu window. A menuentry may pop up a submenu. If the selected program expectsinput image(s), the Mouse state field in the Control windowwill change to JC.

2.

Select an Image (<Btn3>), a band (<Btn2>) or an area(<Btn1>) as input to the program.

If the program reads from stdin or writes to stdout,a text window for the job will be created.You may press Shift <Btn2>to save/delete thetext-window.

If the program writes to stderr, this will bewritten in the message area of the Control window.

To abort a program: Press the left mouse button in the mousestate field.

The menu hierarchy may be manipulated with the mouse only,or with a combination of mouse button activity and keyboardaccelerators. The keyboard accelerators are displayed in themenu entry labels. The mouse pointer must be inside theControl window for the accelerators to work. There areaccelerators for must submenus and command entries.

In addition to the accelerators displayed, one may usethe submenu popup-accelerators without the Ctrl key toget permanent versions of the submenus. These permanentversions are extracts of the originals, not containing anysubmenu buttons. They may be moved and iconified just asother windows (unless your windowmanager has been tolddifferently).

Inside the permanent submenu extracts, one may navigatewith arrow keys or Ctrl-n (next entry) or Ctrl-p (previousentry). A menu entry may be activated by hitting theReturn key (or clicking the left mouse-button).

A permanent submenu may be removed by hitting the "q" keywhile the mouse pointer is somewhere inside the submenu.

 

CONTROL WINDOW

xshowmay display several images. Each image band has itsown window (for an exception, see option -rgbabove).Histogram windows and slice windows (color palette) may becreated from the image windows. The Control windowgivesinformation about existing images and running jobs.

The various fields of the Control window are:

Menu

From the control menu you can press (using the left mousebutton, <Btn1>):

MacroThis toggle button indicates whether or not themacro-generating facility is active. Itprovides a mechanism for running a sequence ofalgorithms on several images, with a minimum of mousebutton activity (and with the same arguments to thealgorithms for each run).

Press this macro button and you will be asked to give aname for a macro. All activity generated via the menuwindow will be logged to a file with the macro name. Themacroname can optionally be added to the menu hierarchy asthe last entry in a menufile. You will be asked for thelocation of such a file. (See below, in the sectionProgram menus.)The menu hierarchy of xshowis updatedimmediately to reflect the change. The macro file canalternatively be executed from the UNIX command-line.

When running a macro from within the xshowmenuhierarchy, you must give the input images in thesame order as when the macro was generated (byclicking a mouse button as described in the sectionRun a program from xshow).

A macro run may leave fewer images displayed thanwhen the macro was generated. The rule here is thatonly those images which were not used as input toother commands (within the macro), are displayed.If you want to display also intermediate results,use the menu entry Copy imagein the Filemenuto display an extra copy while generating the macro.

A current limitation of the macro facility is thatany dialog input during macro generation is fixed inthe resulting macro (which of course can be manuallyedited).

HelpStart a help session. One of the following willhappen:
 1) The man page for xshow is displayed by
    starting the "man" program.
 2) "xman" is started.
 3) The WWW browser "netscape" is started on
    the front page of the online hypertext
    reference manual.
 4) The WWW browser "Mosaic" is started on the
    front page of the online hypertext
    reference manual.
 5) The WWW browser "lynx" is started on the
    front page of the online hypertext
    reference manual.
 6) The formatted manual page for xshow or some

other specified file is displayed with "more","less" or "cat".Which one of the above alternatives that is chosen,depends on the XShow X11 resource xiteHelper.This resource should be a colon-separated list ofnames of help programs. An example of setting thisresource in a resource file, is:

XShow*XiteHelper: netscape:Mosaic:lynx:xman:man

In this case, netscape is started. If it fails,Mosaic will be started. If this also fails, lynx willbe started, and so on.

Options to the help programs may be set with theresource xiteHelperOption. The setting is not usedfor Mosaic.

The resource setting for help programs may beoverridden by corresponding environment variables,called XITE_HELPER and XITE_HELPER_OPTION.

The environment variable XITE_DOC determineswhere the reference manual is found, in$XITE_DOC/ReferenceManual/Contents.html.

The environment variable XITE_MAN determines wherethe formatted manual page is found by "more", "less"and "cat".

QuitQuit xshow.

Info

Gives some information about the state

ImagesNumber of images.

JobsNumber of running jobs started by xshow.Press left mousebutton to get a list of all running jobs. The list iswritten in the message area.

MouseMouse state. N (Normal), JC (Job Control). Jobs startedwith the special argument <infile>(in the menufile),will read input image from one of the existing images. JCindicates that the program expects to read an image. Thejob may be aborted by pressing the left mouse button inthe mouse field.

Active image

When the cursor is on an image, xshowwill display

NameImage name. The n'th band of an image will have the namename:n.If more than one image has the same name, theywill be numbered name #nfor some integer n.

Zoom factorsMagnification and zoom. This field displays the ratiobetween the pixel size and the dot size. A zoom factor of4 indicates that an area of 4x4 dots on the screencorresponds to one pixel.

Size or posDepending on the Log positionoption (which is alsoavailable from the Optionsmenu), this field will eitherprint the image size or it will log cursor position(x, y, pixel value).

Message area

The message area displays additional information.

 

IMAGE WINDOWS

The following actions may be invoked in the image window.

resize

Images may be resized from window manager functions.If fixed aspect ratio is off, the window will get the sizeindicated by the window manager during the resize operation.If fixed aspect ratio is on, the window manager will notshow the correct size during the resize operation. Thefinal window size is determined by the following rule:If only the window width or the window height is changed,this will determine the new window size. If both window widthand window height are changed, the new window size isdetermined by the new window width.

zoom

 Ctrl  <Btn1>:       Zoom In
 Ctrl  <Btn2>:       Zoom Normal
 Ctrl  <Btn3>:       Zoom Out
 Shift Ctrl  <Btn1>: Zoom 8 x In
 Shift Ctrl  <Btn2>: Zoom = 32
 Shift Ctrl  <Btn3>: Zoom 8 x Out

Zoom normalmeans zoom factor equal to one, i.e. that onedot on the screen corresponds to one image pixel. This doesnot necessarily correspond to the zoom factor used initiallyfor an image if xshowwas started with the option -iwor-ih.If the screen window is larger than the image size,Zoom normalmeans to use the smallest possible zoom factor.

pan

 <Key>Left:        Pan 4 pixels left
 <Key>Right:       Pan 4 pixels right
 <Key>Up:          Pan 4 pixels up
 <Key>Down:        Pan 4 pixels down
 Shift <Key>Left:  Pan 16 pixels left
 Shift <Key>Right: Pan 16 pixels right
 Shift <Key>Up:    Pan 16 pixels up
 Shift <Key>Down:  Pan 16 pixels down
 Ctrl <Key>Left:   Pan 256 pixels left
 Ctrl <Key>Right:  Pan 256 pixels right
 Ctrl <Key>Up:     Pan 256 pixels up
 Ctrl <Key>Down:   Pan 256 pixels down

menus

By default, there is a menubar above each image. This can beremoved (see the section Options menubelow and theximage(3)toolkit option -mb).Additionally, the menus canalways be accessed with the following key combinations:

Shift <Btn1>Colors menu (see the section Colortablesbelow). Thismenu is available by default, but see also the ximagetoolkit option -colorsmenu.

Shift Alt <Btn1>OverlayColors menu (see the section Colortablesbelow).This menu is available by default, but see also theximagetoolkit option -overlaysmenu.

Shift <Btn2>Tools menu (Built-in programs, see the sections Imageinfo, Histogramand Slicebelow). This menu isavailable by default, but see also the ximagetoolkitoption -toolsmenu.

Shift Alt <Btn2>Visuals menu (to display the image with a differentvisual, see the description of the ximagetoolkitoption -iv).This menu is not available by default,but see also the ximagetoolkit option -visualsmenu.

Shift <Btn3>Options menu (see the section Options menubelow).This menu is available by default, but see also theximagetoolkit option -optionsmenu.

Mouse-bindings when Mouse State = JC (Job control)

None <Btn1>Drag region of interest.

None <Btn2>Select band.

None <Btn3>Select image.

Other key-bindings

qKill the image window

cIncrease current overlay draw color

pProtect current overlay (toggle on/off)

gToggle overlay graphics on/off

The above operations are defined in terms of translationtables, which refer to action functions. These actionfunctions are defined by the Image(3)and ImageOverlay(3)widgets. Refer to their descriptions for more information onthe action functions. Examples of the use of action functionsand translation tables can be found in the X11 applicationresources file for xshow.

 

ENVIRONMENT

xshowwill search for the files xshow_colortabs andxshow_menues in the directories given by the environmentvariable XSHOWPATH. The colortable filenames listed inxshow_colortabs are also searched for in these directories.See the sections Colortablesand Program menusas wellas the options -mand the ximagetoolkit options -cl,-ctand -ovl.

Under the csh shell you may set this environment variablewith the command
 setenv XSHOWPATH \
   $XITE_HOME/data/xshow

Under the Bourne shell sh, use the corresponding commands
 XSHOWPATH=\
   $XITE_HOME/data/xshow
 export XSHOWPATH

The program started when pushing the help-button isdetermined by the environment variable XITE_HELPER(with options determined by XITE_HELPER_OPTION).If these variables are not set, the program is determinedby corresponding X11 resource settings. See the sectionControl windowabove.

The online hypertext manual which is read for some settingsof XITE_HELPER, is assumed to be located in$XITE_DOC/ReferenceManual/Contents.html.

 

COLORTABLES

xshowwill search for a file xshow_colortabsin thedirectories listed in XSHOWPATH. This may be overridden withthe -cloption. The file should contain a list ofcolortable filenames. These files are expected to be foundin the same directory as the file xshow_colortabs.

Example

 !
 ! Sample colortables file.
 ! Lines beginning with ;, ! or # are comment lines
 ! Lines beginning with :S start standard colortabs
 ! Lines beginning with :O start overlay colortabs
 ! Lines beginning with @ read an include file
 !
 ! First read all standard colortables:
 !
 @$XSHOWPATH/xshow_colortabs
 !
 ! Add some private colortables
 !
 :Standard color tables
 mywhite.col
 myblack.col
 !
 ! Add an overlay table
 !
 :Overlay color tables
 myoverlay.col

These colortables will be available from the image windowColors and OverlayColors popup menus and menubar.

One of the entries in the Colors menu will be marked by an"x". This is the colortable in use for that particular image.

One of the entries in the OverlayColors menu will also bemarked by an "x". This is the colortable in use for theoverlay of that particular image (most images don't haveoverlays, but you can supply an overlay on the command-lineas described in the section Argumentsabove).

See the section Options menubelow for more informationon the relationship between the colortable for an image andthe colortable for the overlay of that image.

 

PROGRAM MENUS

xshowwill search for files with name xshow_menuesinall the directories specified by XSHOWPATH. This may beoverridden by using the -moption, in which case onlythe file given by this option will be read.

All menu files consist of menu entries. If more than onefile named xshow_menuesis found among the directoriesgiven by XSHOWPATH, all the entries are concatenated toform a larger menu hierarchy. Two conditions must be metfor this to work.

1.

One of the menu files must have a top-level menuwith the name Xshow.This file is called a master menufile.

2.

The names of the top-level menu of each of the other menu filesmust exist as entries in the top-level menu of the mastermenufile.

The menu file supplied with the XITE distribution has atop-level menu with the name Xshow.Two of the othertop-level menu-entries are Site-specific programsandMy programs.So, if you

1.

have a file called xshow_menuesin your home directory

2.

you call the top-level menu in this file My programs

3.

set the environment variable XSHOWPATH to include your homedirectory (in addition to the directory where xshow's ownmenu file is located)

your menu hierarchy will pop up under the menu entryMy programs.

In the same way, a menufile specific to the local siteor project can be created and included in the menuhierarchy.

The menu file supplied with the XITE distribution canprobably be found on your local system in the directory$XITE_HOME/data/xshow, where $XITE_HOME is the name of thedirectory into which XITE was installed.

The structure of a menu file is as follows.
 !
 ! Sample menu file.
 ! Lines beginning with ;, ! or # are comment lines
 !
 ! @ in first column reads an include file
 ! : in first column creates a new menu
 ! + in first column means that the entry is a new menu
 ! - in first column creates a menu separator
 ! ? in first column defines a dialog
 !   (blank) in first column means a simple entry
 !
 ! ONE MENU IN ONE OF THE MENU FILES MUST HAVE THE NAME
 ! "Xshow" (root menu) !!
 :Xshow
 +Arithmetic/logical
 +Others
 !
 !
 :Arithmetic/logical
 +Generate noisy images
 -One image/band
  Negate          ; negate <infile> <outfile>
  Scale           ; scale <infile> <outfile> ?dialog:scale
  Absolute value  ; absValue <infile> <outfile>
 -Two images/bands
  Absolute difference; absDiff <infile> <infile> <outfile>
  Signed difference ; signDiff <infile> <infile> <outfile>
 !
 ?scale
  scale the input image according to the formula \
  \
         output(x,y) = scale*input(x,y) + offset
  # scale:  # -scale  # f # 1.0 \
  # offset: # -offset # f # 0.0
 !
 ! This creates eight rows in the menu
 ! "Arithmetic/logical":
 !   - "Generate noisy images" (refers to a new menu)
 !   - "One image/band" (menu separator, i.e.
 !                       inactive entry)
 !   - "Negate"
 !   - "Scale"
 !   - "Absolute value"
 !   - "Two images/bands" (menu separator)
 !   - "Absolute difference"
 !   - "Signed difference"
 !
 ! Text before ; is the entry name.
 ! Text after ; is the command line (ordinary Unix
 ! commands).
 ! Some special arguments:
 !   <infile>       - Read input from mouse command.
 !   <outfile>      - Send output to xshow (image or
 !                    colortable).
 !   <xterm>        - Send textual output to a separate
 !                    text window. The command must be
 !                    able to interpret "-1" for stdout.
 !   ?writeBIFFfile - Standard dialog (ask for BIFF output
 !                    filename).
 !   ?readBIFFfile  - Standard dialog (ask for BIFF input
 !                    filename).
 !   ?dialog:dialogname - Fetch argument(s) from a dialog.
 !
 ! The dialog is defined over 3 lines, and the dialogname
 ! is global across all the menufiles in XSHOWPATH.
 line 1: ?dialogname
 line 2:  Info text for the program.
 line 3:  Description of expected input arguments.
 ! Refer to the standard menufile $XSHOWPATH/xshow_menues
 ! and FormDialog(3) for more information, especially
 ! on the third line of a menu dialog.
 !
 ! Lines may be continued if the last character on a
 ! line is a backslash.
 !
 ! There are standard filename dialogs also for other
 ! file types than BIFF files. See the section
 ! 'Widget hierarchy' below.

 

IMAGE INFO

The Image infoentry under the Toolsmenubar button, or thekey/mouse combination Shift <Btn2>+ Image infoentry(while the mouse pointer is in the image window) will printsome information about the image.

 

HISTOGRAM

The Histogramentry under the Toolsmenubar button, or thekey/mouse combination Shift <Btn2>+ Histogramentrywill create a histogram-window.

Press Ctrl <Btn1>in the histogram window to toggle betweenhistogram and cumulative histogram. The header displayspixel value and histogram value in absolute value andin percent of the total band.

The LUT may be manipulated by invoking the action Piecewiselinear, Threshold, Linear, Logarithmic or Exponential. The LUTmay be treated as a grayscale or separate red, green and blueLUT by choosing one of the options in the Modes menu.

Piecewise linear

Specify a piecewise linear polynomial.

<Btn1>Insert new breakpoint

<Btn2>Move breakpoint vertical

<Btn3>Delete breakpoint

Threshold

Set threshold.

<Btn1> horizontalSet threshold

Linear

Specify a linear transformation, p = ax + b.

<Btn1> verticalAdjust a.

<Btn1> horizontalAdbust b.

Logarithmic or Exponential

<Btn1> horizontal - Adjust log/exp factor.

Reset

Set initial values for the selected mode.

Histogram EQ

Make a new histogram equalized image.

Send min/max

Apply a linear transformation.

Send colortab

Send colortable back to xshow(add it to the list ofavailable colortables) or to file.

Send image

Transform the image according to the chosenLUT (for the selected mode only), and send image back toxshow.

 

SLICE (COLOR PALETTE)

The Sliceentry under the Toolsmenubar button, or thekey/mouse combination Shift <Btn2>+ Sliceentry willmake a piecewise constant lookup table (LUT) of pseudocolors.Colors may be mixed in a palette by specifying rgb or ihsvalues.

Buttons:

Send colortable to xshowSend LUT back to xshow

Send colortable to fileSave LUT in a file

Load original colortableLoad the colortable which the corresponding image usedwhen the slice application was started

Load colortable from fileRead LUT from file

Set patch in color rangeSelect a color index-range to fill with the color in thepalette

Actions

The following actions may be invoked in the colorfield inthe bottom of the slice window.

<Btn1Down>Fill LUT (and colorfield) at cursor position with thepalette color. This will most likely influence the image.

<Btn2Down>Set the palette color equal to the LUT value at thecursor position. This will influence the color palette.

<Btn3Down>Replace a constant part of LUT values around the cursorposition with the palette color.

Drag <Btn>Same as <Btn1Down>

 

COLORBAR

The Colorbarentry under the Toolsmenubar button, or thekey/mouse combination Shift <Btn2>+ Colorbarentry willdisplay this image's current colormap in a separate imagewindow.

 

OPTIONS MENU

Reduced colors

For 8-plane pseudocolor displays, this switch toggles between128 and 256 colors. For 24-plane DirectColor displays, ittoggles between approximately 16 million and 2 millioncolors.

The decision of using Reduced colorsor not has twoimplications

Technicolor effectsHow the colors on the display outside the image appear

Overlays possibleWhether one can use overlay images on top of other images

These two topics are treated in some more detail in theremaining description of this menu entry.

With Reduced colorsset on an 8-plane pseudocolor display,all pixel values are transformed to the range 64-191, andthis value is used to look up the color from the colortable.This means that from a 256-element colortable, only the entrieswith indices 64-191 are used.

One advantage of the above transformation is that the rest ofthe display is more likely to keep its original colors, evenwhen the mouse cursor is inside the image. At least the windowmanager colors and background colors are likely to stayunchanged. This is because the color entries for indices 0-63and 224-255 are copied from the default colortable of thedisplay. Window managers, display background, cursor colorsetc. are often chosen among these color entries. Displays withmultiple hardware colormaps tend to avoid this problem andthus don't benefit from this to the same degree. (SiliconGraphics is one vendor with such displays even on low-endworkstations.)

The other advantage of using a Reduced colorsscheme is thatanother image may be put on top of the first one. This otherimage may use a limited set of color-entries. This is exactlythe case with overlays in xshow(and in xregion).Theoverlay uses the color entries with indices 192-223 (32colors).

With the Colors menu, an image colortable is chosen. With theOverlayColors menu, a colortable for the overlay is chosen. Beaware, though, that the overlay colors are always installed inthe color entries with indices 192-223 in the currentcolortable for the image. Since all images use the same listof colortables (in the Colors menu), no two images withoverlays can use the same colortable and at the same timedifferent overlay colortables. (Of course, one may work aroundthis limitation by adding an extra copy of the imagecolortable and choose a different overlay colortable to beinstalled into this copy.)

The default behavior is to use reduced colors.

Fixed aspect

Toggle whether this image should maintain a fixed aspect ratio.

Menubar

Toggle the appearance of a menubar for this image.

ROI fill

If set, ROI (region of interest) will be inverted when youdrag <Btn1>.

ROI permanent

If set, display last ROI.

ROI square

If set, force ROI to be a square area.

ROI zoom & pan

If set, the ROI size and position will remain constant relativeto the image when an image is zoomed and panned. Otherwise,the ROI will have a fixed screen size in a fixed screenposition.

Interpret next as RGB

If set, the next image created will be interpreted as athree-band RGB image.

Log position

If set, display position and pixel value in the control window.Otherwise, display image size.

Zoom all

If set, force all images to be zoomed with the same parameters.

 

VISUALS MENU

Whether the entries in this menu are sensitive or not, dependson the visual capabilities of the display, which visual/depthis the default on this display, and the options -multivisualand -iv.

PseudoColor 8-plane

Create a copy of this image which can be displayed on aPseudoColor visual with depth 8.

DirectColor 24-plane

Create a copy of this image which can be displayed on aDirectColor visual with depth 24.

TrueColor 24-plane

Create a copy of this image which can be displayed on aTrueColor visual with depth 24.

 

WIDGET HIERARCHY

The widget hierarchy is listed here, to ease the settingof X resources. See also the section Resources.

For the xshowcontrol window.

xshow (class XShow)

 mainForm           (class Form)
   menuForm         (class Form)
     menuLabel      (class Label)
     action1Button  (class Toggle)
     action2Button  (class Command)
     action3Button  (class Command)
   infoForm         (class Form)
     infoLabel      (class Label)
     imagesLabel    (class Label)
     jobsButton     (class Command)
     mouseButton    (class Toggle)
   activeForm       (class Form)
     activeLabel    (class Label)
     imageNameLabel (class Label)
     zoomLabel      (class Label)
     dataLabel      (class Label)
   stderr           (class Text)

For the menu window (popup child of Control window)

mainMenu (class TopLevelShell)

                          (':' in the  menu file)
   menuBox                (class MenuBox)
     menuTopLabel         (class Label)
     <Command entry name> (class MenuCommand)
     menuSepLabel         (class Label)
     <Submenu label>      (class SubMenuCommand)

For non-permanent submenus (popup children of mainMenu)

<Submenu label> (class OverrideShell)

The children of the submenu are the same as those of themain menu.

For permanent submenus (popup children of mainMenu)

<Submenu label> (class TransientShell

   menuBox                (class MenuBox)
     menuTopLabel         (class Label)
     <Command entry name> (class MenuCommand)
     menuSepLabel         (class Label)

For the input file-selector window (popup child of Controlwindow or of Slice window).

fileSelectorShell (Class TransientShell)

 <readFileWidget>    (Class XfwfFileSelector)
   title             (Class Label)
   cur_dir_text      (Class Text)
   cur_file_text     (Class Text)
   path_list_title   (Class Label)
   path_list         (Class XfwfScrolledList)
     viewport        (Class Viewport)
       clip          (Class Core)
       vertical      (Class Scrollbar)
       multilist     (Class XfwfMultiList)
   file_list_title   (Class Label)
   file_list         (Class XfwfScrolledList)
     viewport        (Class Viewport)
       clip          (Class Core)
       vertical      (Class Scrollbar)
       multilist     (Class XfwfMultiList)
   goto_button       (Class Command)
   select_button     (Class Command)
   up_button         (Class Command)
   ok_button         (Class Command)
   cancel_button     (Class Command)

<readFileWidget> above is one of
   readBIFFfile      (for BIFF images)
   readColortabfile  (for BIFF colortables)
   readColormapfile  (for ascii colormaps)
   readTIFFfile      (for TIFF files)
   readMATfile       (for MATLAB files)
   readfile          (for any other file type)

For the output file-selector window (popup child of Controlwindow or of Slice window).

fileSelectorShell (Class TransientShell)

 <writeFileWidget>   (Class XfwfFileSelector)
   title             (Class Label)
   cur_dir_text      (Class Text)
   cur_file_text     (Class Text)
   path_list_title   (Class Label)
   path_list         (Class XfwfScrolledList)
     viewport        (Class Viewport)
       clip          (Class Core)
       vertical      (Class Scrollbar)
       multilist     (Class XfwfMultiList)
   file_list_title   (Class Label)
   file_list         (Class XfwfScrolledList)
     viewport        (Class Viewport)
       clip          (Class Core)
       vertical      (Class Scrollbar)
       multilist     (Class XfwfMultiList)
   goto_button       (Class Command)
   select_button     (Class Command)
   up_button         (Class Command)
   ok_button         (Class Command)
   cancel_button     (Class Command)

<writeFileWidget> above is one of
   writeBIFFfile     (for BIFF images)
   writeColortabfile (for BIFF colortables)
   writeColormapfile (for ascii colormaps)
   writeTIFFfile     (for TIFF files)
   writeMATfile      (for MATLAB files)
   writePSfile       (for PostScript files)
   writeMacrofile    (for xshow macro files)
   writefile         (for any other file type)

For the image window (popup child of Control window).

imageShell (class TopLevelShell)

 imageForm                (class ImageForm)
   image                  (class ImageOverlay)
   menubar                (class XfwfMenuBar)
     colors               (class XfwfPullDown)
     tools                (class XfwfPullDown)
       toolsmenu          (class SimpleMenu)
     options              (class XfwfPullDown)
       optionsmenu        (class SimpleMenu)

For the colorsmenu (popup child of application shell).

colorsmenu (class SimpleMenu)

 menuLabel      (class SmeBSB)
 backgroundcol  (class SmeBSB)
 Work-map       (class SmeBSB)
 colorsep       (class SmeLine)
 White - 256    (class SmeBSB)
 Black - 256    (class SmeBSB)
 Red - 256      (class SmeBSB)
 Green - 256    (class SmeBSB)
 Blue - 256     (class SmeBSB)
 Spectrum - 256 (class SmeBSB)
 Hue 1 - 256    (class SmeBSB)
 Rainbow - 256  (class SmeBSB)

The toolsmenu, optionsmenu, overlaysmenu and visualsmenuhave a hierarchy similar to the colorsmenu.

For the histogram window (popup child of imageShell).

histogramShell (class TopLevelShell)

 histogramForm               (class Form)
   histogramLabel            (class Label)
   histogram                 (class Histogram)
   histogramMenuForm         (class Form)
     histogramModeForm       (class Form)
       histogramModeLabel    (class Label)
       histogramModeList     (class XfwfMultiList)
     histogramActionsForm    (class Form)
       histogramActionsLabel (class Label)
       histogramActionsList  (class XfwfMultiList)
   colormap                  (class Colormap)

For the slice window (popup child of imageShell).

sliceShell (Class TopLevelShell)

 sliceForm                   (Class Form)
   topLabel                  (Class Label)
   scrollbarIntensity        (Class Scrollbar)
   scrollbarHue              (Class Scrollbar)
   scrollbarSaturation       (Class Scrollbar)
   scrollbarRed              (Class Scrollbar)
   scrollbarGreen            (Class Scrollbar)
   scrollbarBlue             (Class Scrollbar)
   labelIntensity            (Class Label)
   labelHue                  (Class Label)
   labelSaturation           (Class Label)
   labelRed                  (Class Label)
   labelGreen                (Class Label)
   labelBlue                 (Class Label)
   colorPatch                (Class Label)
   labelIhs                  (Class Label)
   labelRgb                  (Class Label)
   sendColtab                (Class Command)
   range                     (Class Command)
   quit                      (Class Command)
   color                     (Class Label)
   colorIndex                (Class Label)
   colorStripe               (Class Image)

 

RESOURCES

xshowuses the ImageOverlaywidget (subclass of theImagewidget). It understands all of the core X Toolkitand Athena resource names and classes as well.

The xshowapplication resources are defined by the ximagetoolkit. Refer to ximage(3)for a description.

For information about resources for the ImageOverlay widget,refer to ImageOverlay(3)and Image(3).

The resources that may be specified for the various menusof class SimpleMenu above, are described in the documentationfor the Athena SimpleMenu widget.

You may find some of the resources for the file-selector widgetparticularly useful:

<widget class or instance>*currentDirectory:

The directory path used.

Substitute <widget class or instance> byXfwfFileSelector (class) or one of the instancenames mentioned in the Widget hierarchysection(such as readBIFFfile, writeTIFFfile).

Examples
 XShow*XfwfFileSelector*currentDirectory: .
 XShow*XfwfFileSelector*currentDirectory: $HOME/img

<widget class or instance>*pattern:

A pattern which the filenames, displayed in the file list,must match.

Example
  XShow*readBIFFfile*pattern: *.img

<widget class or instance>*checkExistence:

Whether or not to demand existence of the specified file.

Examples
  XShow*readColortabfile*checkExistence:  True
  XShow*writeMacrofile*checkExistence: False

See the application defaults resource file for a list ofmore available resources, e.g. keyboard accelerators/shortcuts.This file is found in the directory$XITE_HOME/etc/app-defaults. The filename is XShow(capital 'S').

See also the above section Widget hierarchy.

 

FILES

$XSHOWPATH/xshow_menues, $XSHOWPATH/xshow_colortabs,$XITE_HOME/etc/app-defaults/XShow.

 

SEE ALSO

xite(1),ximage(3),mct(1),xhistogram(3),xhistogram(1),xslice(3),xregion(1),xadd(1),xfft(1),xfilter(1),xpyramid(1),xmovie(1),Image(3),ImageOverlay(3),histogram(3),FormDialog(3),start_xshow(3),fork_xshow(1),XfwfButton(3),XfwfFileSelector(3),XfwfFrame(3),XfwfLabel(3),XfwfToggle(3)

 

DIAGNOSTICS

Please report bugs to blabAATTifi.uio.no

 

EXAMPLES

Display an image with standard grayscale colortable
    xshow mona.img

Display an image with standard grayscale colortable andan extra given colortable available from the Colors menu.
    xshow mona.img mona.col

Display an image with a given colortable
    xshow mona.col mona.img

Display two images, both with the same given colortable.
    xshow mona.col mona.img lena.img

Display two images, with different given colortablesxshow mona.col mona.img lena.col lena.img

Display two images, mona.img with the colortable mona.col,lena.img with the colortable lena.col, and make green.colavailable from the Colors menu.
    xshow green.col mona.col mona.img lena.col lena.img
    xshow -ct green.col mona.col mona.img lena.col lena.img

Display an image with a given overlay image.
    xshow mona.img +lena.img

Display an image (mona.img) with a given colortable (mona.col)and a given overlay (lena.img) which has the given overlaycolortable (black.ovl.col).and overlay colortable
    xshow -ovt black.ovl.col mona.col mona.img +lena.img

Use xshow at the end of a pipe
    median mona.img - 5 | xshow -

Display an rgb image in a single window
    xshow -rgb -iv DirectColor reine_rgb.img

 

AUTHOR

Otto Milvang and Svein Bře

 

DOC

Otto Milvang and Svein Bře

---

 

Index

NAME

SYNTAX

DESCRIPTION

DISPLAY REQUIREMENTS

OPTIONS

ARGUMENTS

X TOOLKIT OPTIONS

RUN A PROGRAM FROM XSHOW

CONTROL WINDOW

IMAGE WINDOWS

ENVIRONMENT

COLORTABLES

PROGRAM MENUS

IMAGE INFO

HISTOGRAM

SLICE (COLOR PALETTE)

COLORBAR

OPTIONS MENU

VISUALS MENU

WIDGET HIERARCHY

RESOURCES

FILES

SEE ALSO

DIAGNOSTICS

EXAMPLES

AUTHOR

DOC

---

This document was created byman2html,using the manual pages.