Skip to content

VertexTypes

Chuck Walbourn edited this page Nov 7, 2018 · 9 revisions

The VertexTypes.h header defines these commonly used vertex data structures:

  • VertexPosition
  • VertexPositionColor
  • VertexPositionTexture
  • VertexPositionDualTexture
  • VertexPositionNormal
  • VertexPositionColorTexture
  • VertexPositionNormalColor
  • VertexPositionNormalTexture
  • VertexPositionNormalColorTexture
  • VertexPositionNormalTangentColorTexture
  • VertexPositionNormalTangentColorTextureSkinning

Header

#include <VertexTypes.h>

Input Layout

Each type also provides a D3D11_INPUT_ELEMENT_DESC array which can be used to create a matching input layout, for example:

Microsoft::WRL::ComPtr<ID3D11InputLayout> inputLayout;

device->CreateInputLayout(
    VertexPositionColorTexture::InputElements,
    VertexPositionColorTexture::InputElementCount,
    vertexShaderCode, vertexShaderCodeSize,
    inputLayout.GetAddressOf());

Usage

Position (which uses the semantic "SV_Position") is required for all rendering. This is XMFLOAT3 (DXGI_FORMAT_R32G32B32_FLOAT).

Normal is required for any effect that supports lighting computations. This is XMFLOAT3 (DXGI_FORMAT_R32G32B32_FLOAT).

Color is for per-vertex coloring used by some effects. Color is typically XMFLOAT4(DXGI_FORMAT_R32G32B32A32_FLOAT).

Texture coordinates (which uses the semantic "TEXCOORD0") are XMFLOAT2 (DXGI_FORMAT_R32G32_FLOAT).

DualTexture coordinates (which uses the semantic "TEXCOORD0" and "TEXCOORD1") are XMFLOAT2 (DXGI_FORMAT_R32G32_FLOAT).

Geometry formats

See DirectXMesh for more information.

Visual Studio content pipeline

VertexPositionNormalTangentColorTexture contains the vertex elements needed for using Visual Studio Shader Designer (DGSL) shaders via DGSLEffect (which requires position, normal, tangent, color, and texture coordinates) and is used when loading .CMO file models. It defines Color as a uint32_t (DXGI_FORMAT_R8G8B8A8_UNORM)

VertexPositionNormalTangentColorTextureSkinning extends VertexPositionNormalTangentColorTexture with blend weights and indices for skinning using Visual Studio Shader Designer (DGSL) shaders via DGSLEffect and is used when loading .CMO file skinned models. It defines the blend indices as uint32_t (DXGI_FORMAT_R8G8B8A8_UINT) and the blend weights as uint32_t (DXGI_FORMAT_R8G8B8A8_UNORM).

DirectX SDK SDKMESH

The .SDKMESH format describes input layouts as Direct3D 9 style vertex decls. There is therefore no specific vertex structure for .SDKMESH data and such input layouts are built on-the-fly. The Model loader attempts to create input layouts that match the needs of the standard Effects, so it can end up ignoring some of the vertex layout content if the critical content is found first.

For Use

  • Universal Windows Platform apps
  • Windows desktop apps
  • Windows 11
  • Windows 10
  • Windows 8.1
  • Xbox One

Architecture

  • x86
  • x64
  • ARM64

For Development

  • Visual Studio 2022
  • Visual Studio 2019 (16.11)
  • clang/LLVM v12 - v18
  • MinGW 12.2, 13.2
  • CMake 3.20

Related Projects

DirectX Tool Kit for DirectX 12

DirectXMesh

DirectXTex

DirectXMath

Win2D

Tools

Test Suite

Model Viewer

Content Exporter

DxCapsViewer

Clone this wiki locally