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

page feeds

with DCR="WYS"

DeCoRation: Geometrical shapes for screen or print output with

case sensitive

CHA

PXL