@gohcltech/edge-print-client 2.0.71-develop → 2.0.81-develop

package/README.md

@@ -265,6 +265,22 @@ Each item in the array is one unit of content (page, label, etc.).
 | `data` | `string` | The content, encoded per `flavor` |
 | `options` | `Record<string, unknown>?` | Format-specific options forwarded to the agent renderer |
 
+#### Image sizing
+
+An image prints at its **intrinsic physical size**, taken from the resolution
+its file declares — PNG `pHYs`, JFIF density, or EXIF resolution.
+
+**A file that declares no resolution is assumed to be 96 DPI.** That assumption
+decides the printed size, so it is worth knowing: a 1200 x 600 PNG with no
+resolution metadata prints at 12.5 x 6.25 inches rather than being sized to the
+paper. Send a file that declares its resolution if you need a specific size.
+
+An image too large for the sheet is scaled down to fit and the job reports a
+`content_scaled_to_fit` warning; nothing is silently cropped.
+
+This describes Windows. On macOS the image is handed to the system print
+system, which fits it to the page instead — the two converge in a later release.
+
 #### Print examples
 
 ```ts

package/dist/edge-print.d.ts

@@ -125,7 +125,21 @@ export interface PrintData {
      * - `'command'` — raw printer command language
      * - `'pdf'` — Portable Document Format
      * - `'html'` — HTML markup (agent renders to pixels)
-     * - `'image'` — raster image (PNG, JPEG, …)
+     * - `'image'` — raster image (PNG, JPEG, BMP, GIF, WebP)
+     *
+     * **Image sizing.** An image prints at its intrinsic physical size, taken
+     * from the resolution its file declares — PNG `pHYs`, JFIF density, or EXIF
+     * resolution. **A file declaring none is assumed to be 96 DPI**, so a
+     * 1200 x 600 PNG with no resolution metadata is treated as 12.5 x 6.25
+     * inches rather than being sized to the paper. If that is not what you want,
+     * send a file that declares its resolution.
+     *
+     * An image too large for the sheet is scaled down to fit, and the job
+     * reports a `content_scaled_to_fit` warning.
+     *
+     * This applies on Windows. On macOS the image is handed to the system print
+     * system, which fits it to the page instead; the two converge in a later
+     * release.
      */
     format: 'command' | 'pdf' | 'html' | 'image';
     /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gohcltech/edge-print-client",
-  "version": "2.0.71-develop",
+  "version": "2.0.81-develop",
   "description": "Browser client for the Edge Printing WebSocket agent",
   "license": "MIT",
   "repository": {