v2.5.2

V2.5.2

Author: mchrisgm

bambulabs_api/client.py

@@ -5,6 +5,8 @@
 
 __all__ = ['Printer']
 
+import base64
+from io import BytesIO
 from typing import Any, BinaryIO
 
 from bambulabs_api.ams import AMSHub
@@ -14,6 +16,7 @@
 from .ftp_client import PrinterFTPClient
 from .mqtt_client import PrinterMQTTClient
 from .filament_info import Filament, AMSFilamentSettings
+from PIL import Image
 
 
 class Printer:
@@ -492,8 +495,23 @@ def get_camera_frame(self) -> str:
         str
             Base64 encoded image of the camera frame.
         """
+        return self.get_camera_frame_()
+
+    def get_camera_frame_(self) -> str:
         return self.__printerCamera.get_frame()
 
+    def get_camera_image(self) -> Image.Image:
+        """
+        Get the camera frame of the printer.
+
+        Returns
+        -------
+        Image.Image
+            Pillow Image of printer camera frame.
+        """
+        im = Image.open(BytesIO(base64.b64decode(self.get_camera_frame_())))
+        return im
+
     def get_current_state(self) -> PrintStatus:
         """
         Get the current state of the printer.

environment.yml

@@ -11,4 +11,5 @@ dependencies:
   - flake8
   - webcolors
   - pip:
-    - paho_mqtt
+    - paho_mqtt
+    - pillow

examples/Basic/basic_read_camera.py

@@ -0,0 +1,25 @@
+import time
+import bambulabs_api as bl
+
+IP = '192.168.1.200'
+SERIAL = 'AC12309BH109'
+ACCESS_CODE = '12347890'
+
+if __name__ == '__main__':
+    print('Starting bambulabs_api example')
+    print('Connecting to Bambulabs 3D printer')
+    print(f'IP: {IP}')
+    print(f'Serial: {SERIAL}')
+    print(f'Access Code: {ACCESS_CODE}')
+
+    # Create a new instance of the API
+    printer = bl.Printer(IP, ACCESS_CODE, SERIAL)
+
+    # Connect to the Bambulabs 3D printer
+    printer.connect()
+
+    time.sleep(5)
+    frame = printer.get_camera_image()
+    frame.save("image.png")
+
+    printer.disconnect()

examples/Basic/basic_subscription.py

@@ -0,0 +1,43 @@
+import time
+import bambulabs_api as bl
+import os
+
+IP = '192.168.1.200'
+SERIAL = 'AC12309BH109'
+ACCESS_CODE = '12347890'
+
+env = os.getenv("env", "debug")
+
+if __name__ == '__main__':
+    print('Starting bambulabs_api example')
+    print('Connecting to Bambulabs 3D printer')
+    print(f'IP: {IP}')
+    print(f'Serial: {SERIAL}')
+    print(f'Access Code: {ACCESS_CODE}')
+
+    # Create a new instance of the API
+    printer = bl.Printer(IP, ACCESS_CODE, SERIAL)
+
+    # Connect to the Bambulabs 3D printer
+    printer.connect()
+
+    try:
+        while True:
+            time.sleep(5)
+
+            # Get the printer status
+            status = printer.get_state()
+            bed_temperature = printer.get_bed_temperature()
+            nozzle_temperature = printer.get_nozzle_temperature()
+            print(
+                f'Printer status: {status}, Bed temp: {bed_temperature}, '
+                f'Nozzle temp: {nozzle_temperature}')
+
+            if env == "debug":
+                print("=" * 100)
+                print("Printer MQTT Dump")
+                print(printer.mqtt_dump())
+                print("=" * 100)
+    finally:
+        # Disconnect from the Bambulabs 3D printer
+        printer.disconnect()

pyproject.toml

@@ -19,6 +19,7 @@ classifiers = [
 ]
 dependencies = [
   "paho-mqtt>=2.0.0",
+  "pillow>=11.0.0",
 ]
 
 [project.urls]
@@ -29,3 +30,4 @@ Issues = "https://github.com/acse-ci223/bambulabs_api/issues"
 [tool.poetry.dependencies]
 python = "^3.10"
 paho-mqtt = "^2.0.0"
+pillow = "^11.0.0"

requirements.txt

@@ -4,3 +4,4 @@ sphinx
 sphinx_rtd_theme
 paho_mqtt
 webcolors
+pillow