next up previous 200
Next: AGI_ANNUL - Annul a picture identifier
Up: Routine Specifications
Previous: AGD_NWIND - Define an IDI window from the current picture


AGD_SWIND - Save an IDI window in the database

Description:
Save an IDI window as a picture in the database. The new picture must be equal in size or smaller than the current picture in the database. The window coordinates define the size of the rectangular area in pixels and the offset of its bottom left corner from the memory origin. The name of the picture and a comment are used to identify the picture in the database. The name string has leading blanks removed and is converted to upper case. The world coordinates define the user coordinate system and are saved in the database as given. They should be linear and increasing left to right and bottom to top. If the picture was successfully created then a valid picture identifier is returned and the new picture becomes the current picture.

Invocation:
$\textstyle \parbox{135mm}{CALL AGD\_SWIND( DISPID, MEMID, XSIZE, YSIZE, XOFF, YOFF,
PNAME, COMENT, \\ WX1, WX2, WY1, WY2, PICID, STATUS )}$

Arguments:

DISPID = INTEGER (Given)
Display identifier
MEMID = INTEGER (Given)
Memory identifier
XSIZE = INTEGER (Given)
X size of window (pixels)
YSIZE = INTEGER (Given)
Y size of window (pixels)
XOFF = INTEGER (Given)
X offset of window from origin (pixels)
YOFF = INTEGER (Given)
Y offset of window from origin (pixels)
PNAME = CHARACTER $*$ ( $*$ ) (Given)
Name of picture
COMENT = CHARACTER $*$ ( $*$ ) (Given)
Description of picture
WX1 = REAL (Given)
World coordinate of left edge of new picture
WX2 = REAL (Given)
World coordinate of right edge of new picture
WY1 = REAL (Given)
World coordinate of bottom edge of new picture
WY2 = REAL (Given)
World coordinate of top edge of new picture
PICID = INTEGER (Returned)
Picture identifier
STATUS = INTEGER (Given and Returned)
The global status



next up previous 200
Next: AGI_ANNUL - Annul a picture identifier
Up: Routine Specifications
Previous: AGD_NWIND - Define an IDI window from the current picture

AGI --- Applications Graphics Interface Library
Starlink User Note 48
Nicholas Eaton
Brian McIlwrath
30 January 2002
E-mail:ussc@star.rl.ac.uk

Copyright © 2009 Science and Technology Facilities Council