FAQ: Calibration
Q: What is Calibration in EPV?
Calibration allows users to measure distances, perimeters, and areas using calculation markups. Once a scale is set, it is document-tied, meaning other users with shared access can also use the same scale.
Q: Who can set, edit, or delete scales?
Both primary users (document owners) and secondary users can set, edit, and delete scales under specific conditions:
-
**Primary Users** can set, use, delete, and edit scales unless another user has already applied that scale to markups.
-
**Secondary Users** can set, use, delete, and edit scales unless another user has already applied that scale to markups.
Q: What happens when no scale is set?
If no scale is set when a user attempts to use a calculation tool, a 'Set Scale' modal will appear prompting them to enter scale values.
Q: How can users set a new scale?
In the 'Set Scale' modal, users can enter:
-
**Paper Units** (e.g., inches, feet)
-
**Actual Units** (e.g., 1 inch = 5 feet)
-
**Apply Scale To:** All Pages (default), Current Page (future enhancement), or Custom (future enhancement).
Q: Can users use decimals or fractions when entering scale values?
Yes, scale values can be entered in both decimal and fractional formats.
Q: What happens when saving a scale?
-
The 'Save' button activates only when all required fields are filled.
-
Users will see a confirmation message: 'Set scale successfully.'
-
If saving fails due to network issues, users will see: 'Scale set unsuccessfully. Please try again.'
Q: What is the Dynamic Scale Modal?
Once a scale is set, a **Dynamic Scale Modal** appears in the top-right corner for easy reference. It updates in real-time and can be repositioned within the viewer.
Q: Can users add multiple scales to one document?
Yes, users can add up to **7 scales per document**. Attempting to add an 8th scale will display: 'Max 7 scales.'
Q: How can users edit a scale?
Users can edit a scale if it has NOT been used by another user. Editing a scale will **not** retroactively update previously placed markups.
Q: What happens if a user tries to delete a scale used by others?
If a scale is in use by another user, the delete icon will be disabled with a hover message: 'Scale in use by another user; edit and delete are disabled.'
Q: What are the key system messages users may encounter?
-
**Success (5 sec):** 'Scale set successfully.'
-
**Error (10 sec):** 'Scale not set. Please try again.'
-
**Deletion Success (5 sec):** 'Scale deleted successfully.'
-
**Deletion Failure (10 sec):** 'Scale not deleted. Please try again.'
-
**Disabled Icon Message:** 'Scale in use by another user; edit and delete are disabled.'
Q: What if a user tries to add an 8th scale?
They will see a help message: 'Max 7 scales.'
Q: Can a secondary user delete a scale set by the primary user?
Yes, but only if the primary user has **not** used that scale in their markups.
Q: What if a user sets a scale, but calculation tools remain disabled?
Ensure the user has saved the scale successfully. A confirmation message will appear.
Q: Can a scale be applied to specific pages instead of the whole document?
Not in the MVP. For now, scales are applied to **'All Pages'** by default.