VideoCTRL ActiveX Help  

MotionDetectSet Method


Syntax
object.MotionDetectSet( iTolerance, bPreview, [optional lFrequency], [optional lTriggerFrames],[optional iSpacing], [optional lDetectFromX], [optional lDetectFromY], [optional lDetectToX], [optional lDetectToY] )


Parameters
iTolerance = int, pixel RGB color change before detection is triggered.
bPreview = boolean, show motion detection live, fit to control, (retains aspect ratio of source).
lFrequency = int, miliseconds between frames
lTriggerFrames
= long, number of consecutive frames detecting motion before event MotionDetected triggers.
iSpacing = int, pixels spacing 3 minimum
lDetectFromX = long, X coordinate to start detection area in pixels, default = 0
lDetectFromY = long, Y coordinate to start detection area in pixels, default = 0
lDetectToX = long, X coordinate to stop detection area in pixels, default entire source width.
lDetectToY = long, Y coordinate to stop detection area in pixels, default entire source height.



Additional Notes
Motion detection requires RGB format,  usually default but can be set with captureDlgFormat if required.

Pictorial view of detection pixel groups,   1   = detection pixel.

0 1 0
1 1 1
0 1 0

Each detection point is grouped from 5 pixels as shown above, All 5 pixels must change value of red, green and blue color values greater than the iTolerance in order to trigger the detection event.

iTolerance can be changed manually at anytime using the MotionDetectTolerance() or MotionDetectLevel() methods.

The pixel groups are spaced a part horizontally and vertically using iSpacing this is to reduce CPU usage.

Frames are checked every iFrequency, this can be set higher to reduce CPU usage.

Partial area or full area detection of source can be set with lDetectFromX, lDetectToX, lDetectFromY, lDetectToY.

Result
Sets motion detection parameters, before MotionDetectStart().

See Also
CaptureDriverName to enquire on specfic driver details.
CaptureDriverVersion to enquire on specfic driver details .
CaptureDriverConnect to connect to specfic driver.
CaptureDriverDisconnect  to disconnect currently connected driver.

MotionDetectSet - Set parameters for detection
MotionDetectStart - Start motion detection
MotionDetectStop - Stop motion detection
MotionDetectShow - Show detected motion.
MotionDetectBMP - Save motion capture as BMP
MotionDetectJPG - Save motion capture as JPG
MotionDetectPicture - Capture as picture object.
MotionDetectLevel - Auto set detection tolerance level
MotionDetectTolerance - Get and set tolerance level


 

HELP! If you have any further questions please visit the VideoCtrl Forum - http://www.datadevelopment.co.uk/forum


Copyright © 2003-2007 www.datadevelopment.co.uk