NAME: itool_tpannounce PURPOSE: (one line) Custom text and graphical-dialog tool, specific to template corruption. DESCRIPTION: CATEGORY: Widgets CALLING SEQUENCE: result = itool\_tpannounce(oitool, text, xcen, ycen) INPUTS: oitool : Object reference to host instance of the itool GUI. text : The text to be displayed in the text widget. xcen : The array of proposed X-locations for the active itool template. ycen : The array of proposed Y-locations for the active itool template. OPTIONAL INPUT PARAMETERS: KEYWORD PARAMETERS: FALSELABEL=false : Label for false button. Default='No' GROUP_LEADER=group_leader : Group leader. TRUELABEL=true : Label for true button. Default='Yes' TITLE=title : Title of widget. Default='qannounc'. XSIZE=ysize : Width, in characters, of the text display. YSIZE=ysize : Max size, in rows, of text display. OUTPUTS: result=0 if false button pressed, otherwise result=1. COMMON BLOCKS: SIDE EFFECTS: Suspends all event generation. A user response is required. RESTRICTIONS: PROCEDURE: Call this function from an instance of itool, when a template is about to be modified with a new set of object locations. The object locations will be listed, numerically, in a text widget, as well as being displayed in a separate draw widget. The draw widget will display a copy of the itool work window, with plots of the template that would be centered over the new object locations, if the new object locations were to be accepted. The itool object reference passed as the first argument is used to invoke itool's method routines (itool::draw and itool::tpdraw). Those method routines accept keywords that allow them to use an alternate window number and an alternate template. No new routines are needed to draw into the stand-alone draw widget launched by this function. MODIFICATION HISTORY: 2004/05 Written by Doug Loucks, consultant for Lowell Observatory.