Skip to content

Commit

Permalink
Fix -- usage
Browse files Browse the repository at this point in the history
  • Loading branch information
walbourn committed Oct 24, 2024
1 parent 9dbc6ba commit 918b7f1
Show file tree
Hide file tree
Showing 2 changed files with 143 additions and 0 deletions.
1 change: 1 addition & 0 deletions Texconv/texconv.cpp
Original file line number Diff line number Diff line change
Expand Up @@ -1275,6 +1275,7 @@ int __cdecl wmain(_In_ int argc, _In_z_count_(argc) wchar_t* argv[])
{
// "-- " is the POSIX standard for "end of options" marking to escape the '-' and '/' characters at the start of filepaths.
allowOpts = false;
continue;
}
else
{
Expand Down
142 changes: 142 additions & 0 deletions t.txt
Original file line number Diff line number Diff line change
@@ -0,0 +1,142 @@
Microsoft (R) DirectX Texture Converter [DirectXTex] Version 205 (library)
Copyright (C) Microsoft Corp.
*** Debug build ***

Usage: texconv <options> [--] <files>

-r wildcard filename search is recursive
-r:flatten flatten the directory structure (default)
-r:keep keep the directory structure
-flist <filename>, --file-list <filename>
use text file with a list of input files (one per line)

-w <n>, --width <n> width for output
-h <n>, --height <n> height for output
-m <n>, --mip-levels <n> miplevels for output
-f <format>, --format <format> pixel format for output

-if <filter>, --image-filter <filter> image filtering
-srgb{i|o}, --srgb-in, --srgb-out sRGB {input, output}

-px <string>, --prefix <string> name prefix
-sx <string>, --suffix <string> name suffix
-o <directory> output directory
-l, --to-lowercase force output filename to lower case
-y, --overwrite overwrite existing output file (if any)
-ft <filetype>, --file-type <filetype> output file type

-hflip, --horizontal-flip horizonal flip of source image
-vflip, --vertical-flip vertical flip of source image

-sepalpha, --separate-alpha resize/generate mips alpha channel separately from color channels
--keep-coverage <ref> Preserve alpha coverage in mips for alpha test ref

-nowic Force non-WIC filtering
-wrap, -mirror texture addressing mode (wrap, mirror, or clamp)
-pmalpha, --premultiplied-alpha convert final texture to use premultiplied alpha
-alpha convert premultiplied alpha to straight alpha
-at <threshold>, --alpha-threshold <threshold>
Alpha threshold used for BC1, RGBA5551, and WIC
(defaults to 0.5)

-fl <feature-level>, --feature-level <feature-level>
Set maximum feature level target (defaults to 11.0)
-pow2, --fit-power-of-2
resize to fit a power-of-2, respecting aspect ratio

-nmap <options>, --normal-map <options>
converts height-map to normal-map
options must be one or more of
r, g, b, a, l, m, u, v, i, o
-nmapamp <weight>, --normalmap-amplitude <weight>
normal map amplitude (defaults to 1.0)

(DDS input only)
-t{u|f} TYPELESS format is treated as UNORM or FLOAT
-dword Use DWORD instead of BYTE alignment
--bad-tails Fix for older DXTn with bad mipchain tails
--permissive Allow some DX9 variants with unusual header values
--ignore-mips Reads just the top-level mip which reads some invalid files
--fix-bc-4x4 Fix for odd-sized BC files that Direct3D can't load
-xlum, --expand-luminance Expand legacy L8, L16, and A8P8 formats

(DDS output only)
-dx10 Force use of 'DX10' extended header
-dx9 Force use of legacy DX9 header

(TGA input only)
--tga-zero-alpha Allow all zero alpha channel files to be loaded 'as is'

(TGA output only)
--tga20 Write file including TGA 2.0 extension area

(BMP, PNG, JPG, TIF, WDP output only)
-wicq <quality>, --wic-quality <quality>
When writing images with WIC use quality (0.0 to 1.0)
--wic-lossless When writing images with WIC use lossless mode
--wic-multiframe When writing images with WIC encode multiframe images

-nologo suppress copyright message
--timing display elapsed processing time

--single-proc Do not use multi-threaded compression
-gpu <adapter> Select GPU for DirectCompute-based codecs (0 is default)
-nogpu Do not use DirectCompute-based codecs

-bc <options>, --block-compress <options>
Sets options for BC compression
options must be one or more of
d, u, q, x
-aw <weight>, --alpha-weight <weight>
BC7 GPU compressor weighting for alpha error metric
(defaults to 1.0)

-c <hex-RGB>, --color-key <hex-RGB> colorkey (a.k.a. chromakey) transparency
--rotate-color <rot> rotates color primaries and/or applies a curve

-nits <value>, --paper-white-nits <value>
paper-white value in nits to use for HDR10 (def: 200.0)
--tonemap Apply a tonemap operator based on maximum luminance
-x2bias Enable *2 - 1 conversion cases for unorm/pos-only-float
--invert-y Invert Y (i.e. green) channel values
--reconstruct-z Rebuild Z (blue) channel assuming X/Y are normals
--swizzle <rgba> Swizzle image channels using HLSL-style mask

'-- ' is needed if any input filepath starts with the '-' or '/' character

<format>: R32G32B32A32_FLOAT R32G32B32A32_UINT R32G32B32A32_SINT
R32G32B32_FLOAT R32G32B32_UINT R32G32B32_SINT R16G16B16A16_FLOAT
R16G16B16A16_UNORM R16G16B16A16_UINT R16G16B16A16_SNORM
R16G16B16A16_SINT R32G32_FLOAT R32G32_UINT R32G32_SINT
R10G10B10A2_UNORM R10G10B10A2_UINT R11G11B10_FLOAT R8G8B8A8_UNORM
R8G8B8A8_UNORM_SRGB R8G8B8A8_UINT R8G8B8A8_SNORM R8G8B8A8_SINT
R16G16_FLOAT R16G16_UNORM R16G16_UINT R16G16_SNORM R16G16_SINT
R32_FLOAT R32_UINT R32_SINT R8G8_UNORM R8G8_UINT R8G8_SNORM
R8G8_SINT R16_FLOAT R16_UNORM R16_UINT R16_SNORM R16_SINT
R8_UNORM R8_UINT R8_SNORM R8_SINT A8_UNORM R9G9B9E5_SHAREDEXP
R8G8_B8G8_UNORM G8R8_G8B8_UNORM BC1_UNORM BC1_UNORM_SRGB BC2_UNORM
BC2_UNORM_SRGB BC3_UNORM BC3_UNORM_SRGB BC4_UNORM BC4_SNORM
BC5_UNORM BC5_SNORM B5G6R5_UNORM B5G5R5A1_UNORM B8G8R8A8_UNORM
B8G8R8X8_UNORM R10G10B10_XR_BIAS_A2_UNORM B8G8R8A8_UNORM_SRGB
B8G8R8X8_UNORM_SRGB BC6H_UF16 BC6H_SF16 BC7_UNORM BC7_UNORM_SRGB
AYUV Y410 Y416 YUY2 Y210 Y216 B4G4R4A4_UNORM A4B4G4R4_UNORM
DXT1 DXT2 DXT3 DXT4 DXT5 RGBA BGRA BGR FP16 FP32 BPTC
BPTC_FLOAT
BC3n DXT5nm RXGB

<filter>: 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

<rot>: 709to2020 2020to709 709toHDR10 HDR10to709 P3D65to2020
P3D65toHDR10 709toP3D65 P3D65to709

<filetype>: bmp jpg jpeg png dds ddx tga hdr tif tiff wdp hdp
jxr ppm pfm heic heif

<feature-level>: 9.1 9.2 9.3 10.0 10.1 11.0 11.1 12.0 12.1 12.2

<adapter>:
0: VID:10DE, PID:2488 - NVIDIA GeForce RTX 3070
1: VID:1414, PID:008C - Microsoft Basic Render Driver

0 comments on commit 918b7f1

Please sign in to comment.