Microsoft DirectX 9.0 SDK Update (October 2004)

Mesh.TextFromFont Method

Language:

Note: This documentation is preliminary and is subject to change.

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

Definition

Visual Basic .NET Public Shared Function TextFromFont( _
    ByVal device As Device, _
    ByVal font As Font, _
    ByVal text As String, _
    ByVal deviation As Single, _
    ByVal extrusion As Single, _
    ByRef adjacency As GraphicsStream, _
    ByRef glyphMetrics As GlyphMetricsFloat _
) As Mesh
C# public static Mesh TextFromFont(
    Device device,
    Font font,
    string text,
    float deviation,
    float extrusion,
    out GraphicsStream adjacency,
    out GlyphMetricsFloat glyphMetrics
);
Managed C++ public: static Mesh* TextFromFont(
    Device *device,
    Font *font,
    String *text,
    float deviation,
    float extrusion,
    GraphicsStream **adjacency,
    GlyphMetricsFloat *glyphMetrics
);
JScript .NET public static function TextFromFont(
    device : Device,
    font : Font,
    text : String,
    deviation : float,
    extrusion : float,
    adjacency : GraphicsStream,
    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 Font Leave 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.
adjacency Microsoft.DirectX.GraphicsStream. A GraphicsStream object containing an array of three Int32 Leave Site values per face that specify the three neighbors for each face in the mesh.
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.
OutOfMemoryException Leave Site Microsoft® Direct3D® could not allocate sufficient memory to complete the call.

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center