.help dispname Mar12 votools
.ih
NAME
dispname -- Get the currently displayed image name
.ih
USAGE
dispname frame

.ih
PARAMETERS
.ls frame
Frame number to query.
.le

.ih
DESCRIPTION

The \fIDISPNAME\fR task is used to get the name of the image displayed
in the frame number specified by the \fIframe\fR parameter.

.ih
EXAMPLES

1. Print the displayed image name to the STDOUT

.nf
  votools> display dev$pix 1
  votools> dispname 1 verbose+
  dev$pix
.fi

2. Get the name, but use it within as script as a parameter:

.nf
    int  frame_num = 1
    dispname (frame_num)
    printf ("The displayed image is '%s'\n", dispname.name)
.fi


.ih
SEE ALSO

.endhelp
