ktx-codec

Khronos texture format

Stackage Nightly 2026-07-08:0.1.0.0
Latest on Hackage:0.1.0.0

See all snapshots ktx-codec appears in

BSD-3-Clause licensed by IC Rainbow
Maintained by [email protected]
This version can be pinned in stack with:ktx-codec-0.1.0.0@sha256:f6493481cebefba50585f2ef86cce8a74d28fa95987ebd6bece296ef46572a61,2819

Module documentation for 0.1.0.0

This package implements low-level encoding and decoding for .ktx and .ktx2 files.

A framework-specific wrapper may be needed to work with the decoded data and/or supercompression. Check out test/Spec.hs for usage examples.

KTX 1: https://registry.khronos.org/KTX/specs/1.0/ktxspec.v1.html

KTX 2: https://registry.khronos.org/KTX/specs/2.0/ktxspec.v2.html#_abstract

Changes

Changelog for ktx-codec

0.1.0.0 - 2025-12-11

Making editing KTX2 files simpler.

  • Add Codec.Ktx2 with the Ktx2 type pulled from Codec.Ktx2.Write arguments.
  • Changed Codec.Ktx2.Write functions to use that Ktx2 instead. Breaking.
  • Add Codec.Ktx2.Read.fromFile to read the whole file at once and put it into Ktx2 envelope.
  • Add Codec.Ktx.KeyValue.writerKtxCodec/writerCodecWith/editWriter so you can brag about using this library when writing.
  • Add container-like functions for Codec.Ktx.KeyValue: lookup, insertBytes, insertNumber, and insertText.

0.0.2.1 - 2023-04-08

  • Add Codec.Ktx2.Write.
  • Add patterns for Khronos keys
  • Add patterns for Khronos DFD.BasicV2

0.0.2.0 - 2023-03-18

  • Add experimental KTX 2.0 support.
    • Only reading for now.
    • Everything besides the header is read on demand.
    • MipLevel data can be read into provided buffer directly.
  • KeyValueData moved to Codec.Ktx.KeyValue and dropped the Key newtype.
    • Add textual to extract all valid text values.

0.0.1.4 - 2022-01-24

  • Put tests under a flag. No code change.
  • Allow text-2.

0.0.1.3 - 2021-04-04

  • Allow bytestring-0.12.
  • Fix getKeyValueData decoder.
  • Fix encoder endianness.
  • Add fromByteStringLazy, toBuilder and toFile.

0.0.1.2 - 2021-01-18

  • Add fromByteString.

0.0.1.1 - 2020-08-24

  • Debug traces removed.

0.0.1.0 - 2020-08-23

  • Initial release.