DrawAlphaRectangle

Description

Draws an empty or filled rectangle in the alpha plane over the video window.


Syntax

[VB]
objActiveGige.DrawAlphaRectangle X1, Y1, X2, Y2, Width, Red , Green, Blue [, Opacity]

[C/C++]
HRESULT DrawAlphaRectangle( short X1, short Y2, short X2, short Y2, short Width, long Red , long Green, long Blue [, short Opacity ]);


Data Types [VB]

X1, Y1, X2, Y2 : Integer
Width: Integer
Red, Green, Blue: Long
Opacity: Intager


Parameters [C/C++]

X1 [in], Y1 [in]

Coordinates of the top left corner of the rectangle's bounding rectangle relative to the image origin.

X2 [in], Y2 [in]

Coordinates of the bottom right corner of the rectangle's bounding rectangle relative to the image origin.

Width [in]

Width of the line in pixels. If zero, a filled rectangle will be drawn.

Red [in], Green [in], Blue [in]

Values specifying the color or intensity of the rectangle.

Opacity [in]

Value in the range 1-100 specifying the percentage of opacity at which the ellipse will be blended with the underlying pixels in the image.

If 0, the pixels of the rectangle will be reset to the fully transparent state.

If omitted, default value of 100 is used.

Return Values

S_OK

Success

E_FAIL

Failure.

Example

The following VB example draws a semi-transparend filled red rectangle in the alpha-plane over the live video:

ActiveGige1.Acquire = True
ActiveGige1.DrawAlphaRectangle 100,100,200,200,0,255,0,0,50
ActiveGige1.Alpha =  True


Remarks

To draw multiple rectangles, call this method several times. For more information on the alpha-plane drawing refer to Alpha.