DrawEllipse

Description

Draws an empty or filled ellpse in the current image frame.


Syntax

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

[C/C++]
HRESULT DrawEllipse( short X1, short Y1, 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: Integer


Parameters [C/C++]

X1 [in], Y1 [in]

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

X2 [in], Y2 [in]

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

Width [in]

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

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

Values specifying the color or intensity of the ellipse. If Green and Blue arguments are omitted, they will be assigned the value of Red.

Opacity [in]

An optional integer between 0 and 100 specifying the percentage of opacity at which the ellipse will be blended with the underlying pixels in the image. If omitted, default value of 100 is used.

Return Values

S_OK

Success

E_FAIL

Failure.

Example

The following VB example embeds a semi-transparent filled ellipse into the live video:

Private Sub ActiveGige1_FrameAcquired()
      ActiveGige1.DrawEllipse 50,100, 300,200, 0, 0, 0, 255, 50
End Sub

Remarks

To draw multiple ellipses, call this method several times.