Tkinter PDF Viewer

This tool provides an embeddable PDF viewing component for Python Tkinter applications.
It is designed for developers who need to render and navigate PDFs locally in desktop software, without relying on external viewers or network resources.
Typical use cases include in-app manuals, reports, product documentation, and help panes shown within a GUI panel. It exposes a simple API that aligns with Tkinter event loops and can be wired to canvas or label widgets for display.

Conceptually, the tool treats a PDF as a multi-page document.
It maintains state for the current page, zoom level, and rotation, and it renders the requested page into an image that Tkinter can display.
Rendering is performed on demand, with optional caching to accelerate repeated views in layouts with thumbnails or side panes. The rendering pipeline rasterizes a page at the configured zoom, then applies rotation, and finally returns a raster suitable for Tkinter widgets.

Core features include: open pdf_path, set initial_page, adjust zoom, rotate pages in 0/90/180/270 increments, retrieve total_pages, and expose an image buffer for display.
Optional features like thumbnail previews, outline navigation, and memory-aware caching can be integrated later. The tool preserves default font rendering and image fidelity, with a focus on reliable offline operation.

Inputs & outputs are strictly defined:
Inputs include pdf_path (string, required), initial_page (int, required), zoom (float, optional, 0.25–3.0), rotation (int, optional, 0/90/180/270), show_outline (bool, optional). Outputs include current_page (int), total_pages (int), current_zoom (float), rendered_image (PNG bytes). The tool runs entirely offline and does not fetch data from the internet.