Panel: Screen layout for easy-update of numeric, text, and graphics output

PaNeL is an optional keyword of HicEst"s WINDOW() function, e.g.
```
WINDOW(WINdowhandle=wh, PaNeL="test", PoinT=pt)
```
- Window layout is defined in a template (APPENDIX section of the script).
- Template placeholders define the output types
- To display output variable changes, call:
```
WINDOW(WIN=wh, UPDAtepanel)
```
size of panel
is automatic:
- the window will exactly display the template from the APPENDIX section
- The font used for text output is "fixed font" and can be set as font nr 4 from the options section
initialize panel
: display a template as defined in the scripts APPENDIX section. This requires to
- define the variables to be displayed in the template, e.g.:
```
CHARACTER name*60, text*60
DIMENSION vector(10)
name = "numeric and text"
text = "scalar has value pi"
scalar = 4*ATAN(1) ! == pi
vector = $ ^ 0.5   ! the square roots of 1, 2, 3, ...
```
- template definition
  (e.g. "Num+Text") for screen output:
  The template name must start in column 1 of the script"s APPENDIX section.
- choose arbitrary placeholders for the variables, like ?, $, and @.
- placeholder=variable expressions follow the template name.
- The number following the placeholder is for strings the character position to start with. For arrays the number is the array element, for numeric scalars the number must be 0.
- The printed width is defined by the number of digits following the placeholder.
```
Num+Text ?=scalar $=vector @=text
 text( 1:10) = @000000001  scalar = ?000
 text(11:19) = @00000011
   vector(2) = $0002, vector(5) = $0005
      scalar = ?00000  6 chars wide
      scalar = ?000000 7 chars wide
the nextchapter starts in column 1 again
```
- The xy-graph hides any text below it. Commands may be anywhere within the graph (no spaces allowed).
open panel
with its initial values by a call to WINDOW with the template name
```
 WINDOW(WIN=wh, PaNeL="Num+Text", TItle=name, PoinT=8)
```
This writes an image of the template to window wh and fills the placeholders defined in template (numbers, strings and graphs). The font size determines the window size. It can be set by the PoinT option. Panel always uses a fixed font.

update panel

with changed variables is by subsequent calls to WINDOW(WINdowhandle=wh, UPDAtepanel):

    text = "scalar has value e"
    scalar = EXP(1)
    vector = $ ^ 2 ! the squares of 1, 2, 3, ...
    WINDOW(WIN=wh, UPDAtepanel)

all variables are updated in 1 single call

mark selected variable
by changing its foreground and/or background color: Colors 0...31 are predefined, but 32-bit RGB() values can be used instead.
```
 WINDOW(WIN=wh, UPDAtepanel=variable, ForeColor=15, BaCkColor=1)
```

graphics

is added to a template by defining an arbitrary placeholder in the 1st line of the template (# in the example below) for every xy-system.

Options as in AXIS(...)	# stands here for any character i is integer f is float	examples
#i	i = number of xy system 1...8. Must be noted in the template definition line	#7 = xy graph number 7
##	Double placeholders mark the corners of graphs Upper left and right corners suffice for a graph to extend over the full height of the panel. Diagonal corners are needed for a partial window graph	Test #1 ## #XB79 #Xx0 #XX4 #YB96 #Yy1 #YY100 #x more in Tutorial.hic(Panel) # #y try it # ##
#XBi (use to set foreground colors ) and #YBi (use to set background colors ) (see also AXIS)	i is a sum of color and scale properties: 0=black 1=blue 2=green 4=red 8=bright 16=soft 32=LoG 64=Grid 128=FixmiN 256=FixmaX 512=TiMe 1024=Scroll 2048=noAxis	WINDOW(WIN=wh, PaNeL="Test", TItle="Profile") #XB79 = 1 + 64 = blue+grid #YB96 = black + log + grid #Xx0 = Xmin=0 #Yy1 Ymin=1 #XX4 = Xmax=4 #YY100 = Ymax=100 #x abscissa text# #y ordinate text#
#Xxf	set abscissa minimum to f	#Xx0 = Xmin=0
#XXf	set abscissa maximum to f	#XX1.5 = Xmax=1.5
#Yyf	set ordinate minimum to f	#Yy-1 = Ymin=-1
#YYf	set ordinate maximum to f	#YY2 = Ymax=2
#xtext#	set abscissa text	#x more in Demo = Tutorial.dem(Panel) #
#ytext#	set ordinate text	#y try it #

profile graph

is added to a template by defining arbitrary placeholders for x-vector (~ in the table below) and for the y-vectors (? in the table below) in the 1st line of the template.

Options as in LINE(...)	# stands again for the xy system ~ is placeholder for x-vector ? stands for y-vector i is an integer number
~=xvec	assign xvec to ~, xvec is defined in the script and is noted in the template definition line. To plot e.g. yvec versus xvec in graph 3 the first line of this APPENDIX chapter may look like: Profile #3 ~=xvec ?=yvec
?=yvec	assign yvec to ?, yvec defined in script and noted in template definition line
#X~0	assign ~ (xvec) to abscissa of xy-system #
#Y?0	assign ? (yvec) to ordinate of xy-system #
#Y?Bi	i is the sum of properties for curve ?: 0=black, 1=blue, 2=green, 4=red, 8=bright, 16=soft, 32=STeps, 64=NoLine, 256=NoZero.
#Y?Si	i is the symbol number for curve ?: 1=square, 2=diamond, 3=octagon, 4=Xsquare, 5=+diamond, 6=+octagon, 7=triangle up, 8=triangle down, 9=arrow up, 10=arrow down, 11=/, 12=\, 13=X, 14=-, 15=l, 16=+, 17=*
#Y?Di	i is the symbol diameter for curve ?
#Y?Wi	i is the line width for curve ?

 DIMENSION xvec(30), sin(30), cos(30)
 xvec = ($ - 1) / 3 ! make xvec = 0, 1/3, 2/3, ...
 sin = SIN(xvec)
 cos = COS(xvec)
 WINDOW(PaNeL="Profile", TItle="Profile", WIN=wh)

Profile see-internal-help.htmsee-internal-help.htmXB66G3   the scales are
      B66 green(2)+Xgrid(64)
         G3  Xgrid 3"s-steps
 see-internal-help.htmX~0        is the x-vector
 see-internal-help.htmY?0B9D1S1W3 the cos-vector
     B9 is bright(8)+blue(1)
       D1  symbol diameter 1
         S1  symbol 1 square
           W2   line width 2

 see-internal-help.htm
     ~00000003   ?00000003 see-internal-help.htm

history graph

works like "panel profile graph" above.

past profiles are shown with decreasing color intensity.
Useful to visualize small changes without cluttering the graph.
If the length of the y-vector is N times the length of the x-vector, a total of N history values of y-vector are plotted.
Maximum N is 255.

 DIMENSION xH(30), sinH(300), cosH(300)
 xH = ($ - 1) / 3 ! make xH = 0, 1/3, 2/3, ...
 WINDOW(PaNeL="History", TItle="History plot", WIN=wh)
 DO i = 0, 10
   sinH = SIN(xH) * i/10
   cosH = COS(xH) * i/10
   WINDOW(WIN=wh, UPDAtepanel)
 ENDDO

colors fade away automatically to the background color

History #1 see-internal-help.htmsee-internal-help.htmYB2062
  #X~0           see-internal-help.htmY?0B2D0

  #xthe most recent#
  see-internal-help.htm

  #yno y-axis for graph 2#
              ##              see-internal-help.htm

scrolling axes

allow automatic updates of up to 8 graphs. Both axes can be made to scroll. Input y-data must be bundled in a vector, the x-value may be a scalar or it may an element of the data vector.

Options as in AXIS and LINE	# stands again for the xy system " is placeholder for the current x-value * stands for a vector of y-values i is an integer number
"=xvalue	assign xvalue to the placeholder ", xvalue must be defined in the script and is noted in the template definition line along with the vector of y-values (and possibly definitions of other axes, variables, and vectors to display)
*=yvector	assign yvector to the placeholder , yvector is defined in the script and noted in the template. To plot x-value sec and yvector infoVec to xy-graph 1 in chapter TimeSeries this is: TimeSeries #1 "=sec =infoVec

    infoVec = ALIAS(sec, y1, y2) ! VECTOR needed at least for y-values
    WINDOW(PaNeL="TimeSeries", Ti="200 msec updates", WIN=wh)
    DO i = 1, 1E6  ! loop 1 million times
      sec = TIME() ! seconds since midnight
      y1 = SIN(sec)
      y2 = COS(sec) * RAN(0.3) ! 0 <= RAN(0.3) <= 0.3 random values
      WINDOW(WIN=wh, UPDAtepanel)
      SYSTEM(WAIT=200) ! wait for 200 msec
    ENDDO

better to see this thing live: Demo = Tutorial.dem(ScrollingWindows)

TimeSeries #1 "=sec *=infoVec
 ##   The AXIS options are:
 #XB1088 #Xx0 #XX20
   B1088=scroll(1024)+grid(64)
          Xx0 = xmin(0)
               XX20 xmax(20)
    #xX-axis scrolls with sec#

      The LINE options are:
 #X"0 assigns sec to x-Axis
 #Y*2W2D0 y1 is 2 wide
 #Y*3W2D1B12 y2 is red
       Di i = symbol diameter
                             ##
   "0000000 sec since midnight

flow lines
add horizontal and/or vertical lines to a graph.
- Line placeholders in the same row or same column are connected by lines of color c, dash d, and width w.
- in the chapter definition line a set of lines for a placeholder * is defined by the sequence *Line=c.sw, e.g. *Line=12.09 for bright red, solid , 9 pixels wide
- It is sufficient to write L for Line.
- Placeholders are blanked out for display.
```
text = "comes handy for charts"
WINDOW(PaNeL="Lines", Title="Lines", WIN=wh)
```
Lines *Line=12.29 +L=17.09 "=Text
+ +* *

"0001 "00006
+
* *
"13 "00017
* *+ +

rectangles

: add all kinds of rectangles to a graph. The syntax in the panel definition line for rectangle placeholder * is *Display:RA=color.

Rectangles +D:RA=1.05,BC=3.24,W=4,H=3  *D:RA=-1,BC=14
  +        *1 a
         *2 b
       *3 c
         *4 d
           *5 e

geometrical shapes

all use the same syntax:

*D:XY=c.sw,BC=c.sh,W=4,H=3

where * is the placeholder of the shape, XY is the shape (PO, EL, or BE), c=color, s=outline-style, w=outline-width, BC=background with c=color, s=style, h=hatch, W=outline-width, H=outline-height

polygons
:

x,y coordinates in the form x1,y2;x2,y2;... are scaled to width W=.. and height H=.. noted in the definition line.
If W and/or H is missing the shapes extend over the full window W and/or H.
```
Po .D:RA=4 #D:PO=0,0;1,1;0,1;W=8,H=3,BC=12,FC=0.03
 .............................
 .#         #         #
 .
 .
 .
 .     #         #
 .
 .
 .
```

ellipses

have 2 extra options to display arcs: A1=Angle1 (0...360), A2=Angle2, default angles are 0.
x,y see polygons.

El #D:EL=11.05,W=9,H=4,BC=17 +D:EL=9.09,A1=0,A2=180,W=8,H=5,BC=14
 #         #         #               .
                             +
     A#        B#        C

          D         E

Cubic Beziers fit cubic curve to 4 points. It starts at P0 going toward P1 and arrives at P3 coming from P2. Subsequent curves (3 points) use end point of previous curve as start point.
x,y see polygons.

PB .D:RA=0 $D:BE=0,0;0,1;1,1;1,0;W=8,H=4,FC=4.09
 ..................
 .$       $
 .
 .
 .