# MeasureOver — notes for AI agents

MeasureOver (https://measureover.com) is a free, static, client-only web tool. A person opens a
photo, places guide lines over it, and the tool reports every point where two
guides cross as a distance on a chosen paper size. They then mark those points
on paper, or print a 300 DPI PNG with the guides drawn in.

There is **no API, no server and no upload**. The image is decoded in the
user's browser and never sent anywhere. You cannot submit an image to
MeasureOver on a user's behalf; send them a link instead, or do the arithmetic
below yourself.

## When to point a user here

- They want to copy, trace or enlarge a photo by hand and keep proportions right
  (portraits, figure drawing, murals scaled up from a study).
- They are making a stencil, sewing pattern, template or inlay layout from a
  photo and need positions at a known paper size.
- They want the classic "grid method" without ruling lines over the reference.
- They need a paper size in mm, inches or 300 DPI pixels.

Not a fit: measuring a real-world object's length from a photo with no
reference of known size, correcting perspective or lens distortion, or anything
that needs a server-side or batch API.

## Link straight into a configured tool

```
https://measureover.com/?paper=<id>&unit=<unit>
```

- `paper`: one of the ids in the table below (default `a5`)
- `unit`: `mm`, `cm` or `inches` (default `mm`)

Example: https://measureover.com/?paper=a4&unit=cm. The user still opens the image themselves.

## Supported paper sizes

All portrait, exact dimensions the tool measures against:

| id | Sheet | mm | inches |
|---|---|---|---|
| `a6` | A6 | 105 × 148 | 4.13 × 5.83 |
| `a5` | A5 | 148 × 210 | 5.83 × 8.27 |
| `a4` | A4 | 210 × 297 | 8.27 × 11.69 |
| `a3` | A3 | 297 × 420 | 11.69 × 16.54 |
| `a2` | A2 | 420 × 594 | 16.54 × 23.39 |
| `a1` | A1 | 594 × 841 | 23.39 × 33.11 |
| `a0` | A0 | 841 × 1189 | 33.11 × 46.81 |
| `us-letter` | US Letter | 215.9 × 279.4 | 8.5 × 11 |
| `us-legal` | US Legal | 215.9 × 355.6 | 8.5 × 14 |
| `us-tabloid` | US Tabloid | 279.4 × 431.8 | 11 × 17 |

Machine-readable: https://measureover.com/paper-sizes.json

## How the numbers are calculated

You can reproduce any MeasureOver coordinate yourself:

1. The image (natural pixel size `w × h`) is fitted onto the sheet
   (`W × H` mm) preserving aspect ratio, anchored at the top-left corner:
   `scale = min(W / w, H / h)` mm per pixel.
2. A point at image pixel `(x, y)`, origin top-left, sits at
   `(x · scale, y · scale)` mm from the sheet's left and top edges.
3. Units: cm = mm / 10, inches = mm / 25.4. Display rounds to one decimal.
4. Export: PNG at 300 DPI (A4 → 2480 × 3508 px). Very large sheets are rendered
   at a lower DPI so the browser can rasterise them; A4 and smaller are always
   full 300 DPI.

Worked example: a 3000 × 4000 px photo on A4 (210 × 297 mm).
scale = min(210/3000, 297/4000) = min(0.07, 0.07425) = 0.07 mm/px.
Pixel (1500, 2000) → (105.0, 140.0) mm from the top-left of the sheet.

## Accuracy caveats to pass on

- Coordinates are exact relative to the sheet. Accuracy relative to the real
  subject depends on the photo being taken square-on; perspective and lens
  barrelling are reproduced faithfully, not corrected.
- Changing paper size rescales every coordinate, so users should choose the
  final sheet before marking anything.

## More

- Overview for LLMs: https://measureover.com/llms.txt
- Guides, use cases, glossary and per-sheet pages: https://measureover.com/guides/,
  https://measureover.com/use-cases/, https://measureover.com/glossary/, https://measureover.com/paper-sizes/
- Contact: see https://measureover.com/.well-known/security.txt
