Description

Functions to control the trigger delay of an oscilloscope.

Trigger delay allows to start measuring a specified time after the trigger occurred. This allows to capture events that are more than one full record length past the trigger moment.

The trigger delay can be affected by changing the sample frequency.

Functions
bool8_t	ScpHasTriggerDelay (TpDeviceHandle_t hDevice)
	Check whether the oscilloscope has trigger delay support with the currently selected measure mode. More...

double	ScpGetTriggerDelayMax (TpDeviceHandle_t hDevice)
	Get the maximum trigger delay in seconds, for the currently selected measure mode and sample frequency. More...

double	ScpGetTriggerDelay (TpDeviceHandle_t hDevice)
	Get the currently selected trigger delay in seconds, for a specified oscilloscope. More...

double	ScpSetTriggerDelay (TpDeviceHandle_t hDevice, double dDelay)
	Set trigger delay in seconds, for a specified oscilloscope. More...

Function Documentation

bool8_t ScpHasTriggerDelay ( TpDeviceHandle_t hDevice )

Check whether the oscilloscope has trigger delay support with the currently selected measure mode.

Parameters

[in] hDevice A device handle identifying the oscilloscope.

Returns: BOOL8_TRUE if the oscilloscope has trigger delay support, BOOL8_FALSE otherwise.

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

Since: 0.5

double ScpGetTriggerDelayMax ( TpDeviceHandle_t hDevice )

Get the maximum trigger delay in seconds, for the currently selected measure mode and sample frequency.

Parameters

[in] hDevice A device handle identifying the oscilloscope.

Returns: The maximum trigger delay in seconds.

Status values

INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also: ScpHasTriggerDelay; ScpGetTriggerDelay; ScpSetTriggerDelay

Since: 0.5

double ScpGetTriggerDelay ( TpDeviceHandle_t hDevice )

Get the currently selected trigger delay in seconds, for a specified oscilloscope.

Parameters

[in] hDevice A device handle identifying the oscilloscope.

Returns: The currently set trigger delay in seconds.

Status values

NOT_SUPPORTED	The oscilloscope does not support trigger.
INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also: ScpHasTriggerDelay; ScpGetTriggerDelayMax; ScpSetTriggerDelay

Since: 0.4.3

double ScpSetTriggerDelay	(	TpDeviceHandle_t	hDevice,
		double	dDelay
	)

Set trigger delay in seconds, for a specified oscilloscope.

Parameters

[in]	hDevice	A device handle identifying the oscilloscope.
[in]	dDelay	The required trigger delay in seconds.

Returns: The actually set trigger delay in seconds.

Status values

VALUE_MODIFIED	The requested trigger delay is within the valid range but not available. The closest valid value is set.
INVALID_VALUE	The requested value is not valid.
NOT_SUPPORTED	The oscilloscope does not support trigger.
INVALID_HANDLE	The handle is not a valid oscilloscope handle.
DEVICE_GONE	The device indicated by the device handle is no longer available.
LIBRARY_NOT_INITIALIZED	The library is not initialized, see LibInit().
SUCCESS	The function executed successfully.

See also: ScpHasTriggerDelay; ScpGetTriggerDelayMax; ScpGetTriggerDelay

Since: 0.4.3