Section 3: Instrument description Model 2601B-PULSE System SourceMeter Instrument Reference Manual
3-20 2601B-PULSE-901-01A April 2020
Be careful when embedding character codes in the text string. It is easy to forget that the character
following the $ is part of the code. For example, if you want to display Hello on the top line and
Nate on the bottom line, send the following command:
display.settext("Hello$Nate")
The above command displays Hello on the top line and ate on the bottom line. The correct syntax
for the command is as follows:
display.settext("Hello$NNate")
Returning a text message
The display.gettext() function returns the displayed message (text) and can be used in the
following ways:
text = display.gettext()
text = display.gettext(embellished)
text = display.gettext(embellished, row)
text = display.gettext(embellished, row, columnStart)
text = display.gettext(embellished, row, columnStart, columnEnd)
Where:
Returns text as a simple character string (false) or includes character codes (true)
The row to read text from (1 or 2); if not included, text from both rows is read
Starting column for reading text
Ending column for reading text
Sending the command without the row parameter returns both lines of the display. The $N character
code is included to show where the top line ends and the bottom line begins. The $N character code
is returned even if embellished is set to false.
With embellished set to true, all other character codes that were used in the creation of each
message line are returned with the message. With embellished set to false, only the message
is returned.
Sending the command without the columnStart parameter defaults to column 1. Sending the
command without the columnEnd argument defaults to the last column (column 20 for row 1,
column 32 for row 2).