CURSor Commands (Cursor setting and reading)


Configure the number of and ability to move the A and B cursors.


Syntax


(Command)
(Query)


:CURSor:ABCUrsor A$
:CURSor:ABCUrsor?

(Response)

A$
A$:A, B, A_B


Details


Select A, B or A&B cursors.
The current settings for the A, B, and A&B cursors are returned in the form of text data.

A  move A cursor
B  move B cursor
A_B  2 cursors and move both A and B cursors simultaneously


Example


:CURSor:ABCUrsor A
:CURSor:ABCUrsor?
(Response)  :CURSOR:ABCURSOR A  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Assign the Cursor A channel. (X-Y waveforms)


Syntax


(Command)
(Query)


:CURSor:ACHAnnel CH$
:CURSor:ACHAnnel?

(Response)

CH$
CH$:XY1 to XY4 (X-Y waveforms)


Details


Specifies a channel for Cursor A. (X-Y waveforms)
Returns the current Cursor A channel as a text string.


Example


:CURSor:ACHAnnel XY1
:CURSor:ACHAnnel?
(Response)  :CURSOR:ACHANNEL XY1  (when headers are enabled)


Note


-


Usage
Conditions


HIGHSPEED
"X-Y line" or "X-Y dot" can be selected as display format.




Set or query the position of Cursor A.


Syntax


(Command)
(Query)


:CURSor:APOSition A
:CURSor:APOSition?

(Response)

A<NR1>
A<NR1>:0 to the number of stored data (vertical cursor or trace cursor)
A<NR1>:0 to 360
(horizontal cursor)


Details


Specifies the position of Cursor A.
Returns the current position of Cursor A.


Line cursor (vertical)


Trace cursor


Line cursor (horizontal)

Normal waveform

0 to the number of stored data points

0 to the number of stored data points

0 to 360

XY waveform

0 to 360

0 to the number of stored data points

0 to 360


Example


:CURSor:APOSition 1000
:CURSor:APOSition?
(Response)  CURSOR:APOSITION 1000  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Assign the Cursor B channel. (X-Y waveforms)


Syntax


(Command)
(Query)


:CURSor:BCHAnnel CH$
:CURSor:BCHAnnel?

(Response)

CH$
CH$:XY1 to XY4 (X-Y waveforms)


Details


Specifies a channel for Cursor B. (X-Y waveforms)
Returns the current Cursor B channel as a text string.


Example


:CURSor:BCHAnnel CH1
:CURSor:BCHAnnel?
(Response)  :CURSOR:BCHANNEL CH1  (when headers are enabled)


Note


-


Usage
Conditions


HIGHSPEED
"X-Y line" or "X-Y dot" can be selected as display format.




Set or query the position of Cursor B


Syntax


(Command)
(Query)


:CURSor:BPOSition A
:CURSor:BPOSition?

(Response)

A<NR1>
A<NR1>:to the number of stored data (vertical cursor or trace cursor)
A<NR1>:0 to 360
(horizontal cursor)


Details


Specifies the position of Cursor B.
Returns the current position of Cursor B.


Line cursor (vertical)


Trace cursor


Line cursor (horizontal)

Normal waveform

0 to the number of stored data points

0 to the number of stored data points

0 to 360

XY waveform

0 to 360

0 to the number of stored data points

0 to 360


Example


:CURSor:BPOSition 1000
:CURSor:BPOSition?
(Response)  :CURSOR:BPOSITION 1000  (when headers are enabled)


Note


-


Usage
Conditions


All functions




Query a cursor readout value. (time)


Syntax


(Query)


:CURSor:DTREad? A$

(Response)

B$
A$:A, B, B_A
B$:readout value (time)


Details


Returns a cursor readout (time) value as a text string.

A  Cursor A
B  Cursor B
B_A  The value at Cursor B minus the value at Cursor A


Example


:CURSor:DTREad? A
(Response)  :CURSOR:DTREAD 5ms  (when headers are enabled)


Note


Only trace cursor mode is available when the XY display format is selected.


Usage
Conditions


All functions




Query a cursor readout value. (measured value)


Syntax


(Query)


:CURSor:DVREad? A$(,B$)

(Response)

C$(,D$)
A$:A, B, B_A
B$:CH1 to CH4(Normal waveforms)
C$ ,D$:readout value(V)
(Argument D$ is available with the Envelope mode ON or for XY waveforms.)


Details


Returns a cursor readout (measured amplitude) value as a text string.

A  Cursor A
B  Cursor B
B_A  The value at Cursor B minus the value at Cursor A

C$

D$

Envelope mode ON
(Trace cursor)

Maximum value

Minimum value

XY waveform
(Trace cursor)

X-axis data

Y-axis data

Other case

Measured value

-



Example


:CURSor:DVREad? A,CH1
(Response)  :CURSOR:DVREAD 500.0mV  (when headers are enabled)

(REALTIME, when Envelope mode is set to ON)
:CURSor:DVREad? A,CH1
(Response)  :CURSOR:DVREAD 1.5688 V,-1.4688 V  (when headers are enabled)

(HIGHSPEED, XY waveform)
:CURSor:DVREad? A
(Response)  :CURSOR:DVREAD 0.0469 V,0.0594 V  (when headers are enabled)


Note


When XY synthetic waveform is selected, do not specify B$.


Usage
Conditions


All functions




Select or query the cursor mode.


Syntax


(Command)
(Query)


:CURSor:MODE A$
:CURSor:MODE?

(Response)

A$
A$:OFF, TIME(vertical), VOLT(horizontal), TRACe


Details


Selects the cursor mode.
Returns the current cursor mode as a text string.


Example


:CURSor:MODE TRACe
:CURSor:MODE?
(Response)  :CURSOR:MODE TRACE  (when headers are enabled)


Note


-


Usage
Conditions


All functions