Regions provide a means for marking particular
areas of an image for further analysis. Regions may also be used for presentation
purposes. DS9 supports a number of region descriptions, each of which may
be edited, moved, rotated, displayed, saved and loaded, via the GUI and
XPA.
The color property specifies the color
of the region when rendered. The follow 8 colors are supported:
white
black
red
green
blue
cyan
magenta
yellow
Example: color = green
Font
The font property specifies the font family,
size, and type of any text to be displayed along with the region.
Example: font="times 12 bold"
Can Select
The Select property specifies if the user
is allowed to select (hence, edit) the region via the GUI. For Regions
used for catalogs and such, it is desirable that the user is unable to
edit, move, or delete the region.
Example: select = 1
Can Edit
The Edit property specifies if the user
is allowed to edit the region via the GUI.
Example: edit = 1
Can Move
The Move property specifies if the user
is allowed to move the region via the GUI.
Example: move = 1
Can Rotate
The Rotate property specifies if the user
is allowed to rotate the region via the GUI.
Example: rotate = 1
Can Delete
The Delete property specifies if the user
is allowed to delete the region via the GUI. Example: delete
= 1
Include/Exclude
The Include/Exclude properties flags the
region with a boolean NOT for
later analysis.
Example: include = 1
Fixed in Size
The Fixed in Size property specifies that
the region does not change in size as the image magnification factor changes.
This allows the user to build complex pointer type regions.
Example: fixed = 1
External
Region Files
DS9 can read and write a number of region
file formats. Not all formats support all the functionality of DS9 regions.
Therefore, the user may loose some information when writing and then reading
back from a region file in a format other that DS9. The non-native formats
supported by DS9 are: