Share via

Mesh.TextFromFont(Device,Font,String,Single,Single,GlyphMetricsFloat) Method (Microsoft.DirectX.Direct3D)

  • Article

Creates a mesh that contains the specified text, using a .NET font object.

Definition

Visual Basic Public Shared Function TextFromFont( _
    ByVal device As Device, _
    ByVal font As FontLeave Site, _
    ByVal text As String, _
    ByVal deviation As Single, _
    ByVal extrusion As Single, _
    ByRef glyphMetrics As GlyphMetricsFloat _
) As Mesh
C# public static Mesh TextFromFont(
    Device device,
    FontLeave Site font,
    string text,
    float deviation,
    float extrusion,
    out GlyphMetricsFloat glyphMetrics
);
C++ public:
static Mesh^ TextFromFont(
    Device^ device,
    FontLeave Site^ font,
    StringLeave Site^ text,
    float deviation,
    float extrusion,
    [Out] GlyphMetricsFloat% glyphMetrics
);
JScript public static function TextFromFont(
    device : Device,
    font : FontLeave Site,
    text : String,
    deviation : float,
    extrusion : float,
    glyphMetrics : GlyphMetricsFloat
) : Mesh;

Parameters

device Microsoft.DirectX.Direct3D.Device
A Device object that represents the device associated with the text mesh.
font System.Drawing.Font
A FontLeave Site object that creates the mesh.
text System.String
String that specifies the text to generate.
deviation System.Single
Maximum chordal deviation from font outlines.
extrusion System.Single
Amount to extrude text in the negative z-direction.
glyphMetrics Microsoft.DirectX.Direct3D.GlyphMetricsFloat[]
Array of GlyphMetricsFloat structures that contain the glyph metric data. See Remarks. If glyph sizes are not a concern, this parameter can be omitted.

Return Value

Microsoft.DirectX.Direct3D.Mesh
A Mesh object that represents the cylinder mesh.

Remarks

Each element contains information about the position and orientation of the corresponding glyph in the string. The number of elements in the array should be equal to the number of characters in the string. Note that the origin in each structure is not relative to the entire string, but rather is relative to that character cell. To compute the entire bounding box, add the increment for each glyph while traversing the string.

Exceptions

InvalidCallException

The method call is invalid. For example, a method's parameter might contain an invalid value.

InvalidDataException

The data is invalid.

OutOfMemoryExceptionLeave Site

Microsoft Direct3D could not allocate sufficient memory to complete the call.

See Also