Compressing textures¶
In Kanzi, you can use the ASTC and ETC algorithms for compressing textures, as well as precompressed DXT textures.
If your application tries to read more data from the memory than the memory can handle, reading the memory becomes a performance bottleneck for your application. If your target hardware supports any of these compression methods, use texture compression to reduce the memory bandwidth and improve the performance of your application. You can achieve the relatively smallest file size and the best image quality with the modern ASTC algorithm.
The best performing compression level depends on your target device. High compression levels use more CPU but less memory bandwidth, whereas low compression levels use less CPU but more memory bandwidth.
Kanzi applications send compressed textures directly to the GPU, reducing the amount of interchanged data and without requiring preprocessing on the CPU side at runtime (for example, loading libJPEG or libPNG).
For example, an unpacked 256 by 256 pixel RGB texture uses 196 kb (256 * 256 * 3 bytes). When compressed:
With ASTC that texture uses 16 kb (((256/8)^2)*16)/1024 with a block size of 8 by 8. With a block size of 12 by 12, the texture uses 8 kb.
With ETC that texture uses 32 kb (256 * 256 / 2).
If your target hardware does not support any of these compression algorithms, in some cases raw image format can be faster than any compression algorithm. This is particularly true when processing single small images.
If your target hardware does not support the selected texture compression algorithm, when you run your Kanzi application on your target device, Kanzi prints a warning message to the log. Kanzi paints black the surfaces where you use compressed texture formats that your target hardware does not support.
Because OpenGL expects DXT texture data to have the bottom row first, compress DXT files vertically flipped. Note that you can use the DXT files in your Kanzi application, but the DXT files are not supported in the windows emulation because of GPU limitations. See Importing images.
Kanzi Studio compresses the images when you create the kzb file, but you can also compress them manually. See Preprocessing images manually.
Tip
When Kanzi Studio compresses images it by default uses all available CPU resources of your computer. To free up CPU resources for other applications while Kanzi Studio compresses multiple images, select Edit > User Preferences and in the Properties tab adjust the value of the Images to compress in parallel setting.
The Images to compress in parallel setting limits the number of logical cores Kanzi Studio uses when preprocessing multiple images. The number of logical cores in your computer determines the Maximum value.
Using the ASTC algorithm¶
If your target hardware supports ASTC algorithm, use the ASTC algorithm for the best results. The ASTC algorithm creates smaller files and results in better image quality than the ETC algorithm.
To use the ASTC algorithm:
In Kanzi Studio in the Library select Resource Files > Images, and select the image for which you want to apply compression.
In the Properties set the Target Format property to ASTC.
In the Properties set:
ASTC Block Size to the block size in pixels you want to use for compressing the image.
In ASTC the size of one compressed block is always 128 bits. Fewer pixels in a block result in better image quality of the compressed image, but create larger files. 4x4 pixels per block is the largest and best looking supported value, whereas 12x12 pixels per block creates the smallest file size output.
ASTC Compression Speed to the amount of time it takes to compress an image.
Very fast, Fast, Medium, Thorough, and Exhaustive refer to the amount of time it takes to compress an image and image quality, not the file size of compressed image or decompression time:
Very fast takes the least amount of time to compress an image.
Exhaustive takes the most amount of time to compress an image and results in the best quality.
Use fast compressions for fast and good results and slower compressions for better quality.
For example, for the best final result use Exhaustive. During development Very fast is the most useful.
ASTC sRGB Variant to:
False to use linear space for the image format. This is the most common use case.
True to use the sRGB color space for the image format. This converts the image from the sRGB color space to linear space before compression and then back to the sRGB color space after decompression in the GPU.
Using the ETC algorithm¶
To use the ETC algorithm:
In Kanzi Studio in the Library select Resource Files > Images, and select the image for which you want to apply compression.
In the Properties set the Target Format property to the ETC compression you want to use:
ETC fast, medium, and slow refer to the speed of image compression and image quality, not the resulting size or decompression time. Slow returns the best image quality.
For the best final result with the ETC1 compression scheme use ETC slow perceptual.
ETC Perceptual refers to the emphasis of the green color channel over the red and blue color channels, based on the human visual system color affinity.
When using ETC1 compression scheme during development ETC fast is the most useful.
ETC2 to use the ETC2 compression scheme.
To set the quality of ETC2 compression use the Effort property.
The value of Effort corresponds to the compression time and image quality, not to the resulting size or decompression time. For the best image quality result set Effort to 100. During development 0 is the most useful because it gives the shortest compression time.
ETC2 with alpha to use the ETC2 compression scheme for images with alpha channel
Preprocessing images manually¶
Kanzi Studio compresses the images when you create the kzb file, but you can also compress them manually. To manually preprocess images, in the Library > Resource Files > Images right-click one or more images you want to preprocess, and select Preprocess images.
Tip
When Kanzi Studio compresses images it by default uses all available CPU resources of your computer. To free up CPU resources for other applications while Kanzi Studio compresses multiple images, select Edit > User Preferences and in the Properties tab adjust the value of the Images to compress in parallel setting.
The Images to compress in parallel setting limits the number of logical cores Kanzi Studio uses when preprocessing multiple images. The number of logical cores in your computer determines the Maximum value.