You are here: Start » Filter Reference » WebCamera » WebCamera_GrabImage

WebCamera_GrabImage

Captures a frame from a camera using Direct Show interface.

Name	Type	Range	Description
inCameraIndex	Integer *	0 - +	Index number of camera device to connect with
inFrameSize	Size *		Requested size of source frame in pixels selected from camera output formats
outFrame	Image		Captured frame

Applications

Not recommended for industrial operation.

Description

Filter uses DirectDraw API to acquire images from devices registered in system. Images can be acquired from many sources like: web cameras with support for DirectDraw, video grabbers and system video streams.

Input inCameraIndex selects device in order provided by the operational system.

Input inFrameSize selects output image size in pixels. If an image in requested size is not available an error occurs. If value of inFrameSize is not provided filter returns image with first available size found.

Examples

Description of usage of this filter can be found in examples and tutorial: Dynamic Template Matching, HMI Recorder.

Remarks

Filter WebCamera_GrabImage reads only data from input type MEDIASUBTYPE_RGB24.

Errors

"Unable to connect with chosen Web Camera." - error will occur when provided inCameraIndex is not valid device number.

"Unable to connect with media type of Web Camera. Required image format may not be supported. " - selected inFrameSize is not supported by selected device.

Complexity Level

This filter is available on Basic Complexity Level.