MDO3000 Programmer Manual.pdf - 第486页

Commands Listed in A lphabetical Order Another way to e nter characters is \xnn where the nn is the hexadecimal value of the character to display . An advantag e o f these methods is that any con troller program can be u…

100%1 / 1158
Commands Listed in Alphabetical Order
Bit 7 0
Bit 6
If set, invers
e video is toggled from current state and the following text
is displayed in the new inverse state until the state is toggled again.
Remaining bits are ignored
Bit 5
If set, the color index in the four LSB’s (bits 0 through 3) is applied to
the foregrou
nd or background color depending on the fg/bg bit (bit 4 ).
Bit 4
If set, colo
r change is applied to the background, otherwise applies to
the foreground.
Bit0–3
Specifies the color index (0 through 15) to change color as specified
below:
Index 0
Black (transparent)
Index 1
Yellow (Ch 1)
Index 2
Cyan (Ch 2 )
Index 3
Magenta (Ch 3)
Index 4
Green (Ch 4)
Index 5
Red (math)
Index 6
White (reference)
Index 7
Orange
Index 8 Black
Inde
x9
Blac
k
Index 10 Blue
Index 11
Dark Green
Index 12 Tan
In
dex 13
Bl
ack
Index 14
Wh
ite (text color)
Index 15 Dark gray
Bit 4
If set, the foreground color is set to the default foreground color.
Bit 3
If set, the background color is set to the default background color.
Bit 2
Undefined
Bit 1
Undefined
Bit 0
Undefined
The ESC (escape) character followed by the @ character turns inverse video on or
off and can be embedded in the message string. Example: “abcESC@defESC@
ghi” specifies the string “abcdefghi” where the “def” portion is displayed in
inverse video.
Example: “abcESC#defESC)ESC@ghi” specifies the string “abcdefghi” where
the “def” portion appears in the channel 3 color (magenta) and the “ghi” portion
appears in the normal text color except it’s in inverse video.
An alternate way to enter characters is octal escape sequences. This consists of a
backslash followed by numerals in the standard C language printf fashion.
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-455
Commands Listed in Alphabetical Order
Another way to e
nter characters is \xnn where the nn is the hexadecimal value of
the character to display.
An advantage o
f these methods is that any controller program can be used.
Another advantage is it’s easy to access characters with the high bit set, that is,
those characters with a decimal value greater than 127.
An alternate way to enter certain characters is with a backslash followed bya
single character (following “standard” Unix) as described in the table below.
n
Newline (c
arriage return and line feed)
\ Backslash
(\\ is required to get a backslash character)
t
Horizont
al tab; the next 2 characters specify the pixel column to tab to
as explained earlier
If a backslash is followed by an undefined special character, the backslash is
ignored and the character following it is accepted as is.
NOTE. The use of any escape codes other than those described above may
produc
e unpredictable results.
Examples
MESSage:SHOW “Hello World”
displays “Hello world” in the upper left corner of the box (you can define the box
size
with the MESSAGE BOX command).
MESSage:SHOW “@Hello World@ .. hello”
dis
plays “Hello world .. hello” in the upper left corner of the box and the word
“world” is displayed in inverse video. In this example, stands for the escape
character. The escape character may appear differently for you depending on
your controller program.
MESSage:STATE
Controls the display of the message box.
Group
Display
Syntax
MESSage:STATE {OFF|ON| <NR1>}
MESSage:STATE?
Related Commands
MESSage:BOX
MESSage:SHOW, MESSage:CLEAR
2-456 MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual
Commands Listed in Alphabetical Order
Arguments
OFF or <NR1> = 0 r
emoves the message window from the screen.
ON or <NR1> ≠ 0 displays the message window and its contents on the screen.
NEWpass (No Query Form)
This command changes the password that enables access to password protected
data. The PASSWord command must be successfully executed before using this
command or an execution error will be generated.
Group
Miscellaneous
Syntax
NEWpass <QString>
Related Commands
*PUD
PASSWord
Arguments
<QString> is the new password, which can contain up to 16 characters.
Examples
NEWPASS "mypassword" creates a new password (mypassword) for accessing
your protected data.
*OPC
Generates the Operation Complete message in the Standard Event Status Register
(SESR) when all pending commands that generate an OPC message are complete.
The *OPC command allows you to synchronize the operation of the oscilloscope
with your application program. Examples of this commands usage are
available(See page 3-7, Synchronization Methods.) The *OPC? query places
the ASCII character "1" into the output queue when all such OPC commands
are complete.
The *OPC? response is not available to read until all pending operations finish.
(See page 3-978, Status and Events.)
Certain oscilloscope operations can affect the
*OPC response. (See Table 3-3
on page 3-8.)
Group
Status and Error
MDO4000/B/C, MSO/DPO4000B and MDO3000 Series Oscilloscopes Programmer Manual 2-457