Функция D3DXConcatenateMeshes

Статья
06/13/2023

Объединяет группу сеток в одну общую сетку. При необходимости этот метод может применять матричное преобразование к каждой входной сетке и ее координатам текстуры.

Синтаксис

HRESULT D3DXConcatenateMeshes(
  _In_        LPD3DXMESH        *ppMeshes,
  _In_        UINT              NumMeshes,
  _In_        DWORD             Options,
  _In_  const D3DXMATRIX        *pGeomXForms,
  _In_  const D3DXMATRIX        *pTextureXForms,
  _In_  const D3DVERTEXELEMENT9 *pDecl,
  _In_        LPDIRECT3DDEVICE9 pD3DDevice,
  _Out_       LPD3DXMESH        *ppMeshOut
);

Параметры

ppMeshes [in]

Тип: LPD3DXMESH*

Массив указателей входной сетки (см. ID3DXMesh). Число элементов в массиве — NumMeshes.

NumMeshes [in]

Тип: UINT

Количество сцепляемых входных сеток.

Параметры [in]

Тип: DWORD

Параметры создания сетки; это сочетание одного или нескольких флагов D3DXMESH . Параметры создания сетки эквивалентны параметру параметров, требуемому для D3DXCreateMesh.

pGeomXForms [in]

Тип: const D3DXMATRIX*

Необязательный массив преобразований геометрии. Число элементов в массиве — NumMeshes; каждый элемент является матрицей преобразования (см. раздел D3DXMATRIX). Может иметь значение NULL.

pTextureXForms [in]

Тип: const D3DXMATRIX*

Необязательный массив преобразований текстур. Число элементов в массиве — NumMeshes; каждый элемент является матрицей преобразования (см. раздел D3DXMATRIX). Этот параметр может иметь значение NULL.

pDecl [in]

Тип: const D3DVERTEXELEMENT9*

Необязательный указатель на объявление вершины (см. раздел D3DVERTEXELEMENT9). Этот параметр может иметь значение NULL.

pD3DDevice [in]

Тип: LPDIRECT3DDEVICE9

Указатель на устройство IDirect3DDevice9 , которое используется для создания новой сетки.

ppMeshOut [out]

Тип: LPD3DXMESH*

Адрес указателя на созданную сетку (см. ID3DXMesh).

Возвращаемое значение

Тип: HRESULT

Если функция выполнена успешно, возвращаемое значение будет S_OK. В случае сбоя функции возвращается одно из следующих значений: D3DERR_INVALIDCALL E_OUTOFMEMORY.

Если в параметре создания сетки Options не задано ни одно объявление вершины , метод создает объединение всех объявлений вершин вложенных вмешей, повышая при необходимости каналы и типы. Метод создаст таблицу атрибутов из таблиц атрибутов входных сеток. Чтобы обеспечить создание таблицы атрибутов, вызовите optimize с флагами, для D3DXMESHOPT_COMPACT и D3DXMESHOPT_ATTRSORT (см. раздел D3DXMESHOPT).

Требования

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

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

Функции сетки

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