Home

    Command Line Compression Tools

nvDXT.exe - command line tool for batch compressing

detach.exe - extracts the MIP maps from a .dds file 

stitch.exe - recombine MIP levels to form one .dds

readDXT.exe - reads compressed image and writes .tga file (source)


nvDXT Stand alone batch compressor


NVDXT
This program
    compresses images
    creates normal maps from color or alpha
    creates DuDv map
    creates cube maps
    writes out .dds file
    does batch processing
    reads .tga, .bmp, .gif, .ppm, .jpg, .tif, .cel, .dds
    filters MIP maps

Options:
    -nomipmap : don't generate MIP maps
    -fade : fade MIP maps
    -dither : add dithering
    -rescale <nearest, hi, lo>: rescale image to nearest, next highest or next lowest power of two
    -flip : flip top to bottom 
    -timestamp : Update only changed files
    -list <filename> : list of files to convert
    -cubemap <filename> : create cube map <filename>. Files specified with -list option

                    positive x, negative x, positive y, negative y, positive z, negative z
    -all : all image files in current directory
    -outdir : output directory
    -deep [directory]: include all subdirectories
    -outsamedir : output directory same as input
    -overwrite : if input is .dds file, overwrite old file
    -file: input file to process. Accepts wild cards
    -24 <dxt1c,dxt1a,dxt3,dxt5,u1555,u4444,u565,u8888, u888, u555> : compress 24 bit images with this format
    -32 <dxt1c,dxt1a,dxt3,dxt5,u1555,u4444,u565,u8888, u888, u555> : compress 32 bit images with this format

    -swap : swap rgb
    -binaryalpha : treat alpha as 0 or 1
    -alphaborder : border images with alpha = 0
    -fadeamount : percentage to fade each MIP level. Default 15
    -fadecolor : fade map (color, normal or DuDv) over MIP levels
    -fadetocolor <hex color> : color to fade to
    -fadealpha : fade alpha over MIP levels
    -fadetoalpha : [0-255] alpha to fade to
    -border : border images with color
    -bordercolor <hex color> : color for border

Texture Format options. Default DXT3:
    -dxt1c : DXT1 (color only)
    -dxt1a : DXT1 (one bit alpha)
    -dxt3 : DXT3
    -dxt5 : DXT5

    -u1555 : uncompressed 1:5:5:5
    -u4444 : uncompressed 4:4:4:4
    -u565 : uncompressed 5:6:5
    -u8888 : uncompressed 8:8:8:8
    -u888 : uncompressed 0:8:8:8
    -u555 : uncompressed 0:5:5:5
    -p8 : paletted 8 bit

Optional Mip Map Filtering. Default box filter:
    -cubic : cubic filtering
    -kaiser : kaiser filtering
    -gamma : kaiser gamma filtering
    -full : full DFT filtering

***************************
To make a normal or dudv map, specify one of
    -n4 : normal map 4 sample
    -n3x3 : normal map 3x3 filter
    -n5x5 : normal map 5x5 filter
    -n7x7 : normal map 7x7 filter
    -n9x9 : normal map 9x9 filter
    -dudv : DuDv

and source of height info:
    -alpha : alpha channel
    -rgb : average rgb
    -biased : average rgb biased
    -red : red channel
    -green : green channel
    -blue : blue channel
    -max : max of (r,g,b)
    -colorspace : mix of r,g,b
    -norm : normalize mip maps (source is a normal map)

Normal/DuDv Map options:
    -aheight : store calculated height in alpha field
    -aclear : clear alpha channel
    -awhite : set alpha channel = 1.0
    -scale <float> : scale of height map. Default 1.0
    -wrap : wrap texture around. Default off
    -minz <int> : minimum value for up vector [0-255]. Default 0

Examples
    nvdxt -cubemap cubemap.dds -list cubemapfile.lst
    nvdxt -file test.tga -dxt1c
    nvdxt -file *.tga
    nvdxt -file height_field_in_alpha.tga -n3x3 -alpha -scale 10 -wrap
    nvdxt -file grey_scale_height_field.tga -n5x5 -rgb -scale 1.3
    nvdxt -file normal_map.tga -norm
    nvdxt -file image.tga -dudv -fade -fadeamount 10
    nvdxt -all -dxt3 -gamma -outdir .\dds_dir -time


version 5.01
send comments, bug fixes and feature requests to doug@nvidia.com

    reads
        .tga
        .bmp
        .gif
        .ppm
        .jpg
        .tif
        .cel

        .dds


    Known Bugs
        .jpg currently swaps RGB

detach

      Usage: detach <base_filename>

    do not include the .dds extension

    for example to extract MIP maps from wood.dds use

        detach wood

stitch

     Usage: stitch <base_filename>

    do not include the .dds extension

    for example to recombine MIP maps from wood_00.dds,.. wood_01.dds,...

        stitch wood

 

Home