Gallery Wall Planner

Measurement methodology v1.0

Calculation Methodology

The coordinate system, spacing, coverage, fit, unit conversion, hardware, staircase, print, and uncertainty methods used by Gallery Wall Planner.

Last reviewed: 16 July 2026

Canonical units and origin

Every physical value is stored in millimetres. Switching to inches or centimetres changes formatting and input conversion; it does not transform saved geometry.

The wall-local origin is its bottom-left corner. x increases to the right. y increases from the floor/wall origin. A frame is stored as left, bottom, width, and height. Canvas top is derived as wall height minus frame bottom minus frame height.

Rows, columns, and gaps

Horizontal gaps are calculated only between neighbours whose vertical projections overlap by at least 45% of the smaller frame height. Vertical gaps use the same rule across horizontal projections. An overlap remains a negative geometric condition and is also surfaced as a collision; it is never silently converted to a zero gap.

Coverage and centre

Width coverage is the arrangement bounding-box width divided by wall width. Height coverage uses the equivalent height formula. This avoids double-counting frames on multiple rows. Arrangement centre from floor is the midpoint of the arrangement bounding box—not an inferred design recommendation.

Presets and wall changes

Each template is defined on a 96 × 60 inch canonical wall, scaled uniformly to fit the target wall, then centred as a group. Changing a real wall keeps physical frame sizes and repositions frame centres proportionally. Any resulting overflow remains visible for the user to resolve.

Fit and constrained layout

Fit checks include all four wall edges, frame-to-frame rectangle intersections, and intersections with windows, doors, furniture, outlets, and no-drill zones. Auto fit scans valid positions, respects locked frames and clearances, and says when one or more pieces cannot be placed.

Frame edges and hardware

Frame-edge output needs wall and frame geometry. A centred sawtooth or wire point also needs a measured drop from frame top. D-rings need top drop and side inset. Wire is labelled estimated unless its drop was measured under load. A plan is not labelled a hardware mark map while any frame remains edge-only or has invalid offsets.

Staircase geometry

Measured stair pitch is atan2(rise, run). A centre point advances along the selected baseline by x = direction × cos(angle) × distance and y = sin(angle) × distance. Right-to-left ascent reverses x while y still rises. Frames remain level to the floor. The tool warns when a custom baseline differs materially from the measured pitch or the sequence exceeds the measured run/rise.

Print and installation limits

The coordinate table is the authoritative browser export. CSS print scaling, printer margins, paper size, and device adjustment can change physical scale, so every print sheet includes 4-inch and 10-centimetre calibration bars and instructs users to print at 100% / Actual size.

Users must still verify wall construction, frame weight, fastener capacity, hardware condition, and every physical mark before drilling. The product does not provide structural, electrical, lease, or building-code advice.

Reference sources

Product and search behaviour is reviewed against public primary documentation. Relevant current references include Google Search Central canonical, redirect, sitemap, robots, and structured-data policies; WCAG 2.2 reflow, target-size, contrast, keyboard, and focus guidance; Vercel Analytics privacy/custom-event guidance; Schema.org WebApplication; and W3C CSS Paged Media.