Function Name: CalloutArrow1
Function Purpose: it is used to draw the graphical part of the callout (style1)
Some details about some of its arguments:
pp - defines (in this order only and using the stack function ) the coordinates of the extremes 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 ; it can be positive or negative, if positive it is drawn on the right side with respect to the "central" point of the callout and viveversa if it is negative.
The remaining arguments have already been covered in the collapsed area titled "Shape Specs" (in another worksheet )so check there for further details
L_arrow
is the length of the segment that defines the Arrow Head
α_arrow
is the angle (acute ) that the L_arrow segment forms with the arrow central line
the values of the 2 above defined
parameters
can be modified to address particular graphical needs
Fig. 1
\- These are the coordinates to
complete the drawing of the
horizontal part of the callout --/
Function Name: CalloutArrow2
Function Purpose: it is used to draw the graphical part of the callout (style2)
Some details about some of its arguments:
pp - defines (in this order only and using the stack function ) the coordinates of the extremes 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 ; it can be positive or negative, if positive it is drawn on the right side with respect to the "central" point of the callout and viveversa if it is negative.
The remaining arguments have already been covered in the collapsed area titled "Shape Specs" (in another worksheet )so check there for further details
L_arrow
is the length of the segment that defines the Arrow Head
α_arrow
is the angle (acute ) that the L_arrow segment forms with the arrow central line
the values of the 2 above defined
parameters
can be modified to address particular graphical needs
Fig. 1
\-------------------------- These are the coordinates for drawing the horizontal part of the callout + the rectangle to contain the lines of text -------------------/
Herewith there is just the matrix that stores the font sample for each of the available fonts. The complete dont data
are in external .png files
in the Arial (or any other font ) array shown in the above collapsed Area there are:
- 6 rows of 20 pixel each + one row of 1 pixel I guess at the bottom of the area
/picture
- 16 columns (Characters) of 14 pixel each + one row of 1 pixel I guess at the
extreme right of the area/picture
Character size is - 14 width x 20 height (in pixel)
Attention!! some Character are not properly positioned in the Array so it is required a refinement of this aspect (for instance the Character "W"
16 Columns x 6 Rows picture
This matrix is used as Input for the ComboBox List
I have added at the beginning of C$ the space Char
Scalable monospaced bitmapped fonts in XYPlot
Conversion of a Text String in a bitmap string built with a monospaced (bitmap) font
.
As a support for this conversion there is the matrix SubmtrxRef this is a matrix with in each row the information needed to extract from one of the Font matrix shown above the character whose position in C$ is specified in the 1st column using the Submatrix function (see herewith for further details about its content)
This matrix was originally loaded from an Excel file, each row is related to a Character in the string C$, indeed the 5 columns have the following meaning:
Column1: is the position of a character in C$ ( for instance the number 4 corresponds to the character "#", space " " is the 1st character of the string )
Columns from 2 to 5 are the rows and columns index for the extraction of a submatrix from the Arial (or another font ) matrix corresponding to the character whose position is specified to the first column of this matrix , in details they are:
Column2: is the index of the row starting range
Column3: is the index of the row ending range
Column4: is the index of the column starting range
Column5: is the index of the column ending range
Note
- when I have initially read these data from an external Excel file and placed its content in a variable with the same name it was possible to shrink the size of the matrix using the mouse and the 3 dots that indicate that the matrix has a bottom part hidden were shown; Doing the copy and paste trick of Alvaro/Oscar this is no more possible and if you have a huge matrix it is no more possible to collapse it as it was supposed to be.
Moreover it is not possible to copy the content of a collapsed matrix in a variable if the hidden part is not shown completely otherwise the copy and paste is just limited to the part initially shown.
Function Name: WordWrap
Function Purpose: split an input text string in rows of a defined length
Some details about some of its arguments:
Inputs: ts - string of text to wrap
tw - maximum length of each row of wrapped text
Output: an array of row(s) of text wrapped/split at the maximum length tw
\
| Variables Inizialization
|
|
|
/
StrPos is the starting position of a character in the Input text string of the text row to wrap
EndPos is the last position of a character in the Input text string of the text row to wrap
this is the total length of the Input Text String
i_row is the index of the Array that stores the wrapped rows of text
While the position of the cursor/character EndPos is less then the length of the Input Text String executes the line istructions
check if the character at EndPos (so at the end of a substring of tw characters) is not a space
if this is true check if at the next character position there isn't a space
if this is true this means that we will split a word if we break the text string at StrPos
so we need to find the position of the last word in the TextRow string and update accordingly the positions/values of the variables StrPos and EndPos and extracts a substring and store it in the array TextWrapped , is length is less then tw
otherwise
extracts a substring of tw characters and store it in the array TextWrapped
and updates the starting and ending position to use on the next substring in the while loop
to avoid that that this substring start with a space it is added a + 2 and not a +1
in the StrtPos expression
otherwise
(extracts a substring of tw characters and store it in the array TextWrapped
(subtracting -1 from TextWidth avoids that the rows of wrapped text end with a space)
and update accordingly the positions/values of the variables StrPos and EndPos
increment the i_row index
when the while do loop ends we must manage the extraction of the last part of
TextString so assign to the variable LastRowLength the width of the last substring to extract starting at the position StrPos
Function Name: Text2BMP
Function Purpose: converts each character of a text string in a string of BMP characters taken from a
specified \[REGION[c94c3ef81d3741409dd66f168c337141]]\ font family stored in a matrix
Some details about some of its arguments:
Input : TextMatrix = matrix with in each rows a text string to convert in BMP,
FontFamily = matrix that stores a BMP repesentation of each character in C$
Output: Text_BMP = matrix that strores in each row the result of the conversion of
the corresponding Input row (of the matrix TextMatrix) in a BMP array
CharH is the Height of each Char in the matrix FontFamily
N_Rows is the number of rows in the Input matrix TextMatrix
External Loop on each row of the Input matrix TextMatrix
Define a storage matrix τ for the resulting converted text string in BMP
Internal Loop on each character present in the previous selected row of TextMatrix
extracts a character and stores it in the var Char
find its position (if exists ) in C$, if
doesn't
exists place in Char_Index 0
so if CharIndex is 0
replaces the searched character with a space " " and place the extracted submatrix it in the matrix τ
otherwise
extracts from the FontFamily matrix the corresponding char in BMP and places it in the matrix τ
at the End of the Internal Loop strores the content of the matrix τ , so a text string as BMP in the matrix Text_BMP
that is devoted to the storage of each converted text string
this is another function that is used to position a string of text in BMP form at a certain point, scaling it by a factor k
Word Wrapping example(s) of usage
rows of text in the Output matrix
Text to BMP example(s) of usage
result of the search of a character in the string C$, if it is NOT found the result is 0
I need to specify the index 1 because the output from the txt2BMP function is a (1 level) nested matrix and the pos function requires just the internal level
XYLabel'XLabel:"", XYLabel'YLabel:""
( r ) means that a collapsed area can be deleted
An attempt to define the size of a character of the selected Bitmap Monospaced font (Arial) in the XY Plugin Plotting Area
in the pos function there is a scale factor k that changes the size of the character drawn , have drawn a character with different scale factor to understand the relationship of the character size with the scale factor
From the tests done have found that :
Character height = 1.43 ( 20 Pixel) for a scale factor k of 1
Character width = 0.70 ( 14 Pixel ) both are rough evaluations
reducing the scale factor of \[REGION[d58722133bde44708d6153e958289e52]]\ or \[REGION[002a1b3f6a8b471e8d9fb69f4d01af94]]\ reduces the dimensions of the character matrix of the same quantity in proportion
So to position vertically the rows of bitmap converted text we need to define a line spacing that is linked to the size (height) of a character
( based on the k factor) .
Assumptions: We define for now that :
- the line spacing is \[REGION[c655f0ecbf614166b18926a965e70aa6]]\ of the character height (I have seen that 1/10 is too much because the font includes a lot of space at the bottom part )
- the maximum number of text rows to display in a Callout will be 8 ( even if I guess that we will not exeed the 4 ones, the hypotesis is of a Callout not too verbose )
If the number of rows is 1 this row is positioned in 2nd position
2 these rows are positioned in 2nd and 3rd position
3 these rows are positioned in 1st,2nd and 3rd position see picture on the right for row positioning
4 these rows are positioned in 1st,2nd,3rd and 4th position
the rule is that if the number of rows is even they are split in equal parts above and belove the horizontal part of the callout.
if it is odd the numbers of rows of text above the horizontal part of the callout exeed of 1 rows the ones below it.
Size in pixel of drawn Character = 66 x 99 k = 1 -
33 x 49 k = 2 -
22 x 34 k = 3 evaluated using a pixel ruler
the coordinates of the segments have been found by trial and error
we see that the "W" is not printed correctly need to find with Oscar how he produced the Arial mono and try to correct this or other similar errors in the future
Herewith I have tried to develop a procedure (CreateCallout) that put together all the user functions developed previously trying to minimize the data necessary to obtain the final result
Function Name: CreateCallout1
Function Purpose: draws in the XY plugin Plotting Area both the graphical and the textual part of a callout
Some details about some of its arguments:
Input : Txt = String of text to wrap based on the Txt_w length and to position on the graphical part of the callout
Txt_w = Maximum length of each row of wrapped text
FontFamily = Matrix that stores a BMP repesentation of each character in C$
k_t = Text scale factor if it is greater than 1 the size of the text is smaller than the reference one (2 means that it is
half, 3 which is a third an so on) if instead we want the size of the text is higher than the reference one, this
factor must be less than 1
k_h = Horizontal part of the callout scale factor. We have that the length of the horizantal part of the callout is due to
two parts:
1-the text wrap length and this is a fixed length part (b)
2-and the part from the callout "center" till the beginning of the textual part (b) and this can be changed
according to our graphical needs. (see some remarks in the Fig .2 on the right side → )
Txt_p = Indicates the placement of the callout text, it can be on the left or right side of the callout "Center" point;
values of this parameter can be L=Left or R=Right
Output: a list that contains both the graphical and the textual part of a callout
Fig. 2 - Style1
Herewith I have tried to develop a procedure (CreateCallout) that put together all the user functions developed previously trying to minimize the data necessary to obtain the final result
Function Name: CreateCallout2
Function Purpose: draws in the XY plugin Plotting Area both the graphical and the textual part of a callout
Some details about some of its arguments:
Input : Txt = String of text to wrap based on the Txt_w length and to position on the graphical part of the callout
Txt_w = Maximum length of each row of wrapped text
FontFamily = Matrix that stores a BMP repesentation of each character in C$
k_t = Text scale factor if it is greater than 1 the size of the text is smaller than the reference one (2 means that it is
half, 3 which is a third an so on) if instead we want the size of the text is higher than the reference one, this
factor must be less than 1
k_h = Horizontal part of the callout scale factor. We have that the length of the horizantal part of the callout is due to
two parts:
1-the text wrap length and this is a fixed length part (b)
2-and the part from the callout "center" till the beginning of the textual part (b) and this can be changed
according to our graphical needs. (see some remarks in the Fig .2 on the right side → )
Txt_p = Indicates the placement of the callout text, it can be on the left or right side of the callout "Center" point;
values of this parameter can be L=Left or R=Right
Output: a list that contains both the graphical and the textual part of a callout
Fig. 2 - Style2
Tests for the positioning of the bitmaped text over the callout , changing the input Text length
Coordinates of the Callout arrowhead and arrow end ( or "center" , don't change these names)
Font Selection
Sample of the selected font
read the matrix with the complete and specific
font data from an external file whose name is the same of the font selected
Time for drawing rows of 40 char is 4.5 sec/row
50 char is 6 sec/row
60 char is 7.6 sec/row
the trend looks linear and an increment of 10 character increase the execution time of 1.5 sec in average
Effects of variations in k_t values (keeping k_h costant =2) herewith there are simple screenshoots of the final drawing to skip calculation time , with k_t =1 we have what I have called "the reference " situation in the CreateCallout function documentation above
Effect of variations in k_h values (keeping k_t costant =2)
if I want to remove completely the part from the callout "center" till the beginning of the textual part (b) I need to use a very high value of k_h ( 100 is more then enough )
Effect of changes in the Input text length