Enabling Signals

To designate one or several signals as responsible for signaling operation, the MultiCam system provides an adjust-level parameter called SignalEnable.

One such parameter exists for the channel and processor class. It has the MultiCam type "enumerated collection".

Each item of the collection allows for enabling or disabling a specific signal. The value of the item is ON or OFF.

The set of all ON signals constitute the selection of signals enabling the relevant channel or processor to perform one of the following:

  • Calling a callback function
  • Releasing a waiting thread
  • Causing a Windows event

To address a specific signal, the by-ident parameter access method is used with the SignalEnable parameter belonging to the desired channel or processor object. The parameter setting function McSetParamInt or McSetParamStr is used with a parameter identifier established as follows:

To reach signal... Use parameter identifier...
Frame Trigger Violation MC_SignalEnable + MC_SIG_FRAME_TRIGGER_VIOLATION
Start Exposure MC_SignalEnable + MC_SIG_START_EXPOSURE
End Exposure MC_SignalEnable + MC_SIG_END_EXPOSURE
Release (*) MC_SignalEnable + MC_SIG_RELEASE
Surface Filled MC_SignalEnable + MC_SIG_SURFACE_FILLED
Surface Processing MC_SignalEnable + MC_SIG_SURFACE_PROCESSING
Cluster Unavailable MC_SignalEnable + MC_SIG_CLUSTER_UNAVAILABLE
Acquisition failure MC_SignalEnable + MC_SIG_ACQUISITION_FAILURE
End of acquisition MC_SignalEnable + MC_SIG_END_ACQUISITION_SEQUENCE
Start of acquisition MC_SignalEnable + MC_SIG_START_ACQUISITION_SEQUENCE
End of channel activity MC_SignalEnable + MC_SIG_END_CHANNEL_ACTIVITY

(*) This signal is generated only with Domino boards.

Example

The following code enables the "Surface Filled" signal with the channel designated by my_Channel:

Status = McSetParamInt (
  my_Channel,
  MC_SignalEnable + MC_SIG_SURFACE_FILLED,
  MC_SignalEnable_ON
);

The Status variable can be used for error checking.