This DirectXTex sample is a command-line texture utility for creating DDS files containing cubemaps, volume maps, or texture arrays from individual images.
This utility does not support mipmap generation or texture compression, but the resulting .DDS file can be further processed by the Texconv utility. Any texture compressed input file is decompressed on load.
The file-name parameter indicates the file(s) to use to create the image.
The optional command-line switches are described in the following table.
This utility does not support mipmap generation or texture compression, but the resulting .DDS file can be further processed by the Texconv utility. Any texture compressed input file is decompressed on load.
Syntax
Texassemble.exe uses the following command syntax:texassemble [-cube | - volume | -array | -cubearray] [-f format] [-if filter] [-sepalpha] [-o <outputfile>] [-dx10] [-nologo] <files>
The optional command-line switches are described in the following table.
Optional Switches Description
- -cube Creates a cubemap. Must have six images to form each of the six faces.
- -volume Creates a volume map. Must have at least two images and the number of images determines the 'depth'.
- -array Creates a 1D or 2D texture array. Must have at least two images.
- -cubearray Creates a cubemap array. Must have a multiple of six images.
- -f format Output format. Specify the DXGI format without the DXGI_FORMAT_ prefix (i.e. "-f R10G10B10A2_UNORM"). If no format is given, the format of the first image file is used.
- -if filter Image filter used for resizing the images (all images are resized to the same size as the first image). Use one of the following: 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, or TRIANGLE_DITHER_DIFFUSION. Filters with DITHER in their name indicate that the 4x4 ordered dither algorithm, while "DITHER_DIFFUSION" is error diffusion dithering.
- -o Output filename. The default name is a .DDS file based on the first input image file.
- -sepalpha Separates alpha channel for resize/mipmap generation.
- -dx10 Forces DDS file output to always use the "DX10" header extension, and allows the writing of alpha mode metadata information. The resulting file may not be compatible with the legacy D3DX10 or D3DX11 libraries.
- -nologo Suppress copyright message.
