The PDF report is assembled at the moment you tap the export button. Several settings influence its final content:
| Setting | Effect on PDF |
|———|————–|
| **Include images in PDF** (on by default) | OD and OS photos are embedded side-by-side on page 1. Turning this off produces a smaller, text-only document |
| **Practice / Clinic name** | Appears in a teal banner below the report title on every page header |
| **Language** | The entire report — section headings, metric labels, status labels, finding descriptions — is generated in the currently active app language |
| **Herbal / Nutrition / Chiropractic / TCM mode** | Each enabled module adds a section at the end of the report, but only when at least one qualifying finding is present |
| **Auto-save PDF** (off by default) | When enabled, the PDF is saved automatically at the end of every analysis without requiring a manual tap |
Report Language
The PDF is generated using the active interface language at the time of export. All localizable strings — including metric names, zone finding descriptions, ANW status labels, age group names, and therapy section headings — are pulled from the same localization tables used by the on-screen interface.
Supported languages: English, Spanish, Portuguese (Brazil), French, German, Japanese, Korean, Italian.
To export a report in a specific language, switch the app language in Settings before tapping the PDF button. You can switch back immediately after.
File Naming and Save Location
**File name format**
PupilMetrics_<PatientName>_<YYYY-MM-DD_HH-mm>.pdf
Spaces in the patient name are preserved. The timestamp is in local time.
**Save location**
| Platform | Default save path |
|———-|—————–|
| **Windows** | `%USERPROFILE%\Documents\PupilMetrics_<name>_<date>.pdf` |
| **Android** | App documents directory (accessible via Files app) |
| **iOS** | App documents directory; use Share to send to Files, iCloud, etc. |
**Auto-save**
When Auto-save PDF is enabled, the file is written silently immediately after analysis completes. No dialog appears. A snackbar confirms the path. On mobile, the file is saved locally; you can then share it manually.
Image Compression
When images are included, each eye photo is compressed before embedding to keep the PDF file size manageable:
– Maximum width: **2,000 pixels**
– JPEG quality: **85%**
