Event Text Feature
Event Text Feature Pseudo-Code
char[ ] ACTION(void)
- The Feature takes no arguments.
- The Feature returns an array of characters.
- The ACTION is performed on target.
Description: |
Macro |
Identifier |
Displayed Name |
Group* |
Max Text Length |
|
Example: |
define_text_event( |
eventMsgFromUser, |
"Msg From User", |
12, |
64 |
); |
*optional argument. If Group is omitted the Group-Number will default to 0.
The unique message id is derived from the row number, in source file where the macro is used.
Description |
XML |
Feature Root: Start |
<F> |
Event Text: Start |
<Et> |
ID |
<I>BYTE</I> |
SUB ID |
<Is>BYTE</Is> |
GROUP |
<Gr>BYTE</Gr> |
NAME |
<N>STRING</N> |
Maximum number of characters in text |
<Mx>INT</Mx> |
Event Text: End |
</Et> |
Feature Root: End |
</F> |
The text value is of format: UTF-8
The text is of arbitrary length and don't require any END-OF-STRING (0) character.
Byte# |
0 |
1 |
2 |
3 .. N-3 |
N-2 |
N-1 |
N |
Name |
START |
ID |
SUB ID |
TEXT |
CRC MSB |
CRC LSB |
END |
Value |
0xAA |
[0..255] |
[0..255] |
UTF-8 |
CRC16-CITT |
0xBB |
|