************************************************************ GRAF: A GRAPHICS PACKAGE FOR USE WITH THE HEWLETT-PACKARD 7220A PLOTTER UNDER RSX-11M  PROGRAMMER: JASON PRESSESKY (CMR X-RAY FACILITY) ET AL (WHEREABOUTS UNKNOWN) VERSION: 2.1 (MAY 25, 1982) ************************************************************ ALL SOURCE, OBJECT, AND TASK MODULES RESIDE IN [300,300] ON DL2: (RSX RLO2 DISK) EXCEPT AS NOTED. MAIN PROGRAM: GRAF (SOURCE = GRAF.FTN) SUBROUTINES: PSTRT (SOURCE = PLOTGO.FTN) P1P2 DISCO (SOURCE = DISCO.FTN) POINT (SOURCE = PRAXES.FTN) AXES RANGE IBIT (SOURCE = UBIT.FTN) SETBIT REBIT DATAX (SOURCE = DATAX.FTN) SMOOTH SCALE (SOURCE = GSUBS.FTN) UNSCL ICEIL IFLOOR RCEIL RFLOOR PARAM (SOURCE = PARAMO.FTN PARAMS LABEL (SOURCE = LABEL.FTN) LEGEND (SOURCE = LEGEND.FTN) LEGSTT (SOURCE = LEGSTT.FTN) TYPE (SOURCE = TYPE.FTN) HP7220 (SOURCE = HP7220.MAC) DL1:[6,12] DIRPRT (SOURCE = DIRPRT.MAC) DL1:[6,12] TXTWIN (SOURCE = TXTWIN.FTN) PLTUTL (SOURCE = PLTUTL.FTN) RDISK (SOURCE = RDISK.FTN) DIGIT (SOURCE = DIGIT.FTN) ************************************************************ CCOMMAND STRING FOR LINKING UNDER RSX-11M >TKB TKB>@GRAF.BLD ************************************************************ THE PROGRAM 'GRAF' OPERATES AS A SUBMONITOR. THE PROGRAM RESPONDS WITH APPROPRIATE ACTION TO COMMANDS AS THEY ARE ISSUED BY THE USER. THE COMMANDS ARE IN THE FORM OF TWO LETTER MNEMONICS AND CAN BE ISSUED IN VIRTUALY ANY ORDER THAT IS SELF CONSISTENT. UPON ENTERING THE PROGRAM 'GRAF' (RUN GRAF) A PROMPT '*' IS PRINTED AT THE TERMINAL INDICATING THAT THE PROGRAM IS READY TO RECEIVE COMMANDS. A COMMAND 'XX' IS ENTERED AND THE CALLED FOR ACTIONS ARE EXECUTED. THE PROGRAM MAY PROMPT FOR ADDITIONAL INFORMATION FROM THE USER. UPON COMPLETION OF THE COMMAND THE PROGRAM REISSUES THE '*' INDICATING THAT IT IS READY FOR FURTHER INSTRUCTIONS. THE PROGRAM IS (TO A LARGE EXTENT) SELF-POLICING AND WILL AUTOMATICALLY CALL THE NECESSARY PRELIMINARY COMMANDS, IF NEEDED, TO EXECUTE A COMMAND. FOR EXAMPLE, A PLOT WITH AXES COULD BE MADE WITH ONLY TWO COMMANDS: 'PL' (PLOT) AND 'AX' (AXES) AN ADDITIONAL SUBMONITOR MAY BE INVOKED FROM 'GRAF' VIA THE COMMAND 'DA'. THIS COMMAND CALLS THE 'DATA' SUBMONITOR AND IS INDICATED BY THE PROMPT '+'. THE DATA SUBMONITOR IS USED TO MASSAGE OR ALTER DATA FROM A USER GENERATED FILE. THE ALTERED DATA CAN THEN BE PRESENTED TO GRAF FOR PLOTTING. A DESCRIPTION OF THE AVAILABLE GRAF AND DATA COMMANDS FOLLOWS. ************************************************************ GRAF COMMANDS FI FILE READS DATA FILE FROM DISK TO A 2 X 600 POINT DATA BUFFER. FS FILE READS DATA FROM STEPSCAN FORMATTED FILES. STEPSCAN USE INSTEAD OF THE 'FI' COMMAND. ST START SETUP COMMAND FOR USING DEFAULT PAPER SIZE (14 X 11). P1 P1P2 ALLOWS THE USER TO DEFINE THE POINTS P1 AND P2 WHICH DEFINE THE PAPER SIZE AND GRAPH SIZE. PL PLOT PLOT DATA. TI TITLES INPUTS TITLES FOR AXES (UP TO SIXTY CHARACTERS). SHOULD BE CALLED BEFORE AXES. AX AXES DRAWS AXES. SCALES AXES BASED ON THE DATA SET THAT IS READ INTO THE DATA BUFFER (I.E., THE DATA THAT RESIDES IN THE DATA BUFFER BEFORE CALLING AXES OR PLOT). WRITES AXES LABELS AT TIC MARKS AND TITLES AXES. LE LEGEND INPUTS UP TO FIVE 23-CHARACTER LINES TO BE USED AS A PLOT LEGEND. THE LEGEND IS THEN WRITTEN IN THE UPPER RIGHT HAND CORNER OF THE PAPER (DEFAULT POSITION) OR IN THE AREA DEFINED BY THE TEXT WINDOW (TW) COMMAND. TW TEXT PERMITS USER DEFINITION OF THE LEGEND WINDOW POSITION. SHOULD BE FOLLOWED BY THE LEGEND COMAND (LE). SC SCALE PERMITS USER DEFINITION OF THE PLOT SCALE. LT LINE TYPE SELECTS LINE TYPE FOR DATA PLOT. THERE ARE SEVEN TYPES (0-6), SEE PLOTTER MANUAL FOR A COMPLETE DESCRIPTION. LINE TYPE IS SET TO THE DEFAULT VALUE (STRAIGHT LINE) AFTER COMPLETION OF THE PLOT. PU PLOT THIS COMMAND ALLOWS DIRECT USER INTERACTION UTILITY WITH THE HP-7220 VIA THE HP-GL LANGUAGE. COMMAND STRINGS SHOULD BE TERMINATED WITH A '*'. SW STATUS DISPLAYS TO TERMINAL THE CONTROL WORD 'KBYTE' WORD IN BIT FORMAT. ALLOWS THE POSSIBILITY OF CHANGING THE VALUE OF 'KBYTE' AND THEREBY ALTERING THE PROGRAM FLOW. DA DATA INVOKES THE DATA SUBMONITOR. RE RESTART RESETS GRAF TO THE INITIAL STATE. EQUIVALENT TO STARTING OVER. EN END EXIT GRAF; RETURN TO OPERATING SYSTEM MONITOR. DI DIGITIZE INPUT PEN POSITIONS FROM PLOTTER IN ABSOLUTE PLOTTER CO-ORDINATES. ************************************************************ DATA COMMANDS DATA COMMANDS OPERATE ON THE 2 X 600 POINT DATA BUFFER. THE USER MAY BE QUERIED FOR ADDITIONAL INFORMATION AS REQUIRED. UPON COMPLETION OF THE COMMAND THE DATA BUFFER CONTAINS THE MODIFIED DATA. THE ORIGINAL DATA IS NOT RETAINED. PA PARTITION EXTRACT A SUBREGION FROM DATA FILE. SX SCALE X MULTIPLY THE X-COORDINATE OF THE DATA BY A CONSTANT (FLOATING POINT). SY SCALE Y MULTIPLY THE Y-COORDINATE OF THE DATA BY A CONSTANT (FLOATING POINT). LX LOG X TAKE THE LOG (BASE 10) OF THE X-COORDINATE. LY LOG Y TAKE THE LOG (BASE 10) OF THE Y-COORDINATE. OX OFFSET X ADD A CONSTANT TO THE X-COORDINATE (FLOATING POINT). OY OFFSET Y ADD A CONSTANT TO THE Y-COORDINATE (FLOATING POINT) SM SMOOTH SMOOTH THE DATA. EX ESCAPE RETURN TO THE 'GRAF' SUBMONITOR. ************************************************************