Llimage libtest

Introduction

Looking into STORM-746, we realized we needed an applet to quickly and reliably test JPEG2000 compression/decompression strategies. We also realized that we could use such an applet to run texture compression/decompression tests as part of the set of integration tests we're running when building the viewer.

So, instead of doing a quick independent hack, we decided to build an llimage_libtest applet that can be run as part of the test suite.

Objectives

• Allow on-going test of texture compression/decompression code without having to launch the viewer
• Allow consistent compression/decompression performance measurements
• Allow quick test of alternative compress/decompress strategies and techniques
• Allow simple j2c/jpg image conversion

Quick Spec

• [DONE] Add llimage_libtest as part of the integration test suite: indra/integration_tests/llimage_libtest/llimage_libtest.cpp
• [DONE] Command line only executable (no display window after decompression)
• [DONE] Accept a variety of arguments on the command line
• [DONE] Allow bulk processing of images using file patterns on the command line (wild cards)
• [DONE] Support all image file format provided by llimage, namely: j2c (JPEG2000), jpeg, png, bmp, tga
• [DONE] Read images in any format and output them back in any format
• [DONE] Output compress/decompress performances
• Output image properties: size, components, histograms and other stats
• Build automatically as part of the viewer
• Runs on all supported platforms, namely: Mac OS X, Windows, Linux

Command Line Syntax

Get help

./llimage_libtest --help

Convert a jpg image into a j2c image

./llimage_libtest --in image.jpg --out image.j2c

Convert a jpg image into a j2c image and output image statistics

./llimage_libtest --in image.jpg --out image.j2c --image_stats

Convert all j2c images in a folder to png images in the same folder

./llimage_libtest --in path/*.j2c --out png

Load all j2c images in a folder and gather decompression perf data

./llimage_libtest --in path/*.j2c --logmetrics ImageCompressionTester

Convert a set of images to j2c

./llimage_libtest --in image1.jpg image2.jpg image3.png --out j2c

Convert all j2c and jpg images from a folder into png

./llimage_libtest --in ../../../images/*.j?? --out png

Load all j2c images in a folder, gather decompression perf data, compare with baseline and create a report

./llimage_libtest --in path/*.j2c --logmetrics ImageCompressionTester --analyzeperformance

TODO

Add stats gathering and output.

Links

• STORM-987