Level

The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal. More...

Functions
uint32_t	ScpChTrGetLevelCount (TpDeviceHandle_t hDevice, uint16_t wCh)
	Get the number of trigger levels for a specified channel with the current trigger kind.
double	ScpChTrGetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex)
	Get the currently set channel trigger level value for a specified channel and trigger level.
double	ScpChTrSetLevel (TpDeviceHandle_t hDevice, uint16_t wCh, uint32_t dwIndex, double dLevel)
	Set the channel trigger level value for a specified channel and trigger level.

Detailed Description

The channel trigger level property is used to control at which level(s) the channel trigger responds to the channel input signal.

The number of available trigger levels depends on the currently set trigger kind. Use ScpChTrGetLevelCount to determine the number of trigger levels for the currently set trigger kind.

The trigger level is set as a floating point value between 0 and 1, corresponding to a percentage of the full scale input range:

• 0.0 (0%) equals -full scale
• 0.5 (50%) equals mid level or 0 Volt
• 1.0 (100%) equals full scale.

By default the trigger level is set to 0.5 (50%) of the full-scale range.

Function Documentation

uint32_t ScpChTrGetLevelCount	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh
	)

Get the number of trigger levels for a specified channel with the current trigger kind.

Parameters

hDevice	A device handle.
wCh	Channel number, 0 to ScpGetChannelCount() - 1.

Returns

The number of available trigger levels for the currently set trigger kind.

See Also

ScpChTrGetKind

ScpChTrGetLevel

ScpChTrSetLevel

Since

0.4.1

double ScpChTrGetLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex
	)

Get the currently set channel trigger level value for a specified channel and trigger level.

Parameters

hDevice	A device handle.
wCh	Channel number, 0 to ScpGetChannelCount() - 1.
dwIndex	Trigger level index, 0 to ScpChTrGetLevelCount() - 1.

Returns

The currently set trigger level value, a number between 0 and 1.

Since

0.4.1

double ScpChTrSetLevel	(	TpDeviceHandle_t	hDevice,
		uint16_t	wCh,
		uint32_t	dwIndex,
		double	dLevel
	)

Set the channel trigger level value for a specified channel and trigger level.

Parameters

hDevice	A device handle.
wCh	Channel number, 0 to ScpGetChannelCount() - 1.
dwIndex	Trigger level index, 0 to ScpChTrGetLevelCount() - 1.
dLevel	The required trigger level, a number between 0 and 1.

Returns

The actually set trigger level, a number between 0 and 1.

Since

0.4.1