Syntax

Top Previous Next


Boonton55xxx IVI Driver Reference

BTN55XXX_ATTR_POSITION Attribute
Trigger See Also

Set or return the position of the trigger event on displayed sweep.

Attribute Tree Node: \Boonton55xxx\Instrument Specific\Trigger\Position

Declaration: Btn55xxx.h

Implementation: Btn55xxx.dll

Visual C++

#define BTN55XXX_ATTR_POSITION 1150021
ViStatus Btn55xxx_GetAttributeViInt32(
ViSession Vi,
ViConstString RepCapIdentifier,
ViAttr AttributeID,
ViInt32* AttributeValue
);
ViStatus Btn55xxx_SetAttributeViInt32(
ViSession Vi,
ViConstString RepCapIdentifier,
ViAttr AttributeID,
ViInt32 AttributeValue
);

Parameters

The ViSession handle that you obtain from the IviDriver_init or IviDriver_InitWithOptions function. The handle identifies a particular instrument session.

RepCapIdentifier

Must be VI_NULL or an empty string. This attribute is not defined on a repeated capability.

AttributeID

Must be BTN55XXX_ATTR_POSITION.

AttributeValue (GetAttribute)

Returns the current value of the attribute. The user must specify the address of a variable that has the same data type as the attribute.

AttributeValue (SetAttribute)

The value to which to set the attribute.

Remarks

Assuming zero trigger delay, setting the position to LEFT causes the entire trace to be post-trigger. Setting it to RIGHT causes the entire trace to be pre-trigger. And setting to MIDDLE will display both the pre- and post-trigger portions of the trace.

Note that the trigger delay setting is in addition to this setting, and will cause the trigger position to appear in a different location. Setting the trigger position places thepower meter in trigger position mode, which overrides the variable vernier settings of the trigger vernier command.

Instrument Command

TRIGger:POSition {LEFT|MIDDLE|RIGHT}

TRIGger:POSition?

Defined Values

Name	Description
BTN55XXX_VAL_TRIGGER_POSITION_LEFT	Assuming zero trigger delay, setting the position to Left causes the entire trace to be post-trigger.
BTN55XXX_VAL_TRIGGER_POSITION_MIDDLE	Setting trigger position to Middle will display both the pre- and post-trigger portions of the trace.
BTN55XXX_VAL_TRIGGER_POSITION_RIGHT	Assuming zero trigger delay, setting trigger position to right causes the entire trace to be pre-trigger.

Top

Requirements

Supported Models

All supported