Acquisition Start、Stop 與 Abort#

「Acquisition Start 」、「Stop」及「Abort」這三個指令可讓您控制影像擷取。

使用功能#

開始擷取影像#

若要啟用影像擷取功能，請執行 AcquisitionStart 指令。

指令執行完畢後，攝影機將等待觸發訊號。觸發訊號可由攝影機內部產生（自由運行），或由外部提供（觸發式影像擷取）。

停止影像擷取#

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

關於面掃描相機：

• 若相機目前未正在擷取畫面，則會立即關閉影像擷取功能。
• 若相機目前正在讀出影像資料，則會讓讀出過程完成。之後，影像擷取功能將被關閉。
• 如果相機目前正在進行一幀的曝光：
  • 在某些相機型號上, 執行一個 AcquisitionStop 命令 中止 曝光。在此情況下，相機將立即停止曝光並開始讀出影像資料。系統會讓讀出過程完成，之後便會關閉影像擷取功能。
  • 在某些相機型號上, 您可以 設定 無論是執行一個 AcquisitionStop 該指令是否會中止曝光。若要如此操作，請設定 AcquisitionStopMode 參數設為 AbortExposure 或 Complete.

關於線掃描攝影機：

• 當 AcquisitionStopMode 線掃描攝影機的參數總是設定為 Immediate.
• 若相機目前未正在擷取畫面，則會立即關閉影像擷取功能。
• 如果相機目前正在對某一行進行曝光，則 AcquisitionStop 此指令會產生以下結果： 《All Racer 2》 線掃描相機：
  當前行的曝光已完成。擷取作業立即停止。最後擷取的一行將傳輸至主電腦。
• 此外，對於 racer 2 S 具備GigE介面的相機，情況如下：
  僅會將截至執行該命令為止所擷取的影像行傳送至主機。這可能會導致傳輸的畫面不完整。

中止影像擷取#

若要中止影像擷取，請執行 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 來輕鬆設定參數。