SAOtng has defined a number of Public Access Points through which XPA commands can be communicated with SAOtng. A list of public access points is displayed below. The current list can obtained by typing:

    xpaget SAOtng

Each public access point can be accessed by means of the xpaset or xpaget command. For example, to change the colormap, type:

    csh> echo "colormap I8" | xpaset SAOtng

    csh> xpaget SAOtng colormap
    I8

The imset and imget programs are provided as a convenience. These programs assume that the target is SAOtng and allow a more natural command structure. For example, to change the colormap using imset, type:

    csh> imset colormap I8

    csh> imget colormap
    I8

******** A list of public access points ********

accel:		add an accel command
		  options:    [color]
analysis:	run analysis command on current image
		  options: [cmdno]
array:		display array file in current frame
		  options: [file name[xdim=%%d,ydim=%%d,bitpix=%%s,skip=%%d]]
blocking:	set block factor for extracting image data
		  options: [block factor|sum|average|new|next|prev]
cast:		set cast preference for in-memory FITS
		  options: [never|always|asNeeded]
colormap:	set colormap for current frame
		  options: [colormap name|invert|half|full]
coords:		set coordinate display
		  options: [none|pixels|hms|degrees]
destroy:		destroy current image
		  options: 1=erase screen(def) 0=leave
display_data:	get display data for frame
		  options: none
edge:		set image edge to ignore
		  options: value
env:		get(set) an environment variable
		  options: name (value)
exec:		execute commands in the data buffer
		  options: none
file:		display image file in current frame
		  options: [file name [file type]]
fits:		display FITS file in current frame
		  options: [fits name]
frame:		create or change display frame
		  options: [new|next|prev|frameno]
		define area of frame in which to display next image
		  options: [upper_left|upper_right|lower_left|lower_right|
			   center|full]
gif:		create gif from current frame
		  options: [GIF filename]
image:		get current image filename
		  options: none
images:		get list of currently loaded image files
		  options: none
label:		set a text label
		  options: text [x,y]
lower:		lower the image display window
print:		set execute print cmd in current frame
		  options: [printer options]
printer:	set printer options for PostScript printing
		  options: [print options|ghostview|file redirect]
quit:		exit program
raise:		raise the image display window
redisplay:	redisplay selected image in current frame
		  options: none
regions:	get regions for current or specified frame
		  options: [format(hms|degrees|pixels)type(all|source|background)]
rescale:	rescale selected image in current frame
		  options: [image]
save:		save FITS data of current image
		  options: [disk name]
scale:		set scale algorithm
		  options: [scale name]
scalelims:	set min/max for scaling
		  options: [min]|cur|data [max]|cur|data
section:		define section of image to display
		  options: upper_left|upper_right|lower_left|lower_right|
			   center|full
select:		select image 
		  options: [image [x y]] (in image coords)|
			   [frame [x y]] (in frame coords)|
			   none (to unselect)
shm:		map FITS image in shared memory
		  options: [name] [shmid] [len]
tcl:		execute tcl code
		  options: [tcl instructions]
zoom:		set zoom factor for current frame (pixel replication of frame)
		  options: [zoom value]

Last Updated March 7, 1996