Tkinter PDF Viewer

Esta herramienta ofrece un componente de visualización de PDF integrable para aplicaciones Python Tkinter.
Está diseñado para desarrolladores que necesitan renderizar y navegar PDFs localmente en software de escritorio, sin depender de visores externos o recursos de red.
Casos de uso típicos incluyen manuales dentro de la aplicación, informes, documentación de productos y paneles de ayuda mostrados dentro de un panel GUI. Expone una API simple que se alinea con bucles de eventos de Tkinter y puede conectarse a widgets canvas o label para visualización.

Conceptualmente, la herramienta trata un PDF como un documento multi-página.
Mantiene el estado de la página actual, del nivel de zoom y de la rotación, y renderiza la página solicitada en una imagen que Tkinter puede mostrar.
El rendering se realiza bajo demanda, con caching opcional para acelerar visualizaciones repetidas en diseños con miniaturas o paneles laterales. La canalización de renderizado rasteriza una página al zoom configurado, aplica rotación y devuelve un raster adecuado para widgets de Tkinter.

Funciones centrales incluyen: abrir pdf_path, establecer initial_page, ajustar zoom, rotar páginas en incrementos de 0/90/180/270, recuperar total_pages y exponer un buffer de imagen para visualización.
Funciones opcionales como vistas previas en miniatura, navegación de outline y caching dependiente de la memoria pueden integrarse posteriormente. La herramienta conserva el renderizado de fuentes por defecto y fidelidad de las imágenes, con foco en operación offline fiable.

Entradas y salidas están estrictamente definidas:
Entradas incluyen pdf_path (cadena, requerida), initial_page (entero, requerida), zoom (flotante, opcional, 0,25–3,0), rotation (entero, opcional, 0/90/180/270), show_outline (bool, opcional). Salidas incluyen current_page (entero), total_pages (entero), current_zoom (float), rendered_image (bytes PNG). La herramienta funciona completamente offline y no busca datos en Internet.