<content> Shape Specs </content>

ccb8d1ac-cf8b-414b-96b0-b2a4474bc611 58 francesco rapuano 4 5 false false false 0 0 decimal

&[DATE] &[TIME] - &[FILENAME]

Shape vector structure: ( shape, data[, linecolor(lc), linestyle(ls), linewidth(w),
fillcolor (fc)] ).

in between square brackets are listed optional arguments , in between round brackets is reported a shorten equivalent argument name

- Shape type argument can be : "line", "rect", "roundrect", "circle", "ellipse", "arc", "pie", "polygon","polyline", "spline","bezier"

- Data can means different things depending on the shape selected.

"line" : is a 1 column vector with the cordinates of its extremes x1,y1,x2,y2

"rect" : is a 1 column vector of 4 elements, the cordinates of its bottom left corner x1,y1 and the length of the orizontal and vertical side w1 and w2

"roundrect" : same initial data as per "rect" with a last information that is the rounded corners radus r (5 elements column vector )

"circle" : is a 1 column vector with the cordinates of its center xc,yc and the radius r (3 elements column vector )

"ellipse" : is a 1 column vector of 4 elements ,the cordinates of its center xc,yc and the semimajor and minor axis a (horizontal) and b (vertical) respectively

"arc" : same initial data as per an "ellipse" , usually the 2 values for the semimajor and minor axis are equal; the last 2 informations are the initial angle (can be negative and must be expressed in degrees ° ) and the angle wiped by the arc in degrees °. If this last angle is negative the arc is drawn clockwise otherwise is drawn counterclockwise

"pie" : same data as per an "arc"

"polygon": is a 2 column vector in which each row are the coordinates of the polygon vertices , it is better to follow a clockwise (or the opposite) direction in specifying these coordinates otherwise we can have a polugon with intersecting sides

"polyline" : same data as per a "polygon" with the same meaning but in a polyline the last point in the vertices list don't connect back with the first one as for a "polygon" drawing

"spline" / "bezier": same data as per a "polyline" with the same meaning

- line color and fill color field : we can indicate the color of a line or of the border of a shape or its fill color (except for a line obvoiusly) in various way as described in the Reference Book of Martin Kraska at the Paragraph: \[REGION[ed8d5db433ea49dd998629d6f0f706b2]]\ - Colours.
if we specify "none" the line/border of the shape is not drawn while for what concern the fill color it is set to a standard filler always the same for any shape.

I want just add further details on the αRGB color codification, which is the RGB color mode with an Alpha (transparency) channel attached to it (at the beginning as the first 2 digit ); so there is a total of an 8 digits hexadecimal code starting with an "#" and divided in 4 groups of 2 digits each, which represent the first one the trasparency and the following ones the intensity of red, green and blue colors in turn.
Each 2 digit rapresents 255 different values or color/transparency levels ( for transparency 00 means completely transparent and FF completely opaque)

Graphics

<content> HTML color codes from Martin Handbook </content>

Herewith the HTML color codes that can be used as further color specification in defining a Shape (from the Martin's Handbook)

M aliceblue antiquewhite aqua aquamarine azure beige bisque blanchedalmond black blue blueviolet brown burlywood cadetblue chartreuse chocolate coral cornflowerblue cornsilk crimson cyan darkblue darkcyan darkgoldenrod darkgray darkgreen darkkhaki darkmagenta darkolivegreen darkorange darkorchid darkred darksalmon darkseagreen darkslateblue darkslategray darkturquoise darkviolet deeppink deepskyblue dimgray dodgerblue firebrick floralwhite forestgreen fuchsia gainsboro ghostwhite gold goldenrod gray green greenyellow honeydew hotpink indianred indigo ivory khaki lavender lavenderblush lawngreen lemonchiffon lightblue lightcoral lightcyan lightgoldenrodyellow lightgray lightgreen lightpink lightsalmon lightseagreen lightskyblue lightslategray lightsteelblue lightyellow lime limegreen linen magenta maroon mediumaquamarine mediumblue mediumorchid mediumpurple mediumseagreen mediumslateblue mediumspringgreen mediumturquoise mediumvioletred midnightblue mintcream mistyrose moccasin navajowhite navy oldlace olive olivedrab orange orangered orchid palegoldenrod palegreen paleturquoise palevioletred papayawhip peachpuff peru pink plum powderblue purple red rosybrown royalblue saddlebrown salmon sandybrown seagreen seashell sienna silver skyblue slateblue slategray snow springgreen steelblue tan teal thistle tomato turquoise violet wheat white whitesmoke yellow yellowgreen 354 mat $

- Line styles: "solid", "dash", "dot", "dashdot", "dashdotdot".

- Line width: is the thickness of a line expressed in point number , if is set to 0 it is
not drawn

<content> Alternative ways to draw Shapes using intermediate routines from a UNI Post </content>

pp lc w fc CreateRect out 1 el rect : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : out 6 el fc : out 71 line :

pp lc w CreateLine out 1 el line : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : out 61 line :

pp lc w fc CreateRoundRect out 1 el roundrect : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : fc none ≡ 1 out 6 el fc : if out 71 line :

pp lc w fc CreateCircle out 1 el circle : out 2 el pp : out 3 el lc : out 4 el dash : out 5 el w : fc none ≡ 1 out 6 el fc : if out 71 line :

pp lc w fc CreateEllipse out 1 el ellipse : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : fc none ≡ 1 out 6 el fc : if out 71 line :

pp lc w CreateArc out 1 el arc : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : out 61 line :

pp lc w fc CreatePie out 1 el pie : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : fc none ≡ 1 out 6 el fc : if out 71 line :

pp lc w fc CreatePolygon out 1 el polygon : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : fc none ≡ 1 out 6 el fc : if out 71 line :

pp lc w CreatePolyline out 1 el polyline : out 2 el pp : out 3 el lc : out 4 el dash : out 5 el w : out 61 line :

pp lc w CreateSpline out 1 el spline : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : out 61 line :

pp lc w CreateBezier out 1 el bezier : out 2 el pp : out 3 el lc : out 4 el solid : out 5 el w : out 61 line :

<content> Some notes taken during the study of the Shapes functions </content>

Different ways to enter input data for Shapes drawing (from a UNI post ):

nm pp lc w fc shape nm pp transpose 11 mat lc solid w fc stack :

nm pp lc w shape nm pp lc w none shape :

nm pp lc shape nm pp lc 1 none shape :

nm pp shape nm pp blue 1 none shape :

--- Examples focused on the "polyline" shape

pline1 polyline 0012 mat 1212 mat 3012 mat 4312 mat stack 11 mat blue solid 2 stack :

or pline1 can be built this other ways :

points 0134020324 mat transpose :

pline1 polyline points blue solid 215 mat transpose : polyline 0012304342 mat blue solid 251 mat

pline1 is at the end a 1 column vector that contains various info's among them a sub-matrix with the coordinates of the polyline points and other elements describing its color and graphical apparence

polyline points blue solid 2 1 5 mat transpose 1 1 mat 1 1 mat

graph drawn without using an intermediate storage variable (matrix) of 1st level

pline1 1 1 mat 1 1 mat

graph drawn using an intermediate storage variable of 1st level (pline1)

shape pline1 11 mat 11 mat :

shape

graph drawn using an intermediate storage variable of 2nd level (shape)

From a practical point of view looks that the interpreter in the XY Plot Region uses to draw a shape a 3 level nesting; at the
1st level is a primitive that creates a matrix with several elements of different types including sub-matrices of points, then there is a further level which is the assembly of more shapes to make a more complex one (probably) and the last is the assembly of more "previous" complex shapes. All these levels of nesting even if are not necessary for a single primitive creation (this is my personal consideration) they must still all be present to be able to draw it

Based on the previous routines available in a UNI post have developed a new one that is a particular application of the "polyline" function to draw Callouts

pp lc w H_Length ls CreateCallout out 1 el polyline : L_arrow 1 : α_arrow 30 ° * : DeltaX pp 11 el pp 21 el - : DeltaY pp 12 el pp 22 el - : DeltaX abs 1010 -^≤ X_arrow pp 11 el L_arrow α_arrow sin * - : pp 12 el pp 22 el ≤ pp 12 el 0 ≥ Y_arrow pp 12 el L_arrow α_arrow cos * + : Y_arrow pp 12 el L_arrow α_arrow cos * + : if pp 12 el 0 ≥ Y_arrow pp 12 el L_arrow α_arrow cos * - : Y_arrow pp 12 el L_arrow α_arrow cos * - : if if 21 line DeltaX 0 > DeltaY 0 > X_arrow pp 11 el L_arrow 90 ° * DeltaY DeltaX / atan - α_arrow + sin * - : Y_arrow pp 12 el L_arrow 90 ° * DeltaY DeltaX / atan - α_arrow + cos * - : 21 line X_arrow pp 11 el L_arrow DeltaY DeltaX / atan - α_arrow + cos * - : Y_arrow pp 12 el L_arrow DeltaY DeltaX / atan - α_arrow + sin * + : 21 line if DeltaY 0 > X_arrow pp 11 el L_arrow 90 ° * DeltaY DeltaX / atan + α_arrow + sin * + : Y_arrow pp 12 el L_arrow 90 ° * DeltaY DeltaX / atan + α_arrow + cos * - : 21 line X_arrow pp 11 el L_arrow 90 ° * DeltaY DeltaX / atan - α_arrow - sin * + : Y_arrow pp 12 el L_arrow 90 ° * DeltaY DeltaX / atan - α_arrow - cos * + : 21 line if if pp_New X_arrow Y_arrow 12 mat pp H_Length pp 21 el + pp 22 el 12 mat stack : out 2 el pp_New : out 3 el lc : out 4 el ls : out 5 el w : out 121 line :

L_arrow is the length of the segment that defines the Arrow Head
α_arrow is the angle (acute ) of the L_arrow segment with the arrow central line
the values of the 2 above defined parameters can be modified to address particular graphical needs

Some details about the arguments of the CreateCallout function.

pp - defines (in this order only and using thestack function ) the coordinates of the eteremes of the arrow part of the callout, STARTING with the position of the Arrow Head and then with the position of the Arrow End that we refer as the "central" point of the callout.
H_Length - is the length of the horizontal part of the callout and can be positive or negative if positive it is drawn on the right side with respect to the "central" point of the callout and on the opposite side if is negative
The remaining arguments have already been covered in the collapsed area titled "Shape Specs" so check there for further details

Some examples of usage

Callout1 6112 mat 5512 mat stack blue 13 - solid CreateCallout :

Callout2 7112 mat 5512 mat stack blue 23 - dot CreateCallout :

Callout3 8112 mat 5512 mat stack blue 33 - dashdot CreateCallout :

Callout4 9112 mat 5512 mat stack blue 13 - dash CreateCallout :

Callout5 9312 mat 5512 mat stack blue 23 - dashdotdot CreateCallout :

Callout Callout1 Callout2 Callout3 Callout4 Callout5 51 mat 11 mat :

Callout

CalloutColour black blue brown cyan gold gray green olive orange pink purple red tan violet yellow navy green red 181 mat :

herewith a more complex testing , the idea is to do a star of callouts to show the drawing possibilities

L_arrow 2 :

X_AEnd 1 - :

Y_AEnd 1 - :

index 1 :

A_Callout_Star 111 mat :

Callout_Matrix 01 matrix :

αi 0 : αi 2 π * 18 / π * - ≤ αi αi 18 / π * + : X_AHead X_AEnd L_arrow αi cos * + : Y_AHead Y_AEnd L_arrow αi sin * + : Callout_Matrix Callout_Matrix X_AHead Y_AHead 12 mat X_AEnd Y_AEnd 12 mat stack CalloutColour index el 13 solid CreateCallout stack : A_Callout_Star index el Callout_Matrix 15 index 1 - (* + (55 index 1 - (* + (range el : index index 1 + : L_arrow L_arrow 0.25 + : 61 line for

A_Callout_Star 1 1 mat

Callout_1 el #

Callout_6 el #

Callout_15 range el #

Callout_2 el #

In diesem Beispiel sind die Dimensionen zufällig, um die Zuverlässigkeit der
Verbindungsfunktion zu prüfen.

In this example, the dimensions are fully randomized in order to test the reliability
of the procedure for joining the blocks.

mn 1 :

mx 4 :

Dim 2 mn mx Random.N :

Dim transpose 2112 mat

R Dim 1 el mn mx Random.N :

R transpose 2412 mat

C Dim 2 el mn mx Random.N :

C transpose 211 mat

j 1 Dim 1 el range k 1 Dim 2 el range M j k el R j el C k el 09 Random.N : for for

M 349822 mat 4992336442 mat 21 mat

M joinRows j 1 M rows range Rt j el M j 1 el : M cols 1 > k 2 M cols range Rt j el Rt j el M j k el augment : for 0 if 21 line for Rt 21 line :

tmp M joinRows :

res tmp transpose joinRows transpose 1 el :

res #