A CPU-based DDS texture encoder optimized for fast batch conversions with high encoding quality.
ARGS:
input Encode all PNG files inside of this folder as DDS. It can also point to a single PNG file. If this parameter points to a TXT file, it will be processed as a list of PNG files and/or directories. Entries must be on separate lines. Every listed PNG file and those inside listed directories will be encoded as DDS.
output Write DDS files to this folder instead of creating them next to input PNGs. This argument is ignored if input points to a TXT file.
OPTIONS:
-cl, --clean Deletes all DDS files matching input PNG files instead of encoding them.
-f, --format DDS encoding format.
BC7: High-quality compression supporting alpha. [Default]
BC1: Highly compressed RGB data.
PNG: PNG format, intended for downscaling or metric calculation.
-af, --alpha-format Use a different DDS encoding format for files with alpha. Defaults to using the value in --format unconditionally.
BC7: High-quality compression supporting alpha. [Default]
-q, --quality Encoder quality level, must be in [0, 7]. Defaults to 6.
-nm, --no-mipmaps Disable mipmap generation.
-fs, --fix-size Set image width and height to the next multiple of 4.
-mf, --mipmap-filter Filter used to resize images during mipmap generation.
LANCZOS: Lanczos interpolation. Preserves edges and details better than other filters when dowsncaling images. [Default]
NEAREST: Nearest neighbor interpolation. Very fast, but it does not produce great results.
LINEAR: Bilinear interpolation. Fast, and with reasonable quality.
CUBIC: Bicubic interpolation. Recommended filter for upscaling images.
AREA: Resampling using pixel area relation. Good for downscaling images and mipmap generation.
-mb, --mipmap-blur Blur applied during mipmap generation. Defaults to 0.55.
-sc, --scale Scale image size by a value given in %.
-ms, --max-size Downscale images with a width or height larger than this threshold to fit into it.
-sf, --scale-filter Filter used to scale images when using the scale or max_size parameters.
LANCZOS: Lanczos interpolation. Preserves edges and details better than other filters when dowsncaling images. [Default]
NEAREST: Nearest neighbor interpolation. Very fast, but it does not produce great results.
LINEAR: Bilinear interpolation. Fast, and with reasonable quality.
CUBIC: Bicubic interpolation. Recommended filter for upscaling images.
AREA: Resampling using pixel area relation. Good for downscaling images and mipmap generation.
-th, --threads Number of threads used by the parallel pipeline, must be in [1, 32]. Defaults to maximum.
-d, --depth Maximum subdirectory depth to use when looking for source files. Defaults to maximum.
-o, --overwrite Convert files even if an output file already exists.
-on, --overwrite-new Convert files if an output file exists, but it is older than the input file.
-vf, --vflip Flip source images vertically before encoding.
-t, --time Show total execution time.
-r, --regex Process only absolute paths matching this regular expression.
-dr, --dry-run Calculate all files that would be affected but do not make any changes.
-p, --progress Display progress messages.
-v, --verbose Display all input files of the current operation.
-h, --help Show usage information.
ADVANCED OPTIONS:
-bc1-ab, --bc1-alpha-black The BC1 encoder will use 3 color blocks for blocks containing black or very dark pixels. Increases texture quality substantially, but programs using these textures must ignore the alpha channel.
-rp, --report Prints information about the encoding process of each file.
BC7 support is implemented using the bc7e.ispc library. BC1 support has been implemented with the rgbcx library.
As seen in the Texture Compression in 2020 blog post, these libraries provide great encoding quality and performance.
Check the Analysis documentation for details.
todds is optimized for encoding multiple files at the same time, without compromising on encoding quality. The full benefits of todds are reached when it is used to encode large numbers of files, but it also performs well while encoding single files.
Check the Analysis documentation for details.
todds uses CMake presets and a vcpkg submodule to retrieve its dependencies and compile. Compiling also requires the Intel® Implicit SPMD Program Compiler. For more details, check the wiki.
To compile todds without vcpkg, all of its dependencies must be available as development libraries. Check the dependencies section for details.
All of the following dependencies are available through vcpkg.
- Boost.Filesystem
- Boost.NoWide
- Boost.String
- Catch2: Only required if
TODDS_UNIT_TESTSis set to on. - Hyperscan: Required for regular expression support. Only required when
TODDS_REGULAR_EXPRESSIONSis set toON. - fmt
- oneTBB
- OpenCV
The following third party library dependencies are contained as source code in the thirdparty folder of the todds repository. Each one of these libraries is under its own license which is also included in the repository.
TODDS_CLANG_ALL_WARNINGS: This option is only available when the clang compiler is in use. This enables almost every Clang warning, except for a few that cause issues with todds. This may trigger unexpected positives when using newer Clang versions. Off by default.TODDS_CLANG_TIDY: If clang-tidy is available, it will be used to analyze the project. Off by default.TODDS_ISPC: Enables use of the bc7e_ispc for encoding BC7 files, which uses SIMD and requires the ispc compiler. On by default. If this setting is disabled, BC7 encoding will take longer and might have decreased quality.TODDS_MIMALLOC_ALLOCATOR: todds will use the mimalloc allocator instead of the standard allocator.TODDS_NEON_SIMD: Use NEON SIMD instructions instead of x64 SIMD instructions. Intended for compiling for ARM platforms.TODDS_PIPELINE_DUMP: Dump the binary data generated by each pipeline stage. Limited to a single file. The dump files will be generated next to the todds executable.TODDS_REGULAR_EXPRESSIONS: Enables the regular expression parameter for todds. Requires the Hyperscan library.TODDS_TBB_ALLOCATORtodds will use the scalable_allocator from oneTBB instead of the standard allocator.TODDS_UNIT_TESTS-> Build todds unit tests. Requires the Catch2 library. Off by default.TODDS_WARNINGS_AS_ERRORS: Treat all compiler warnings as errors. Off by default.TODDS_TRACY: Compiles todds with Tracy Profiler support. todds will use a custom allocator that will expose allocation data to Tracy.
todds encourages community involvement and contributions. Check the CONTRIBUTING.md and CODE_OF_CONDUCT.md files for details. You can check all contributors in the contributors list.
todds is licensed under the Mozilla Public License, v. 2.0. See the LICENSE file for details. Check the MPL 2.0 FAQ to learn more.
Read the ACKNOWLEDGEMENTS.md file for details.
React
Typescript
Django
Laravel
Facebook
Microsoft
Google
Alibaba
D3
Tencent