7.7.8.111. GEL_TargetTextOut()ΒΆ
Display Target Formatted String.
Syntax
GEL_TargetTextOut( startAddress, [page], [maxLength], [Format], ["outputLabel"], [textColor], [lineNumber], [appendToEnd], [changeHighlight] );
Parameters
startAddress: specifies the first address of the block containing the preformatted string.
page (optional): identifies the type of memory: 0 (Program memory), 1 (Data memory) or 2 (I/O space)
For processors that do not have more than one type of memory, use 0 for page. The default value for the page number is 0. For simulated targets, the I/O space parameters is not supported.
maxLength (optional): specifies the maximum length of the block if the block is longer than 400 bytes. The formatted string on the target should be a null terminated string. However, if a null is not encountered only 400 or maxLength bytes (whichever is larger) of the string will be printed.
Format (optional): indicates whether the text is in packed or unpacked format on the target:
0 1 2 |
ASCII character (per addressable unit) Packed ASCII character using big endian format; the first character is in the most significant byte of the target. ASCII character using little endian format; the first character is in the least significant byte of the target. |
outputLabel (optional): names the label that GEL prepends in its output. The outputLabel must be enclosed in quotation marks. By default, "GEL Output" is used.
textColor (optional): This argument is ignored in this version of CCS.
lineNumber (optional): This argument is ignored in this version of CCS.
appendToEnd (optional): This argument is ignored in this version of CCS.
changeHighlight (optional): This argument is ignored in this version of CCS.
Description
This function is used to print a formatted string to the console window. The string must already exist on the target and must be null terminated.
Synchronous
Synchronous from GEL: Yes
Completely synchronous: Yes
Example
GEL_TargetTextOut(0x800);
GEL_TargetTextOut(0x1000, 0, 400, 1, "My Window", 1);
Related Topics