-
Notifications
You must be signed in to change notification settings - Fork 409
3D shapes
This lesson draws simple shapes in 3D.
First create a new project using the instructions from the first two lessons: The basic game loop and Adding the DirectX Tool Kit which we will use for this lesson.
In the previous lesson, we generated geometry with code using PrimitiveBatch to draw simple shapes. Here we make use of GeometricPrimitive which procedurally generates shapes like spheres, cubes, etc. These 3D shapes are more efficient to render because they make use of indexed primitives, and because they make use of a static rather than dynamic vertex buffer and index buffer.
In the Game.h file, add the following variables to the bottom of the Game class's private declarations (right after where you added m_graphicsMemory
as part of the setup):
DirectX::SimpleMath::Matrix m_world;
DirectX::SimpleMath::Matrix m_view;
DirectX::SimpleMath::Matrix m_proj;
std::unique_ptr<DirectX::GeometricPrimitive> m_shape;
std::unique_ptr<DirectX::BasicEffect> m_effect;
In Game.cpp, add to the TODO of CreateDevice after where you have created m_graphicsMemory
:
RenderTargetState rtState(DXGI_FORMAT_B8G8R8A8_UNORM, DXGI_FORMAT_D32_FLOAT);
EffectPipelineStateDescription pd(
&GeometricPrimitive::VertexType::InputLayout,
CommonStates::Opaque,
CommonStates::DepthDefault,
CommonStates::CullNone,
rtState);
m_effect = std::make_unique<BasicEffect>(m_d3dDevice.Get(), EffectFlags::Lighting, pd);
m_effect->EnableDefaultLighting();
m_shape = GeometricPrimitive::CreateSphere();
m_world = Matrix::Identity;
In Game.cpp, add to the TODO of CreateResources:
m_view = Matrix::CreateLookAt(Vector3(2.f, 2.f, 2.f),
Vector3::Zero, Vector3::UnitY);
m_proj = Matrix::CreatePerspectiveFieldOfView(XM_PI / 4.f,
float(backBufferWidth) / float(backBufferHeight), 0.1f, 10.f);
In Game.cpp, add to the TODO of OnDeviceLost:
m_shape.reset();
m_effect.reset();
In Game.cpp, add to the TODO of Render:
m_effect->SetMatrices(m_world, m_view, m_proj);
m_effect->Apply(m_commandList.Get());
m_shape->Draw(m_commandList.Get());
In Game.cpp, add to the TODO of Update:
float time = float(timer.GetTotalSeconds());
m_world = Matrix::CreateRotationZ(cosf(time) * 2.f);
Build and run, and you'll see a white lit sphere.
Unlike DirectX Tool Kit for DirectX 11, you must create your own effect to render with
GeometricPrimitive
.
In Game.cpp modify the TODO of CreateDevice:
m_shape = GeometricPrimitive::CreateTorus();
Build and run to see a torus instead of a sphere.
You can try out other shapes like a cube, cone, cylinder, dodecahedron, or the classic teapot.
m_shape = GeometricPrimitive::CreateCube();
m_shape = GeometricPrimitive::CreateCone();
m_shape = GeometricPrimitive::CreateCylinder();
m_shape = GeometricPrimitive::CreateDodecahedron();
m_shape = GeometricPrimitive::CreateTeapot();
Start by saving earth.bmp into your new project's directory, and then from the top menu select Project / Add Existing Item.... Select "earth.bmp" and click "OK".
In the Game.h file, add the following variable to the bottom of the Game class's private declarations:
std::unique_ptr<DirectX::DescriptorHeap> m_resourceDescriptors;
Microsoft::WRL::ComPtr<ID3D12Resource> m_texture;
std::unique_ptr<DirectX::CommonStates> m_states;
enum Descriptors
{
Earth,
Count
};
In Game.cpp, add to the TODO of CreateDevice (be sure to add it before you create the m_effect
instance, but after you created m_graphicsMemory
).
m_resourceDescriptors = std::make_unique<DescriptorHeap>(m_d3dDevice.Get(),
D3D12_DESCRIPTOR_HEAP_TYPE_CBV_SRV_UAV,
D3D12_DESCRIPTOR_HEAP_FLAG_SHADER_VISIBLE,
Descriptors::Count);
m_states = std::make_unique<CommonStates>(m_d3dDevice.Get());
ResourceUploadBatch resourceUpload(m_d3dDevice.Get());
resourceUpload.Begin();
DX::ThrowIfFailed(
CreateWICTextureFromFile(m_d3dDevice.Get(), resourceUpload, L"earth.bmp",
m_texture.ReleaseAndGetAddressOf(), false));
CreateShaderResourceView(m_d3dDevice.Get(), m_texture.Get(),
m_resourceDescriptors->GetCpuHandle(Descriptors::Earth));
auto uploadResourcesFinished = resourceUpload.End(m_commandQueue.Get());
uploadResourcesFinished.wait();
In Game.cpp, add to the TODO of OnDeviceLost:
m_texture.Reset();
m_states.reset();
m_resourceDescriptors.reset();
In Game.cpp modify the TODO of CreateDevice:
m_effect = std::make_unique<BasicEffect>(m_d3dDevice.Get(),
EffectFlags::Lighting | EffectFlags::Texture, pd);
m_effect->EnableDefaultLighting();
m_effect->SetTexture(m_resourceDescriptors->GetGpuHandle(Descriptors::Earth),
m_states->AnisotropicWrap());
m_shape = GeometricPrimitive::CreateSphere();
In Game.cpp, modify to the TODO of Render:
ID3D12DescriptorHeap* heaps[] = { m_resourceDescriptors->Heap(), m_states->Heap() };
m_commandList->SetDescriptorHeaps(_countof(heaps), heaps);
m_effect->SetMatrices(m_world, m_view, m_proj);
m_effect->Apply(m_commandList.Get());
m_shape->Draw(m_commandList.Get());
In Game.cpp, modify to the TODO of Update:
float time = float(timer.GetTotalSeconds());
m_world = Matrix::CreateRotationY(time);
Build and you'll see planet earth spinning.
Remember that setting the descriptor heap is left to the caller using
SetDescriptorHeaps
as part of your render function. This allows the application to use their own heaps instead of theDescriptorHeap
class for where the textures are in memory. You can freely mix and match heaps in the application, but remember that you can have only a single texture descriptor heap and a single sampler descriptor heap active at any given time.
In Game.cpp modify the TODO of CreateDevice:
m_effect = std::make_unique<BasicEffect>(m_d3dDevice.Get(),
EffectFlags::PerPixelLighting | EffectFlags::Texture, pd);
m_effect->SetLightEnabled(0, true);
m_effect->SetLightDiffuseColor(0, Colors::White);
m_effect->SetLightDirection(0, -Vector3::UnitZ);
m_effect->SetTexture(m_resourceDescriptors->GetGpuHandle(Descriptors::Earth),
m_states->AnisotropicWrap());
Build and run to see earth with more 'space-like' lighting.
- The
GeometricPrimitive
class is designed for simple rendering, so it always uses theVertexPositionNormalTexture
vertex format. For details on how to utilize the built-in shape generation for other vertex formats, see Custom vertex format.
Next lesson: Rendering a model
DirectX Tool Kit docs Effects, EffectPipelineStateDescription, GeometricPrimitive, RenderTargetState
All content and source code for this package are subject to the terms of the MIT License.
This project has adopted the Microsoft Open Source Code of Conduct. For more information see the Code of Conduct FAQ or contact [email protected] with any additional questions or comments.
- Universal Windows Platform apps
- Windows desktop apps
- Windows 11
- Windows 10
- Xbox One
- Xbox Series X|S
- x86
- x64
- ARM64
- Visual Studio 2022
- Visual Studio 2019 (16.11)
- clang/LLVM v12 - v18
- MinGW 12.2, 13.2
- CMake 3.20