フレーム測定と積算測定

English

MiniPixCtrl.acquire(count, sec, acquisition_type="frames", callback=None, save_format=None, save_path=None) は共通測定APIである。count は測定回数、sec は1回の測定時間（秒）を指定する。受け付ける測定種別は frames と integral のみである。

Frames: doSimpleAcquisition() を使用する。callback、TIFF保存、HDF5保存のいずれかが有効な場合、PX_EVENT_ACQ_FINISHED にフックして各フレームを取得する。それ以外の場合は測定終了後に acqFrameCount() と acqFrame() を利用して結果を読み出す。取得結果は内部履歴に保持する。

Integral: doSimpleIntegralAcquisition() を使用する。Python側でフレームを加算しない。完了後に最終積算フレームを取得し、callbackがあれば1回だけ呼ぶ。count を指定しても、返却される画像数は通常のフレーム測定と同一ではない。

結果の辞書は rc、acquisition_type、frame_count、frames、saved_file を持つ。frames の各要素は画像データとサイズ・統計量を含む。エラー時は例外を発生させ、state() からエラー状態を参照できる。

注意: acquire() は同期呼び出しであり、測定終了まで戻らない。外部から停止する場合は別スレッドなどで stop() を呼ぶ設計が必要になる。実機での動作・割り込みの応答性は未検証。

出典：添付 pixet_ctrl.py acquire()、acquire_frames()、acquire_integral()。