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:
-
- 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: 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