OpenSite/Reference/Features/Unit preferences: Difference between revisions
BathAfrica (talk | contribs) Use sidebar contents consistently on unit-preferences reference |
BathAfrica (talk | contribs) Publish organized OpenSite guides and reference navigation |
||
| Line 1: | Line 1: | ||
__NOTOC__ | __NOTOC__ | ||
{{OpenSite scope}} | |||
{{BathAfrica Feature | {{BathAfrica Feature | ||
|id=foundation.unit-preferences | |id=foundation.unit-preferences | ||
|summary=Select how quantities are presented without changing the stored values. | |summary=Select how quantities are presented without changing the stored values. | ||
| Line 14: | Line 14: | ||
}} | }} | ||
== Try this workflow == | |||
[[OpenSite/Guides/Quantities and profiles|Quantities and profiles]] — a worked lesson with expected results. | |||
== Documentation basis == | == Documentation basis == | ||
| Line 24: | Line 27: | ||
[[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]] | [[OpenSite|OpenSite overview]] · [[OpenSite/Reference|Reference]] · [[OpenSite/Guides|Guides]] | ||
[[Category:OpenSite documentation]] | [[Category:OpenSite documentation]] | ||
<div class="os-page-nav">{{Docnav|OpenSite/Getting started|OpenSite/Guides|OpenSite/Guides|All guides}}</div> | |||
Revision as of 14:00, 29 October 2026
Select how quantities are presented without changing the stored values.
- Stable identifier
foundation.unit-preferences
Status reported by source
Implemented in the reviewed development source. Historical test evidence is recorded by the repository; no test rerun or product release is claimed by this publication.
Units
The service stores profile ids and unit ids. It does not store an SI value.
Behavior
The application default profile is SI. The user can select engineering_metric or us_customary. A document key and a property can override the presentation. The default object owns a private settings service. UnitPreferences(SettingsService&) uses a caller-owned service, and that service is the only preferences file. Save writes opensite-settings version 1. Load still accepts opensite-unit-preferences version 1 and migrates it. A change to units.profile through the shared service updates this object and notifies its listeners. Listeners are notified after a real change.
Errors
corrupt_preferences, unsupported_version, reentrant_call, and incompatible_dimension when a display unit does not match the quantity.
Limitations
The desktop Preferences window and document/property presentation consume this service. Scope and property overrides affect formatting, not canonical SI values. Language/country remain separate settings. Do not treat a preference file as an engineering document or as a design-code unit system.
Available hosts
C++ service, CLI, embedded Python and Windows desktop preferences/quantity presentation. The core service does not depend on Qt.
Licensing and access
A profile change is presentation. It does not check a design code and it does not change a stored SI value.
Verification evidence
Repository evidence references (not rerun for this publication): CTest foundation.unit_preferences. ADR-0016. The seven CI jobs for commit 34d462a9ac58634ed66604a4df829fc5a7a7730e are in the Phase 1 acceptance report.
Try this workflow
Quantities and profiles — a worked lesson with expected results.
Documentation basis
Source-reviewed against development commit 77c3fee13944bcc4b5d487c77eb1f82fbe4c6ea7, branch feature/phase-13c-properties-python-expressions. This review inspected the implementation and repository evidence; it did not run the Windows application or repeat CTest.
src/foundation/unit_preferences.cppsrc/gui/preferences_window.cppdocs/verification/Phase-11P-Preferences.md
