Converts common image formats (PNG, JPG, etc.) to GPU-native compressed (BCn, ETC, ASTC) in KTX containers.

Cort

Last update: Dec 17, 2022

Overview

img2ktx

img2ktx is a simple command-line utility.

It currently runs on Windows, Linux and MacOS.

It loads images with stb_image. Supported formats include JPEG, PNG, BMP, TGA, GIF, etc.

It optionally generates mipmap chains with stb_image_resize.

It compresses the mipmaps to BC1, BC3, BC7, ETC1, or ASTC with Intel's ISPC Texture Compressor. It can also output uncompressed 32-bit RGBA images. Only the Windows ispc_texcomp library is included in the repo; users on other platforms must provide their own.

It writes the compressed images to a KTX file. If more than one image is provided with identical dimensions, the output KTX file can be either a 2D texture array or a cubemap.

Compile

img2ktx uses submodules for its dependencies. After cloning the repository, be sure to fetch these dependencies:

$ git submodule update --init

Then use CMake 3.15+ to generate a project file for your platform.

Binaries

Download pre-built binaries from the Releases page.

TODO

img2ktx may eventually do the following things as well (but no promises):

Output DDS files, because inevitably somebody is going to ask for it.
Convert animated GIFs directly into array textures, because what 3D graphics application isn't improved by animated GIFs?

Comments

Expose additional compression options

Compressonator allows more customizable compression, including a speed/quality slider and various format-specific tweaks. See which ones are worth exposing.
enhancement

opened by cdwfs 3
Add version info / changelog
As I'm about to release a major update, this seems as good a time as any to start tracking what's changed.

[ ] Changes.txt file

[ ] Version info (hooked up to -v)

enhancement
opened by cdwfs 1
Consider licensing this code

I would love it if you released this code under a license so that it could be integrated into other projects without worries. The MIT license would be savory. The image compressor appears to already be MIT, and the STB stuff is public domain.

opened by a-day-old-bagel 1

compile problem

Machine : ubuntu 18.04

[ 33%] Building CXX object CMakeFiles/img2ktx.dir/img2ktx.cpp.o
[ 66%] Building CXX object CMakeFiles/img2ktx.dir/build_version.cpp.o
[100%] Linking CXX executable img2ktx
/usr/bin/ld: cannot find -lIMG2KTX_ISPC_TEXCOMP_LIB-NOTFOUND
collect2: error: ld returned 1 exit status
CMakeFiles/img2ktx.dir/build.make:112: recipe for target 'img2ktx' failed
make[2]: *** [img2ktx] Error 1
CMakeFiles/Makefile2:99: recipe for target 'CMakeFiles/img2ktx.dir/all' failed
make[1]: *** [CMakeFiles/img2ktx.dir/all] Error 2
Makefile:90: recipe for target 'all' failed
make: *** [all] Error 2

opened by Cvjark 0

Move compression backend to Compressonator
Motivation:

ispc_texcomp hasn't been updated in years, including merging some PRs for significant-looking bugfixes. Compressonator is under active development (for now).

ispc_texcomp requires a fancy custom compiler, which complicates the build process and hinders both distribution and CI/testing. Compressonator can be easily built from source on any platform with a relatively modern C++ compiler.

Compressonator supports more output formats than ispc_texcomp.

enhancement
opened by cdwfs 3

DEADLYSIGNAL when compress into BC3 format

I use cmake to build the library then run: ./img2ktx -o out.ktx -f BC3 input/not_kitty.png here's not_kitty.png: not_kitty.zip

Loaded input/not_kitty.png -- width=32 height=32 comp=3
compressing mip 0 layer 0: width=32 height=32 pitch_x=32 pitch_y=32
AddressSanitizer:DEADLYSIGNAL
=================================================================
==3641==ERROR: AddressSanitizer: SEGV on unknown address 0x000000000000 (pc 0x0000008c0f2a bp 0x7ffd3a604c00 sp 0x7ffd3a604778 T0)
==3641==The signal is caused by a READ memory access.
==3641==Hint: address points to the zero page.
    #0 0x8c0f29 in _fini (/opt/img2ktx/img2ktx+0x8c0f29)

AddressSanitizer can not provide additional info.
SUMMARY: AddressSanitizer: SEGV (/opt/img2ktx/img2ktx+0x8c0f29) in _fini
==3641==ABORTING

bug

opened by frokaikan 2

Releases(preview-20170425)

preview-20170425(Apr 25, 2017)
First preview release.

MacOS binaries provided by @underscorediscovery

Notable features:

Loads common image formats (JPEG, BMP, PNG, TGA, BMP, GIF, etc.) using stb_image.

Auto-generate mipmaps (box-filtered, nothing fancy).

Fast ASTC, ETC1, BC1, BC3, and BC7 compression provided by ispc_texcomp. Or just stick with uncompressed RGBA.

Output to KTX files.

Convert multiple images to a 2D texture array, cubemap, or cubemap array.

Source code(tar.gz)
Source code(zip)
img2ktx-20170425-macos.zip(359.56 KB)
img2ktx-20170425-win32.zip(655.16 KB)
img2ktx-20170425-win64.zip(760.41 KB)

Converts common image formats (PNG, JPG, etc.) to GPU-native compressed (BCn, ETC, ASTC) in KTX containers.

Related tags

Overview

img2ktx

Compile

Binaries

TODO

Comments

Expose additional compression options

Add version info / changelog

Consider licensing this code

compile problem

Move compression backend to Compressonator

DEADLYSIGNAL when compress into BC3 format

Releases(preview-20170425)

preview-20170425(Apr 25, 2017)

Owner

Cort

Better lossless compression than PNG with a simpler algorithm

An image and texture viewer for tga, png, apng, exr, dds, gif, hdr, jpg, tif, ico, webp, and bmp files

pngtostl is a program that converts a PNG image into STL 3D models

Converts file formats supported by AdPlug to VGM format.

Compressed Log Processor (CLP) is a free tool capable of compressing text logs and searching the compressed logs without decompression.

PNGFuse is a cross-platform application that allows you to embed and extract full zlib-compressed files within PNG metadata.

A resource pack converter from Optifine/MCPatcher formats to other formats

Single header KTX/DDS reader

Single source file ASTC texture decompression in C++ (derived from Google's open source Android project)

C++ (with python bindings) library for easily reading/writing/manipulating common animation particle formats such as PDB, BGEO, PTC. See the discussion group @ http://groups.google.com/group/partio-discuss

Minerva: a fast and flexible tool for deep learning on multi-GPU. It provides ndarray programming interface, just like Numpy. Python bindings and C++ bindings are both available. The resulting code can be run on CPU or GPU. Multi-GPU support is very easy.

This code converts a point cloud obtained by a Velodyne VLP16 3D-Lidar sensor into a depth image mono16.

Small header-only C library to decompress any BC compressed image

Arduino PNG image decoder library

Program will decode a PNG file into an array and apply the gaussian blur filter. Blurring an image reduces noise by taking the average RGB values around a specific pixel and setting it’s RGB to the mean values you’ve just calculated.

Second life for famous JPEGView - fast and tiny viewer/editor for JPEG, BMP, PNG, WEBP, TGA, GIF and TIFF images with a minimalist GUI and base image processing.

Image decoding for many popular formats for Simple Directmedia Layer.

Like feh, but better, faster, more image formats, simpler, more lightweight, animation support, and better UI