Expand description
Manifold: lossless RGB8 shared-patch-atlas image codecs (MNF5/6/7/8).
NOTE on names: the published package is manifold-codec, but the lib
target is manifold (the original crate name, kept for path stability).
Depend on manifold-codec in Cargo.toml and import as manifold:
[dependencies]
manifold-codec = "1.3"use manifold::codec::Dims;Entry points:
codec: MNF5 (v0.5 format) encode/decode;codec::DecodeLimits.mnf6: MNF6/7 (zstd container, planar, YCoCg, color modes) —mnf6::encode_mnf7/mnf6::decode_mnf7+ configurable ceilings (mnf6::decode_mnf7_with_limits).mnf8: MNF8 (backend byte: zlib/zstd-19, planar, FLAG_PRED_MED, FLAG_TOKENS, branch predictors, balanced|maximum profiles) —mnf8::encode_mnf8/mnf8::decode_mnf8.mnf9: MNF9 exact-generative whole-frame format (ADR-007) —mnf9::encode_exact(None when no rule fits; the CLI pick emits an MNF9-magic file only when it wins) /mnf9::decode_mnf9.refdecode: independent MNF5 decoder used by the differential tests.error: the shared error/Resulttype for every fallible op.
Decoding is deterministic integer arithmetic (no float, no allocation
beyond the pixel buffer). Formats are frozen at v1.x; malformed input
returns error::Error::Format, never a panic.
Modules§
- codec
- MNF5 (v0.5 format): atlas codec, zlib container.
- error
- Shared error and
Resulttypes for the whole library. - img
- Image-I/O shims (JPEG/PNG load, PNG save) —
image-iofeature. - mix_
coder - MNF13-R5: the dual-timescale adaptive mix coder — MNF8 backend id 4 (fixed-point dual-EWA estimators, zero model transport; docs/mnf13-r5.md). MNF13-R5 — the dual-timescale adaptive mix coder (backend id 4).
- mnf6
- MNF6/7: zstd container, planar packing, YCoCg + modular color modes.
decode_mnf7accepts both magics. - mnf8
- MNF8: versioned backend-byte container (zlib/zstd-19/mix), profiles,
FLAG_PRED_MED. - mnf9
- MNF9 exact generative whole-frame records (ADR-007; Track A). MNF9 — exact generative whole-frame records (ADR-007; Track A promotion).
- refdecode
- Independent MNF5 decoder (differential-testing instrument).
- tokens
- LZ77-2D token engine (MNF8
FLAG_TOKENS; the retained ladder arm).