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

XREGION

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

NAME

xregion - interactively draw regions in an XITE overlayimage

SYNTAX

xregion [<option>...] <image-filename> [<maskimage>]

DESCRIPTION

xregionis a tool for drawing or editing overlay images. Onthe display, the overlays are drawn with an overlay colorpalette. Each color may represent a class in a classifiedimage. xregionhas an interface to regionAnalyse(1)andstatistics(1)which makes it very powerful.

The regions can be stored as masks in an output file, withbackground = 0 and region-pixels equal to a user specifiedvalue (1 - 254 ), default value = 1. Regions must be filledwith the same classnumber as they are drawn with.

OPTIONS

xregionaccepts all of the standard X Toolkit commandline options (see X(1)) as well as the XITE ximage(3)toolkit command line options.

ACTIONS

See Image(3)and ImageOverlay(3)for descriptions ofmenus, key bindings, colortables, zooming and panning.

xregionhas a few additional translations defined forediting. These translations invoke the notify action functiondefined by the Image(3)widget. This action function inturn calls the functions on the XtNcallback list. xregionadds the callback function which performs the actual work.

The additional translations are:

<Btn1Down>

Draw with the present "class" color.

<Btn2Down>

Fill region with the present "class" color.

<Btn3Down>

Clear region.

DRAW PUSHBUTTONS

Prev

Previous image band.

Next

Next image band.

Clear

Remove all regions (clear all overlays).

Read mask

Read a file of regions (an overlay image).

Save mask

Save the regions (an overlay image).

Save gray

Save the original image where regions are overlapping, setpixels to 0 otherwise.

Set class

Set region number for drawing (new draw color).

Close path

Fill regions

Fill all regions (all holes). This command will remove smallareas of background pixels.

Checkpoint

Save the current regions (overlays). Go back to this stateby pressing the Undo button. Checkpoint is done automaticallybefore each fill and delete operation performed with themouse button translations described in the Actionssectionabove.

Undo

Go back to the last checkpoint state.

Graphics

Toggle graphic overlay on/off.

Region analyse

Start the program regionAnalyseon the current regions. Setoptions with the Parameters pushbuttons. See the section belowand regionAnalyse(1).

This program will create a new window. To kill the window orsave the content of the window, choose from the menu you getby pressing Shift+<Btn2> in the text window.

Statistics

Invoke the program statistics(1).Set options with theParameters pushbuttons. See the section below.

Quit

Exit the program.

PARAMETER PUSHBUTTONS

These pushbuttons set options for regionAnalyseand/orstatistics.

RESOURCES

In order to specify resources, it is useful to knowthe hierarchy of the widgets which compose xregion.In the notation below, indentation indicates hierarchicalstructure.

The following hierarchy is constructed when the defaultresources/options for widget layout is used. The widgetsof class XfwfButton and XfwfToggle can be replaced by classCommand and Toggle (from the Athena widget set) by usingthe ximage(3)option -widgetsetor correspondingapplication resource.

xregion (class XRegion)

imageShell         (class TopLevelShell)
   imageForm        (class ImageForm)
     image          (class ImageOverlay)
     menubar        (class XfwfMenuBar)
       colors       (class XfwfPullDown)
       overlays     (class XfwfPullDown)
       tools        (class XfwfPullDown)
       options      (class XfwfPullDown)
xregion control panel (class TopLevelShell)
   topContainer     (class Form)
     Draw commands  (class Label)
     Prev           (class XfwfButton)
     Next           (class XfwfButton)
     Clear          (class XfwfButton)
     Read mask      (class XfwfButton)
     Save mask      (class XfwfButton)
     Save gray      (class XfwfButton)
     Set class      (class XfwfButton)
     Close path     (class XfwfButton)
     Fill regions   (class XfwfButton)
     Checkpoint     (class XfwfButton)
     Undo           (class XfwfButton)
     Graphics       (class XfwfToggle)
     Parameters     (class Label)
     Behaviour      (class Label)
     Header         (class XfwfToggle)
     Nc             (class XfwfToggle)
     Sort           (class XfwfToggle)
     Split          (class XfwfToggle)
     Overlay properties (class Label)
     Objnr          (class XfwfToggle)
     Regnr          (class XfwfToggle)
     Area           (class XfwfToggle)
     Perimeter      (class XfwfToggle)
     Minmax         (class XfwfToggle)
     Height         (class XfwfToggle)
     Width          (class XfwfToggle)
     Point          (class XfwfToggle)
     Image properties (class Label)
     Minmaxpix      (class XfwfToggle)
     Xymean         (class XfwfToggle)
     Volume         (class XfwfToggle)
     Mean           (class XfwfToggle)
     Median         (class XfwfToggle)
     Stdev          (class XfwfToggle)
     Commands       (class Label)
     Region analyse (class XfwfButton)
     Statistics     (class XfwfButton)
     Quit           (class XfwfButton)
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 - 256        (class SmeBSB)
   Rainbow - 256    (class SmeBSB)
overlaysmenu       (class SimpleMenu)
   menuLabel        (class SmeBSB)
   backgroundovl    (class SmeBSB)
   Std-overlay      (class SmeBSB)
   colorsep         (class SmeLine)
   White - mono     (class SmeBSB)
   Black - mono     (class SmeBSB)
toolsmenu          (class SimpleMenu)
   menuLabel        (class SmeBSB)
   imageinfo        (class SmeBSB)
   histogram        (class SmeBSB)
   slice            (class SmeBSB)
optionsmenu        (class SimpleMenu)
   menuLabel        (class SmeBSB)
   optionsmenusep   (class SmeLine)
   optionsmenuentry (class SmeBSB)
   optionsmenuentry (class SmeBSB)
   optionsmenuentry (class SmeBSB)
   optionsmenusep   (class SmeLine)
   optionsmenuentry (class SmeBSB)
   optionsmenuentry (class SmeBSB)
   optionsmenuentry (class SmeBSB)
subjobmenu         (class SimpleMenu)
   menuLabel        (class SmeBSB)
   savebuffer       (class SmeBSB)
   killwindow       (class SmeBSB)

FILES

$XITE_HOME/etc/app-defaults/XRegion

AUTHOR

Otto Milvang

REVISED

Svein Bře 22.11.95 and 96,Helene Schulerud 20.1.91,Tor L|nnestad 25.04.91,Otto Milvang 06.08.91

EXAMPLES

xregion mona.img
xregion -iw 1200 nbandimg.img:3

ID

$Id: xregion.c,v 1.100 1997/07/29 09:15:23 svein Exp $

This document was created byman2html,using the manual pages.