A command line tool that converts textures between the following formats: BMP, DDS, JPEG, HDR, PFM or PNG.
Compatibility Chart
Direct3D 9 Direct3D 10 64-bit Native Mode Windows XP Windows Vista Yes
No
Yes
Yes
Yes
Path
The executable file, Texconv.exe, is in the following platform-dependent locations:
Item Description 32-bit
DirectX SDK root\Utilities\Bin\x86
64-bit
DirectX SDK root\Utilities\Bin\x64
Syntax
Texconv.exe uses the following command syntax:
texconv [-w number] [-h number] [-d number] [-m number] [-f format] [-if filter] [-mf filter] [-c color] [-srgbi] [-srgbo] [-px string] [-sx string] [-o directory] [-ft file-type] [-nologo] file-name
The file-name parameter indicates the file to convert.
The optional command-line switches are described in the following table.
Optional Switches Description -c color Colorkey value. Wherever this color appears in the source texture it is replaced with a transparent black value (0x000000) in the output texture. If an alpha channel is present in the output texture, this makes the specified color transparent. If no alpha channel is present it is changed to black. When specifying this color, always include an alpha value (use FF if the color is opaque). For example, -c FFFE02A5 sets the colorkey value to a solid magenta. -d number Depth of the output texture. This setting applies only to volume textures. -f format Output format. Use any of the formats in D3DFORMAT without the D3DFMT_ prefix (except: D3DFMT_MULTI2_ARGB8). -ft file-type A file type for the output texture. Use one of the following: bmp, dds, jpg, hdr, pfm, png, or tga. The default value is dds. -h number Height of the output texture in pixels. -w number Width of the output texture in pixels. -if filter Image filter. Use one of the following: NONE, POINT, LINEAR, TRIANGLE, BOX, NONE_DITHER,POINT_DITHER, LINEAR_DITHER, TRIANGLE_DITHER, or BOX_DITHER. Filters with DITHER in their name indicate that a 4×4 ordered dither algorithm is also applied. See D3DX_FILTER for descriptions of the filters. -m number Number of mipmap levels to generate in the output texture. This setting only applies to DDS output. For more information, see Texture Filtering with Mipmaps (Direct3D 9). -mf filter Mipmap filter value described in D3DX_FILTER. -o directory Output directory. -px string Text string to attach to the front of the resulting texture's name. -srgbi or
-srgbo
Use -sRGBi to indicate that the input data is in the sRGB (gamma 2.2) color format. Use -sRGBoto indicate that the output data should be in sRGB color format. -sx string Text string to attach to the end of the resulting texture's name. -nologo Suppress copyright message.
Send comments about this topic to Microsoft
Build date: 3/11/2010