DrawAlphaText
Top  Previous  Next

Description

Embeds a string of text in the alpha plane over the live video.


Syntax


[VB]
objActiveGige.DrawAlphaText X, Y, Text, Red, Green, Blue [,Opacity ]


[C/C++]
HRESULT DrawAlphaText( short X, short Y, bstr Text, long Red, long Green, long Blue [,short Opacity ]);


Data Types
[VB]

X, Y : Integer
Text: String
Red, Green, Blue: Long
Opacity: Intager

Parameters
[C/C++]

X [in], Y [in]  
Coordinates of the beginning of the text relative to the image origin.  
Text [in]  
The string containing the text to be drawn.  
Red [in], Green [in], Blue [in]  
Values specifying the color or intensity of the text.  
Opacity [in]  
Vaule in the range 1-100 specifies the percentage of opacity at which the ellipse will be blended with the underlying pixels in the image.  
If 0, the pixels of the text area 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-transparent yellow text in the alpha plane:

ActiveGige1.Acquire = 
True

ActiveGige1.
DrawAlphaText 50,100, "ActiveGige SDK for 1394 cameras", 255,255,0,50

ActiveGige1.Alpha =  
True



Remarks


To select the font for drawing text strings in the alpha plane, use the OverlayFont property. To draw multiple strings, call this method several times. For more information on the alpha-plane drawing refer to Alpha.