next up previous 530
Next: PIXDUPE - Expands an NDF by pixel duplication
Up: Specifications of KAPPA applications
Previous: PICVIS - Finds the first unobscured FRAME picture in the graphics database


PICXY - Creates a new FRAME picture defined by co-ordinate bounds

Description:
This command creates a new FRAME picture in the graphics database. The bounds of the new picture are defined through two parameters. The new picture is formed within either the current or BASE picture, and it adopts the world co-ordinate system of that reference picture. On completion the new picture becomes the current picture.

This command is a synonym for picdef xy 1.0.


Usage:
picxy lbound ubound

Parameters:
CURRENT = _LOGICAL (Read)
TRUE if the new picture is to lie within the current picture, otherwise the new picture can lie anywhere within the BASE picture. In other words, when CURRENT is TRUE the current picture is the reference picture, and when it is FALSE the base is the reference picture. [FALSE]
DEVICE = DEVICE (Read)
The graphics device. [current graphics device]
LBOUND( 2 ) = _REAL (Read)
Co-ordinates of the lower bound that defines the new picture. The suggested default is the bottom-left of the current picture.
OUTLINE = _LOGICAL (Read)
If TRUE, a box that delimits the new picture is drawn. [TRUE]
UBOUND( 2 ) = _REAL (Read)
Co-ordinates of the upper bound that defines the new picture. The suggested default is the top-right of the current picture.

Examples:
picxy [0.1,0.2] [0.9,0.6]
This creates a new FRAME picture in the BASE picture extending from (0.1, 0.2) to (0.9, 0.6), which becomes the new current picture. An outline is drawn around the picture.
picxy ubound=[1.1,0.9] lbound=[0.1,0.2] current nooutline
This creates a new FRAME picture in the current picture extending from (0.1, 0.2) to (1.1, 0.9), which becomes the new current picture. No outline is drawn.

Related Applications :
KAPPA: PICCUR, PICDEF, PICGRID, PICSEL.



next up previous 530
Next: PIXDUPE - Expands an NDF by pixel duplication
Up: Specifications of KAPPA applications
Previous: PICVIS - Finds the first unobscured FRAME picture in the graphics database

KAPPA --- Kernel Application Package
Starlink User Note 95
Malcolm J. Currie & David S. Berry
2013 February 14
E-mail:starlink@jiscmail.ac.uk

Copyright © 2013 Science and Technology Facilities Council