Функция D3DXCreateTorus
Использует левую систему координат для создания сетки, содержащей тор.
Синтаксис
HRESULT D3DXCreateTorus(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ FLOAT InnerRadius,
_In_ FLOAT OuterRadius,
_In_ UINT Sides,
_In_ UINT Rings,
_Out_ LPD3DXMESH *ppMesh,
_Out_ LPD3DXBUFFER *ppAdjacency
);
Параметры
-
pDevice [in]
-
Тип: LPDIRECT3DDEVICE9
Указатель на интерфейс IDirect3DDevice9 , представляющий устройство, связанное с созданной сеткой торусов.
-
InnerRadius [in]
-
Тип: FLOAT
Внутренний радиус тора. Значение должно быть больше или равно 0,0f.
-
OuterRadius [in]
-
Тип: FLOAT
Внешний радиус тора. Значение должно быть больше или равно 0,0f.
-
Side [in]
-
Тип: UINT
Количество сторон в поперечном сечении. Значение должно быть больше или равно 3.
-
Кольца [в]
-
Тип: UINT
Количество колец, составляющих тор. Значение должно быть больше или равно 3.
-
ppMesh [out]
-
Тип: LPD3DXMESH*
Адрес указателя на выходную фигуру, интерфейс ID3DXMesh .
-
ppAdjacency [out]
-
Тип: LPD3DXBUFFER*
Адрес указателя на интерфейс ID3DXBuffer . При возврате метода этот параметр заполняется массивом из трех DWORD на каждое лицо, которое задает три соседя для каждого лица в сетке. Можно указать значение NULL.
Возвращаемое значение
Тип: HRESULT
Если функция выполняется успешно, возвращаемое значение будет D3D_OK. Если функция завершается сбоем, возвращаемое значение может быть одним из следующих: D3DERR_INVALIDCALL, D3DXERR_INVALIDDATA E_OUTOFMEMORY.
Комментарии
Созданный тор выравнивается по центру в начале, а его ось выравнивается по оси Z. Внутренний радиус тора — это радиус поперечного сечения (незначительный радиус), а внешний радиус тора — радиус центральной дыры.
Эта функция возвращает сетку, которую можно использовать позже для рисования или обработки приложением.
Эта функция создает сетку с параметром создания D3DXMESH_MANAGED и D3DFVF_XYZ | D3DFVF_NORMAL гибкий формат вершин (FVF).
Требования
| Требование | Значение |
|---|---|
| Заголовок |
|
| Библиотека |
|
См. также раздел