Tkinter PDF Viewer

تقدم هذه الأداة مكوّناً قابلاً للدمج لعرض PDF في تطبيقات بايثون Tkinter.
صُمم للمطورين الذين يحتاجون إلى عرض PDFs محلياً والتنقل بينها ضمن برمجيات سطح المكتب، من دون الاعتماد على عوارض خارجية أو موارد إنترنت.
تشمل حالات الاستخدام الشائعة كتيبات داخل التطبيق، التقارير، الوثائق الفنية واللوحات المساعدة المعروضة في لوحة GUI. تعرض واجهة API بسيطة تتوافق مع حلقات أحداث Tkinter ويمكن توصيلها بواجهات canvas أو label للعرض.

مبدئياً، تعتبر الأداة ملف PDF كوثيقة متعددة الصفحات.
تحافظ على حالة الصفحة الحالية، ومستوى التكبير والدوران، وتعرض الصفحة المطلوبة كصورة يمكن لـ Tkinter عرضها.
يتم إجراء العرض عند الطلب، مع خيار التخزين المؤقت لتعجيل العروض المتكررة في تخطيطات تحتوي على مصغّرات أو ألواح جانبية. تسارع سلسلة العرض بتصغير صفحة عند التكبير المحدد، ثم تطبيق الدوران وأخيراً إرجاع raster مناسب لعناصر Tkinter.

المزايا الأساسية تشمل: فتح pdf_path، ضبط initial_page، تعديل التكبير، تدوير الصفحات في خطوات 0/90/180/270، الحصول على total_pages وعرض مخزن صورة للعرض. يمكن دمج ميزات اختيارية مثل معاينات المصغرات، التنقل بالبنية (outline) وتخزين مؤقت يراعي الذاكرة لاحقاً. تحافظ الأداة على عرض الخط الافتراضي ووفاء الصورة، مع تركيز على تشغيل Offline موثوق.

المدخلات والمخرجات محددة بصرامة:
المدخلات تشمل pdf_path (سلسلة، مطلوبة)، initial_page (عدد صحيح، مطلوب)، zoom (رقم عائم، اختياري، 0,25–3,0)، rotation (عدد صحيح، اختياري، 0/90/180/270)، show_outline (bool، اختياري). المخرجات تشمل current_page (عدد صحيح)، total_pages (عدد صحيح)، current_zoom (float)، rendered_image (بايت PNG). الأداة تعمل بالكامل بدون اتصال بالإنترنت.