Marblecore Imaging Library Documentation

Documentation / Marblecore Imaging / Methods / DrawTextInGradientUsingWarp

DrawTextInGradientUsingWarp method

Syntax

Boolean DrawTextInGradientUsingWarp(strText As String, nX1 As Number, nY1 As Number, nX2 As Number, nY2 As Number, nX3 As Number, nY3 As Number, nX4 As Number, nY4 As Number, nColorA As Number, nOpacityA As Number, nColorB As Number, nOpacityB As Number, nGradient As Gradient, strFontFace As String, nFontSize As Number, bFontBold As State, bFontItalic As State, bFontUnderline As State, bFontStrikeout As State, bFontAntiAliasing As State, nFontAlignment As Alignment, nFontRotation As Number, nFontShearX As Number, nFontShearY As Number)

Return value

Returns true if the function succeeded.

Parameters

Parameter	Type	Required	Description
strText	String	Yes	Text to draw.
nX1	Number	Yes	Left top horizontal coordinate for the text warp.
nY1	Number	Yes	Left top vertical coordinate for the text warp.
nX2	Number	Yes	Right top horizontal coordinate for the text warp.
nY2	Number	Yes	Right top vertical coordinate for the text warp.
nX3	Number	Yes	Left bottom horizontal coordinate for the text warp.
nY3	Number	Yes	Left bottom vertical coordinate for the text warp.
nX4	Number	Yes	Right bottom horizontal coordinate for the text warp.
nY4	Number	Yes	Right bottom vertical coordinate for the text warp.
nColorA	Number	Yes	Specifies the first color for the gradient.
nOpacityA	Number	Yes	Parameter containing the opacity percentage (where 0% is completely transparent) for the first color.
nColorB	Number	Yes	Specifies the second color for the gradient.
nOpacityB	Number	Yes	Parameter containing the opacity percentage (where 0% is completely transparent) for the second color.
nGradient	Gradient (Enumeration)	No	Optional parameter containing the gradient style.
strFontFace	String	No	Optional parameter which specifies the font face.
nFontSize	Number	No	Optional parameter which specifies the font size.
bFontBold	State (Enumeration)	No	Optional parameter which enables or disables the bold font style.
bFontItalic	State (Enumeration)	No	Optional parameter which enables or disables the italic font style.
bFontUnderline	State (Enumeration)	No	Optional parameter which enables or disables the underline font style.
bFontStrikeout	State (Enumeration)	No	Optional parameter which enables or disables the strikeout font style.
bFontAntiAliasing	State (Enumeration)	No	Optional parameter which enables or disables the font anti-aliasing.
nFontAlignment	Alignment (Enumeration)	No	Optional parameter which specifies the alignment of the text.
nFontRotation	Number	No	Optional parameter which specifies the rotation angle of the text in degrees.
nFontShearX	Number	No	Optional parameter which specifies the horizontal shear percentage of the text.
nFontShearY	Number	No	Optional parameter which specifies the vertical shear percentage of the text.

Example

The example below shows how to use the method. If you take a look at the example code, assume there is a reference to the Marblecore Imaging object with the name 'MarblecoreImaging'. Transparent parts of the image are displayed using a checkerboard pattern.

1 // Creates a new transparent image
2 MarblecoreImaging.Create(150, 150, true);
3 
4 // Execute the operation
5 MarblecoreImaging.DrawTextInGradientUsingWarp("Demo", 25, 25, 130, 40, 15, 100, 110, 100, 16711680, 100, 65280, 100);
6 
7 // Save the modified image to the specified file
8 MarblecoreImaging.SaveToFile("example-drawtextingradientusingwarp.jpg");

Category

Text drawing

See also

DrawTextInGradient | DrawTextInGradientWithBorder | DrawTextInGradientWithBorderAndShadow | DrawTextInGradientWithBorderAndShadowUsingWarp | DrawTextInGradientWithBorderUsingWarp | DrawTextInGradientWithShadow | DrawTextInGradientWithShadowUsingWarp | DrawTextNormal | DrawTextUsingWarp | DrawTextWithBorder | DrawTextWithBorderUsingWarp | DrawTextWithShadow | DrawTextWithShadowUsingWarp | GetTextHeight | GetTextWidth