display_image

Context: images

Synopsis

Sets the visibility of the specified image to true. Note that here, the visibility is in terms of show/hide and that other factors such as alpha channel, colormap, data limits, etc... may affect actually seeing the image.

Syntax

display_image()
display_image( [ChipsId] )
display_image( "image_id" )
display_image( "all" )

Description

Depending on the argument, this command displays the current image; the image indicated in a ChipsId structure or by the image_id; or all images.

(no argument) - the current image is displayed.
ChipsId - an optional ChipsId structure containing values to modify the currency state for the command.
image_id - identification tag given to each object that is created; use this to display a specific image.
all - displays all images.

Example 1

chips> add_image('evt2_image.fits')
chips> hide_image()
chips> display_image()

Create a image and hide it, then display the current image.

Example 2

chips> id = ChipsId()
chips> add_image('evt2_image.fits','id=events')
chips> hide_image('events')
chips> add_image('evt2_image2.fits')
chips> id.image = 'events'
chips> display_image(id)

Two images are created; the second image is current after it is created. The id.image command sets the image value of the ChipsId structure to the first image. That image is then displayed.

Example 3

chips> add_image('evt2_image.fits')
chips> add_image('evt2_image2.fits')
chips> hide_image('all')
chips> display_image('all')

Two images are created and hidden, then the display_image command displays them both.

Bugs

See the bugs pages on the ChIPS website for an up-to-date listing of known bugs.