Acquisition Start、Stop 與 Abort#

透過 Acquisition Start、Stop 和 Abort 命令，您可以控制影像擷取。

使用功能#

開始影像擷取#

若要開啟影像擷取，請執行 AcquisitionStart 指令。

執行命令後，相機便會等待觸發訊號。觸發訊號可由相機內部產生（free run），或是由外部輸入（triggered image acquisition）。

停止影像擷取#

若要關閉影像擷取，請執行 AcquisitionStop 命令。執行該命令時，將會發生以下情況：

在面陣掃描相機上：

• 如果相機目前未擷取畫格，影像擷取將會立即關閉。
• 如果相機目前正在讀出影像資料，系統會允許讀出程序完成。之後，影像擷取便會關閉。
• 如果相機目前正在對畫格進行曝光：
  • 在某些相機型號上，執行 AcquisitionStop 命令 aborts 曝光。在這種情況下，相機將立即停止曝光並開始讀出影像資料。系統會允許讀出程序完成。之後，影像擷取便會關閉。
  • 在某些相機型號上，您可以 設定 執行 AcquisitionStop 命令是否會中止曝光。若要這麼做，請設定 AcquisitionStopMode 參數設為 AbortExposure 或 Complete.

在線陣掃描相機上：

• 當 AcquisitionStopMode 線陣掃描相機的參數一律設為 Immediate.
• 如果相機目前未擷取畫格，影像擷取將會立即關閉。
• 如果相機目前正在進行行曝光，則 AcquisitionStop 指令對於以下 所有 racer 2 線掃描相機將產生以下結果：
  目前行的曝光完成。影像擷取立即停止。最後擷取的行將傳輸至主機電腦。
• 此外，對於配備 GigE 介面的 racer 2 S 相機，情況如下：
  僅將執行指令前已擷取的行傳送至主機電腦。這可能會導致傳輸不完整的畫面。

中止影像擷取#

若要中止影像擷取，請執行 AcquisitionAbort 指令（若適用)。

在面陣相機上，執行該指令時會發生以下情況：

• 如果相機目前未擷取畫面，影像擷取將立即關閉。
• 如果相機目前正在進行畫面曝光，相機將立即停止曝光。若讀取程序已經開始，將會被中止。目前的畫面將不完整且不會傳輸至主機電腦。隨後，影像擷取將會關閉。
• 如果相機目前正在讀取影像資料，相機將立即停止讀取程序。目前的畫面將不完整且不會傳輸至主機電腦。隨後，影像擷取將會關閉。

在線掃描相機上，執行該指令時會發生以下情況：

• 如果相機目前未擷取行，影像擷取將立即關閉。
• 如果相機目前正在進行行曝光，相機將立即停止曝光。若讀取程序已經開始，將繼續進行。僅將執行指令前已擷取的行傳送至主機電腦。對於配備 GigE 介面的線掃描相機，這可能會導致傳輸不完整的畫面。隨後，影像擷取將會關閉。
• 如果相機目前正在讀取影像資料，相機將繼續讀取程序，直到將執行指令前已擷取的所有行都傳送至主機電腦為止。對於配備 GigE 介面的線掃描相機，這意味著目前的畫面可能不完整（部分畫面）。
  隨後，影像擷取將會關閉。

詳細資料#

顯示所有相機型號

範例程式碼#

// Configure continuous image acquisition on the cameras
camera.AcquisitionMode.SetValue(AcquisitionMode_Continuous);
// Switch on image acquisition
camera.AcquisitionStart.Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
camera.AcquisitionStop.Execute();
// Switch image acquisition back on
camera.AcquisitionStart.Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
camera.AcquisitionAbort.Execute();

INodeMap& nodemap = camera.GetNodeMap();
// Configure continuous image acquisition on the cameras
CEnumParameter(nodemap, "AcquisitionMode").SetValue("Continuous");
// Switch on image acquisition
CCommandParameter(nodemap, "AcquisitionStart").Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
CCommandParameter(nodemap, "AcquisitionStop").Execute();
// Switch image acquisition back on
CCommandParameter(nodemap, "AcquisitionStart").Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
CCommandParameter(nodemap, "AcquisitionAbort").Execute();

// Configure continuous image acquisition on the cameras
camera.Parameters[PLCamera.AcquisitionMode].SetValue(PLCamera.AcquisitionMode.Continuous);
// Switch on image acquisition
camera.Parameters[PLCamera.AcquisitionStart].Execute();
// The camera waits for trigger signals
// (...)
// Switch off image acquisition
camera.Parameters[PLCamera.AcquisitionStop].Execute();
// Switch image acquisition back on
camera.Parameters[PLCamera.AcquisitionStart].Execute();
// The camera waits for trigger signals
// (...)
// Abort image acquisition
camera.Parameters[PLCamera.AcquisitionAbort].Execute();

/* Macro to check for errors */
#define CHECK(errc) if (GENAPI_E_OK != errc) printErrorAndExit(errc)
GENAPIC_RESULT errRes = GENAPI_E_OK;  /* Return value of pylon methods */
/* Configure continuous image acquisition on the cameras */
errRes = PylonDeviceFeatureFromString(hdev, "AcquisitionMode", "Continuous");
CHECK(errRes);
/* Switch on image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStart");
CHECK(errRes);
/* The camera waits for trigger signals */
/* (...) */
/* Switch off image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStop");
CHECK(errRes);
/* Switch image acquisition back on */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionStart");
CHECK(errRes);
/* The camera waits for trigger signals */
/* (...) */
/* Abort image acquisition */
errRes = PylonDeviceExecuteCommandFeature(hdev, "AcquisitionAbort");
CHECK(errRes);

# Configure continuous image acquisition on the cameras
camera.AcquisitionMode.Value = "Continuous"
# Switch on image acquisition
camera.AcquisitionStart.Execute()
# The camera waits for trigger signals
# (...)
# Switch off image acquisition
camera.AcquisitionStop.Execute()
# Switch image acquisition back on
camera.AcquisitionStart.Execute()
# The camera waits for trigger signals
# (...)
# Abort image acquisition
camera.AcquisitionAbort.Execute()

您也可以 use the pylon Viewer 來輕鬆設定參數。