(OpenCV) cvQueryFrame

フレーム画像を取得

定義

/* Just a combination of cvGrabFrame and cvRetrieveFrame
   !!!DO NOT RELEASE or MODIFY the retrieved frame!!!      */
CVAPI(IplImage*) cvQueryFrame( CvCapture* capture );

にあるようにcvGrabFrameとcvRetrieveFrameの組合せらしい。 取得したIplImageを弄るのはダメらしい。

ちなみにその二つの関数は以下のように定義される。

/* grab a frame, return 1 on success, 0 on fail. 
  this function is thought to be fast               */  
CVAPI(int) cvGrabFrame( CvCapture* capture );

/* get the frame grabbed with cvGrabFrame(..) 
  This function may apply some frame processing like 
  frame decompression, flipping etc.
  !!!DO NOT RELEASE or MODIFY the retrieved frame!!! */
CVAPI(IplImage*) cvRetrieveFrame( CvCapture* capture );

引数

cvCaptureFromCAMで取得したポインタを渡す。

返り値

IplImageになるが直接弄るのは禁止なのでcvCloneImage等でコピーしてから作る。