FRAME initializes the graphics metafile/terminal/Ramtek software and resets internal variables. This routine is usually the first LONGLIB routine called (also see PLOTS which calls FRAME). FRAME must be activated before plotting calls are issued by the user program. FRAME should normally be called only once in a program. MASTER routines optionally handle the FRAME call.
FRAME intializes the graphics output device packages. The FORTRAN unit number used for the LONGLIB metafile can be specified. Normally, unit 3 is used. If unit 0 is specified, FRAME will prompt the user for a yes/no response to create a metafile. A negative unit number disables the metafile package. All calls to metafile routines (such as PPLOT) are dummy calls when the metafile package is disabled.
FRAME also initializes the screen graphics device. A screen device code is used to determine whether the Ramtek or Terminal screen device packages are open. If a negative value for the screen device code is used the screen device is not cleared prior to use, otherwise it is. If the screen device code is +/- 4, no screen device package is used and all calls to screen specific routines (such as PLOTRM or PLOTVT) are dummy calls. If a screen device code of 0 is used, the user is prompted for a screen device to use. The screen devices may then be selected using a character code. A reply of "?" will list the available options.
FRAME also intializes the origin and scale factor for plotting. The default origin on the terminal and the Ramtek is the lower left of screen (0.,0.). The X axis runs horzontally, while the Y axis runs vertically. The default origin on the printer is the upper left corner of page. The X axis runs vertically down page, while the Y axis runs horizontally across the page.
When the Ramtek Screen device is selected, FRAME opens a communications channel to the Ramtek. If no channel is available or the Ramtek is in use an error message is typed and the calling program is terminated.
CALL FRAME (pl,id,vpx,vpy,zom)
pl (I): Fortran file unit number (normally 3) used for LONGLIB
Metafile. If pl < 0 then no metafile is generated.
If pl = 0 then the user will be prompted for a yes/no
metafile. In this case unit number used will be 3.
id (I): Screen device code number.
< 0 : Do not clear Ramtek/terminal screens prior to use.
> 0 : Clear Ramtek/terminal screens prior to use.
= 0 : Prompts user for which screen device to use.
A ? response will list the available devices.
= 1 : Use VT100 as Screen Output (only) (Selanar GR100)
= 2 : Use Ramtek as Screen Output (only).
= 3 : Use both Ramtek and VT100 as Screen Output.
= 4 : Do not produce Screen output.
= 5 : Use VT125 as Screen Output (only)
= 6 : Use VT100 as Screen Output (only) (Selanar GR100)
= 8 : Use VT240 as Screen Output (only)
= 9 : Use VT220 as Screen Output (only) (Selanar SG220)
=10 : Use Tektronix 4010/4014 as Screen Output
=11 : Use Tektronix 4107/4109 as Screen Output
(color Tektronix)
=12 : Use Graph-On GO-235 as Screen Output
=13 : Use Xterm (Tektronics with control codes)
vpx, (R): relative x,y offset of the bottom left hand corner of
vpy the screen/page. Equivalent to PLOT(vpx,vpy,-3).
zom (R): The value of 'zom' scale factor. (see FACTOR)