Next: Communication Interfaces Up: No Title Previous: Table Interfaces

Graphics Interfaces

Module Version 1.0 (27-Oct-1993) Module PCA

Author: R.M. van Hees ESO-IPG, Garching

Language: C

Classification: High Level Graphics Interfaces

Source file: $MIDASHOME/$MIDVERS/libsrc/plot/pca.c

Environment:

Midas and AGL
#include <agl.h> /* Prototypes for AGL application programs */
#include <midas_def.h> /* Prototypes for MIDAS interfaces */
#include <plot_def.h> /* Symbols used by the PLT interfaces */

Comments: The module contains the routines to draw a coordinate box. The main arguments used by the routines are:

xmnmx: floating point array holding minimum and maximum value along the X-axis,
ymnmx: floating point array holding minimum and maximum value along the Y-axis,
labelx: character array to be drawn as label along the X-axis
labely: character array to be drawn as label along the Y-axis
xwcfrm: floating point array with the definition of the X-axis: amin, amax, abig ticksteps, asmall tickstep
ywcfrm: floating point array with the definition of the Y-axis: amin, amax, abig ticksteps, asmall tickstep
AGLopt: character array with AGL options, see AGL reference manual.

History:

[1.0] 23-Sep-1993: Creation (R.M. van Hees)

Function

PCAXES

void PCAXES(xmnmx, ymnmx, labelx, labely, AGLopt)

float *xmnmx IN : minimum and maximum value along the X-axis

float *ymnmx IN : minimum and maximum value along the Y-axis

char *labelx IN : label along X-axis

char *labely IN : label along Y-axis

char *AGLopt IN : AGL option string, see AGL ref. manual (AG_AXES)

Purpose:Computes tick marks, and draws axes including tick marks and labels
Algorithm:PCAXES sets the clipping area so that it encloses the box defined by the axes. In practice this means that you can call PCDATA and PCHIST to plot your data within the drawn frame. The clipping area is NOT taken from the MIDAS keywords! The character dimension is not affected by PCAXES. PCAXES uses the AGL routine AG_AXES.

Function

PCFRAM

void PCFRAM(xwcfrm, ywcfrm, labelx, labely)

float *xwcfrm IN : definition of the X axis

float *ywcfrm IN : definition of the Y axis

char *labelx IN : label along the X axis

char *labely IN : label along the Y axis

Purpose:Draws a standard MIDAS coordinate frame including tick marks and labels
Algorithm:PCFRAM draws a standard MIDAS frame including tick marks and labels. Font, character size, line width and text thickness are defined by the current MIDAS setting. PCFRAM uses the AGL routine AG_AXIS.

External references:

<agl.h><midas_def.h><plot_def.h>
<stdio.h><string.h>
<math.h>

Module Version 1.0 (27-Oct-1993) Module PCD

Author: R.M. van Hees ESO-IPG, Garching

Language: C

Classification: High Level Graphics Interfaces

Source file: $MIDASHOME/$MIDVERS/libsrc/plot/pcd.c

Environment:

Midas and AGL
#include <agl.h> /* Prototypes for AGL application programs */
#include <plot_def.h> /* Symbols used by the PLT interfaces */
#include <midas_def.h> /* Prototypes for MIDAS interfaces */

Comments: The module contains the routine for plotting data points by lines, symbols, and histogram. In addition the module takes care of plotting text strings. The main arguments used by the routines are:

stype: Integer number defining the symbol type used, see SET/GRAPHIC options,
ltype: Integer number defining the line type used, see SET/GRAPHIC options,
binmod: Integer number: (0) bin mode OFF; (1) bin mode ON
fopt: floating point array, [0] histogram type selector: (= 0) simple staircase, (= 1) staircase steps joined to X-axis, (> 1) boxes with width starting from 0 (simple line) and increasing with mode value in steps of small character width, [1] space between the filling lines, [2] angle of the filling lines w.r.t. X-axis.
ipos: Integer number defining the centering position: (= 1) starts at (xc, yc), (= 2) ends at (xc, yc), or centred on (xc, yc)

History:

[1.0] 23-Sep-1993: Creation (R.M. van Hees)

Function

PCDATA

void PCDATA(stype, ltype, binmod, x_data, y_data, y_off, nrdata)

int stype IN : symbol type

int ltype IN : line type

int binmod IN : bin mode

float *x_data IN : X values of the data points

float *y_data IN : Y values of the data points

float y_off IN : offset along the Y-axis

int nrdata IN : number of points to be plotted

Purpose:Plot a set of points connected with lines, or indicated by symbols
Algorithm:The data points are connected with lines if ltype is not equal to zero. Symbols are only plotted when ltype equals zero. A graphic device must be defined. Coordinates refer to the current active coordinate system

Function

PCHIST

void PCHIST(nbins, cl, rfr, fopt)

int nbins IN : number of data points

float *cl IN : values along the X-axis

float *rfr IN : number of occurrences per bin

float fopt[ ] IN : histogram options

Purpose:PCHIST draws a histogram with an option to fill
Algorithm:A graphic device must be defined. Coordinates refer to the current active coordinate system. PCHIST uses the AGL routines AG_HIST and AG_FILL.

Function

PCTEXT

void PCTEXT(text, xc, yc, angle, chsiz, ipos)

char *text IN : text to be drawn

float xc IN : string position in X

float yc IN : string position in Y

float angle IN : text angle, in degrees w.r.t. x-axis

float chsiz IN : character expansion factor

int ipos IN : centering parameter

Purpose:PCTEXT draws a text in the current active viewport
Algorithm:Coordinates refer to the current active coorniate system. The routine makes use of the character size as stored in the graphic keywords, which is multiplied by CHSIZ

External references:

<agl.h><plot_def.h><midas_def.h><stdio.h><string.h>

Module Version 1.0 (27-Oct-1993) Module PCG

Author: R.M. van Hees ESO-IPG, Garching

Language: C

Classification: High Level Graphics Interfaces

Source file: $MIDASHOME/$MIDVERS/libsrc/plot/pcg.c

Environment:

Midas and AGL
#include <agl.h> /* Prototypes for AGL application programs */
#include <midas_def.h> /* Prototypes for MIDAS interfaces */

Comments: The module contains routine(s) to manipulate the graphics cursor. The main arguments used by the routines are:

xval: input: required initial x position of the locator
output: final locator x position
yval: input: required initial y position of the locator
output: final locator y position
key: key code (device dependent)

History:

[1.0] 23-Sep-1993: Created by R.M. van Hees

Function

PCGCUR

int PCGCUR(xval, yval, key)

float *xval IN/OUT : x value of the locator position

float *yval IN/OUT : y value of the locator position

int *key OUT : key code

Purpose:retrieve interactively positions from a graphic device
Algorithm:PCGCUR gets a graphics cursor and returns coordinates refering to the current active coordinate system. It returns an error message if the cursor is outside the clipping area.
PCGCUR uses AGL routine AG_VLOC
Returns:zero if the final position is within the clipping area

External references:

<agl.h><midas_def.h><stdio.h>

Module Version 1.0 (27-Oct-1993) Module PCK

Author: R.M. van Hees ESO-IPG, Garching

Language: C

Classification: High Level Graphics Interfaces, graphic keywords

Source file: $MIDASHOME/$MIDVERS/libsrc/plot/pck.c

Environment:

Midas
#include <midas_def.h> /* Prototypes for MIDAS interfaces */

Comments: The module PCK contains routines to interact with the graphic keywords of MIDAS. The graphic keywords contain values which can be read or written by the user, using a parameter name. For the definition of these name see section . Using parameter names offers a greater flexibility than using the standard interfaces directly, since the contents of the keywords may change, while the link between the parameter name and its value is saved.

The functions provided are:

read a parameter from a keyword (PCKRDC, PCKRDI, PCKRDR)
write a parameter to a keyword (PCKWRC, PCKWRI, PCKWRR)
set the graphic keywords to default (PCKDEF)

The main arguments used by the routines are:

cpar,ipar,rpar: name of a parameter in a keyword, see section
maxvals: maximum number of elements required
actvals: actual number of elements accessed, value returned by the routine
cval,ival,rval: buffer for the value(s) of the parameter

History:

[1.0] 23-Sep-1993: Created by R.M. van Hees

Function

PCKRDC

void PCKRDC(cpar, maxvals, actvals, cval)

char *cpar IN : character parameter to be found

int maxvals IN : no. of elements to get

int *actvals OUT : actual no. of elements returned

char *cval OUT : value of the parameter

Purpose:reads character values from keyword PLCSTAT, PLCMETA or PLCDATA

Function

PCKRDI

void PCKRDI(ipar, maxvals, actvals, ival)

char *ipar IN : integer parameter to be found

int maxvals IN : no. of elements to get

int *actvals OUT : actual no. of elements returned

int *ival OUT : value of the parameter

Purpose:reads integer values from keyword PLISTAT

Function

PCKRDR

void PCKRDR(rpar, maxvals, actvals, rval)

char *rpar IN : real parameter to be found

int maxvals IN : no. of elements to get

int *actvals OUT : actual no. of elements returned

float *rval OUT : value of the parameter

Purpose:reads real values from keyword PLRSTAT or PLRGRAP

Function

PCKWRC

void PCKWRC(cpar, cval)

char *cpar IN : name of the character parameter

char *cval IN : value of the parameter

Purpose:writes character values in keyword PLCSTAT, PLCMETA or PLCDATA

Function

PCKWRI

void PCKWRI(ipar, nrval, ival)

char *ipar IN : name of the integer parameter

int nrval IN : no. of elements to write, if zero then set IPAR to default

int *ival IN : value for the parameter

Purpose: writes integer values in keyword PLISTAT

Function

PCKWRR

void PCKWRR(rpar, nrval, rval)

char *rpar IN : name of the real parameter

int nrval IN : no. of elements to write, if zero then set RPAR to default

float *rval IN : value of the parameter

Purpose:writes real values in keyword PLRSTAT or PLRGRAP

Function

PCKDEF

void PCKDEF(void)

Purpose:restores the default MIDAS graphic setting

External references:

<midas_def.h><stdio.h><string.h>

Module Version 1.1 (29-Oct-1993) Module PCO

Author: R.M. van Hees ESO-IPG, Garching

Language: C

Classification: High Level Graphics Interfaces

Source file: $MIDASHOME/$MIDVERS/libsrc/plot/pco.c

Environment:

Midas and AGL
#include <agl.h> /* Prototypes for AGL application programs */
#include <osparms.h> /* Symbols used by the OS interfaces */
#include <plot_def.h> /* Symbols used by the PLT interfaces */
#include <midas_def.h> /* Prototypes for MIDAS interfaces */

Comments: The module contains the routine for opening and closing a graphics device The main arguments used by the routines are:

devnam: Name of the graphics device to open. The devic must be present in the `agldevs.dat' file containing all legal devices.
plname: Name of the meta (plot) file to open or to append
access: Integer number to set the access mode to cursor (= -1), over plot (= 1) or new plot (= 0)
plmode: Integer number to set the plot mode: (0) no axes and no info, (1) draw axes, labels and some info, (2) draw axes, labels and full info, (-1) use and return the current MIDAS setting.

History:

[1.0] 23-Sep-1993: FORTRAN to C (R.M. van Hees)

[1.1] 29-Oct-1993: made device and meta-file optional, RvH

Function

PCOPEN

void PCOPEN(devnam, plname, access, plmode)

char *devnam IN : name of device to be activated

char *plname IN : name of meta file

int access IN : access mode

int *plmode IN/OUT : plot mode

Purpose:sets up graphics device according to MIDAS settings
Algorithm:PCOPEN activates a given device (DEVNAM), or the current (by MIDAS) defined device if no device name is given. A given device has to be present in the ``AGLDEVS.dat'' file.
PCOPEN does not open, or append to, a meta file if PLNAME equals ``NO''ne. If no name, or a file name (with or without ``.plt'' extention) is given PCOPEN will open or append to a meta file (see access mode). Default for the name of the meta file is the name of the activated device extended with MIDAS session number. A meta file will always get the extension ``.plt'', any other extension will be replaced.
PCOPEN reads the MIDAS graphics keywords, opens this device (on graphics or image display) according to the MIDAS settings. The coordinate box has to be defined before the call to PCOPEN, by using the routine PCKWRR (PTKWRR) to write t he parameters XWNDL and YWNDL or the parameters XAXES or YAXES. The parameters SCALES and OFFSETS (see PCKWRR or PTKWRR) are always used by PCOPEN(!). They have to be set in the MIDAS procedure calling your program (see procedure ``plscoff'') or in your program if you do not want to use the previous setting. Note that you will always overrule them with SET/GRAPHIC.

Function

PCCLOS

void PCCLOS()

Purpose:close plot file, and terminate graphic operations

External references:

<agl.h><osparms.h><plot_def.h><midas_def.h>
<stdio.h><string.h><stdlib.h><math.h>

Module Version 1.0 (27-Oct-1993) Module PTA

Author: R.M. van Hees ESO-IPG, Garching

Language: Fortran 77

Classification: High Level Graphics Interfaces

Environment:

Midas and AGL
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DEF.INC
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DAT.INC

Comments: This module contains the routines to draw a coordinate box. Main arguments used by the routines are:

XMNMX: real array holding minimum and maximum value along the X-axis,
YMNMX: real array holding minimum and maximum value along the Y-axis,
LABELX: character array to be drawn as label along the X-axis
LABELY: character array to be drawn as label along the Y-axis
XWCFRM: real array with the definition of the X-is: amin, amax, abig ticksteps, asmall tickstep
YWCFRM: real array with the definition of the Y-axis: amin, amax, abig ticksteps, asmall tickstep
AGLOPT: character array with AGL options, see AGL reference manual.

History:

[1.0] 23-Sep-1993: Creation (R.M. van Hees)

Subroutine

PTAXES

PTAXES(XMNMX, YMNMX, LABELX, LABELY, AGLOPT)

REAL XMNMX(2) IN : minimum and maximum value along the X-axis

REAL YMNMX(2) IN : minimum and maximum value along the Y-axis

CHARACTER*(*) LABELX IN : label along X-axis

CHARACTER*(*) LABELY IN : label along Y-axis

CHARACTER*(*) AGLOPT IN : option string, see AGL ref. manual (AG_AXES)

Purpose:Computes tick marks, and draws axes including tick marks and labels
Algorithm:PTAXES sets the clipping area so that it encloses the box defined by the axes. In practice this means that you can call PTDATA and PTHIST to plot your data within the drawn frame. The character dimension is not affected by PTAXES. PTAXES uses the AGL routine AG_AXES.

Subroutine

PTFRAM

PTFRAM(XWCFRM, YWCFRM, LABELX, LABELY)

REAL XWCFRM(4) IN : definition of the X axis

REAL YWCFRM(4) IN : definition of the Y axis

CHARACTER*(*) LABELX IN : label along the X axis

CHARACTER*(*) LABELY IN : label along the Y axis

Purpose:Draws a frame including tick marks and labels
Algorithm:PTFRAM draws a standard MIDAS frame including tick marks and labels. Font, character size, line width and text thickness are defined by the current MIDAS setting. PTFRAM uses the AGL routine AG_AXIS.

Module Version 1.0 (27-Oct-1993) Module PTD

Author: R.M. van Hees ESO-IPG, Garching

Language: Fortran 77

Classification: High Level Graphics Interfaces

Environment:

Midas and AGL
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DEF.INC
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DAT.INC

Comments:

This module contains the routines for plotting data points by lines, symbols, and histogram. In addition the module takes care of plotting text strings. The main arguments used by the routines are:

STYPE: Integer number defining the symbol type used, see SET/GRAPHIC options,
LTYPE: Integer number defining the line type used, see SET/GRAPHIC options,
BINMOD: Integer number: (0) bin mode OFF; (1) bin mode ON
FOPT: real array,
(1) histogram type selector: (= 0) simple staircase, (= 1) staircase steps joined to X-axis, (> 1) boxes with width starting from 0 (simple line) and increasing with mode value in steps of small character width,
(2) space between the filling lines,
(3) angle of the filling lines w.r.t. X-axis.
IPOS: Integer number defining the centering position: (= 1) starts at (xc, yc), (= 2) ends at (xc, yc), or centred on (xc, yc)

History:

[1.0] 23-Sep-1993: Creation (R.M. van Hees)

Subroutine

PTDATA

PTDATA(STYPE,LTYPE,BINMOD,XDATA, YDATA, YOFF, NRDATA)

INTEGER STYPE IN : symbol type

INTEGER LTYPE IN : line type

INTEGER BINMOD IN : bin mode

REAL XDATA(NRDATA) IN : X values of the data points

REAL YDATA(NRDATA) IN : Y values of the data points

REAL YOFF IN : offset along the Y-axis

INTEGER NRDATA IN : number of points to be plotted

Purpose:Plot a set of points connected with lines, or indicated by symbols
Algorithm:The data points are connected with lines if ltype is not equal to zero. Symbols are only plotted when ltype equals zero. A graphic device must be defined. Coordinates refer to the current active coordinate system

Subroutine

PTHIST

PTHIST(NBINS, CL, RFR, FOPT)

INTEGER NBINS IN : number of data points

REAL CL(NBINS) IN : values along the X-axis

REAL RFR(NBINS) IN : number of occurrences per bin

REAL FOPT(3) IN : array with the histogram options

Purpose:PTHIST draws a histogram with an option to fill
Algorithm:A graphic device must be defined. Coordinates refer to the current active coordinate system. PTHIST uses the AGL routines AG_HIST and AG_FILL

Subroutine

PTTEXT

PTTEXT(TEXT,XC,YC,ANGLE,CHSIZ,IPOS)

CHARACTER*(*) TEXT IN : text to be drawn

REAL XC IN : string position in X

REAL YC IN : string position in Y

REAL ANGLE IN : text angle, in degrees w.r.t. x-axis

REAL CHSIZ IN : character expansion factor

INTEGER IPOS IN : centering parameter

Purpose:PTTEXT draws a text in the current active viewport
Algorithm:Coordinates refer to the current active coordinate system. The routine makes use of the character size as stored in the graphic keywords, which is multiplied by CHSIZ

Module Version 1.0 (27-Oct-1993) Module PTG

Author: R.M. van Hees ESO-IPG, Garching

Language: FORTRAN 77

Classification: High Level Graphics Interfaces

Environment:

Midas and AGL
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DEF.INC
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DAT.INC

Comments: The module contains routine(s) to manipulate the graphics cursor. The main arguments used by the routines are:

XVAL: input: required inital x position of the locator,
output: final locator position
YVAL: input: required inital y position of the locator,
output: final locator position
KEY: returned key code (device dependent)

History:

[1.0] 23-Sep-1993: Created by R.M. van Hees

Subroutine

PTGCUR

PTGCUR(XVAL,YVAL,KEY,IERR)

REAL XVAL IN/OUT : x position of the locator position

REAL YVAL IN/OUT : y position of the locator position

INTEGER KEY OUT : key code

INTEGER IERR OUT : error code

Purpose:retrieve interactively positions from a graphic device
Algorithm:PTGCUR gets a graphics cursor and returns coordinates referring to the current active coordinate system. It returns an error message if the cursor is outside the clipping area. PTGCUR uses the AGL routine AG_VLOC
Returns:zero if the final position is within the clipping area

Module Version 1.0 (27-Oct-1993) Module PTK

Author: R.M. van Hees ESO-IPG, Garching

Language: FORTRAN 77

Classification: High Level Graphics Interfaces, graphic keywords

Environment:

Midas
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DEF.INC
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DAT.INC

Comments: The module PTK contains routines to interact with the graphic keywords of MIDAS. The graphic keywords contain values which can be read or written by the user, using a parameter name. For the definition of these name see section . Using parameter names offers a greater flexibility than using the standard interfaces directly, since the contents of the keywords may change, while the link between the parameter name and its value is saved.

The functions provided are:

read a parameter from a keyword (PTKRDC, PTKRDI, PTKRDR)
write a parameter to a keyword (PTKWRC, PTKWRI, PTKWRR)
set the graphic keywords to default (PTKDEF)

The main arguments used by the routines are:

CPAR,IPAR,RPAR: name of a parameter in a keyword, see section
MAXVALS: maximum number of elements required
ACTVALS: actual number of elements accessed, returned by the routine
CVAL,IVAL,RVAL: buffer for the value(s) of the parameter

History:

[1.0] 23-Sep-1993: Created by R.M. van Hees

Subroutine

PTKRDC

PTKRDC(CPAR,MAXVALS,ACTVALS,CVAL)

CHARACTER*(*) CPAR IN : character parameter to be found

INTEGER MAXVALS IN : no. of elements to get

INTEGER ACTVALS OUT : actual no. of elements returned

CHARACTER*(*) CVAL OUT : value of the parameter

Purpose:reads character values from keyword PLCSTAT, PLCMETA or PLCDATA

Subroutine

PTKRDI

PTKRDI(IPAR, MAXVALS, ACTVALS, IVAL)

CHARACTER*(*) IPAR IN : integer parameter to be found

INTEGER MAXVALS IN : no. of elements to get

INTEGER ACTVALS OUT : actual no. of elements returned

INTEGER IVAL(*) OUT : value of the parameter

Purpose:reads integer values from keyword PLISTAT

Subroutine

PTKRDR

PTKRDR(RPAR, MAXVALS, ACTVALS, RVAL)

CHARACTER*(*) RPAR IN : real parameter to be found

INTEGER MAXVALS IN : no. of elements to get

INTEGER ACTVALS OUT : actual no. of elements returned

REAL RVAL(*) OUT : value of the parameter

Purpose:reads real values from keyword PLRSTAT or PLRGRAP

Subroutine

PTKWRC

PTKWRC(CPAR, CVAL)

CHARACTER*(*) CPAR IN : name of the character parameter

CHARACTER*(*) CVAL IN : value of the parameter

Purpose:writes character values in keyword PLCSTAT, PLCMETA or PLCDATA

Subroutine

PTKWRI

PTKWRI(IPAR, NRVAL, IVAL)

CHARACTER*(*) IPAR IN : name of the integer parameter

INTEGER NRVAL IN : no. of elements to write, if zero then set IPAR to default

INTEGER IVAL(*) IN : value for the parameter

Purpose:writes integer values in keyword PLISTAT

Subroutine

PTKWRR

PTKWRR(RPAR, NRVAL, RVAL)

CHARACTER*(*) RPAR IN : name of the real parameter

INTEGER NRVAL IN : no. of elements to write, if zero then set RPAR to default

REAL RVAL(*) IN : value of the parameter

Purpose:writes real values in keyword PLRSTAT or PLRGRAP

Subroutine

PTKDEF

PTKDEF

Purpose:restores the default MIDAS graphic setting

Module Version 1.1 (29-Oct-1993) Module PTO

Author: R.M. van Hees ESO-IPG, Garching

Language: FORTRAN 77

Classification: High Level Graphics Interfaces

Environment:

Midas and AGL
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DEF.INC
INCLUDE MID_DISK:[MIDAS.`version'.INC]ST_DAT.INC

Comments: The main arguments used by the routines are:

DEVNAM: Name of the graphics deivce to open
PLNAME: Name of the meta (plot) file to open or to append
ACCESS: Integer number to set the access mode to cursor (= -1), over plot (= 1) or new plot (= 0)
PLMODE: Integer number to set the plot mode: (0) no axes and no info, (1) draw axes, labels and some info, (2) draw axes, labels and full info, (-1) use and return the current MIDAS setting.

History:

[1.0] 23-Sep-1993: FORTRAN to C (R.M. van Hees)

[1.1] 29-Oct-1993: made device and meta-file optional, RvH

Subroutine

PTOPEN

PTOPEN(DEVNAM,PLNAME,ACCESS,PLMODE)

CHARACTER *(*) DEVNAM IN : name of device to be activated

CHARACTER *(*) PLNAME IN : name of meta file

INTEGER ACCESS IN : access mode

INTEGER PLMODE IN/OUT : plot mode

Purpose:sets up graphics device according to MIDAS settings
Algorithm:PTOPEN activates a given device (DEVNAM), or the current (by MIDAS) defined device if no device name is given. A given device has to be present in the ``AGLDEVS.dat'' file.
PTOPEN does not open, or append to, a meta file if PLNAME equals ``NO''ne. If no name, or a file name (with or without ``.plt'' extention) is given PTOPEN will open or append to a meta file (see access mode). Default for the name of the meta file is the name of the activated device extended with MIDAS session number. A meta file will always get the extension ``.plt'', any other extension will be replaced.
PTOPEN reads the MIDAS graphics keywords, opens the device (hardcopy, graphics or an image display) according to the keyword settings. The coordinate box has to be defined before the call to PCOPEN, by using the routine PCKWRR to write t he parameters XWNDL and YWNDL or the parameters XAXES or YAXES.

Subroutine

PTCLOS

PTCLOS()

Purpose:close plot file, and terminate graphic operations

Next: Communication Interfaces Up: No Title Previous: Table Interfaces

float *xmnmx	IN : minimum and maximum value along the X-axis
float *ymnmx	IN : minimum and maximum value along the Y-axis
char *labelx	IN : label along X-axis
char *labely	IN : label along Y-axis
char *AGLopt	IN : AGL option string, see AGL ref. manual (AG_AXES)

float *xwcfrm	IN : definition of the X axis
float *ywcfrm	IN : definition of the Y axis
char *labelx	IN : label along the X axis
char *labely	IN : label along the Y axis

int stype	IN : symbol type
int ltype	IN : line type
int binmod	IN : bin mode
float *x_data	IN : X values of the data points
float *y_data	IN : Y values of the data points
float y_off	IN : offset along the Y-axis
int nrdata	IN : number of points to be plotted

int nbins	IN : number of data points
float *cl	IN : values along the X-axis
float *rfr	IN : number of occurrences per bin
float fopt[ ]	IN : histogram options

char *text	IN : text to be drawn
float xc	IN : string position in X
float yc	IN : string position in Y
float angle	IN : text angle, in degrees w.r.t. x-axis
float chsiz	IN : character expansion factor
int ipos	IN : centering parameter

float *xval	IN/OUT : x value of the locator position
float *yval	IN/OUT : y value of the locator position
int *key	OUT : key code

char *cpar	IN : character parameter to be found
int maxvals	IN : no. of elements to get
int *actvals	OUT : actual no. of elements returned
char *cval	OUT : value of the parameter

char *ipar	IN : integer parameter to be found
int maxvals	IN : no. of elements to get
int *actvals	OUT : actual no. of elements returned
int *ival	OUT : value of the parameter

char *rpar	IN : real parameter to be found
int maxvals	IN : no. of elements to get
int *actvals	OUT : actual no. of elements returned
float *rval	OUT : value of the parameter

char *cpar	IN : name of the character parameter
char *cval	IN : value of the parameter

char *ipar	IN : name of the integer parameter
int nrval	IN : no. of elements to write, if zero then set IPAR to default
int *ival	IN : value for the parameter

char *rpar	IN : name of the real parameter
int nrval	IN : no. of elements to write, if zero then set RPAR to default
float *rval	IN : value of the parameter

char *devnam	IN : name of device to be activated
char *plname	IN : name of meta file
int access	IN : access mode
int *plmode	IN/OUT : plot mode

REAL XMNMX(2)	IN : minimum and maximum value along the X-axis
REAL YMNMX(2)	IN : minimum and maximum value along the Y-axis
CHARACTER() LABELX	IN : label along X-axis
CHARACTER() LABELY	IN : label along Y-axis
CHARACTER() AGLOPT	IN : option string, see AGL ref. manual (AG_AXES)

REAL XWCFRM(4)	IN : definition of the X axis
REAL YWCFRM(4)	IN : definition of the Y axis
CHARACTER() LABELX	IN : label along the X axis
CHARACTER() LABELY	IN : label along the Y axis

INTEGER STYPE	IN : symbol type
INTEGER LTYPE	IN : line type
INTEGER BINMOD	IN : bin mode
REAL XDATA(NRDATA)	IN : X values of the data points
REAL YDATA(NRDATA)	IN : Y values of the data points
REAL YOFF	IN : offset along the Y-axis
INTEGER NRDATA	IN : number of points to be plotted

INTEGER NBINS	IN : number of data points
REAL CL(NBINS)	IN : values along the X-axis
REAL RFR(NBINS)	IN : number of occurrences per bin
REAL FOPT(3)	IN : array with the histogram options

CHARACTER() TEXT	IN : text to be drawn
REAL XC	IN : string position in X
REAL YC	IN : string position in Y
REAL ANGLE	IN : text angle, in degrees w.r.t. x-axis
REAL CHSIZ	IN : character expansion factor
INTEGER IPOS	IN : centering parameter

REAL XVAL	IN/OUT : x position of the locator position
REAL YVAL	IN/OUT : y position of the locator position
INTEGER KEY	OUT : key code
INTEGER IERR	OUT : error code

CHARACTER() CPAR	IN : character parameter to be found
INTEGER MAXVALS	IN : no. of elements to get
INTEGER ACTVALS	OUT : actual no. of elements returned
CHARACTER() CVAL	OUT : value of the parameter

CHARACTER() IPAR	IN : integer parameter to be found
INTEGER MAXVALS	IN : no. of elements to get
INTEGER ACTVALS	OUT : actual no. of elements returned
INTEGER IVAL(*)	OUT : value of the parameter

CHARACTER() RPAR	IN : real parameter to be found
INTEGER MAXVALS	IN : no. of elements to get
INTEGER ACTVALS	OUT : actual no. of elements returned
REAL RVAL(*)	OUT : value of the parameter

CHARACTER() IPAR	IN : name of the integer parameter
INTEGER NRVAL	IN : no. of elements to write, if zero then set IPAR to default
INTEGER IVAL(*)	IN : value for the parameter

CHARACTER () DEVNAM	IN : name of device to be activated
CHARACTER () PLNAME	IN : name of meta file
INTEGER ACCESS	IN : access mode
INTEGER PLMODE	IN/OUT : plot mode