: (Optional) Resize, flip, or generate mipmaps using GenerateMipMaps .
For simplicity, let's assume you've loaded the image data into a buffer imageData , and you know its width width , height height , and the format of the data.
| Format | DirectXTex (WIC) | DDS Loader | Notes | |--------|----------------|------------|-------| | PNG | ✅ | ❌ | Best for general use | | JPEG | ✅ | ❌ | Lossy, no alpha | | BMP | ✅ | ❌ | Uncompressed | | TGA | ✅ | ❌ | Requires WIC codec | | DDS | ❌ | ✅ | Supports mipmaps, cubemaps | | HDR | ✅ | ❌ | High dynamic range | nd3d11 texture create from file
In Direct3D 11, textures are typically loaded from image files (e.g., PNG, JPEG, DDS, BMP, TGA). The most common and robust method is to use the library ( CreateWICTextureFromFile ) or the legacy D3DX11 (deprecated). This guide focuses on the modern, recommended approach using DirectXTex and the Windows Imaging Component (WIC).
| Error Code | Meaning | Solution | |------------|---------|----------| | HRESULT_FROM_WIN32(ERROR_FILE_NOT_FOUND) | File missing | Check file path | | WINCODEC_ERR_UNKNOWNIMAGEFORMAT | Unsupported format | Convert to PNG/JPG/DDS | | E_OUTOFMEMORY | Texture too large | Reduce resolution or use tiling | | DXGI_ERROR_UNSUPPORTED | Format not supported | Use CreateTexture with conversion flags | : (Optional) Resize, flip, or generate mipmaps using
This guide provides a basic overview. Depending on your project's requirements, you might need to adjust texture properties, handle different image formats, or consider asynchronous loading.
First, you need to load the image file from disk. Direct3D 11 itself doesn't provide a built-in method for loading textures from common image file formats like PNG, JPEG, DDS, etc. You can either: The most common and robust method is to
// Cleanup delete[] imageData; pConverter->Release(); pFrame->Release(); pDecoder->Release();
HRESULT hr = DirectX::LoadFromDDSFile( L"texture.dds", DirectX::DDS_FLAGS_NONE, &metadata, scratchImage );
For tools, editors, or complex runtime processing (like mipmap generation or format conversion), the DirectXTex library is preferred. It provides deeper access to the underlying image data before it is sent to the GPU.
// Create a Texture2D var texture = new Texture2D(device, width, height, 1, 1, Format.R8G8B8A8_UNORM, ResourceOption.None);