TriggerImage

If in trigger mode, this function triggers the next image in the list.

Syntax

Definition:

METHOD TriggerImage : HRESULT

Return value

HRESULT

Weiterführende Informationen

Die Methode TriggerImage triggert ein Bild aus dem File Source.

Zustandsübergänge

Mit TriggerImage soll das File Source nur ein Bild einladen und dabei im aktuellen Zustand ACQUIRING bleiben. Da die Bildaufnahme üblicherweise mehrere Zyklen dauert, geht das File Source im Regelfall jedoch kurzzeitig in den Zwischenzustand TRIGGERING.

Alle möglichen Zustandsübergänge sowie ihre Return Codes sind in folgender Übergangsmatrix dargestellt:

Return Codes (`HRESULT`)		Ergebniszustand
		TRIGGERING	ACQUIRING	ERROR
Ausgangszustand	ACQUIRING	`PENDING`	`BUSY / SUCCESS`	`FAILED`
	TRIGGERING	`BUSY`	`SUCCESS`