{"id":1309,"date":"2014-02-21T11:13:51","date_gmt":"2014-02-21T11:13:51","guid":{"rendered":"http:\/\/bitmap2lcd.com\/blog\/?p=1309"},"modified":"2014-02-21T15:49:20","modified_gmt":"2014-02-21T15:49:20","slug":"bitmap2lcd-text-processing-functions","status":"publish","type":"post","link":"https:\/\/bitmap2lcd.com\/blog\/bitmap2lcd-text-processing-functions\/","title":{"rendered":"Bitmap2LCD : Text Processing Functions"},"content":{"rendered":"

Bitmap2LCD is a tool for programming small Graphic LCDs in embedded systems and a programmable graphic and text processing tool.<\/em><\/strong><\/p>\n

From Bitmap2LCD V2.9 and upwards
\n<\/strong><\/p>\n

Bitmap2LCD : Text Processing Functions<\/span><\/h2>\n

Note : Additional Processing functions will be implemented in the future<\/p>\n

The batch conditions and functions listed below, are available for programaticaly modifying the text editor content. A condition block (IF.. \/ WHILE..<\/strong>) can be followed by one or more functions (THEN..<\/strong>) A single condition block applies from the first to the last line to the whole text editor content. Next condition block again applies to the whole editor content…<\/p>\n

Internal Batch System Variables<\/span><\/h2>\n

The batch system has internal variables holding informations such as :<\/p>\n

Internal Index<\/strong> : The char index (or position) in the text editor line, where a ‘text’ or an other data has been found. This internal index can be used in a following ‘then’ function by letting ‘index’ as it is next to the function (= no index number)<\/p>\n

Internal Text Buffer : <\/strong>A text buffer where lines can be copied to<\/p>\n

Current Hex Value<\/strong> : The last Hex value found for example by the get hex<\/strong> function<\/p>\n

Hex Length Value<\/strong> : The Length of a hexadecimal value<\/p>\n

Current Integer Value<\/strong> : The last Integer value found for example by the get integer<\/strong> function<\/p>\n

Current Float Value<\/strong> : The last floating point value value found for example by the get float<\/strong>\u00a0 function<\/p>\n

Current Flag<\/strong> : A boolean status flag ( True or false )<\/p>\n

 <\/p>\n

Undefined Conditions<\/span><\/h2>\n

if unconditional
\n<\/strong><\/h2>\n

Unconditionally Set condition = True , execute list of functions on any text editor line<\/p>\n

Hexadecimal Conditions and Functions <\/span><\/h2>\n

if hex in line\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition = True when a hex string (as user defined in the configuration settings ) is found in the line ( A hex value is defined by its prefix or suffix\u00a0 ( for example prefix like 0x<\/strong> or $<\/strong> or a suffix like h<\/strong><\/p>\n

while hex in line<\/strong><\/h2>\n

Condition is and remains true while a hex value is found in the line, usefull for example, in a line of 16 hex values.<\/p>\n

 <\/p>\n

then get hex (index)<\/strong><\/h2>\n

If condition was True, gets the hex value specified by index ( first hex value index being index = 0 )\u00a0 Internal Index<\/strong> variable holds the char index where the hex value has been found.<\/p>\n

 <\/p>\n

then insert hex (index)<\/strong><\/h2>\n

If condition was True, Inserts the current hex value in string on position specified by index.
\nIf no numeric index specified, inserts hex on Internal Index<\/strong> value.<\/p>\n

 <\/p>\n

then overwrite hex
\n<\/strong><\/h2>\n

If condition was True, overwrites the current hex value in string on position on current index position.<\/p>\n

 <\/p>\n

Text and\u00a0 Conditions and Functions<\/span><\/h2>\n

 <\/p>\n

if ‘text’ \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition = True when the defined string under ‘text’ is found in the line<\/p>\n

Internal Index<\/strong> variable holds the index where ‘text’\u00a0 has been found.<\/p>\n

 <\/p>\n

if not ‘text’ \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition = True when the defined string under ‘text’ wasn’t found in the line<\/p>\n

 <\/p>\n

while ‘text’ \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition is and remains true while\u00a0the defined string under ‘text’ is found in the line<\/p>\n

Remark : The defined ‘text’ might be deleted or modified in a function afterwards to prevent a loop without end.<\/em><\/p>\n

 <\/p>\n

and ‘text’\u00a0 ,\u00a0 and not ‘text’ ,\u00a0 or<\/strong> ‘text’ ,\u00a0 <\/strong>or not ‘text’\u00a0\u00a0 <\/strong><\/strong>
\n<\/strong><\/h2>\n

self speaking conditions, to extend\u00a0if<\/strong> conditions<\/p>\n

 <\/p>\n

then overwrite (index) ‘text’
\n<\/strong><\/h2>\n

If condition was True, overwrites text editor line from index<\/strong> position with specified ‘text’<\/strong><\/p>\n

Uses internal index<\/strong> value if index was’nt specified<\/p>\n

 <\/p>\n

then insert (index) ‘text’
\n<\/strong><\/h2>\n

If condition was True, inserts in text editor line from index<\/strong> position the specified ‘text’<\/strong><\/p>\n

Uses internal index<\/strong> value if index was’nt specified<\/p>\n

 <\/p>\n

then remove ‘text’
\n<\/strong><\/h2>\n

If condition was True, removes in the text editor line, the specified ‘text’<\/strong><\/p>\n

 <\/p>\n

then delete until ‘text’
\n<\/strong><\/h2>\n

If condition was True, deletes chars in the text editor line from the internal index<\/strong> position to the position of ‘text’<\/strong>
\n<\/strong><\/p>\n

 <\/p>\n

 <\/p>\n

Line Number Conditions and Functions<\/span><\/h2>\n

if line number (index)
\n<\/strong><\/h2>\n

Condition = True if line number of text editor has been reached<\/p>\n

 <\/p>\n

if last line
\n<\/strong><\/h2>\n

Condition = True if last line of text editor has been reached<\/p>\n

 <\/p>\n

then delete line
\n<\/strong><\/h2>\n

If condition was True, deltes the current text editor line<\/p>\n

 <\/p>\n

then next line
\n<\/strong><\/h2>\n

If condition was True, jumps to the next line of text editor<\/p>\n

 <\/p>\n

then insert line
\n<\/strong><\/h2>\n

If condition was True, inserts a line at current line of text editor<\/p>\n

 <\/p>\n

Flag Conditions and Functions<\/span><\/h2>\n

if flag \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition = True when flag was previously set <\/strong><\/p>\n

 <\/p>\n

if not flag \u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0\u00a0 <\/strong><\/h2>\n

Condition = True when flag was’nt previously set<\/p>\n

then set flag<\/strong><\/h2>\n

If condition was True, gets then sets the flag<\/p>\n

then set flag<\/strong><\/h2>\n

If condition was True, then clears the flag<\/p>\n

and flag\u00a0 ,\u00a0 and not flag ,\u00a0 or<\/strong> flag ,\u00a0 <\/strong>or not flag \u00a0 <\/strong><\/strong>
\n<\/strong><\/h2>\n

self speaking conditions, to extend\u00a0if<\/strong> conditions<\/p>\n

 <\/p>\n

Other Conditions and Functions<\/span><\/h2>\n

then save as ‘file’
\n<\/strong><\/h2>\n

If condition was True, then copies the content of the text editor as it is now <\/strong>to a filename defined under ‘file<\/strong>‘ <\/strong>in the user defined Output Files Path<\/strong> ( Note : No path or folder allowed in ‘file’ )<\/p>\n

then start delete
\n<\/strong><\/h2>\n

If condition was True, then sets a start of deletion flag at current text editor line<\/p>\n

then stop delete
\n<\/strong><\/h2>\n

If condition was True, then , if start delete has been found upwards in the text editor, deletes all the lines from Start to Stop delete position.<\/p>\n

then start copy
\n<\/strong><\/h2>\n

If condition was True, then sets a start of copy flag at current text editor line<\/p>\n

then stop copy
\n<\/strong><\/h2>\n

If condition was True, then , if start copy has been found upwards in the text editor, copies\u00a0 all the lines from start to stop copy position to the internal text buffer<\/strong><\/p>\n

then save copy as ‘file’
\n<\/strong><\/h2>\n

If condition was True, then copies the content of the internal text buffer <\/strong>to a filename defined under ‘file<\/strong>‘ <\/strong>in the user defined Output Files Path<\/strong> ( Note : No path or folder allowed in ‘file’ )<\/p>\n

 <\/p>\n

then load and insert ‘file’
\n<\/strong><\/h2>\n

If condition was True, then loads an external text file defined under ‘file<\/strong>‘ located <\/strong>in the user defined Output Files Path<\/strong> and inserts the\u00a0 text into the text editor ( Note : No path or folder allowed in ‘file’ )<\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n

 <\/p>\n\t

\r\n\t