AndroidJava/GraffitiXR/TODO.md

GraffitiXR Project Roadmap & To-Do

This document tracks the development status, future enhancements, and identified gaps in the GraffitiXR application.

---

V1.5 Completed Features

• [x] Refactor from Vuforia Engine to ARCore:
  • Removed all Vuforia dependencies and code.
  • Integrate the ARCore SDK.
  • Implement runtime Image Target creation using the device camera.
• [x] Mock-up Mode:
  • Users can select a static background image.
  • A four-point transformation UI allows users to warp the overlay image.
  • Two-finger gestures for scaling and rotating the overlay are implemented.
• [x] On-the-Go Mode (Non-AR Camera):
  • A fallback mode overlays the image on the live camera feed for non-AR devices.
• [x] Core UI and Image Adjustments:
  • UI for selecting overlay and background images.
  • Functional sliders for opacity, contrast, and saturation.
  • Background removal for the overlay image.
• [x] Code & Project Documentation:
  • Added comprehensive KDocs to all classes, methods, and properties.
  • Rewrote README.md, AGENTS.md, and BLUEPRINT.md to align with the project vision.
• [x] Robustness and Error Handling:
  • Implemented error handling for background removal failures.
  • Implemented user guidance for AR plane detection failures.
• [x] Automated Tests:
  • Added a suite of unit tests for the MainViewModel.
• [x] UI Refinements:
  • Refined the Adjustment Slider UI into an integrated, animated panel.
• [x] Enhance User Experience (UX):
  • Create User Onboarding: Design and implement a tutorial or onboarding flow to explain the two different modes (Mock-up and On-the-Go) to new users.
  • Add Gesture Feedback: Provide visual feedback in Mock-up mode when a scale or rotation gesture is active.
• **[x] Keep track of the real-world image's progress as the original fingerprint is eventually covered by it completely.
• [x] Undo/Redo Functionality:
  • Implement undo and redo buttons to revert or reapply image adjustments.
• [x] Refine Gesture Feedback UI:
  • Replace the full-screen gesture feedback with a more subtle, non-intrusive indicator.
• [x] Optimize Progress Calculation Performance:
  • Refactor the progress calculation logic to avoid recalculating the entire bitmap on every update.
• [x] Add "Save/Export" Feature:
  • Allow users to save or export the final composed image from any of the modes.
  • Allow users to save the marks or griding "fingerprint" and overlay location, size, and orientation.
  • Saving the project includes the fingerprint and undo/redo history.
• [x] Implement Advanced Image Editing:
  • Add more advanced image adjustment tools like color balance or blending modes.
  • Curves Adjustment: Implement a user interface for adjusting the image's tonal range using curves.
• [x] Create a Project Library:
  • Implement functionality to save, load, and manage different mock-up projects (background, overlay, settings).

---

Project Backlog

All items completed. Ready for the next phase of development.