WHCC · Partner Self-Validation

Crop Coordinate Validator

Preview how your X / Y / ZoomX / ZoomY crop values will be read for a given product size — the source region you selected and the print the customer receives — without needing production access.

Source Image

Sample image loaded — a labelled 3:2 grid so the presets below are demonstrable right away.

Crop Coordinates

X and Y position the image within the print area, counting down from an origin of 100: raising them moves the image's center toward the print's top-left, lowering them moves it toward the bottom-right. 50 / 50 places the image's center at the center of the print. ZoomX and ZoomY control how much of the image is used — raise them to fit more of the image; at 100 the full dimension is used.

Width
×
Height

Presets

Preview

Source & crop — the region you selected
1
Print framing — what the customer receives
2
AutoRotate is on — your X / Y / ZoomX / ZoomY crop is discarded. WHCC rotates to the product orientation and center-crops to fill.

How WHCC reads these values

X and Y position the image within the print area, and they count down from an origin of 100: raising X or Y moves the image's center toward the print's top-left; lowering them moves it toward the bottom-right. 50 / 50 places the image's center at the center of the print. The center being positioned is the center of the visible image after zoom is applied.

ZoomX and ZoomY control how much of the image is used. Raise them to fit more of the image; at 100 the full dimension is used, and values past 100 make the image smaller than the print space, leaving white space.

The equivalent source-region arithmetic this preview computes:

crop width = ZoomX / 100 × imageWidth crop height = ZoomY / 100 × imageHeight center X px = X / 100 × imageWidth center Y px = Y / 100 × imageHeight left = centerX − width / 2 top = centerY − height / 2
  • Decimals flow through. Inputs like 22.49999 pass through unrounded — decimal values are honored to five decimal places.
  • Landscape sizes carry a rotation instruction. Product nodes are portrait-aligned, so when the product size is landscape (width > height) the generated payload includes "ImageRotation": 90.
  • AutoRotate is a separate render path: when on, WHCC ignores the explicit crop entirely, rotates the asset to the product orientation, and center-crops to fill. Toggle it above to see that mode.

OAS order payload

A ready-to-submit Order Import request body for POST /api/OrderImport, built live from the values above. Everything in <ANGLE_BRACKETS> is yours to supply — entry ID, image, product, and shipping. The X / Y / ZoomX / ZoomY fields track the values you set; AutoRotate and ImageRotation are set automatically from your crop and product orientation.

Product nodes are portrait-aligned, so landscape orders carry a 90° rotation instruction ("ImageRotation": 90).

application/json