From ff245529aafdfab0dc1f328e58e3cfcf7a3ad411 Mon Sep 17 00:00:00 2001 From: Ty Date: Fri, 11 Sep 2026 14:20:51 +0000 Subject: [PATCH] docs: lock inventory PNG properties from Woo research --- docs/CAPTURE.md | 16 ++++++++++++++-- 1 file changed, 14 insertions(+), 2 deletions(-) diff --git a/docs/CAPTURE.md b/docs/CAPTURE.md index 631fa68..85823cf 100644 --- a/docs/CAPTURE.md +++ b/docs/CAPTURE.md @@ -20,7 +20,7 @@ The app expects that sheet. Background removal keys green or black. Other backgr 4. App draws the minimum-area bounding rectangle of the mask and the length axis on the long side of that rectangle. User rotates the axis if it does not follow the slab length, then approves the axis. 5. User enters length `L` in inches (1/8 in steps) and thickness (1/8 in steps). 6. App sets `scale = longest_axis_px / L`. -7. App computes widths, sqft, and bdft from the mask, and writes the inventory PNG with the background gone. +7. App computes widths, sqft, and bdft from the mask, and writes the inventory PNG. 8. User sees the PNG and the numbers. ## Measurements @@ -31,4 +31,16 @@ The app expects that sheet. Background removal keys green or black. Other backgr ## Inventory PNG -Transparent (background removed), 3:4, slab centered, 80% fill at extremes. Shorter side at least 1600px when the source allows. Source below that floor requires a new photo. +Role: `kind=inventory`. Filename is an implementation detail. +The first inventory photo is the measurement reference. Later inventory photos use the same file properties. + +| Property | Value | +|---|---| +| Format | PNG, 8-bit RGBA (`image/png`) | +| Alpha | Kept through encode and upload | +| Aspect | 3:4 portrait | +| Layout | Slab centered, 80% fill at the widest and tallest points | +| Size | After crop, shorter side ≥ 1600px when the source can supply it | + +Source below that floor: warn and require a new photo. No upscale from an undersized source. +Editor preview of alpha is a light gray checkerboard. The storefront uses the theme background.