TGA Editor

The tool processes TGA texture files, enabling header validation, pixel-level edits, and controlled re-encoding for asset pipelines. Target users include game developers, 3D artists, and archival specialists who must modify dimensions, color depth, or channel data without leaving the TGA domain. Use cases include resizing textures for level-of-detail, converting 32-bit RGBA to 24-bit when alpha is unused, and adjusting palette indices for indexed textures, all while preserving compatibility with typical game engines and rendering pipelines.
Core Logic & Features: Required features include robust TGA header parsing for 8/16/24/32-bit variants, support for uncompressed and RLE data, and a deterministic re-encoding path. The tool exposes editing capabilities such as crop, resize, rotate, and flip; bit-depth conversions between 8/24/32-bit; palette mapping for indexed textures; alpha channel operations such as thresholding and premultiplication; and brightness/contrast/gamma adjustments. Advanced options cover optional dithering for 8-bit outputs and preservation or adjustment of minimal metadata. Outputs can be produced with original or modified compression settings to ensure engine compatibility.
Inputs & Outputs: Inputs include input_file TGA, operations as a list with per-operation parameters, and target settings such as width, height, crop rect, rotation angle, alpha mode, and depth. Outputs include edited_file TGA, final_width, final_height, depth, has_alpha, and a concise processing summary. Example: input 1024x512 32-bit RGBA texture, crop to 512x256, convert to 24-bit, yielding a smaller TGA ready for a compact atlas.
Algorithms & Calculations: Under the hood the tool decodes the TGA header, unpacks pixel data according to depth and compression, applies a pipeline of edits, and re-encodes with the requested format. It ensures proper color channel order (BGR for storage) and updates header fields accordingly. Error handling covers invalid headers, unsupported compression schemes, and incompatible depth requests. In addition, the tool can perform simple dithering and alpha adjustments when requested.
Error & Edge Cases: Invalid or corrupted headers, unsupported compression, or images with unsupported bit depths trigger explicit errors. Very large images may exceed memory limits; other edge cases include mismatched parameters for crop or depth conversions, or attempting edits without a valid input file. The tool gracefully reports such conditions to maintain data integrity.
Industry/Region & Localization: Follows standard TGA specifications including pixel formats 8/16/24/32-bit, palette-based and truecolor variants, and BGR channel order. Units are in pixels; no region- or currency-specific data is produced. Assumptions & Exclusions: Input is a valid TGA file; the tool does not convert to non-TGA formats nor perform comprehensive image editing beyond header and pixel data edits.