Retrieve descriptions of regions applied to a displayed image
String_Type[] ds9_get_regions()
String_Type[] ds9_get_regions( [ file_name, handle ] )
Returns a, possibly empty, string array describing the regions that have been applied to the current image frame. Results will be given in the current region file format and coordinate system. The latter defaults to the internal DS9 format, and both may be changed within the Region menu of the GUI.
A stirng passed as the first argument will be interpreted as the name of a file to which the region descriptions should be writted, and will be echoed back to the caller as the onlu element within the results array.
Some region formats will prepend one or more comment lines (beginning with a '#') prior to the actual regions, unless the "strip" option has been selected within the GUI.
- ds9
-
ds9_center,
ds9_clear,
ds9_get_array,
ds9_get_cmap,
ds9_get_coords,
ds9_get_crosshair,
ds9_get_file,
ds9_get_scale,
ds9_get_zoom,
ds9_launch,
ds9_pan,
ds9_put_array,
ds9_put_crosshair,
ds9_put_file,
ds9_put_regions,
ds9_put_wcs,
ds9_put_wcs_keys,
ds9_put_wcs_struct,
ds9_quit,
ds9_set_cmap,
ds9_set_scale,
ds9_set_zoom,
ds9_view
- modules
-
ds9
|
![[CIAO Logo]](../imgs/ciao_logo_navbar.gif){kind=logo}