Функция D3DXCreateTorus

Статья
06/13/2023

Использует левую систему координат для создания сетки, содержащей тор.

Синтаксис

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).

Требования

Требование	Значение
Заголовок	D3dx9shape.h
Библиотека	D3dx9.lib

См. также раздел

Функции рисования фигур

Поделиться через