|
| 1 | +Microsoft (R) DirectX Texture Converter [DirectXTex] Version 205 (library) |
| 2 | +Copyright (C) Microsoft Corp. |
| 3 | +*** Debug build *** |
| 4 | + |
| 5 | +Usage: texconv <options> [--] <files> |
| 6 | + |
| 7 | + -r wildcard filename search is recursive |
| 8 | + -r:flatten flatten the directory structure (default) |
| 9 | + -r:keep keep the directory structure |
| 10 | + -flist <filename>, --file-list <filename> |
| 11 | + use text file with a list of input files (one per line) |
| 12 | + |
| 13 | + -w <n>, --width <n> width for output |
| 14 | + -h <n>, --height <n> height for output |
| 15 | + -m <n>, --mip-levels <n> miplevels for output |
| 16 | + -f <format>, --format <format> pixel format for output |
| 17 | + |
| 18 | + -if <filter>, --image-filter <filter> image filtering |
| 19 | + -srgb{i|o}, --srgb-in, --srgb-out sRGB {input, output} |
| 20 | + |
| 21 | + -px <string>, --prefix <string> name prefix |
| 22 | + -sx <string>, --suffix <string> name suffix |
| 23 | + -o <directory> output directory |
| 24 | + -l, --to-lowercase force output filename to lower case |
| 25 | + -y, --overwrite overwrite existing output file (if any) |
| 26 | + -ft <filetype>, --file-type <filetype> output file type |
| 27 | + |
| 28 | + -hflip, --horizontal-flip horizonal flip of source image |
| 29 | + -vflip, --vertical-flip vertical flip of source image |
| 30 | + |
| 31 | + -sepalpha, --separate-alpha resize/generate mips alpha channel separately from color channels |
| 32 | + --keep-coverage <ref> Preserve alpha coverage in mips for alpha test ref |
| 33 | + |
| 34 | + -nowic Force non-WIC filtering |
| 35 | + -wrap, -mirror texture addressing mode (wrap, mirror, or clamp) |
| 36 | + -pmalpha, --premultiplied-alpha convert final texture to use premultiplied alpha |
| 37 | + -alpha convert premultiplied alpha to straight alpha |
| 38 | + -at <threshold>, --alpha-threshold <threshold> |
| 39 | + Alpha threshold used for BC1, RGBA5551, and WIC |
| 40 | + (defaults to 0.5) |
| 41 | + |
| 42 | + -fl <feature-level>, --feature-level <feature-level> |
| 43 | + Set maximum feature level target (defaults to 11.0) |
| 44 | + -pow2, --fit-power-of-2 |
| 45 | + resize to fit a power-of-2, respecting aspect ratio |
| 46 | + |
| 47 | + -nmap <options>, --normal-map <options> |
| 48 | + converts height-map to normal-map |
| 49 | + options must be one or more of |
| 50 | + r, g, b, a, l, m, u, v, i, o |
| 51 | + -nmapamp <weight>, --normalmap-amplitude <weight> |
| 52 | + normal map amplitude (defaults to 1.0) |
| 53 | + |
| 54 | + (DDS input only) |
| 55 | + -t{u|f} TYPELESS format is treated as UNORM or FLOAT |
| 56 | + -dword Use DWORD instead of BYTE alignment |
| 57 | + --bad-tails Fix for older DXTn with bad mipchain tails |
| 58 | + --permissive Allow some DX9 variants with unusual header values |
| 59 | + --ignore-mips Reads just the top-level mip which reads some invalid files |
| 60 | + --fix-bc-4x4 Fix for odd-sized BC files that Direct3D can't load |
| 61 | + -xlum, --expand-luminance Expand legacy L8, L16, and A8P8 formats |
| 62 | + |
| 63 | + (DDS output only) |
| 64 | + -dx10 Force use of 'DX10' extended header |
| 65 | + -dx9 Force use of legacy DX9 header |
| 66 | + |
| 67 | + (TGA input only) |
| 68 | + --tga-zero-alpha Allow all zero alpha channel files to be loaded 'as is' |
| 69 | + |
| 70 | + (TGA output only) |
| 71 | + --tga20 Write file including TGA 2.0 extension area |
| 72 | + |
| 73 | + (BMP, PNG, JPG, TIF, WDP output only) |
| 74 | + -wicq <quality>, --wic-quality <quality> |
| 75 | + When writing images with WIC use quality (0.0 to 1.0) |
| 76 | + --wic-lossless When writing images with WIC use lossless mode |
| 77 | + --wic-multiframe When writing images with WIC encode multiframe images |
| 78 | + |
| 79 | + -nologo suppress copyright message |
| 80 | + --timing display elapsed processing time |
| 81 | + |
| 82 | + --single-proc Do not use multi-threaded compression |
| 83 | + -gpu <adapter> Select GPU for DirectCompute-based codecs (0 is default) |
| 84 | + -nogpu Do not use DirectCompute-based codecs |
| 85 | + |
| 86 | + -bc <options>, --block-compress <options> |
| 87 | + Sets options for BC compression |
| 88 | + options must be one or more of |
| 89 | + d, u, q, x |
| 90 | + -aw <weight>, --alpha-weight <weight> |
| 91 | + BC7 GPU compressor weighting for alpha error metric |
| 92 | + (defaults to 1.0) |
| 93 | + |
| 94 | + -c <hex-RGB>, --color-key <hex-RGB> colorkey (a.k.a. chromakey) transparency |
| 95 | + --rotate-color <rot> rotates color primaries and/or applies a curve |
| 96 | + |
| 97 | + -nits <value>, --paper-white-nits <value> |
| 98 | + paper-white value in nits to use for HDR10 (def: 200.0) |
| 99 | + --tonemap Apply a tonemap operator based on maximum luminance |
| 100 | + -x2bias Enable *2 - 1 conversion cases for unorm/pos-only-float |
| 101 | + --invert-y Invert Y (i.e. green) channel values |
| 102 | + --reconstruct-z Rebuild Z (blue) channel assuming X/Y are normals |
| 103 | + --swizzle <rgba> Swizzle image channels using HLSL-style mask |
| 104 | + |
| 105 | + '-- ' is needed if any input filepath starts with the '-' or '/' character |
| 106 | + |
| 107 | + <format>: R32G32B32A32_FLOAT R32G32B32A32_UINT R32G32B32A32_SINT |
| 108 | + R32G32B32_FLOAT R32G32B32_UINT R32G32B32_SINT R16G16B16A16_FLOAT |
| 109 | + R16G16B16A16_UNORM R16G16B16A16_UINT R16G16B16A16_SNORM |
| 110 | + R16G16B16A16_SINT R32G32_FLOAT R32G32_UINT R32G32_SINT |
| 111 | + R10G10B10A2_UNORM R10G10B10A2_UINT R11G11B10_FLOAT R8G8B8A8_UNORM |
| 112 | + R8G8B8A8_UNORM_SRGB R8G8B8A8_UINT R8G8B8A8_SNORM R8G8B8A8_SINT |
| 113 | + R16G16_FLOAT R16G16_UNORM R16G16_UINT R16G16_SNORM R16G16_SINT |
| 114 | + R32_FLOAT R32_UINT R32_SINT R8G8_UNORM R8G8_UINT R8G8_SNORM |
| 115 | + R8G8_SINT R16_FLOAT R16_UNORM R16_UINT R16_SNORM R16_SINT |
| 116 | + R8_UNORM R8_UINT R8_SNORM R8_SINT A8_UNORM R9G9B9E5_SHAREDEXP |
| 117 | + R8G8_B8G8_UNORM G8R8_G8B8_UNORM BC1_UNORM BC1_UNORM_SRGB BC2_UNORM |
| 118 | + BC2_UNORM_SRGB BC3_UNORM BC3_UNORM_SRGB BC4_UNORM BC4_SNORM |
| 119 | + BC5_UNORM BC5_SNORM B5G6R5_UNORM B5G5R5A1_UNORM B8G8R8A8_UNORM |
| 120 | + B8G8R8X8_UNORM R10G10B10_XR_BIAS_A2_UNORM B8G8R8A8_UNORM_SRGB |
| 121 | + B8G8R8X8_UNORM_SRGB BC6H_UF16 BC6H_SF16 BC7_UNORM BC7_UNORM_SRGB |
| 122 | + AYUV Y410 Y416 YUY2 Y210 Y216 B4G4R4A4_UNORM A4B4G4R4_UNORM |
| 123 | + DXT1 DXT2 DXT3 DXT4 DXT5 RGBA BGRA BGR FP16 FP32 BPTC |
| 124 | + BPTC_FLOAT |
| 125 | + BC3n DXT5nm RXGB |
| 126 | + |
| 127 | + <filter>: POINT LINEAR CUBIC FANT BOX TRIANGLE POINT_DITHER |
| 128 | + LINEAR_DITHER CUBIC_DITHER FANT_DITHER BOX_DITHER TRIANGLE_DITHER |
| 129 | + POINT_DITHER_DIFFUSION LINEAR_DITHER_DIFFUSION CUBIC_DITHER_DIFFUSION |
| 130 | + FANT_DITHER_DIFFUSION BOX_DITHER_DIFFUSION TRIANGLE_DITHER_DIFFUSION |
| 131 | + |
| 132 | + <rot>: 709to2020 2020to709 709toHDR10 HDR10to709 P3D65to2020 |
| 133 | + P3D65toHDR10 709toP3D65 P3D65to709 |
| 134 | + |
| 135 | + <filetype>: bmp jpg jpeg png dds ddx tga hdr tif tiff wdp hdp |
| 136 | + jxr ppm pfm heic heif |
| 137 | + |
| 138 | + <feature-level>: 9.1 9.2 9.3 10.0 10.1 11.0 11.1 12.0 12.1 12.2 |
| 139 | + |
| 140 | + <adapter>: |
| 141 | + 0: VID:10DE, PID:2488 - NVIDIA GeForce RTX 3070 |
| 142 | + 1: VID:1414, PID:008C - Microsoft Basic Render Driver |
0 commit comments