Content-type: text/html Man page of X-GEN

X-GEN

Section: X-GEN Commands (1)
Updated: April 2005
Index Return to Main Contents
 

NAME

X-GEN - editbord  

SYNOPSIS

editbord

 

DESCRIPTION

"editbord" is a text-based editor for the detector's active area. It reads the current active area from the file with environment variable AMASK and in the end writes it out there. Text commands are directed to the standard input as follows:
verb shape val1 val2 [val3 . . . ]

The "verb" defines what kind of change we plan to make in the detector border. It can be abbreviated down to one or two letters as long as no ambiguity arises, and it is case-insensitive. Possible values are: Activate Blank Quit Toggle Shrink Write Exit

*
Activate unconditionally turn on a group of pixels
*
Blank unconditionally turn off a group of pixels
*
Quit quit the functionality without writing the AMASK.
*
Toggle change all "on" pixels to "off" and vice versa
*
Shrink examine the current edges of the border and move
the border inward by some number of pixels.
*
Write write the active-area image to AMASK now.
*
Exit write active-area image out and exit.
The "shape" defines the shape of object to be changed in a border-editing operation. Possible values are:
Box OBox Circle OCircle Column Row Shrinkv
*
Box rectangular area
*
OBox region outside a rectangular area
*
Circle circular area
*
OCircle region outside a circular area
*
Column group of columns defined by center column and width
*
Row group of rows defined by center row and height
*
Shrinkv how far in to shrink the active area within each row
The values, val1, val2, . . . specify numerical parameters associated with a given verb and shape.
*
Box xmin ymin xmax ymax defines the corners of a box inside of which the verb is to be applied. The four numeric arguments are the (X,Y) coordinates of the upper-left and the lower-right respectively.
*
Obox xmin ymin xmax ymax defines the corners of a box outside of which the verb is to be applied. The four numeric arguments are the (X,Y) coordinates of the upper-left and lower-right corners respectively.
*
Circle xcen ycen radius defines the coordinates of a circle inside of which the verb is to be applied. The three numeric arguments are the (X,Y) coordinates of the center of the circle and its radius.
*
Ocircle xcen ycen sradius defines the coordinates of a circle outside of which the verb is to be applied. The three numeric arguments are the (X,Y) coordinates of the center of the circle and its radius.
*
Row ymin ymax defines the coordinates of group of rows to be manipulated as part of changing the detector border. The two numeric arguments are the Y value of the center-most row in the group and the number of rows to be altered thus if we wish to alter rows 130 through 134, we would specify 132 as the center and 5 as the number of rows.
*
Column xmin xmax defines the coordinates of group of columns to be manipulated as part of changing the detector border. The two numeric arguments are the X value of the center-most row in the group and the number of columns to be altered; thus if we wish to alter columns 130 through 134, we would specify 132 as the center and 5 as the number of columns.
*
Shrinkval sval defines the number of pixels to push the border inwards on a SHRINK operation. Note that the SHRINK operation operates only on the outermost portions of the border within any given row; thus if the first and last pixels active in a row are 5 and 495, and the user provides a SHRINKVAL value of 7 here, the left and right edges of the row will be altered to 12 and 487 respectively, and anything in between will be left unaltered.
 

EXAMPLES

editbord > blank box 4 490 530 520 > blank circle 508 514 34 > exit
Define the shadow of the beam-stop support as a rectangle from [X,Y] = [4, 490] through [530,520] and the shadow of the beam-stop itself as a circle of radius 34 centered at [X,Y] = 508, 514.
 

REPORTING BUGS

Report bugs to Andy Howard at howard@iit.edu or 312-567-5881.  

COPYRIGHT

Copyright © 2002, Illinois Institute of Technology. See the file 'LICENSE' for information on usage and redistribution of this file, and for a DISCLAIMER OF ALL WARRANTIES


 

Index

NAME
SYNOPSIS
DESCRIPTION
EXAMPLES
REPORTING BUGS
COPYRIGHT

This document was created by man2html, using the manual pages.
Time: 02:08:09 GMT, October 03, 2005