flet-pdfview 0.1.2__py3-none-any.whl → 0.2.1__py3-none-any.whl

flet_pdfview/main.py

@@ -1,4 +1,4 @@
-from flet import Column,Image,ScrollMode,BoxFit
+from flet import Column,Image,ScrollMode,BoxFit,InteractiveViewer
 import asyncio , os,pymupdf,gc
 from typing import Optional
 class PdfColumn(Column):
@@ -15,7 +15,8 @@ def main(page:Page):
             src="you/pdf/path",
             expand=True,
             dpi=300,
-            fitImage=BoxFit.FILL
+            fitImage=BoxFit.FILL,
+            enable_zoom=True
         )
     )
 run(main)
@@ -23,7 +24,7 @@ run(main)
 
 make sure if the path do not end with .pdf or the path not exists the PdfColumn will do not show anything !
     """
-    def __init__(self,src:str="",widht:Optional[int]=None,height:Optional[int]=None,spacing:Optional[int]=None,expand_loose:Optional[bool]=False,expand:Optional[bool]=False,scroll:ScrollMode=ScrollMode.ADAPTIVE,dpi:int=150,fitImage:BoxFit=BoxFit.FILL,visible:Optional[bool]=True):
+    def __init__(self,src:str="",enable_zoom:Optional[bool]=False,max_zoom:float=2.5,min_zoom:float=0.8,trackpad_scroll_causes_scale:Optional[bool]=True,widht:Optional[int]=None,height:Optional[int]=None,spacing:Optional[int]=None,expand_loose:Optional[bool]=False,expand:Optional[bool]=False,scroll:ScrollMode=ScrollMode.ADAPTIVE,dpi:int=150,fitImage:BoxFit=BoxFit.FILL,visible:Optional[bool]=True):
         super().__init__()
         self._src=src
         self.expand=expand
@@ -36,57 +37,120 @@ make sure if the path do not end with .pdf or the path not exists the PdfColumn
         self._fitImage=fitImage
         self._dpi=dpi
         self.visible=visible
-        asyncio.create_task(self.__start_converte(src))
-    async def __start_converte(self,path:str="",dpi:int=150):
-        self.controls.clear()
-        if os.path.exists(path) and path.endswith(".pdf"):
-            
-            pdf_pages = pymupdf.open(path)
-            
-            for pdf_page in pdf_pages:
-                if self.src==path:
-                    pix = pdf_page.get_pixmap(dpi=dpi)
-                    
-                    # pix.save(filename="file.png",output=ram)
-                    self.controls.append(
-                        Image(
-                            expand=self.expand,
-                            expand_loose=self.expand_loose,
-                            width=self.widht,
-                            height=self.height,
-                            src=pix.tobytes(),
-                            fit=self.fitImage
-                        )
-                    
-                    )
-                    
-                    self.update()
-                    gc.collect()
-                    await asyncio.sleep(0.3)
-                else:
-                    break
-            
+        self._enable_zoom=enable_zoom
+        self._min_zoom=min_zoom
+        self._max_zoom=max_zoom
+        self._trackpad_scroll_causes_scale=trackpad_scroll_causes_scale
+        # self.page.run_task
 
+    async def __start_converte(self,path:str="",dpi:int=150):
+        try:
+            self.controls.clear()
+            if os.path.exists(path) and path.endswith(".pdf"):
+                
+                pdf_pages = pymupdf.open(path)
+                
+                for pdf_page in pdf_pages:
+                    if self.src==path:
+                        pix = pdf_page.get_pixmap(dpi=dpi)
+                        
+                        # pix.save(filename="file.png",output=ram)
+                        self.controls.append(
+                            InteractiveViewer(
+                                expand=self.expand,
+                                expand_loose=self.expand_loose,
+                                width=self.widht,
+                                height=self.height,              
+                                content=Image(
+                                    expand=self.expand,
+                                    expand_loose=self.expand_loose,
+                                    width=self.widht,
+                                    height=self.height,
+                                    src=pix.tobytes(),
+                                    fit=self.fitImage
+                                ),
+                                scale_enabled=self._enable_zoom,
+                                trackpad_scroll_causes_scale=self._trackpad_scroll_causes_scale,
+                                max_scale=self._max_zoom,
+                                min_scale=self._min_zoom
+                                )
+                            )
+                        
+                        self.update()
+                        gc.collect()
+                        del pix
+                        del pdf_page
+                        await asyncio.sleep(0.3)
+                    else:
+                        break
+        except :
+            self.start_function.cancel()
+        finally:
+            # تنظيف الذاكرة في كل الأحوال
+            if 'pdf_pages' in locals():
+                pdf_pages.close()
+    def did_mount(self):
+        if self._src:
+            self.start_function = asyncio.create_task(self.__start_converte(self._src, self._dpi))
+    def will_unmount(self):
+        if self.start_function:
+            self.start_function.cancel()
     @property
     def src(self):
         return self._src
     @src.setter
     def src(self,new_src):
         self._src=new_src
-        asyncio.create_task(self.__start_converte(new_src,))
+        self.start_function = asyncio.create_task(self.__start_converte(new_src,))
     @property
     def fitImage(self):
         return self._fitImage
     @fitImage.setter
     def fitImage(self,new_fitImage):
         self._fitImage=new_fitImage
-        for image in self.controls:
-            if isinstance(image,Image):
-                image.fit=new_fitImage
+        for parent_image in self.controls:
+            if isinstance(parent_image,InteractiveViewer):
+                image = parent_image.content
+                if isinstance(image,Image):
+                    image.fit=new_fitImage
     @property
     def dpi(self):
         return self._dpi
     @dpi.setter
     def dpi(self,new_dpi):
         self._dpi=new_dpi
-        asyncio.create_task(self.__start_converte(self.src,))
+        self.start_function = asyncio.create_task(self.__start_converte(self.src,))
+    @property
+    def enable_zoom(self):
+        return self._enable_zoom
+    @enable_zoom.setter
+    def enable_zoom(self, value: bool):
+        self._enable_zoom = value
+        for viewer in self.controls:
+            if isinstance(viewer, InteractiveViewer):
+                viewer.scale_enabled = value
+        self.update()
+    @property
+    def trackpad_scroll_causes_scale(self):
+        return self._trackpad_scroll_causes_scale
+    @trackpad_scroll_causes_scale.setter
+    def trackpad_scroll_causes_scale(self, value: bool):
+        for viewer in self.controls:
+            if isinstance(viewer, InteractiveViewer):
+                viewer.trackpad_scroll_causes_scale = value
+    @property
+    def max_zoom(self):
+        return self._max_zoom
+    @max_zoom.setter
+    def max_zoom(self, value: float):
+        for viewer in self.controls:
+            if isinstance(viewer, InteractiveViewer):
+                viewer.max_scale = value
+    @property
+    def min_zoom(self):
+        return self._min_zoom
+    @min_zoom.setter
+    def min_zoom(self, value: float):
+        for viewer in self.controls:
+            if isinstance(viewer, InteractiveViewer):
+                viewer.min_scale = value

{flet_pdfview-0.1.2.dist-info → flet_pdfview-0.2.1.dist-info}/METADATA

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: flet_pdfview
-Version: 0.1.2
+Version: 0.2.1
 Summary: Flet pdf view for all platforms
 Author: Mostafa Kessassi
 Author-email: mustaphakessassi76@gmail.com
@@ -28,6 +28,7 @@ Dynamic: summary
 ### ✨ Features
 
 * 🧩 **Native PDF rendering** inside Flet layouts.
+* 🔍 **Interactive Zoom**: Support for zooming in and out with configurable limits.
 * 📐 **High-resolution** rendering with custom DPI.
 * 🖼️ **Flexible image fitting** using `BoxFit`.
 * 📱 **Fully responsive** (via `expand=True`).
@@ -54,18 +55,33 @@ def main(page: Page):
             src="path/to/your/file.pdf",
             expand=True,
             dpi=300,
-            fitImage=BoxFit.FILL
+            fitImage=BoxFit.FILL,
+            enable_zoom=True
         )
     )
 
 run(main)
 ```
-### ⚠️ Important Behavior
+### 🔍 Zoom Control
+You can now fully control the viewing experience with the following properties:
 
-`PdfColumn` will not render anything if:
+min_zoom: Sets the minimum scale allowed (Default : 0.8).
 
-1. The provided **path does not exist**.
-2. The file path **does not end with `.pdf`**.
+max_zoom: Sets the maximum scale allowed to ensure quality and performance (Default : 2.5).
+### ⚠️ Important Behavior & Performance
+**1. Silent Failure**
+
+PdfColumn will not render anything if the provided path does not exist or does not end with .pdf.
+
+No exceptions ❌
+
+No error dialogs ❌
+
+No UI interruption ❌
+
+**2. Technical Performance Warning**
+
+[!WARNING] Resource Management: Be cautious when performing intensive property updates on the PdfColumn object after its initial call. If changes involve high values or frequent updates, it may cause a brief delay when closing the application as the component finishes processing tasks to ensure a stable exit.
 
 > [!IMPORTANT]
 > **This behavior is intentional:**

flet_pdfview-0.2.1.dist-info/RECORD

@@ -0,0 +1,6 @@
+flet_pdfview/__init__.py,sha256=uxLtdoexxWnULjF0YXDF3bTUuoizSUearqHxcs-n-dY,27
+flet_pdfview/main.py,sha256=tsgwmdw8TvZ9Ou8XO0ker0G8JrBz9ye9UpSyLb38wXQ,6035
+flet_pdfview-0.2.1.dist-info/METADATA,sha256=x8OTXCanJpsa_ozHVsrZWXNozTU7qgDQZe1aJTzZX6w,3115
+flet_pdfview-0.2.1.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
+flet_pdfview-0.2.1.dist-info/top_level.txt,sha256=e-e9EU2FfrodvbFGo3DJapANzBRZgjcvCeG4d-jdnGM,13
+flet_pdfview-0.2.1.dist-info/RECORD,,

flet_pdfview-0.1.2.dist-info/RECORD

@@ -1,6 +0,0 @@
-flet_pdfview/__init__.py,sha256=uxLtdoexxWnULjF0YXDF3bTUuoizSUearqHxcs-n-dY,27
-flet_pdfview/main.py,sha256=LscccGNDfx0-t6lnumqKthuxPT5Ki19V7ftlOKSiw_A,3040
-flet_pdfview-0.1.2.dist-info/METADATA,sha256=Qh_mA-seEwXK0k9dtACldjpzbBYxeF7--rPG8-lnCBY,2310
-flet_pdfview-0.1.2.dist-info/WHEEL,sha256=_zCd3N1l69ArxyTb8rzEoP9TpbYXkqRFSNOD5OuxnTs,91
-flet_pdfview-0.1.2.dist-info/top_level.txt,sha256=e-e9EU2FfrodvbFGo3DJapANzBRZgjcvCeG4d-jdnGM,13
-flet_pdfview-0.1.2.dist-info/RECORD,,