Photo Documentation
Photos in QuickInspect and YachtInspect are managed as FindingsFiles -- file records linked to findings, products, or reports. Each photo has a title, short and long descriptions, a file path, and a custom sort index for ordering.
Note
Screenshots show QuickInspect. YachtInspect has identical photo documentation features.
Attaching Photos
Photos can be linked to:
- Findings: document evidence for a specific finding
- Products: attach images to a vessel or product record
- Reports: include images directly in a report via image elements
Each FindingsFile record stores a title, short description, long description, and custom sort index so you can control the display order.
Photo Gallery
The ImageGalleryWidget provides a browsable grid of all photos associated with a finding, product, or report. From the gallery you can:
- Browse thumbnails in a scrollable grid
- Tap a photo to open the detail view
- Reorder photos using the custom sort index
Image Detail View
The ImageDetailsPageWidget shows a single image at full size with its metadata. From this view you can:
- View the photo title and descriptions
- Edit the title, short description, and long description
- Toggle the noShowForReports flag (see below)
Image Annotation & Markup
Both apps include built-in drawing tools that let you annotate photos directly on the device. From the image detail view, tap the edit/markup button to open the annotation editor. Available tools include:
- Freehand drawing -- sketch arrows, circles, or highlights over the image
- Color selection -- choose from multiple colors to make annotations stand out
- Undo/redo -- step back through your drawing actions
- Save -- annotations are saved as part of the image and appear in exported reports
Tip
Use annotations to highlight defects, mark measurement points, or draw attention to specific areas in your inspection photos. Annotated images are included as-is in PDF and Photo Report exports.
Excluding Images from Reports
Each photo has a noShowForReports flag. When enabled, that image is excluded from any generated report output (PDF Report, Photo Report, etc.) even though it remains attached to the finding or product.
Tip
Use the noShowForReports flag for reference photos you want to keep on file but do not need in client-facing reports.
Photo Reports
A dedicated Photo Report generation action creates a report focused entirely on images. This produces a PDF with all qualifying photos (those without the noShowForReports flag) organized by finding.
Image Compression
All images are automatically compressed before storage and PDF generation:
- Maximum dimensions: 1200 x 1200 pixels
- Format: JPEG
- Quality: 80%
This keeps file sizes manageable and speeds up PDF generation without significant visible quality loss.
Image Caching for PDF Generation
During PDF generation, images are cached to avoid re-downloading or re-processing the same photo multiple times. This is especially important for large reports with many images, where parallel asset loading and caching significantly reduce generation time.
Note
PDF generation uses parallel asset loading combined with image caching to handle reports with large numbers of photos efficiently.
What's Next?
- Report Designer: Use Image Table and Image elements to place photos in your report layout
- AI Generation: AI can analyze report images and suggest placements
- Templates: Save report layouts that include image table configurations