User manual

Part 6: IEEE 488.2 Command Reference
HOR_POSITION, HPOS
Description
The HOR_POSITION command horizontally positions the geometric center of the intensified (zoomed)
zone represented by a zoom math function trace. Allowed positions range from division 0 through 10. If
the source trace was acquired in sequence mode, horizontal shifting will only apply to a single segment at
a time.
If multi-zoom is enabled, the difference in horizontal position (or segment viewed for sequence mode
acquisitions) is applied to all zoom traces. The VAB bit (bit 2) in the STB register table is set if a value
outside the legal range is specified.
The HOR_POSITION? query returns the position of the geometric center of the intensified zone.
Command Syntax
<trace>:HOR_POSITION <hor_position>,<segment>
<trace>:= F1 to Fn, M1 to Mn, TA to TD
<hor_position>:= 0 to 10 [DIV]
<segment>:= 0 to max segments
Note: TA through TD are for backward compatibility. Although accepted, they are not returned by
queries.
The segment number is only relevant for waveforms acquired in sequence mode; it is ignored in single
waveform acquisitions. When segment number is 0, all segments are shown at default magnification.
Query Syntax
<trace>:HOR_POSITION?
Response Format
<trace>:HOR_POSITION <hor_position | segment>
Note: The segment number is only returned for sequence waveforms.
Example (GPIB)
The following instruction positions the center of the intensified zone on trace F1 at division 3:
CMD$="F1:HPOS 3": CALL IBWRT(SCOPE%,CMD$)
6-79