How ruhanazevedo/battleship works
Battleship is a desktop PDF coordinate picker for iText developers. A user opens a PDF through the launcher or drops it onto the window; the viewer requests page rendering, displays the page, and records clicks as bottom-left-origin PDF coordinates. Picks appear in session history and can be copied or exported as JSON, CSV, or Java snippets. The viewer also supports page navigation, zoom, hover coordinates, and a click marker. The README documents these capabilities; some viewer-to-renderer and canvas wiring is not visible in the excerpts, so those relationships are marked unverified.
Main entry points: ViewerWindow.java PDF viewer · LauncherWindow.java PDF launcher · PdfCanvas.java Page canvas · App.java Application entry
Components 13
Startup and Launch
- Application entry
src/main/java/com/ruhanazevedo/navalbattle/App.java - PDF launcher
src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java - UI utilities
src/main/java/com/ruhanazevedo/navalbattle/ui/UIUtil.java
PDF Viewing
- PDF viewer
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - Page renderer
src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java - Rendered page data
src/main/java/com/ruhanazevedo/navalbattle/pdf/PageRenderResult.java
Coordinate Picking
- Page canvas
src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java - Coordinate pick
src/main/java/com/ruhanazevedo/navalbattle/model/CoordinatePick.java
History and Export
- Session history
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - Export formatting
src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.java
Other components
- User
- PDF file
- System clipboard
Connections 16
- User → Application entry: starts
src/main/java/com/ruhanazevedo/navalbattle/App.java - Application entry → PDF launcher: opens
src/main/java/com/ruhanazevedo/navalbattle/App.java - User → PDF launcher: chooses or drops
src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java - PDF launcher → UI utilities: applies icon
src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java - PDF launcher → PDF viewer: opens PDF
src/main/java/com/ruhanazevedo/navalbattle/ui/LauncherWindow.java - PDF file → PDF viewer: provides input
README.md - PDF viewer → Page renderer: requests rendering
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - Page renderer → Rendered page data: returns page data
src/main/java/com/ruhanazevedo/navalbattle/pdf/PdfRenderer.java - PDF viewer → Page canvas: displays page
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - Page canvas → Coordinate pick: creates pick
src/main/java/com/ruhanazevedo/navalbattle/ui/PdfCanvas.java - Page canvas → PDF viewer: reports click and hover
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - PDF viewer → Session history: records picks
README.md - PDF viewer → Export formatting: formats picks
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - Export formatting → Coordinate pick: reads pick fields
src/main/java/com/ruhanazevedo/navalbattle/export/ExportService.java - PDF viewer → System clipboard: copies text
src/main/java/com/ruhanazevedo/navalbattle/ui/ViewerWindow.java - User → PDF viewer: navigates and zooms
README.md