ROES Web - Setting Quality Limits for Images Used in Products - ppumin, ppumax, ppuaddtoorder
ROES Web – Setting Quality Limits for Images Used in Products
Use this article to configure ROES Web image quality limits with ppumin, ppumax, and ppuaddtoorder so customers are warned or blocked when an image is outside the acceptable resolution range.
Overview
ROES Web has configuration-level options that can warn or prevent the use of improperly sized images in products. Images may be flagged because their calculated resolution is too low or too high for the product. The behavior can be warning-only, or warning plus a block that prevents the customer from adding the product to the order.
When to Use This
- Customers are uploading images that are too small for selected products.
- The lab wants a warning message when the effective DPI is below or above an acceptable range.
- The lab wants to prevent add-to-order when image quality is outside the allowed range.
- The warning text or styling needs to be customized in the lab’s overriding.css file.
Before You Begin
- Determine the minimum acceptable DPI for the product or product group.
- Determine whether customers should only be warned, or whether add-to-order should be blocked.
- Send ROES Support the tags and values that should be enabled.
- Test with real product sizes and sample images before applying the setting broadly.
Important Behavior Note
ppuaddtoorder="false" prevents the customer from adding the product to the order. ppuaddtoorder="true" shows the warning but still allows the product to be added.
Solution
Send ROES Support the configuration tags
Send ROES Support the tags below with the lab’s desired values. ppumin is the most commonly used value.
Config tag meanings
- ppumin — minimum acceptable effective DPI. Images below this value trigger the warning.
- ppumax — maximum acceptable effective DPI. Images above this value can trigger the warning.
- ppuaddtoorder — controls whether the warning blocks add-to-order or only displays a warning.
Determine the ppumin and ppumax values
The values of ppumin and ppumax are expressed in DPI. ROES Web dynamically calculates the minimum or maximum DPI of the part of the image being used in the product. Zooming in or out recalculates the DPI for the portion of the image used, so the result is not based only on the full image and the full template bounds.
DPI calculation note
Bounds units are assumed to be inches. The calculation uses the lesser width or height of the pixels used, divided by the maximum axis of the bounds.
Use a real product example
Find the smallest image size that the lab wants to accept for a typical product. For example:
- Image size: 1200 × 1500 pixels
- Product size: 8 × 10
- Worst-case DPI: 1500 ÷ 10 = 150 DPI
Example threshold
To calculate when the warning should appear, multiply the ppumin value by the short dimension of the template. With an 8×10 product and ppumin="150", an image with a short dimension less than 1200 pixels should trigger the warning when dropped on that template.
Add or modify CSS in overriding.css
Add or update CSS in the lab’s overriding.css file to control the warning text and styling.
If this image does not display, open it directly: PPUMIN_Warning.gif
Optional: use modified warning styling
The warning text and color can be changed to make the message stronger.
Test in ROES Web
After the config tags and CSS are applied, test with images below, within, and above the configured DPI limits to confirm the warning and add-to-order behavior.
Expected Result
ROES Web should display a warning when images fall outside the configured ppumin or ppumax limits. If ppuaddtoorder is set to false, customers should be prevented from adding the affected product to the order.
Escalation Notes
- Confirm the requested ppumin, ppumax, and ppuaddtoorder values.
- Confirm whether the lab wants warning-only behavior or add-to-order blocking.
- Confirm the product/template size used for testing.
- Confirm the pixel dimensions of the test image.
- If the warning text or color is not correct, review the lab’s overriding.css changes.