next up previous 200
Next: AGP_SVIEW - Save the current PGPLOT viewport in the database
Up: Routine Specifications
Previous: AGP_DEASS - Deassociate a device from AGI and PGPLOT


AGP_NVIEW - Create a new PGPLOT viewport from the current picture

Description:
Create a new PGPLOT viewport from the current picture. The viewport will be created with the coordinate system of the current picture. The border flag allocates space around the plot for annotation if required. If true the viewport is made approximately 10% smaller than the picture to allow space for annotation. If false the viewport matches the picture exactly. If the device associated with the current picture is not open then this routine will open it, and additionally the viewport will be cleared if the access mode is 'WRITE' (in AGI_ASSOC or AGI_OPEN). If the SGS interface is already active then the first call to this routine will open PGPLOT in the current SGS zone. In this case the viewport normalised device coordinates will not match the coordinate system of the current picture, but will have the default range of 0 to 1.

Invocation:
CALL AGP_NVIEW ( BORDER, STATUS )

Arguments:

BORDER = LOGICAL (Given)
Flag to indicate if a border is to be left around the viewport
STATUS = INTEGER (Given and Returned)
The global status



next up previous 200
Next: AGP_SVIEW - Save the current PGPLOT viewport in the database
Up: Routine Specifications
Previous: AGP_DEASS - Deassociate a device from AGI and PGPLOT

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