OverlayBitmap::drawFrameRect Method

Draws the frame of a rectangle on the live video.

Syntax:

bool drawFrameRect( COLORREF color, const RECT& rect );

Parameter		Description


color		Specifies the color of the frame of the rectangle. The color can be specified with the RGB macro.
rect		The rectangle to be drawn in pixel coordinates. A CRect object or a RECT structure can be passed for this parameter.

Return value:

true on success, false otherwise.

Information:

Introduced in version 2.0

Sample:

This example demonstrates how draw two rectangles on the live video stream.

smart_ptr<DShowLib::OverlayBitmap> pOverlayBitmap;
pOverlayBitmap = m_Grabber.getOverlay( ePP_DEVICE );
// Make sure, the overlay is enabled.
pOverlayBitmap->setEnable(true);
// Draw a rectangle in magenta, using a CRect object.
pOverlayBitmap->drawFrameRect( RGB(255,0,255),
                                CRect(100,50,50,25));
// Draw a rectangle in blue, using a RECT structure.
RECT rectangle;
rectangle.left   = 160;
rectangle.right  = 200;
rectangle.top    = 160;
rectangle.bottom = 180;
pOverlayBitmap->drawFrameRect( RGB(0,0,255),    rectangle);

<< OverlayBitmap