DeCoRation: Geometrical shapes for screen or print output with

• DeCoRation# is an optional keyword to the WRITE function. It has no stand-alone meaning.
• Decoration patterns are most useful in the WINDOW(Panel) function, for example to visualize

  real time flowsheet data

• The sub-options of DeCoRation are embedded in its argument string, e.g.
  • WRITE(DeCoRation="T=-150, L=1/2, EL=1.09, BC=4.25")
  this example generates: top space 150 pixel, left space 50% window width, ellipse with border color 1 (blue, see Colors), border width 9 pixels, fill color 4 (red), style 2 (hatched), hatch type 5 (diagonally crossed lines)
• Decoration patterns can then be used as a background for the payload, e.g.
  • WRITE(PoinT=100, Align="Vertical Center", BC=-1) 123
  to transparently add (BC=-1) a "123" to the center of the ellipse
• Different from the regular keyword syntax, the options noted in the DeCoRation string are

  case sensitive

  and only the indicated capitals should be used.

sub options	type	rectangle and ellipse are fitted to the dimensions given in in L, R, T, B, H, W
RA	num	RectAngle coded as FORECOLOR.STYLE|WIDTH. The fill color or pattern can be set by BC WRITE(dcr="BC=1 RA=4.09") ! blue screen, red border, fills window area RA=4.09 RectAngle outline color=4, solid line=0, lineWidth=9 BC=1 fill color=1=blue use this technique to clear screen to a specified pattern
EL	num	ELlipse, num=ForeColor.style|width (fill with BC)
A1	num	Angle1, num=0...360 for arc or chord, default=0
A2	num	Angle2, num=0...360 for arc or chord, default=0 ( 0 = South, 90 = W, 180 = N, 270 = E ) WRITE(decor = "EL= 3.03 A1=225 A2=45, BC=11") ! top left arc WRITE(decor = "EL=13.03 A1=45 A2=225, BC=3") ! bottom right arc WRITE(Align="Cent Vert", PoinT=24, BaCkcolor=-1) "Hic Est" EL=3.03 Ellipse border Colors 3, border width 3 A1 and A2 angles to start/end arc BC=11 fill color (backcolor) 11 size and location are set with any combination of the H, W, L, R, T, B options (find out more about this figure in the Panel section)
		polygon , polyline , bezier : The coordinates given in vec (x1,y1, x2,y2, x3,y3, ...) will be adjusted to fit the decoration output area, if either of the strings CHA or PXL is present in the DeCoRation-argument the dimension is in absolute character units or pixels resp. Arguments are separated by blanks, commas, semicolon in the DeCoRation-string. Order is arbitrary.
PO	vec	POlygon, vec=x1 y1 x2 y2 .. xn yn (fill with BC) WRITE(DeCoRation="RA=4 BC=4.24 PO=0,0;1,1;0,1;W=8,H=3,BC=12,FC=0.02") (find out more about this figure in the Panel section)
LI	vec	polyLIne, vec=x1 y1 x2 y2^x3 y3 x4 y4 .. where a caret ^ forces a pen up break between line segments WRITE(DeCoRation="LI=0 1; 0 0; 1 0; 1 2; 2 2 FC=17.09") ! similar to the line in the figure (find out more about this figure in the Panel section)
BE	vec	Bezier, vec=x1 y1 x2 y2 .. xn yn ( n >= 4 )
		set output margins of decoration area : num = 0...1 relative screen dimension num > 1 character units num < 1 pixels
L	num	set Left output margin
T	num	set Top output margin
B	num	set Bottom output margin
R	num	set Right output margin WRITE(DeCoRation="L=1/4, T=1/4, R=1/4, B=1/4") ! rectangle 1/2 linear window size becomes centered output area
H	num	set Height of output area, may be combined with T or B
W	num	set Width of output area, may be combined with L or R
		set shape color and style . The meaning of num below is: num = 0...1 relative screen dimension num > 1 character units num < 1 pixels
BC	num	BaCkground color coded as COLOR.STYLE|HATCH, e.g. BC=3.21 means COLOR=3=cyan, STYLE=2=hatched, HATCH=1=vertical with STYLE = 0: solid 1: transparent 2: HATCH = 0: no shade by drawing fine parallel or crossed lines 1: vertical lines 2: \\ diagonal lines 3: // diagonal lines 4: # crossed lines >4:diagonally crossed lines
FC	num	Foreground Color coded as COLOR.STYLE|WIDTH, e.g. FC=1.23 means COLOR=1=blue, STYLE=2=dotted, WIDTH=3=3 pixels with STYLE = <0 invisible 0: solid line 1: dashed line 2: dotted line 3: dash-dotted line 4: dash-dot-dot line
NOUP	---	no update, postpone repainting to avoid flicker until a WRITE without this option is met.
WYS	---	To print, try what you see is what you get . In particular, suppress page scroll or page feeds with DCR="WYS"