Acquisition Start、Stop 與 Abort#

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

使用此功能#

開始影像擷取#

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

執行命令後，相機便會等待觸發訊號。觸發訊號可以由相機內部產生 (free run)，也可以從外部套用 (triggered image acquisition)。

停止影像擷取#

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

在面陣相機上：

• 如果相機目前未擷取畫格，影像擷取將會立即關閉。
• 如果相機目前正在讀出影像資料，將允許讀出程序完成。之後，影像擷取將會關閉。
• 如果相機目前正在對影格進行曝光：
  • 在某些相機型號上，執行 AcquisitionStop 指令 將會中止 曝光。在這種情況下，相機將立即停止曝光並開始讀出影像資料。讀出程序將會執行完畢。在此之後，影像擷取將會關閉。
  • 在某些相機型號上，您可以 設定 執行 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()

您也可以使用 pylon Viewer 來輕鬆設定參數。