Click or drag to resize
DigitalRuneDirectXTex 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:

Usage

texassemble [-cube | - volume | -array | -cubearray] [-w <width>] [-h <height>] [-f <format>] [-if <filter>] [-sepalpha] [-o <outputfile>] [-dx10]  [-nologo] <files>
Arguments

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.

Examples

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
See Also

Other Resources