docs: lock inventory PNG properties from Woo research

This commit is contained in:
Ty
2026-09-11 14:20:51 +00:00
parent f08569894e
commit ff245529aa
+14 -2
View File
@@ -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.