ICImagingControl.MemorySnapImage Method [Deprecated]
|This method captures a still image from a live video stream.|
This method captures a still image from a live video stream and stores it in the ring buffer. The buffer can be saved to a file using the ICImagingControl.MemorySaveImage Method.
If the live video stream is already running, then the maximum duration of MemorySnapImage is double of the frame rates time interval. MemorySnapImage captures the next new provided image from the live video stream.
If the live video stream was not started before a call of MemorySnapImage, then the live video stream is started in MemorySnapImage automatically. An image will be captured and the live video stream is stopped automatically. If MemorySnapImage is called often in an application, then this sequence of start - snap - stop can be very time expensive. Thus, it is better to call LiveStart once in the application and stop the live video stream when the application ends.
If no image was provided by the video capture device in the timeout time an exception is thrown.
If an external triggered camera is in use, then MemorySnapImage should be avoided, because it blocks the application until it returns. For triggered cameras the ImageAvailable event should be used.
This method is deprecated since version 3.5.
The following code snippet shows how to snap an image from the video live stream using a timeout of 1000ms. The snapped image will be shown in a PictureBox:
|See also:||ICImagingControl, ICImagingControl.MemorySaveImage, ICImagingControl.ImageActiveBuffer, ICException.ErrorCodes|