DirectXTexXbox

DirectXTex

For Xbox One XDK / Microsoft GDKX development, there are a number of Xbox extension functions for rearranging textures for the target hardware offline. This functionality is available with the official samples and hosted in the xbox branch on GitHub.

The xtexconv sample is a variant of the texconv command-line tool that uses these extensions.

These extensions are only usable by Xbox registered developers via the Xbox One XDK / Microsoft GDKX.

Header

#include "DirectXTexXbox.h"

Namespace

All the functions in the library are in the Xbox C++ namespace.

Functions

• GetMetadataFromDDSMemory, LoadFromDDSMemory, LoadFromDDSFile, SaveToDDSMemory, SaveToDDSFile - Variants of the DDS I/O Functions that write the tiled/detiled versions of data in a custom DDS variant.

• Tile - Converts 'standard' to 'tiled' textures

• Detile - Converts 'tiled' to 'standard' textures

• CreateTexture, CreateShaderResourceView - Variants that use placement creation of textures with tiled/detiled data.

• FreeTextureMemory - Releases memory allocated by these variants.

Structures

XboxImage is a variant of Image with additional metadata.

Adding to a VS solution

Using project-to-project references

In your application's solution, right-click on the Solution and use "Add \ Existing Project..." to add the appropriate .vcxproj file to your solution.

DirectXTex_GDK_2022	For the Gaming.Xbox.*.x64 platforms, this project includes the extension functions.
DirectXTex_GXDK_PC_2022	This project is a variant of DirectXTex_Desktop_2019 that includes the extensions for PC-hosted content tools for Microsoft GDKX development.

DirectXTex_GDK_2019	For the Gaming.Xbox.*.x64 platforms, this project includes the extension functions.
DirectXTex_GXDK_PC_2019	This project is a variant of DirectXTex_Desktop_2019 that includes the extensions for PC-hosted content tools for Microsoft GDKX development.

DirectXTex_XboxOneXDK_2017	For the Durango platform, this project includes the extension fucntions.
DirectXTex_XboxOneXDK_PC_2017	This project is a variant of DirectXTex_Desktop_2017 that includes the extensions for PC-hosted content tools for Xbox One XDK development.

Dependencies

These functions make use of the XG Library.