GLE is an interactive Graphics Language Editor. (for VAX installation see INSTALL.TXT) GLE is NOT WYSIWYG, it shows you a close approximation to what you will get, but fonts, line widths, colors may all be slightly incorrect. Please send reports of bugs (including the GLE file) to: in%"srghcxp@grv.dsir.govt.nz" The rest of this file contains version update notices, they are in REVERSE chronological order. (e.g. recent changes first) NOTE: The command is CGLE, but the package is called GLE. You might find a text only copy of the manual in a file called MANUAL.TXT Chris Pugmire. GLE 3.3b (25-Mar-1992) ---------------------- Bigfile now accepts variables in place of file name, e.g. xxx$ = "test.dat,2,3" d1 bigfile xxx$ Added AUTOSCALE option to bigfile e.g.: d1 bifile a.dat line autoscale This pre-reads the file to scale the axis, which is slow but sometimes required. Updated version of inittex.ini which was causing problems with /char /def /movexy UNIX: install.com now copies graph.idx into system area. VMS: dviprint symbol added to CGLE_LOGIN.COM GLE 3.3a (27-Jan-1992) ---------------------- Bug lowercase xnames labels being mis-aligned is fixed. Gle now writes out gletmp.t1 .t2 .t3 .t4 instead of .bak so you have four backup versions if something crashes. Fixed axis rounding errors for labels, e.g. .1 to .9 step .1 might occasionally stop at .8 Fixed filled boxes on DVIGLE driver, the filled region wasn't being translated if a scale or rotate was being used. Added commands: fopen, fclose, fread, freadln, fwrite, fwriteln E.G.: fopen "file.dat" inchan read fopen "file.out" outchan write until feof(inchan) fread inchan x y z aline x y rline x z fwriteln outchan x*2 "y =" y next fclose inchan fclose outchan The following accents now work. \` \' \v \u \= \^ \. \H \~ \" e.g. text P\'e ter GLE 3.2i (1-Jan-1992) --------------------- Improvements made to lstyle for dot matrix and laserjet drivers. It now works!, patterns which don't divide into 32 bits and dashlen are both supported. (Thanks to Frank Evans) HPGL driver modified, now supports sizes greater than a3. New symbols HPGL_ADDX, HPGL_ADDY add a margin to the plot. These default to .9cm and 1.5cm Bug in 'E' format numbers, 5e+7 was interpreted as 5+7 = 12 instead of 50,000,000 (5e7 was always interpreted correctly) GLE 3.2g (1-Nov-1991) --------------------- All bitmap dot matrix drivers have been re-written: dvigle dvilj, dvilj300, dviepson, dviep24 They now perform clipping and filling correctly, funny glitches in filled characters (texcmr) have been fixed. They also support a much wider range of fill styles Print the file DVIFILL.GLE to see the supported fill options. The command syntax has changed, the commands: dvilj, dvilj300, dviepson, dviep24 Have been replaced by: dviprint -dlj dviprint -dlj -hires (was dvilj300) dviprint -depson dviprint -depson -hires (was dviep24) Support for HP-PaintJet printers has been added: dviprint -dpj Usage: dviprint [-depson | -dlj] [-old] [-hires] [-debug] [-output xx.prt] -depson To produce output for epson printers -dwp To add tiff image to wp .eps file -dlj To produce output for HP LaserJet printers -dpj To produce output for HP PaintJet printers -dover Overhead transparency mode for PaintJet -old For old HP Laser Jet printers (no compression) -hires Uses high resolution for that printer (slower) -wide If your printer has a wide carriage -noflip Disable's auto flipping -nosquash Tries to print it full size -compress Force internal bitmap compression (slow,saves memory) -noff No form feed -debug Prints debug messages -out x.x Prints output to file instead of printer port ... 3d Bar graphs are now supported, the commands are: bar d1,d2 3d .5 .3 side red,green notop bar d3,d4 3d .5 .3 side red,green top black,white Take note of comma's. 3d (xoffset yoffset) Specifies the x and y vector used to draw the receding lines, they are defined as fractions of the width of the bar. A negative xoffset will draw the 3d bar on the left side of the bar instead of the right hand side. side (color list) The color of the side of each of the bars in the group. top (color list) The color of the top part of the bar notop Turns off the top part of the bar, use this if you have a stacked bar graph so you only need sides on the lower parts of each stack. Note: You won't see the color of the side or top on the pc screen. GLE 3.2 (6-Mar-1991) --------------------- File type changed from STREAM_LF to normal vax format. SMOOTHM option added which is identical to SMOOTH but will allow multi-valued functions. (e.g. circles etc) TWIDTH("") and THEIGHT("") functions fixed again. ...V3.2b DEFINE MARKER myname subnamex MARKER myname Allows you to define a new marker as any subroutine. e.g. to define a character from the postscript ZapDingbats font as a marker you would use. sub subnamex size mdata gsave ! save font and x,y set just left font pszd hei size t$ = "\char{102}" rmove -twidth(t$)/2 -theight(t$)/2 ! Centers marker write t$ grestore ! restores font and x,y end sub The second parameter can be supplied using the MDATA command when drawing a graph, this gives the marker subroutine a value from another dataset to use to draw the marker. For example the marker could vary in size, or angle, with every one plotted. d3 MARKER myname MDATA d4 Encapsulated Postscript option modified so that WordPerfect won't clip the edge of the drawing. On a PC the /EPS qualifier will now create a file using an extension of .EPS instead of .PS DEFMARKER mname fontname char_num scale dx dy This command defines a new marker, from any font, it is automatically centered but can be adjusted using dx,dy. e.g. defmarker hand pszd 43 1 0 0 Bug in set color in PS devices which caused the color to affect a previous line is fixed. Added built in function which returns a string describing the device. e.g. DEVICE$() = "HARDCOPY, PS," on the postscript driver. This can be used to use particular fonts etc on appropriate devices. E.g.: if pos(device$(),"PS,",1)>0 then set font psncsb end if POS(src$,search$,start) string function fixed (surprise surprise) The editor now tolerates lines > 80 characters. Fixed bug which caused incorrect characters to be drawn on pc screen occasionally. ...3.2c Pressing ESC repeatedly will now abort a redraw operation. (on PC) Load and Saveas will now default to .GLE Bug with tex macro replacement fixed. Bug with mouse cursor not appearing on HERC screens is fixed. WPGLE.EXE added, this command will produce a special output file which contains EPS for PostScript printers and a crude bitmap for WordPerfect to display on the screen. ...3.2e Fixed some colour mapping and added, purple, orange, pink, brown. ...3.2f Modified maximum size of dvilj,dvilj300,dviepson,dviep24 so that all can take graphs up to 19cm x 27cm Added command line switches /nod (add ^D to ps file) /addd (Don't add ^D to ps file) /nomaxpath (Don't choke on complex fill paths) /fill (For dvibit, makes bar's filled instead of shaded) Added symbol for PC. GLE_NOCONTROLD TRUE (Stops ^D being added to ps files) (this is the default for unix) The DCL symbol GLE_NOCONTROLD should be set to "TRUE" to kill the ^D on vms systems. If you set the DCL symbol GLE_EDITOR to TPU then you will get TPU instead of EDT when you press ^E You can now tell gle about postscript fonts that you have downloaded into your own printer. Lets pretend we are adding a font called Greek-Bold 1) Download the font into you laser printer 2) Add a line to FONT.DAT psgb 86 psgb.fmt plsr.fve psgb.fmt a b c d a = GLE's name for the font b = The next unused number in font.dat c = The font metric file, this can be created using makefmt from and adobe font metric file (.afm) which you should have been supplied with your font. d = The font vector file, this is just a font that that gle can use to draw your font on non postscript devices. 3) Add a line to psfont.dat psgb Greek-Bold This tells the postscript driver that this is a font that the printer knows how to deal with. ----------------------------------------------------------------------------- GLE 3.1e (1-Mar-1990) ---------------------- Errbars will now work with the bigfile option. x2ticks now come back on again if you turn the xaxis off and x2axis on (The error bars distances cannot also be a bigfile) if you use a let d1 = exp from 1 to 10000 step 1 with a log xaxis it doesn't produce a smooth line. GLE now checks and if the xaxis is a LOG scale then it uses the step option as an approximate required number of intervals which it spreads along the xaxis in increasing steps. In the graph module, if you use '0' as a column for the x data of a bigfile GLE will generate xdata of 1,2,3,4 ... e.g. d1 bigfile a.dat,0,2 Data separated with commas and no spaces was being read incorrectly The data reading routine has been re-written. (introducing new and more interesting bugs in the process) GLE 3.1d (19-FEB-1990) ----------------------- In the past "TEXT a\delta b" would have produced a space between the delta character and the letter b, this action was incorrect and had been fixed. Use "TEXT a\delta\ b" to get a space. "TEXT a(\delta)b" also works now. GLE 3.1c --------- Built in functions twidth("") and theight("") now work. Their is now a BIGFILE command for executing large gle files that won't fit into memory using INCLUDE. (note this should not be confused with the BIGFILE graph command). e.g. BIGFILE NZMAP.GLE As bigfile compiles and executes the gle file one line at a time you cannot use multi line structures (subs, if then else etc) but you can call subroutines if they are defined before the bigfile statement. Lines in bitmap drivers are now the right length (text looks better) There is currently a limitation on the size of text or tables that can be printed (this may be fixed at a later date) The xg() and yg() functions now work if the graph has log axes A bug which stopped the last line of a data file being read had been fixed. Correction to expression passing allows IF A$="ABC" THEN ... to work. Added shading styles RSHADE, RSHADE1, RSHADE2 ...(Lines at right angles) GLE 3.1b --------- Fixed the circle fill command so it uses the right colour. Modified PostScript arrows with wide lines so they look nice. They are now filled triangles rather than two short lines. There is now an example in BOXR.GLE which shows you how to define a subroutine to draw boxes with rounded corners. Horizontal error bars have been added, the commands are HERR, HERRLEFT, HERRRIGHT, HERRWIDTH If you had the same subroutine defined twice in a gle file it would skip the intervening gle commands, this is fixed. Arcto fixed for line devices (hpgl) Stacked bargraphs should not contain missing values, replace missing values with the value from the column on the left. e.g. 1 22 * 45 becomes 1 22 22 45 GLE 3.1a --------- Bug with reading exponential format numbers fixed. Bigfile option added, so that you can extract particular columns of data from a data file, e.g. D1 LINE BIGFILE TEST.DAT,3,2 Will use column 3 for x values and column 2 for y values. e.g. ' data x.dat d3 line becomes d3 line bigfile x.dat,1,4 As dataset three is made from columns 1 and 4. The space codes (\: \; \,) are now proportional to the current font size. text \rule{2}{3} will draw a box, and \glass can be used to offset text. GLE 3.1 -------- Modified default DPOINTS setting so that if DTICKS is not a whole number it will display one decimal point. e.g. (1.0, 1.5, 2.0) instead of (1 1.5 2) the "graph data d2=c3,c1" option now requires no spaces within the "d1=c1,c2" Begin path wasn't issuing a newpath, so multiple paths got added together. Gle files can now begin with a numeric character. Bug with bitmap drivers fixed (dviepson, dvilj300 etc) which resulted in a stray horizontal line on the page. The editor doesn't display long lines correctly, it does store them though. On the PC the PSGLE driver now writes output files to INPUTFILE.PS instead of out.ps e.g. bar.gle --> bar.ps Added \linegap{-1} tex primitive to stop odd spaces lines when using super/subscripts. vscale and hscale were not being reset after each graph. Some of the characters which were missing from the PLOTTER fonts have now been installed (e.g. []{}<>% ) You can no add lines and text to a drawing using the mouse or arrow keys on the PC version of gle. There is now a graph command, FULLSIZE which sets vscale,hscale to 1, and turns the border off. GLE 3.0h --------- Fixed bug with LSTYLE in PSGLE (on the pc only) You can change the size of the default key by setting the hei of text used to draw the key. e.g. begin graph ... key hei 1.2 end graph If the value of an error bar length is a missing value then that particular bar won't be drawn. If you escape out of the idiot graph creation menu it will now correctly put an END GRAPH in your file. Line and Grid shading has been added to the postscript device driver, the following colour names are now accepted. shade,shade1,shade2,shade3,shade4,shade5 grid,grid1,grid2,grid3,grid4,grid5 e.g. BAR 2 3 FILL GRID3 Print the example file SHADE.GLE on a postscript printer and stick it on the wall for reference. ($ cgle shade /print) Bug with changing diskdrives on a PC is fixed. The fonts SSBI and SSI were reversed on the laser printer. There is now an axis qualifier SHIFT for shifting the labelling horizontally (when the label refers to the data between the two ticks) e.g. xaxis shift .4 In order to put a large space between two words you must use these control sequences e.g. TEXT Hello \; world \, = .1cm \: = .2cm \; = .4cm Use \_ to get an underscore character inside text ("_" normally means subscript) Fixed X2AXIS SIDE ON HPGL Plotter pens 1=black, 2=red, 3=green, 4=blue, 5=magenta, 6=white Bug fixed in linestyles caused by the cap being set to ROUND which merges the dashes together for wide lines on the laser printer. GLE 3.0g --------- Fixed bug with smoothing more that 200 points Fixed bug with joining between saved objects. When using the plotter fonts you may find some characters are missing, e.g. %,[ and ] (These have now been put into these fonts V3.1) The following command will replace these characters with latex equivalents. size 24 18 text \chardef{%}{{\setfont{texcmr}\char{37}}} text \chardef{[}{{\setfont{texcmr}\char{91}}} text \chardef{]}{{\setfont{texcmr}\char{93}}} ... rest of gle file GLE 3.0e (17-Sep-1990) ----------------------- Missing values are not used to calculate new dataset values during a let command (e.g. "let d3 = sin(d2)") Fixed bug in LOG data display. (If you have used LOG axis prior to this release you SHOULD replot your graphs) The bigfile option now works with markers as well as lines. (e.g. "d3 bigfile "year.dat" lstyle 1 marker dot ") GLE 3.0d (5-SEP-1990) ---------------------- The default labelling of axes is sometimes not ideal, for example 0 0.333333 0.6666667 1.0 you can now adjust this with the command "XAXIS DPOINTS 3" which sets the decimal places for an axis. e.g. 0.000 0.3330.666 1.000 The MSCALE option now works. Markers have been reduced in size, this will affect existing gle files, they are now approx 60% of there original size. The bigfile option now works on postscript printers, there was a bug caused by sending an entire 10,000 point curve to the printer as one path which it choked on if it was short of memory. You will occasionally get an error message "PATH TOO COMPLEX" this means that GLE decided to split up a line into shorter segments. Normally this WARNING can be ignored. The default axis labelling of 1, 1.5, 2 has been changed to 1.0, 1.5, 2.0 Exponent axis labelling has been fixed 2.00000e4 becomes 2.0e4 *** NEW DEVICE DRIVERS *** GLE now supports the EPSON 8PIN and 24Pin printers, and the HP deskjet/laserjet printers. To support bitmap devices which require a large amount of memory GLE first writes a device independent file OUT.DVI, you then run the bitmap driver for your printer and that prints directly to LPT1: e.g. C:\GLE> dvigle myfile (produces OUT.DVI) C:\GLE> dviepson (creates bitmap and prints to lpt1) The output options are: C:\GLE> DVIEPSON Standard epson printer C:\GLE> DVIEP24 24 Pin epson printers (180 dpi) C:\GLE> DVILJ HP Laser jet, Desk jet (150 dpi) C:\GLE> DVILJ300 HP Laser jet, Desk jet (300 dpi) The hi resolution drivers are significantly slower (2-3 times) than the low resolution drivers so would only be used for final copies. By default the fonts (RM, RMB, SS, TT etc) will all map to PLSR (plotter simplex roman) on both bitmap drivers and the HPGL driver. If you want this to happen on other drivers then put the command "PLOTTER FONTS" right after your SIZE command in your gle file. An lwidth of .00001 on a laser printer will give you 1 pixel width lines. (and won't occasionally round to two pixels) Using Postscript and HP drivers on the PC: C:\GLE\> PSGLE MYFILE.GLE (Writes myfile.ps) C:\GLE\> HPGLE myfile.gle (Writes out.hp) Making a 360K distribution diskette from the 1.2M diskette. (if a: = 1.2Meg disk, b: = 360K disk) a:> copy a:install.exe b: a:> copy a:pkunzip.exe b: a:> copy a:gle1.zip b: a:> copy a:gle2.zip b: a:> copy a:gle3.zip b: a:> copy a:gle4.zip b: To install GLE on a pc type: C:\> a:install GLE 3.0c --------- Bug with LaTeX symbols in graph titles fixed. Extra graph dataset qualifiers "BIGFILE and NOMISS" NOMISS removes missing values from a dataset. (so disjointed lines are re-connected) (e.g. "d3 colour red nomiss") BIGFILE allows a very large dataset to be drawn on a PC, it doesn't read the dataset into memory as usual. (but must be in a file with only one dataset, and no BARS or markers can be drawn. And axis ranges must be specified by hand. (e.g. "d3 bigfile "year.dat" lstyle 1") Fonts: The LaTeX greek font is missing from the small distribution disk. It is now possible to copy on any missing font directly into the c:\gle\font\ directory. Copy both the FMT and FVE files. e.g. "texcmmi.fmt, texcmmi.fve" set join mitre | round | bevel set cap but | round | square Fixed: Superscript, Subscript Symbols on Laser Printer after white fill. Individual dataset scaling fixed. Notes on new Drivers: HPGL, TEK4010, P79. HPGL: With this driver you can define the symbols hpgl_open, hpgl_close to be the escape sequences required for strange hp printers. also HPGL_WIDTH, and HPGL_HEIGHT for non A3 plotters TEK: TEK_OPEN and TEK_CLOSE can be defined to allow non dec tektronix terminals, e.g. TEK_OPEN = "^[?38h" (this is normally done in CGLECMD.COM so that when you specify /DEV=V550, OR /DEV=HPA4 it defines the symbols for you. On the vax the following cgle dev qualifiers are valid: cgle myfile.gle /dev=vdisk,v550,hpgl,tek Plus any P79 supported device, your output file will be MYFILE.HPGL GLE 3.0b --------- 2) Currently supported devices: PC version: HERC, EGA, CGA, etc (any BGI supported display) PostScript VAX version: REGIS(VT125,VT240,VT340 etc) UIS (Workstations running VWS software) PostScript (additions to this list lower down) 3) Fonts: The PC version comes on one 360K floppy, on this disk is a subset of fonts, if you use a font that isn't on this disk it will use a replacement font, and replacement metrics so the size of the text may be misleading. If you have enough disk space (another 1Meg) then you can install the complete font set. 4) PostScript: The PSGLE driver is not on the 360K Floppy, you must install it separately if you have enough disk space (another 400K) (or copy gle and data files to a VAX and use the vax PS driver) 5) Using GLE on a VT100/VT240 If your keyboard doesn't have function keys (f9-f14) then you can use GOLD 1-4 (for 11-14) and GOLD 0 (for f10) and GOLD 9 (for F9) GOLD 5 (show errors) If you run GLE on a vt100 it will work OK but not actually DRAW anything on the screen (as it thinks it's a vt240) 6) Other keyboard features: ^F will toggle between fast and slow (but nicer text) on some devices ^E will call VAX/EDT ^Z Exits from all menu's etc (like ESC on a PC) ALT-X Exits on a PC without asking you for confirmation. 7) There are currently no drivers for Plotters or DotMatrix Printers, these are planned for the next month or two (see update notices below) 8) Additions: The command "SET FONTLWIDTH value" has been added, this allows the line width of stroked fonts to be changed.