Modules
	Trigger edge property

	Trigger delay property

	Trigger divider property

	Trigger burst property

Data Structures
struct	peak_trigger_mode
	peak Trigger mode More...

Macros
#define	PEAK_TRIGGER_MODE_HARDWARE_TRIGGER
	peak Trigger mode preset: Frame start by trigger input More...

#define	PEAK_TRIGGER_MODE_SOFTWARE_TRIGGER
	peak Trigger mode preset: Frame start by software trigger More...

Enumerations
enum	peak_trigger_target { PEAK_TRIGGER_TARGET_INVALID, PEAK_TRIGGER_TARGET_FRAME_START, PEAK_TRIGGER_TARGET_LEVEL_CONTROLLED_EXPOSURE }
	peak Trigger target More...

Functions
peak_access_status	peak_Trigger_GetAccessStatus (peak_camera_handle hCam)
	Query the trigger feature access status. More...

peak_status	peak_Trigger_Enable (peak_camera_handle hCam, peak_bool enabled)
	Enable/Disable the trigger. More...

peak_bool	peak_Trigger_IsEnabled (peak_camera_handle hCam)
	Get the enabled status of the trigger. More...

peak_bool	peak_Trigger_IsExecutable (peak_camera_handle hCam)
	Check whether the trigger is executable or not. More...

peak_status	peak_Trigger_Execute (peak_camera_handle hCam)
	Execute the trigger. More...

peak_access_status	peak_Trigger_Mode_GetAccessStatus (peak_camera_handle hCam, peak_trigger_mode triggerMode)
	Query the trigger mode access status. More...

peak_status	peak_Trigger_Mode_Set (peak_camera_handle hCam, peak_trigger_mode triggerMode)
	Set the trigger mode. More...

peak_status	peak_Trigger_Mode_Get (peak_camera_handle hCam, peak_trigger_mode *triggerMode)
	Get the trigger mode. More...

Detailed Description

Trigger related functions and types.

Macro Definition Documentation

◆ PEAK_TRIGGER_MODE_HARDWARE_TRIGGER

#define PEAK_TRIGGER_MODE_HARDWARE_TRIGGER

peak Trigger mode preset: Frame start by trigger input

Initialize a peak_trigger_mode with this preset and pass it to peak_Trigger_Mode_Set to configure a hardware trigger for frame start.
See the following example code.

const peak_trigger_mode triggerMode = PEAK_TRIGGER_MODE_HARDWARE_TRIGGER;

peak_status status = peak_Trigger_Mode_Set(cameraHandle, triggerMode);

Note: This is the default trigger mode which is configured until peak_Trigger_Mode_Set has been called.

◆ PEAK_TRIGGER_MODE_SOFTWARE_TRIGGER

#define PEAK_TRIGGER_MODE_SOFTWARE_TRIGGER

peak Trigger mode preset: Frame start by software trigger

Initialize a peak_trigger_mode with this preset and pass it to peak_Trigger_Mode_Set to configure a software trigger for frame start.
See the following example code.

const peak_trigger_mode triggerMode = PEAK_TRIGGER_MODE_SOFTWARE_TRIGGER;

peak_status status = peak_Trigger_Mode_Set(cameraHandle, triggerMode);

Enumeration Type Documentation

◆ peak_trigger_target

enum peak_trigger_target

peak Trigger target

The trigger target specifies which operation a trigger signal initiates or defines.

Enumerator

PEAK_TRIGGER_TARGET_INVALID

Invalid trigger target.

Use this value for the initialization of variables of type peak_trigger_target.

PEAK_TRIGGER_TARGET_FRAME_START

Frame start.

A trigger signal will initiate the start of a frame acquisition.

PEAK_TRIGGER_TARGET_LEVEL_CONTROLLED_EXPOSURE

Level controlled exposure.

The trigger signal will define the exposure duration.

Function Documentation

◆ peak_Trigger_Enable()

peak_status peak_Trigger_Enable	(	peak_camera_handle	hCam,
		peak_bool	enabled
	)

Enable/Disable the trigger.

Sets the trigger to enabled or disabled.

A trigger can be enabled or disabled if there is no running acquisition only.

Parameters

[in]	hCam	The camera handle.
[in]	enabled	The desired enabled status. PEAK_TRUE for enabled, PEAK_FALSE for disabled.

Returns: PEAK_STATUS_SUCCESS Operation was successful; no error occurred.; PEAK_STATUS_ACCESS_DENIED The trigger feature is not accessible for write. Check the access status of the trigger feature via peak_Trigger_GetAccessStatus.; PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.; PEAK_STATUS_NOT_INITIALIZED The library is not initialized.; PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_Trigger_Execute()

peak_status peak_Trigger_Execute ( peak_camera_handle hCam )

Execute the trigger.

Executes the trigger.

If a trigger is executed the configured trigger target is issued.
For a hardware trigger this means that an appropriate signal on the configured io channel is simulated.

Parameters

[in] hCam The camera handle.

Returns: PEAK_STATUS_SUCCESS Operation was successful; no error occurred.; PEAK_STATUS_ACCESS_DENIED The trigger is not enabled or it is not executable or the trigger feature is not accessible. Check for the trigger to be enabled via peak_Trigger_IsEnabled. Check for the trigger to be executable via peak_Trigger_IsExecutable. Check the access status of the trigger feature via peak_Trigger_GetAccessStatus.; PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.; PEAK_STATUS_NOT_INITIALIZED The library is not initialized.; PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_Trigger_GetAccessStatus()

peak_access_status peak_Trigger_GetAccessStatus ( peak_camera_handle hCam )

Query the trigger feature access status.

Provides the current access status for the trigger feature.

This function implements the Access Status Query principle.

Parameters

[in] hCam The camera handle.

Returns: PEAK_ACCESS_READWRITE The trigger feature is readable and writeable.; PEAK_ACCESS_READONLY The trigger feature is readable only.; PEAK_ACCESS_GFA_LOCK The trigger feature is not accessible because the GFA write access is enabled.; PEAK_ACCESS_NONE The trigger feature is not accessible. Check for a running acquisition.; PEAK_ACCESS_NOT_SUPPORTED The trigger feature is not supported.; PEAK_ACCESS_INVALID The function failed. Call peak_Library_GetLastError to get the error code and description.

If the function indicates an error by returning PEAK_ACCESS_INVALID, these are the possible errors:

PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.
PEAK_STATUS_NOT_INITIALIZED The library is not initialized.
PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_Trigger_IsEnabled()

peak_bool peak_Trigger_IsEnabled ( peak_camera_handle hCam )

Get the enabled status of the trigger.

Queries whether the trigger is currently enabled or disabled.

This function implements the Enabled Status Query principle.

Parameters

[in] hCam The camera handle.

Returns: PEAK_TRUE The trigger is currently enabled.; PEAK_FALSE The trigger is currently disabled or the query failed.

◆ peak_Trigger_IsExecutable()

peak_bool peak_Trigger_IsExecutable ( peak_camera_handle hCam )

Check whether the trigger is executable or not.

Queries whether the trigger is executable or not.

If a trigger is executable it can be issued via peak_Trigger_Execute.

This function implements the Boolean Status Queries principle.

Parameters

[in] hCam The camera handle.

Returns: PEAK_TRUE The trigger is executable.; PEAK_FALSE The trigger is not executable or the query failed.

◆ peak_Trigger_Mode_Get()

peak_status peak_Trigger_Mode_Get	(	peak_camera_handle	hCam,
		peak_trigger_mode *	triggerMode
	)

Get the trigger mode.

Reads the current trigger mode.

Parameters

[in]	hCam	The camera handle.
[out]	triggerMode	The trigger mode.

Returns: PEAK_STATUS_SUCCESS Operation was successful; no error occurred.; PEAK_STATUS_ACCESS_DENIED The trigger mode is not available for read access. Check the access status of the trigger mode via peak_Trigger_Mode_GetAccessStatus.; PEAK_STATUS_INVALID_PARAMETER triggerMode is an invalid pointer.; PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.; PEAK_STATUS_NOT_INITIALIZED The library is not initialized.; PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_Trigger_Mode_GetAccessStatus()

peak_access_status peak_Trigger_Mode_GetAccessStatus	(	peak_camera_handle	hCam,
		peak_trigger_mode	triggerMode
	)

Query the trigger mode access status.

Provides the access status for the given trigger mode.

This function implements the Access Status Query principle.

Parameters

[in]	hCam	The camera handle.
[in]	triggerMode	The trigger mode.

Returns: PEAK_ACCESS_READWRITE The trigger mode is readable and writeable.; PEAK_ACCESS_READONLY The trigger mode is readable only.; PEAK_ACCESS_GFA_LOCK The trigger mode is not accessible because the GFA write access is enabled.; PEAK_ACCESS_NONE The trigger mode is not accessible.; PEAK_ACCESS_NOT_SUPPORTED The trigger mode is not supported.; PEAK_ACCESS_INVALID The function failed. Call peak_Library_GetLastError to get the error code and description.

If the function indicates an error by returning PEAK_ACCESS_INVALID, these are the possible errors:

PEAK_STATUS_ACCESS_DENIED The trigger feature is not accessible. Check the access status of the trigger feature via peak_Trigger_GetAccessStatus.
PEAK_STATUS_INVALID_PARAMETER triggerMode is an invalid trigger mode. Check peak_trigger_target and peak_io_channel.
PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.
PEAK_STATUS_NOT_INITIALIZED The library is not initialized.
PEAK_STATUS_ERROR An unexpected internal error occurred.

◆ peak_Trigger_Mode_Set()

peak_status peak_Trigger_Mode_Set	(	peak_camera_handle	hCam,
		peak_trigger_mode	triggerMode
	)

Set the trigger mode.

Changes the trigger mode.

The properties of the trigger will be reset to the following default values:

The trigger edge will be set to PEAK_TRIGGER_EDGE_RISING.
The trigger delay will be set to 0.
The trigger divider will be set to 1.
The trigger burst size will be set to 1.

Parameters

[in]	hCam	The camera handle.
[in]	triggerMode	The trigger mode.

Returns: PEAK_STATUS_SUCCESS Operation was successful; no error occurred.; PEAK_STATUS_ACCESS_DENIED The trigger mode is not available for write access or the io channel is not available for write access. Check the access status of the trigger mode via peak_Trigger_Mode_GetAccessStatus. Check the access status of the io channel via peak_IOChannel_GetAccessStatus.; PEAK_STATUS_INVALID_PARAMETER triggerMode is an invalid trigger mode. Check peak_trigger_target and peak_io_channel.; PEAK_STATUS_INVALID_HANDLE hCam is an invalid camera handle.; PEAK_STATUS_NOT_INITIALIZED The library is not initialized.; PEAK_STATUS_ERROR An unexpected internal error occurred.

Modules

Data Structures

Macros

Enumerations

Functions

Detailed Description

Macro Definition Documentation

◆ PEAK_TRIGGER_MODE_HARDWARE_TRIGGER

◆ PEAK_TRIGGER_MODE_SOFTWARE_TRIGGER

Enumeration Type Documentation

◆ peak_trigger_target

Function Documentation

◆ peak_Trigger_Enable()

◆ peak_Trigger_Execute()

◆ peak_Trigger_GetAccessStatus()

◆ peak_Trigger_IsEnabled()

◆ peak_Trigger_IsExecutable()

◆ peak_Trigger_Mode_Get()

◆ peak_Trigger_Mode_GetAccessStatus()

◆ peak_Trigger_Mode_Set()