Tkinter PDF Viewer

Esta ferramenta oferece um componente de visualização de PDF integrável para aplicações Python Tkinter.
Está projetado para desenvolvedores que precisam renderizar e navegar PDFs localmente em software de desktop, sem depender de visores externos ou recursos de rede.
Casos de uso típicos incluem manuais dentro da aplicação, relatórios, documentação de produtos e painéis de ajuda exibidos em um painel GUI. Expõe uma API simples que se alinha com bucles de eventos de Tkinter e pode conectarse a widgets canvas ou label para visualização.

Conceitualmente, a ferramenta trata um PDF como um documento multi-página.
Mantém o estado da página atual, do nível de zoom e da rotação, e renderiza a página solicitada em uma imagem que Tkinter pode exibir.
O rendering é feito sob demanda, com caching opcional para acelerar visualizações repetidas em layouts com miniaturas ou painéis laterais. A pipeline de renderização rasteriza uma página no zoom configurado, aplica rotação e retorna um raster adequado para widgets Tkinter.

Recursos centrais incluem: abrir pdf_path, definir initial_page, ajustar o zoom, girar páginas em incrementos de 0/90/180/270, recuperar total_pages e expor um buffer de imagem para exibição.
Recursos opcionais como visualizações em miniatura, navegação de outline e caching dependente da memória podem ser integrados posteriormente. A ferramenta mantém o renderização de fontes padrão e fidelidade de imagem, com foco em operação offline confiável.

Entradas e saídas são estritamente definidas:
Entradas incluem pdf_path (string, obrigatório), initial_page (inteiro, obrigatório), zoom (flutuante, opcional, 0,25–3,0), rotation (inteiro, opcional, 0/90/180/270), show_outline (bool, opcional). Saídas incluem current_page (inteiro), total_pages (inteiro), current_zoom (float), rendered_image (bytes PNG). A ferramenta funciona totalmente offline e não busca dados na Internet.