@quario/layout 0.3.0 → 0.5.0

package/lib/image.js

@@ -1,58 +0,0 @@
-/**
- * An image's own size, read from its header. Sizing is a fact about the bytes
- * rather than anything a page can answer, so it sits here and not on the
- * drawing surface: the band flow asks for it while measuring, where no
- * document is in reach at all, and again while drawing, where one is.
- *
- * Read, never decoded — a PNG's IHDR and a JPEG's frame header carry the two
- * numbers the layout needs, and nothing else here looks at a pixel.
- *
- * The XLSX target reads the same two headers for its own placement, in pixels.
- * Whether that fact belongs on the engine's event instead — it already reads
- * the magic numbers to name the format — is bead `quario-b0h`.
- */
-
-// Points, at the conventional 96 dpi the schema names: 72/96 of a pixel.
-let PER_PX = 72 / 96;
-
-/** @type {(bytes: Uint8Array, at: number) => number} */
-let word = (bytes, at) => (bytes[at] << 8) | bytes[at + 1];
-
-/** @type {(code: number) => boolean} */
-let inSof = (code) => code >= 0xc0 && code <= 0xcf;
-
-/** @type {(code: number) => boolean} */
-let notTable = (code) => code !== 0xc4 && code !== 0xc8 && code !== 0xcc;
-
-// The frame header carries the dimensions, and it is the first SOFn marker:
-// every code in C0..CF except the three in that range that are not frames --
-// DHT, the JPG extension, and DAC.
-/** @type {(code: number) => boolean} */
-let isFrame = (code) => inSof(code) && notTable(code);
-
-/** @type {(bytes: Uint8Array) => { w: number, h: number }} */
-let jpegSize = (bytes) => {
-  for (let at = 2; at + 9 < bytes.length; at += 2 + word(bytes, at + 2)) {
-    if (bytes[at] !== 0xff) break;
-    if (isFrame(bytes[at + 1])) return { w: word(bytes, at + 7), h: word(bytes, at + 5) };
-  }
-  return { w: 0, h: 0 };
-};
-
-/**
- * The image's intrinsic size in points. The format is the engine's sniff,
- * riding on the event, so nothing here decides it a second time.
- *
- * @param {Uint8Array} bytes The image file.
- * @param {string} format The engine's sniff: `"png"` or `"jpeg"`.
- * @returns {{ w: number, h: number }} The size, in points.
- */
-export let intrinsic = (bytes, format) => {
-  // A PNG carries the two numbers in its IHDR at a fixed offset.
-  let { w, h } = format === "png" ? { w: word(bytes, 18), h: word(bytes, 22) } : jpegSize(bytes);
-  // The engine vouched for the magic numbers, not for the rest of the file:
-  // a truncated header reaches here as a zero, and failing loudly beats
-  // drawing an image with no size (SCHEMA.md, "Image item").
-  if (!(w > 0 && h > 0)) throw Error("could not read the image's size from its bytes");
-  return { w: w * PER_PX, h: h * PER_PX };
-};