TX2-IFF Viewer Guide
This guide explains how to use the viewer binary to display .iff images using the tx2-core engine.
Prerequisites
Rust toolchain
A graphical environment (X11, Wayland, Windows, or macOS)
GPU with Vulkan, Metal, DX12, or WebGPU support
Building
The viewer requires the gpu feature (for pollster and wgpu support in tx2-iff) and tx2-core's native features.
cargo build --bin viewer --features gpu
Running
To view an .iff file:
cargo run --bin viewer --features gpu -- <path_to_image.iff>
Example:
cargo run --bin viewer --features gpu -- output_quality.iff
Controls
Escape: Close the viewer
Resize: The image will scale to fit the window (currently stretches, aspect ratio preservation is TODO)
Architecture
The viewer uses:
tx2-iff: To decode the .iff file into raw RGB data.
tx2-core: To manage the window and render the image.
tx2_core::App: Handles the event loop and window creation.
tx2_core::Renderer: Uses WGPU to render the image as a textured quad.
WASM Support
The tx2-core engine is designed to support WASM. To run the viewer on the web:
Compile with wasm32-unknown-unknown target.
Use wasm-bindgen to generate bindings.
Load the WASM module in a web page.
(Note: The current
viewer.rs
is a native binary. A separate WASM entry point would be needed, or
viewer.rs
adapted for wasm-bindgen-test style execution).