DirectXTex Texassemble |
Microsoft(R) DirectX 11 Texture Assembler (DirectXTex version). Copyright (C) Microsoft Corp. All rights reserved.
The DirectXTex command-line tool texassemble can be used to create DDS files containing cube maps, volume maps, or texture arrays from individual images.
texassemble does not support mipmap generation or texture compression. The resulting DDS file needs to be processed using Texconv.
This topic contains the following sections:
texassemble [-cube | - volume | -array | -cubearray] [-w <width>] [-h <height>] [-f <format>] [-if <filter>] [-sepalpha] [-o <outputfile>] [-dx10] [-nologo] <files>
The following arguments can be specified on the command-line:
Argument | Description |
---|---|
files | The image files that should be assembled into the DDS file. |
-cube | Create a cube map. Requires 6 image files (+X, -X, +Y, -Y, +Z, -Z). |
-volume | Create a volume texture. Requires 2 or more images. The number of images defines the depth of the volume. |
-array | Create a 1D or 2D texture array. Requires 2 or more images. |
-cubearray | Create a cube map array. Requires multiple of 6 images. |
-w width | The width of the output texture in pixels. |
-h height | The height of the output texture in pixels. If no size is given, the size is taken from the first input image. |
-f format | The texture format of the output texture. If no format is given, the format of the first image file is used. Allowed values are all DXGI formats (without the "DXGI_FORMAT_" prefix). Example: -f R10G10B10A2_UNORM |
-if filter | The image filter used for resizing. Allowed values: POINT, LINEAR, CUBIC, FANT, BOX, TRIANGLE, POINT_DITHER, LINEAR_DITHER, CUBIC_DITHER, FANT_DITHER, BOX_DITHER, TRIANGLE_DITHER, POINT_DITHER_DIFFUSION, LINEAR_DITHER_DIFFUSION, CUBIC_DITHER_DIFFUSION, FANT_DITHER_DIFFUSION, BOX_DITHER_DIFFUSION, TRIANGLE_DITHER_DIFFUSION Filters with DITHER in their name indicate that the 4x4 ordered dither algorithm, while "DITHER_DIFFUSION" is error diffusion dithering. |
-sepalpha | Resize alpha channel separately from color channels. This implies an alpha mode setting of DDS_ALPHA_MODE_CUSTOM as this is typically only used if the alpha channel doesn't contain transparency information. |
-o outputfile | The output file. The default name is a .DDS file based on the first input image file. |
-dx10 | Force DDS file output to always use the "DX10" header extension. The resulting file may not be compatible with the legacy D3DX10 or D3DX11 libraries. |
-nologo | Suppress copyright message. |
Assemble 3 images into a 256x256x3 volume texture:
texassemble -volume -w 256 -h 256 -f R8G8B8A8_UNORM -o volume.dds lena.jpg fishingboat.jpg peppers.tiff
Assemble a 256x256 cube map from 6 images:
texassemble -cube -w 256 -h 256 -f R8G8B8A8_UNORM -o cubemap.dds lobbyxposjpg lobbyxneg.jpg lobbyypos.jpg lobbyyneg.jpg lobbyzpos.jpg lobbyzneg.jpg
Assemble 2 images into a texture array ('lena.jpg' defines the DXGI format and size of the resulting texture):
texassemble -array -o array.dds lena.jpg peppers.tiff