@realsee/hdr-toolbox 1.0.2 → 1.1.0

package/dist/exr.js

@@ -0,0 +1,291 @@
+import { inflateSync } from "node:zlib";
+const MAGIC = 20000630;
+const PIXEL_TYPE_HALF = 1;
+const PIXEL_TYPE_FLOAT = 2;
+const COMPRESSION_NONE = 0;
+const COMPRESSION_RLE = 1;
+const COMPRESSION_ZIPS = 2;
+const COMPRESSION_ZIP = 3;
+/** ZIP/ZIPS pack 16 scanlines per chunk; ZIPS packs a single scanline. */
+const ZIP_ROWS_PER_CHUNK = 16;
+function halfToFloat(half) {
+    const sign = (half & 0x8000) >> 15;
+    const exponent = (half & 0x7c00) >> 10;
+    const fraction = half & 0x03ff;
+    if (exponent === 0) {
+        return (sign ? -1 : 1) * 2 ** -14 * (fraction / 1024);
+    }
+    if (exponent === 0x1f) {
+        return fraction ? Number.NaN : (sign ? -1 : 1) * Number.POSITIVE_INFINITY;
+    }
+    return (sign ? -1 : 1) * 2 ** (exponent - 15) * (1 + fraction / 1024);
+}
+class ByteReader {
+    view;
+    offset = 0;
+    constructor(view) {
+        this.view = view;
+    }
+    uint8() {
+        return this.view.getUint8(this.offset++);
+    }
+    int32() {
+        const value = this.view.getInt32(this.offset, true);
+        this.offset += 4;
+        return value;
+    }
+    uint32() {
+        const value = this.view.getUint32(this.offset, true);
+        this.offset += 4;
+        return value;
+    }
+    uint64() {
+        const low = this.view.getUint32(this.offset, true);
+        const high = this.view.getUint32(this.offset + 4, true);
+        this.offset += 8;
+        return high * 0x1_0000_0000 + low;
+    }
+    nullString() {
+        let result = "";
+        for (let byte = this.uint8(); byte !== 0; byte = this.uint8()) {
+            result += String.fromCharCode(byte);
+        }
+        return result;
+    }
+    skip(count) {
+        this.offset += count;
+    }
+    get position() {
+        return this.offset;
+    }
+    set position(value) {
+        this.offset = value;
+    }
+}
+function parseChannels(reader) {
+    const channels = [];
+    let byteOffset = 0;
+    // The channel list ends with an empty channel name (a lone null byte).
+    while (true) {
+        const name = reader.nullString();
+        if (name === "")
+            break;
+        const pixelType = reader.int32();
+        reader.skip(4); // pLinear + reserved
+        reader.skip(8); // xSampling + ySampling
+        const byteSize = pixelType === PIXEL_TYPE_FLOAT ? 4 : pixelType === PIXEL_TYPE_HALF ? 2 : 0;
+        if (byteSize === 0)
+            throw new Error(`Unsupported EXR channel pixel type for "${name}": ${pixelType}.`);
+        channels.push({ name, pixelType, byteOffset, byteSize });
+        byteOffset += byteSize;
+    }
+    // EXR stores channels alphabetically; byte offsets within a pixel follow that
+    // same order, which is exactly how we accumulated them above.
+    return channels;
+}
+function decompressChunk(compression, payload, expectedSize) {
+    if (compression === COMPRESSION_NONE)
+        return payload;
+    if (compression === COMPRESSION_ZIP || compression === COMPRESSION_ZIPS) {
+        const inflated = inflateSync(payload);
+        return reconstructZip(inflated, expectedSize);
+    }
+    throw new Error(`Unsupported EXR compression type: ${compression}.`);
+}
+/**
+ * Undoes the two reversible transforms the EXR ZIP codec applies before
+ * deflate: a per-byte delta (predictor) and an interleave of the two byte
+ * halves. Mirrors the reference OpenEXR implementation.
+ */
+function reconstructZip(source, expectedSize) {
+    const buffer = Uint8Array.prototype.slice.call(source, 0, expectedSize);
+    for (let index = 1; index < buffer.length; index++) {
+        const delta = buffer[index - 1] + buffer[index] - 128;
+        buffer[index] = delta & 0xff;
+    }
+    const result = new Uint8Array(buffer.length);
+    const half = Math.floor((buffer.length + 1) / 2);
+    let low = 0;
+    let high = half;
+    let out = 0;
+    while (out < result.length) {
+        result[out++] = buffer[low++];
+        if (out < result.length)
+            result[out++] = buffer[high++];
+    }
+    return result;
+}
+/** Reads a linear RGB EXR into interleaved float RGB, dropping any alpha. */
+export function readExr(buffer) {
+    const view = new DataView(buffer.buffer, buffer.byteOffset, buffer.byteLength);
+    const reader = new ByteReader(view);
+    if (reader.uint32() !== MAGIC)
+        throw new Error("Not an OpenEXR file (bad magic number).");
+    reader.skip(4); // version + flags; single-part scanline only
+    let channels;
+    let compression = COMPRESSION_NONE;
+    let dataWindow;
+    // Header: a sequence of (name,type,size,value) attributes ending at a null byte.
+    while (true) {
+        const attributeName = reader.nullString();
+        if (attributeName === "")
+            break;
+        reader.nullString(); // attribute type
+        const size = reader.int32();
+        const next = reader.position + size;
+        if (attributeName === "channels") {
+            channels = parseChannels(reader);
+        }
+        else if (attributeName === "compression") {
+            compression = reader.uint8();
+        }
+        else if (attributeName === "dataWindow") {
+            dataWindow = {
+                xMin: reader.int32(),
+                yMin: reader.int32(),
+                xMax: reader.int32(),
+                yMax: reader.int32(),
+            };
+        }
+        reader.position = next;
+    }
+    if (!channels || !dataWindow)
+        throw new Error("EXR header is missing channels or dataWindow.");
+    if (compression === COMPRESSION_RLE)
+        throw new Error("RLE-compressed EXR files are not supported.");
+    const width = dataWindow.xMax - dataWindow.xMin + 1;
+    const height = dataWindow.yMax - dataWindow.yMin + 1;
+    if (width <= 0 || height <= 0)
+        throw new Error("EXR data window is empty.");
+    const channelByName = new Map(channels.map((channel) => [channel.name, channel]));
+    const red = channelByName.get("R");
+    const green = channelByName.get("G");
+    const blue = channelByName.get("B");
+    if (!red || !green || !blue)
+        throw new Error("EXR file must contain R, G and B channels for HDR conversion.");
+    const bytesPerPixel = channels.reduce((sum, channel) => sum + channel.byteSize, 0);
+    const rowsPerChunk = compression === COMPRESSION_ZIP ? ZIP_ROWS_PER_CHUNK : 1;
+    const chunkCount = Math.ceil(height / rowsPerChunk);
+    // Offset table: one uint64 file offset per chunk, in scanline order.
+    const chunkOffsets = [];
+    for (let index = 0; index < chunkCount; index++)
+        chunkOffsets.push(reader.uint64());
+    const output = new Float32Array(width * height * 3);
+    const readSample = (block, offset, pixelType) => pixelType === PIXEL_TYPE_FLOAT
+        ? block.getFloat32(offset, true)
+        : halfToFloat(block.getUint16(offset, true));
+    for (let chunk = 0; chunk < chunkCount; chunk++) {
+        reader.position = chunkOffsets[chunk];
+        const firstRow = reader.int32();
+        const dataSize = reader.int32();
+        const start = reader.position;
+        const rowsInChunk = Math.min(rowsPerChunk, height - (firstRow - dataWindow.yMin));
+        const expectedSize = rowsInChunk * width * bytesPerPixel;
+        const payload = new Uint8Array(buffer.buffer, buffer.byteOffset + start, dataSize);
+        const pixels = decompressChunk(compression, payload, expectedSize);
+        const block = new DataView(pixels.buffer, pixels.byteOffset, pixels.byteLength);
+        for (let row = 0; row < rowsInChunk; row++) {
+            const imageRow = firstRow - dataWindow.yMin + row;
+            const rowStart = row * width * bytesPerPixel;
+            for (let channel of channels) {
+                if (channel.name !== "R" && channel.name !== "G" && channel.name !== "B")
+                    continue;
+                const target = channel.name === "R" ? 0 : channel.name === "G" ? 1 : 2;
+                let sampleOffset = rowStart + channel.byteOffset * width;
+                let pixelIndex = imageRow * width * 3 + target;
+                for (let x = 0; x < width; x++) {
+                    output[pixelIndex] = readSample(block, sampleOffset, channel.pixelType);
+                    sampleOffset += channel.byteSize;
+                    pixelIndex += 3;
+                }
+            }
+        }
+    }
+    return { width, height, data: output };
+}
+function writeAttribute(parts, name, type, value) {
+    parts.push(Buffer.from(`${name}\0${type}\0`, "latin1"));
+    const size = Buffer.alloc(4);
+    size.writeInt32LE(value.length, 0);
+    parts.push(size, value);
+}
+/**
+ * Writes interleaved linear float RGB as an uncompressed single-part scanline
+ * EXR. Channels are emitted alphabetically (B, G, R) as the format requires.
+ */
+export function writeExr(image) {
+    const { width, height, data } = image;
+    if (data.length !== width * height * 3)
+        throw new Error("EXR pixel data length does not match width * height * 3.");
+    const header = [];
+    const magic = Buffer.alloc(8);
+    magic.writeUInt32LE(MAGIC, 0);
+    magic.writeUInt32LE(2, 4); // version 2, scanline, single-part
+    header.push(magic);
+    // channels: alphabetical B, G, R, each FLOAT with xSampling=ySampling=1.
+    const channelParts = [];
+    for (const name of ["B", "G", "R"]) {
+        const entry = Buffer.alloc(name.length + 1 + 16);
+        entry.write(`${name}\0`, 0, "latin1");
+        let p = name.length + 1;
+        entry.writeInt32LE(PIXEL_TYPE_FLOAT, p); // pixelType
+        p += 4;
+        entry.writeInt32LE(0, p); // pLinear + reserved
+        p += 4;
+        entry.writeInt32LE(1, p); // xSampling
+        p += 4;
+        entry.writeInt32LE(1, p); // ySampling
+        channelParts.push(entry);
+    }
+    channelParts.push(Buffer.from([0]));
+    writeAttribute(header, "channels", "chlist", Buffer.concat(channelParts));
+    writeAttribute(header, "compression", "compression", Buffer.from([COMPRESSION_NONE]));
+    const window = Buffer.alloc(16);
+    window.writeInt32LE(0, 0);
+    window.writeInt32LE(0, 4);
+    window.writeInt32LE(width - 1, 8);
+    window.writeInt32LE(height - 1, 12);
+    writeAttribute(header, "dataWindow", "box2i", window);
+    writeAttribute(header, "displayWindow", "box2i", window);
+    const lineOrder = Buffer.from([0]); // INCREASING_Y
+    writeAttribute(header, "lineOrder", "lineOrder", lineOrder);
+    const screenWindowCenter = Buffer.alloc(8); // 0,0 floats
+    writeAttribute(header, "screenWindowCenter", "v2f", screenWindowCenter);
+    const screenWindowWidth = Buffer.alloc(4);
+    screenWindowWidth.writeFloatLE(1, 0);
+    writeAttribute(header, "screenWindowWidth", "float", screenWindowWidth);
+    const pixelAspectRatio = Buffer.alloc(4);
+    pixelAspectRatio.writeFloatLE(1, 0);
+    writeAttribute(header, "pixelAspectRatio", "float", pixelAspectRatio);
+    header.push(Buffer.from([0])); // end of header
+    const bytesPerChannelRow = width * 4;
+    const scanlineDataSize = bytesPerChannelRow * 3;
+    const scanlineRecord = 8 + scanlineDataSize; // y (int) + size (int) + data
+    const headerBuffer = Buffer.concat(header);
+    const offsetTableSize = height * 8;
+    const pixelDataStart = headerBuffer.length + offsetTableSize;
+    const offsetTable = Buffer.alloc(offsetTableSize);
+    for (let y = 0; y < height; y++) {
+        offsetTable.writeBigUInt64LE(BigInt(pixelDataStart + y * scanlineRecord), y * 8);
+    }
+    const pixelData = Buffer.alloc(height * scanlineRecord);
+    for (let y = 0; y < height; y++) {
+        const base = y * scanlineRecord;
+        pixelData.writeInt32LE(y, base);
+        pixelData.writeInt32LE(scanlineDataSize, base + 4);
+        const rowStart = base + 8;
+        // Channel order within a scanline matches the (alphabetical) channel list.
+        for (let channel = 0; channel < 3; channel++) {
+            const source = channel === 0 ? 2 : channel === 1 ? 1 : 0; // B,G,R -> data index
+            let out = rowStart + channel * bytesPerChannelRow;
+            let pixel = y * width * 3 + source;
+            for (let x = 0; x < width; x++) {
+                pixelData.writeFloatLE(data[pixel], out);
+                out += 4;
+                pixel += 3;
+            }
+        }
+    }
+    return Buffer.concat([headerBuffer, offsetTable, pixelData]);
+}
+//# sourceMappingURL=exr.js.map

package/dist/exr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"exr.js","sourceRoot":"","sources":["../src/exr.ts"],"names":[],"mappings":"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"}

package/dist/hdr.d.ts

@@ -0,0 +1,6 @@
+import type { LinearHdrImage } from "./exr.js";
+/** Reads a Radiance HDR file into interleaved linear float RGB. */
+export declare function readHdr(buffer: Buffer): LinearHdrImage;
+/** Writes interleaved linear float RGB as a new-style RLE Radiance HDR file. */
+export declare function writeHdr(image: LinearHdrImage): Buffer;
+//# sourceMappingURL=hdr.d.ts.map

package/dist/hdr.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr.d.ts","sourceRoot":"","sources":["../src/hdr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAsH/C,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,CAwBtD;AA6ED,gFAAgF;AAChF,wBAAgB,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,CA6BtD"}

package/dist/hdr.js

@@ -0,0 +1,263 @@
+/**
+ * Minimal Radiance HDR (RGBE, ".hdr"/".pic") reader and writer for linear
+ * scanline RGB images.
+ *
+ * RGBE stores three 8-bit mantissas plus one shared 8-bit exponent per pixel,
+ * giving a wide dynamic range in 32 bits. This module reads the flat and
+ * new-style (adaptive) RLE encodings and always writes the new-style RLE form,
+ * which every Radiance reader understands. Pixels are exchanged as interleaved
+ * linear float RGB, matching the EXR codec so both share one conversion path.
+ */
+const EXPONENT_BIAS = 128;
+/**
+ * Converts one RGBE quadruple to linear float RGB, writing into `out`.
+ *
+ * With the shared exponent byte `e`, each mantissa byte decodes as
+ * `byte * 2^(e - 128 - 8)`, where the -8 undoes the 0-255 mantissa scale. This
+ * matches the common three.js/parse-hdr convention (no half-bucket bias), which
+ * keeps near-zero channels at zero.
+ */
+function rgbeToFloat(r, g, b, e, out, offset) {
+    if (e === 0) {
+        out[offset] = 0;
+        out[offset + 1] = 0;
+        out[offset + 2] = 0;
+        return;
+    }
+    const scale = 2 ** (e - (EXPONENT_BIAS + 8));
+    out[offset] = r * scale;
+    out[offset + 1] = g * scale;
+    out[offset + 2] = b * scale;
+}
+/**
+ * Converts one linear float RGB pixel to an RGBE quadruple.
+ *
+ * Mirrors the reference Radiance encoder: decompose the channel maximum as
+ * `max = mantissa * 2^exponent` with `mantissa` in [0.5, 1) (i.e. frexp), then
+ * scale each channel by `mantissa / max * 256` and store `exponent + 128`.
+ */
+function floatToRgbe(r, g, b) {
+    const max = Math.max(r, g, b);
+    if (max <= 1e-32)
+        return [0, 0, 0, 0];
+    // frexp exponent: the e with max / 2^e in [0.5, 1).
+    const exponent = Math.floor(Math.log2(max)) + 1;
+    const factor = 2 ** -exponent * 256;
+    // Round (not floor) so the quantisation error is centred, since the decoder
+    // does not add a half-bucket bias.
+    const clampByte = (value) => {
+        const byte = Math.round(value * factor);
+        return byte < 0 ? 0 : byte > 255 ? 255 : byte;
+    };
+    return [clampByte(r), clampByte(g), clampByte(b), exponent + EXPONENT_BIAS];
+}
+function readHeader(buffer) {
+    let offset = 0;
+    const readLine = () => {
+        let line = "";
+        while (offset < buffer.length) {
+            const byte = buffer[offset++];
+            if (byte === 0x0a)
+                break;
+            line += String.fromCharCode(byte);
+        }
+        return line;
+    };
+    const magic = readLine();
+    if (!magic.startsWith("#?"))
+        throw new Error("Not a Radiance HDR file (missing #? signature).");
+    let format;
+    // Header lines continue until a blank line separates them from the resolution.
+    while (offset < buffer.length) {
+        const line = readLine();
+        if (line === "")
+            break;
+        const match = /^FORMAT=(.+)$/.exec(line);
+        if (match)
+            format = match[1].trim();
+    }
+    if (format && format !== "32-bit_rle_rgbe")
+        throw new Error(`Unsupported Radiance HDR format "${format}" (only 32-bit_rle_rgbe).`);
+    const resolution = readLine();
+    // Standard orientation is "-Y height +X width"; accept the common variants.
+    const match = /([+-][XY])\s+(\d+)\s+([+-][XY])\s+(\d+)/.exec(resolution);
+    if (!match)
+        throw new Error(`Unsupported Radiance HDR resolution line: "${resolution}".`);
+    const [, axis1, size1, axis2, size2] = match;
+    let width;
+    let height;
+    let flipY = false;
+    if (axis1.endsWith("Y")) {
+        height = Number(size1);
+        width = Number(size2);
+        flipY = axis1.startsWith("+");
+    }
+    else {
+        width = Number(size1);
+        height = Number(size2);
+        flipY = axis2.startsWith("+");
+    }
+    if (axis1.endsWith(axis2.charAt(1)))
+        throw new Error("Radiance HDR resolution line must specify one X and one Y axis.");
+    return { width, height, flipY, dataStart: offset };
+}
+/** Reads a Radiance HDR file into interleaved linear float RGB. */
+export function readHdr(buffer) {
+    const { width, height, flipY, dataStart } = readHeader(buffer);
+    const data = new Float32Array(width * height * 3);
+    let offset = dataStart;
+    const scanline = new Uint8Array(width * 4);
+    for (let row = 0; row < height; row++) {
+        offset = readScanline(buffer, offset, width, scanline);
+        const targetRow = flipY ? height - 1 - row : row;
+        let out = targetRow * width * 3;
+        for (let x = 0; x < width; x++) {
+            rgbeToFloat(scanline[x * 4], scanline[x * 4 + 1], scanline[x * 4 + 2], scanline[x * 4 + 3], data, out);
+            out += 3;
+        }
+    }
+    return { width, height, data };
+}
+/**
+ * Decodes one scanline into `scanline` as width*4 RGBE bytes and returns the new
+ * read offset. Handles new-style adaptive RLE, old-style RLE, and flat pixels.
+ */
+function readScanline(buffer, start, width, scanline) {
+    let offset = start;
+    // New-style RLE scanlines begin with the marker 0x02 0x02 and a 16-bit width.
+    const isNewStyle = width >= 8 &&
+        width <= 0x7fff &&
+        buffer[offset] === 2 &&
+        buffer[offset + 1] === 2 &&
+        ((buffer[offset + 2] << 8) | buffer[offset + 3]) === width;
+    if (!isNewStyle)
+        return readFlatOrOldScanline(buffer, offset, width, scanline);
+    offset += 4;
+    // Each of the four RGBE components is run-length encoded separately.
+    for (let channel = 0; channel < 4; channel++) {
+        let x = 0;
+        while (x < width) {
+            let count = buffer[offset++];
+            if (count > 128) {
+                // A run: the next byte repeats (count - 128) times.
+                const value = buffer[offset++];
+                count -= 128;
+                while (count-- > 0)
+                    scanline[(x++ << 2) + channel] = value;
+            }
+            else {
+                // A dump: `count` literal bytes follow.
+                while (count-- > 0)
+                    scanline[(x++ << 2) + channel] = buffer[offset++];
+            }
+        }
+    }
+    return offset;
+}
+/** Reads a flat (uncompressed) or old-style RLE scanline. */
+function readFlatOrOldScanline(buffer, start, width, scanline) {
+    let offset = start;
+    let x = 0;
+    let repeatShift = 0;
+    while (x < width) {
+        const r = buffer[offset++];
+        const g = buffer[offset++];
+        const b = buffer[offset++];
+        const e = buffer[offset++];
+        // Old-style RLE: an (1,1,1,count) pixel repeats the previous one count<<shift times.
+        if (r === 1 && g === 1 && b === 1 && x > 0) {
+            let count = e << repeatShift;
+            const base = (x - 1) * 4;
+            while (count-- > 0 && x < width) {
+                scanline[x * 4] = scanline[base];
+                scanline[x * 4 + 1] = scanline[base + 1];
+                scanline[x * 4 + 2] = scanline[base + 2];
+                scanline[x * 4 + 3] = scanline[base + 3];
+                x++;
+            }
+            repeatShift += 8;
+        }
+        else {
+            scanline[x * 4] = r;
+            scanline[x * 4 + 1] = g;
+            scanline[x * 4 + 2] = b;
+            scanline[x * 4 + 3] = e;
+            x++;
+            repeatShift = 0;
+        }
+    }
+    return offset;
+}
+/** Writes interleaved linear float RGB as a new-style RLE Radiance HDR file. */
+export function writeHdr(image) {
+    const { width, height, data } = image;
+    if (data.length !== width * height * 3)
+        throw new Error("HDR pixel data length does not match width * height * 3.");
+    const header = Buffer.from(`#?RADIANCE\nFORMAT=32-bit_rle_rgbe\n\n-Y ${height} +X ${width}\n`, "latin1");
+    const chunks = [header];
+    const rgbe = new Uint8Array(width * 4);
+    // New-style RLE requires widths in [8, 32767]; otherwise write flat pixels.
+    const useRle = width >= 8 && width <= 0x7fff;
+    for (let row = 0; row < height; row++) {
+        let source = row * width * 3;
+        for (let x = 0; x < width; x++) {
+            const [r, g, b, e] = floatToRgbe(data[source], data[source + 1], data[source + 2]);
+            rgbe[x * 4] = r;
+            rgbe[x * 4 + 1] = g;
+            rgbe[x * 4 + 2] = b;
+            rgbe[x * 4 + 3] = e;
+            source += 3;
+        }
+        chunks.push(useRle ? encodeRleScanline(rgbe, width) : Buffer.from(rgbe.slice()));
+    }
+    return Buffer.concat(chunks);
+}
+/** Length of the run starting at `index` for one interleaved RGBE channel. */
+function runLengthAt(rgbe, channel, index, width) {
+    const value = rgbe[index * 4 + channel];
+    let length = 1;
+    while (index + length < width && rgbe[(index + length) * 4 + channel] === value)
+        length++;
+    return length;
+}
+/** Encodes one width*4 RGBE scanline using new-style adaptive RLE. */
+function encodeRleScanline(rgbe, width) {
+    const out = [2, 2, (width >> 8) & 0xff, width & 0xff];
+    // Runs of >= 4 bytes are worth encoding; shorter spans go in literal dumps.
+    const minRun = 4;
+    for (let channel = 0; channel < 4; channel++) {
+        let x = 0;
+        while (x < width) {
+            // Scan forward over bytes that do not start a worthwhile run; those bytes
+            // become a literal dump. `runStart` always advances, so this terminates.
+            let runStart = x;
+            let run = 0;
+            while (runStart < width) {
+                run = runLengthAt(rgbe, channel, runStart, width);
+                if (run >= minRun)
+                    break;
+                runStart += run;
+            }
+            // Emit the literal span [x, runStart) in chunks of at most 128 bytes.
+            while (x < runStart) {
+                const dumpLength = Math.min(128, runStart - x);
+                out.push(dumpLength);
+                for (let i = 0; i < dumpLength; i++)
+                    out.push(rgbe[(x + i) * 4 + channel]);
+                x += dumpLength;
+            }
+            // Emit the run [runStart, runStart + run) in chunks of at most 127 repeats.
+            if (runStart < width) {
+                const value = rgbe[runStart * 4 + channel];
+                while (run > 0) {
+                    const chunk = Math.min(127, run);
+                    out.push(128 + chunk, value);
+                    run -= chunk;
+                    x += chunk;
+                }
+            }
+        }
+    }
+    return Buffer.from(out);
+}
+//# sourceMappingURL=hdr.js.map

package/dist/hdr.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hdr.js","sourceRoot":"","sources":["../src/hdr.ts"],"names":[],"mappings":"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"}

package/dist/image-format.d.ts

@@ -0,0 +1,30 @@
+/** Bitmap formats accepted for SDR/gain-map input and produced on extract output. */
+export declare const supportedImageFormats: readonly ["jpeg", "jpg", "png", "avif"];
+export type ImageFormat = (typeof supportedImageFormats)[number];
+/** Canonical form used internally; "jpg" is an alias of "jpeg". */
+export type CanonicalImageFormat = "jpeg" | "png" | "avif";
+export declare function canonicalizeImageFormat(format: ImageFormat): CanonicalImageFormat;
+export declare function isSupportedImageFormat(value: string): value is ImageFormat;
+/**
+ * Resolves the desired output format for extraction, preferring an explicit
+ * `--format` flag, then the output path extension, then defaulting to JPEG.
+ */
+export declare function resolveOutputFormat(explicit: string | undefined, outputPath: string): CanonicalImageFormat;
+/**
+ * Detects the bitmap format of a buffer via sharp. Returns the canonical format
+ * when it is one we support, otherwise throws so callers reject unknown inputs.
+ * AVIF is reported by sharp as HEIF with "av1" compression.
+ */
+export declare function detectImageFormat(buffer: Buffer): Promise<CanonicalImageFormat>;
+/**
+ * Ensures a buffer is JPEG, transcoding from PNG/AVIF when needed. JPEG inputs
+ * are returned untouched so Ultra HDR composition stays byte-for-byte lossless
+ * for the common JPEG-in path. The ICC profile, if present, is preserved.
+ */
+export declare function ensureJpegBuffer(buffer: Buffer): Promise<Buffer>;
+/**
+ * Transcodes an extracted JPEG subimage to the requested output format. JPEG
+ * output is a passthrough of the original bytes to preserve the exact subimage.
+ */
+export declare function encodeImage(jpeg: Buffer, format: CanonicalImageFormat): Promise<Buffer>;
+//# sourceMappingURL=image-format.d.ts.map

package/dist/image-format.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"image-format.d.ts","sourceRoot":"","sources":["../src/image-format.ts"],"names":[],"mappings":"AAGA,qFAAqF;AACrF,eAAO,MAAM,qBAAqB,yCAA0C,CAAC;AAE7E,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEjE,mEAAmE;AACnE,MAAM,MAAM,oBAAoB,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAO3D,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,oBAAoB,CAEjF;AAED,wBAAgB,sBAAsB,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,WAAW,CAE1E;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAC5B,UAAU,EAAE,MAAM,GACjB,oBAAoB,CAWtB;AAED;;;;GAIG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC,CAQrF;AAED;;;;GAIG;AACH,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGtE;AAED;;;GAGG;AACH,wBAAsB,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,oBAAoB,GAAG,OAAO,CAAC,MAAM,CAAC,CAK7F"}