DrawText(Int32,String,Int32,Int32,Single,GdPictureFontStyle,Int32,String,Boolean) Method

In This Topic

Draws a text on a GdPicture image. The drawing color is specified with an integer value.

Syntax

Visual Basic
C#
Delphi
JScript
Managed Extensions for C++
C++/CLI

'Declaration
 
Public Overloads Function DrawText( _
   ByVal ImageID As Integer, _
   ByVal Text As String, _
   ByVal DstLeft As Integer, _
   ByVal DstTop As Integer, _
   ByVal FontSize As Single, _
   ByVal FontStyle As GdPictureFontStyle, _
   ByVal TextColor As Integer, _
   ByVal FontName As String, _
   ByVal AntiAlias As Boolean _
) As GdPictureStatus

public GdPictureStatus DrawText( 
   int ImageID,
   string Text,
   int DstLeft,
   int DstTop,
   float FontSize,
   GdPictureFontStyle FontStyle,
   int TextColor,
   string FontName,
   bool AntiAlias
)

public function DrawText( 
    ImageID: Integer;
    Text: String;
    DstLeft: Integer;
    DstTop: Integer;
    FontSize: Single;
    FontStyle: GdPictureFontStyle;
    TextColor: Integer;
    FontName: String;
    AntiAlias: Boolean
): GdPictureStatus;

public function DrawText( 
   ImageID : int,
   Text : String,
   DstLeft : int,
   DstTop : int,
   FontSize : float,
   FontStyle : GdPictureFontStyle,
   TextColor : int,
   FontName : String,
   AntiAlias : boolean
) : GdPictureStatus;

public: GdPictureStatus DrawText( 
   int ImageID,
   string* Text,
   int DstLeft,
   int DstTop,
   float FontSize,
   GdPictureFontStyle FontStyle,
   int TextColor,
   string* FontName,
   bool AntiAlias
)

public:
GdPictureStatus DrawText( 
   int ImageID,
   String^ Text,
   int DstLeft,
   int DstTop,
   float FontSize,
   GdPictureFontStyle FontStyle,
   int TextColor,
   String^ FontName,
   bool AntiAlias
)

Parameters

ImageID: GdPicture image identifier.
Text: Text to draw.
DstLeft: Specifies the x-coordinate of the upper-left corner of the rectangle that bounds the.
DstTop: Specifies the y-coordinate of the upper-left corner of the rectangle that bounds the.
FontSize: The font size in units specified by the FontSetUnit() method.
FontStyle: A member of the FontStyle enumeration.
TextColor: Color of the text. A suitable color value can be obtained by using the ARGBI() method.
FontName: The name of the font. IE: "Arial".
AntiAlias: Set to True to apply the Antialiasing algorithm else False.

Return Value

A member of the GdPictureStatus enumeration.

Remarks

To draw watermark text use an ARGB value with alpha component < 255.

This method requires the Image Documents component to run.

Example

Drawing the red text "GdPicture.Net" on a png image and saving the image using maximum compression.

using (GdPictureImaging gdpictureImaging = new GdPictureImaging())
{
    int imageID = gdpictureImaging.CreateGdPictureImageFromFile("input.png");
 
    // Draw the text in the top left corner of the image.
    gdpictureImaging.DrawText(imageID, "GdPicture.Net", 5, 5, 24, GdPicture14.FontStyle.FontStyleRegular, gdpictureImaging.ARGBI(255, 255, 0, 0), "Arial", true);
 
    // Save the output png using maximum compression.
    gdpictureImaging.SaveAsPNG(imageID, "output.png", 9, false);
    gdpictureImaging.ReleaseGdPictureImage(imageID);
}

Reference

GdPictureImaging Class
GdPictureImaging Members
Overload List
FontSetUnit Method
FontGetUnit Method
ARGBI Method