Partager via


Mesh.Torus Method

[This documentation is for preview only, and is subject to change in later releases. Blank topics are included as placeholders.]

Uses a left-handed coordinate system to create a mesh that contains a torus.

Namespace:  Microsoft.WindowsMobile.DirectX.Direct3D
Assembly:  Microsoft.WindowsMobile.DirectX (in Microsoft.WindowsMobile.DirectX.dll)

Syntax

'Declaration
Public Shared Function Torus ( _
    device As Device, _
    innerRadius As Single, _
    outerRadius As Single, _
    sides As Integer, _
    rings As Integer _
) As Mesh
'Usage
Dim device As Device
Dim innerRadius As Single
Dim outerRadius As Single
Dim sides As Integer
Dim rings As Integer
Dim returnValue As Mesh

returnValue = Mesh.Torus(device, _
    innerRadius, outerRadius, sides, _
    rings)
public static Mesh Torus(
    Device device,
    float innerRadius,
    float outerRadius,
    int sides,
    int rings
)
public:
static Mesh^ Torus(
    Device^ device, 
    float innerRadius, 
    float outerRadius, 
    int sides, 
    int rings
)
static member Torus : 
        device:Device * 
        innerRadius:float32 * 
        outerRadius:float32 * 
        sides:int * 
        rings:int -> Mesh 

Parameters

  • innerRadius
    Type: System.Single
    Inner radius of the torus; should be greater than or equal to 0.0f.
  • outerRadius
    Type: System.Single
    Outer radius of the torus; should be greater than or equal to 0.0f.
  • sides
    Type: System.Int32
    Number of sides in a cross section; must be greater than or equal to 3.
  • rings
    Type: System.Int32
    Number of rings in the torus; must be greater than or equal to 3.

Return Value

Type: Microsoft.WindowsMobile.DirectX.Direct3D.Mesh
A Mesh object that represents the torus mesh.

Exceptions

Exception Condition
InvalidCallException

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

OutOfMemoryException

Direct3D could not allocate sufficient memory to complete the call.

Remarks

The Torus method draws a doughnut shape, centered at (0, 0, 0), whose axis is aligned with the z-axis. The inner radius of the torus is the radius of the cross section (the minor radius), and the outer radius of the torus is the radius of the central hole.

The mesh that this method returns can later be used by the application for drawing or manipulation.

.NET Framework Security

Platforms

Windows CE, Windows Mobile for Smartphone, Windows Mobile for Pocket PC

The .NET Framework and .NET Compact Framework do not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.

Version Information

.NET Compact Framework

Supported in: 3.5, 2.0

See Also

Reference

Mesh Class

Mesh Members

Microsoft.WindowsMobile.DirectX.Direct3D Namespace