Improves async camera wrapper

Adds property-based attribute delegation in the async camera wrapper class to work around a MicroPython subclassing bug, ensuring consistent attribute access.

Refines UI styling in the HTML example for better alignment and updates documentation for clarity, including deprecation notes for legacy method prefixes.

Removes runtime deprecation warnings from native getters/setters to streamline output, as needed for workaround.

Author: cnadler86

README.md

@@ -13,7 +13,7 @@ If you want to play arround with AI, take a look at the [micropython binding for
 
 ## Content
 
-- [Precompiled firmware (the easy way)](#Precompiled-firmware-the-easy-way)
+- [Precompiled firmware (the easy way)](#precompiled-firmware-the-easy-way)
 - [Using the API](#using-the-api)
   - [Importing the camera module](#importing-the-camera-module)
   - [Creating a camera object](#creating-a-camera-object)
@@ -22,7 +22,7 @@ If you want to play arround with AI, take a look at the [micropython binding for
   - [Camera reconfiguration](#camera-reconfiguration)
   - [Freeing the buffer](#freeing-the-buffer)
   - [Is a frame available](#is-frame-available)
-  - [Additional methods](#additional-methods)
+  - [Additional methods and examples](#additional-methods-and-examples)
   - [I2C Integration](#i2c-integration)
   - [Additional information](#additional-information)
 - [Build your custom firmware](#build-your-custom-firmware)
@@ -202,8 +202,8 @@ camera.vflip = True #Enable vertical flip
 ```
 
 See autocompletions in Thonny in order to see the list of methods.
-If you want more insights in the methods and what they actually do, you can find a very good documentation [here](https://docs.circuitpython.org/en/latest/shared-bindings/espcamera/index.html).
-Note: "get_" and "set_" prefixed methods are deprecated.
+If you want more insights in the methods and what they actually do, you can find a very good documentation [in circuitpython](https://docs.circuitpython.org/en/latest/shared-bindings/espcamera/index.html).
+Note: "get_" and "set_" prefixed methods are deprecated and will be removed in a future release.
 
 Take also a look in the examples folder.
 
@@ -332,6 +332,7 @@ Example for Xiao sense:
 #define MICROPY_CAMERA_GRAB_MODE    (1)         // 0=WHEN_EMPTY (might have old data, but less resources), 1=LATEST (best, but more resources)
 
 ```
+
 #### Customize additional camera settings
 
 If you want to customize additional camera setting or reduce the firmware size by removing support for unused camera sensors, then take a look at the kconfig file of the esp32-camera driver and specify these on the sdkconfig file of your board.
@@ -385,6 +386,7 @@ Using fb_count=2 theoretically can double the FPS (see JPEG with fb_count=2). Th
 ## Troubleshooting
 
 You can find information on the following sites:
+
 - [ESP-FAQ](https://docs.espressif.com/projects/esp-faq/en/latest/application-solution/camera-application.html)
 - [ChatGPT](https://chatgpt.com/)
 - [Issues in here](https://github.com/cnadler86/micropython-camera-API/issues?q=is%3Aissue)

examples/CameraSettings.html

@@ -32,16 +32,22 @@
         }
         .setting {
             margin-bottom: 10px;
+            display: flex;
+            align-items: center;
+            justify-content: space-between;
         }
         .setting label {
-            display: block;
             font-size: 14px;
-            margin-bottom: 3px;
+            flex: 1;
         }
         .setting input[type="range"],
         .setting select {
             width: 100%;
         }
+        .setting input[type="checkbox"] {
+            width: auto;
+            margin-left: 10px;
+        }
         .hidden {
             display: none;
         }

examples/CameraSettings.py

@@ -15,7 +15,7 @@
 while not station.isconnected():
     time.sleep(1)
 
-print(f'Connected! IP: {station.ifconfig()[0]}. Open this IP in your browser')
+print(f'Connected! IP: http://{station.ifconfig()[0]}. Open it in your browser')
 
 try:
     with open("CameraSettings.html", 'r') as file:

src/acamera.py

@@ -3,10 +3,206 @@
 from camera import FrameSize, PixelFormat, GainCeiling, GrabMode
 
 class Camera(_Camera):
+    """
+    Async wrapper for Camera class.
+    
+    Workaround for MicroPython bug: Python subclasses of native types with attr handlers
+    cannot properly set attributes. The attr handler is bypassed and values are stored in
+    the instance __dict__ instead. We work around this by explicitly defining properties
+    that delegate to the get_*/set_* methods which are in locals_dict and work correctly.
+    
+    See: https://github.com/micropython/micropython/issues/18592
+    """
+    
     async def acapture(self):
         self.free_buffer() # Free the buffer so the camera task grabs a new frame
         while not self.frame_available():
             await asyncio.sleep(0) # Yield control to the event loop
         return self.capture()
 
+    # Workaround: Define properties that delegate to get_/set_ methods
+    # These methods are in locals_dict and work correctly with subclasses
+    
+    @property
+    def frame_size(self):
+        return self.get_frame_size()
+    @frame_size.setter
+    def frame_size(self, value):
+        self.set_frame_size(value)
+    
+    @property
+    def contrast(self):
+        return self.get_contrast()
+    @contrast.setter
+    def contrast(self, value):
+        self.set_contrast(value)
+    
+    @property
+    def brightness(self):
+        return self.get_brightness()
+    @brightness.setter
+    def brightness(self, value):
+        self.set_brightness(value)
+    
+    @property
+    def saturation(self):
+        return self.get_saturation()
+    @saturation.setter
+    def saturation(self, value):
+        self.set_saturation(value)
+    
+    @property
+    def sharpness(self):
+        return self.get_sharpness()
+    @sharpness.setter
+    def sharpness(self, value):
+        self.set_sharpness(value)
+    
+    @property
+    def denoise(self):
+        return self.get_denoise()
+    @denoise.setter
+    def denoise(self, value):
+        self.set_denoise(value)
+    
+    @property
+    def gainceiling(self):
+        return self.get_gainceiling()
+    @gainceiling.setter
+    def gainceiling(self, value):
+        self.set_gainceiling(value)
+    
+    @property
+    def quality(self):
+        return self.get_quality()
+    @quality.setter
+    def quality(self, value):
+        self.set_quality(value)
+    
+    @property
+    def colorbar(self):
+        return self.get_colorbar()
+    @colorbar.setter
+    def colorbar(self, value):
+        self.set_colorbar(value)
+    
+    @property
+    def whitebal(self):
+        return self.get_whitebal()
+    @whitebal.setter
+    def whitebal(self, value):
+        self.set_whitebal(value)
+    
+    @property
+    def gain_ctrl(self):
+        return self.get_gain_ctrl()
+    @gain_ctrl.setter
+    def gain_ctrl(self, value):
+        self.set_gain_ctrl(value)
+    
+    @property
+    def exposure_ctrl(self):
+        return self.get_exposure_ctrl()
+    @exposure_ctrl.setter
+    def exposure_ctrl(self, value):
+        self.set_exposure_ctrl(value)
+    
+    @property
+    def hmirror(self):
+        return self.get_hmirror()
+    @hmirror.setter
+    def hmirror(self, value):
+        self.set_hmirror(value)
+    
+    @property
+    def vflip(self):
+        return self.get_vflip()
+    @vflip.setter
+    def vflip(self, value):
+        self.set_vflip(value)
+    
+    @property
+    def aec2(self):
+        return self.get_aec2()
+    @aec2.setter
+    def aec2(self, value):
+        self.set_aec2(value)
+    
+    @property
+    def awb_gain(self):
+        return self.get_awb_gain()
+    @awb_gain.setter
+    def awb_gain(self, value):
+        self.set_awb_gain(value)
+    
+    @property
+    def agc_gain(self):
+        return self.get_agc_gain()
+    @agc_gain.setter
+    def agc_gain(self, value):
+        self.set_agc_gain(value)
+    
+    @property
+    def aec_value(self):
+        return self.get_aec_value()
+    @aec_value.setter
+    def aec_value(self, value):
+        self.set_aec_value(value)
+    
+    @property
+    def special_effect(self):
+        return self.get_special_effect()
+    @special_effect.setter
+    def special_effect(self, value):
+        self.set_special_effect(value)
+    
+    @property
+    def wb_mode(self):
+        return self.get_wb_mode()
+    @wb_mode.setter
+    def wb_mode(self, value):
+        self.set_wb_mode(value)
+    
+    @property
+    def ae_level(self):
+        return self.get_ae_level()
+    @ae_level.setter
+    def ae_level(self, value):
+        self.set_ae_level(value)
+    
+    @property
+    def dcw(self):
+        return self.get_dcw()
+    @dcw.setter
+    def dcw(self, value):
+        self.set_dcw(value)
+    
+    @property
+    def bpc(self):
+        return self.get_bpc()
+    @bpc.setter
+    def bpc(self, value):
+        self.set_bpc(value)
+    
+    @property
+    def wpc(self):
+        return self.get_wpc()
+    @wpc.setter
+    def wpc(self, value):
+        self.set_wpc(value)
+    
+    @property
+    def raw_gma(self):
+        return self.get_raw_gma()
+    @raw_gma.setter
+    def raw_gma(self, value):
+        self.set_raw_gma(value)
+    
+    @property
+    def lenc(self):
+        return self.get_lenc()
+    @lenc.setter
+    def lenc(self, value):
+        self.set_lenc(value)
+    
 __all__ = ['Camera', 'FrameSize', 'PixelFormat', 'GainCeiling', 'GrabMode']

src/modcamera_api.c

@@ -518,15 +518,13 @@ static void camera_obj_property(mp_obj_t self_in, qstr attr, mp_obj_t *dest) {
 // Camera sensor property functions
 #define CREATE_GETTER(property, get_function) \
     static mp_obj_t camera_get_##property(const mp_obj_t self_in) { \
-        mp_warning(NULL, "get_" #property "() is deprecated. Use the " #property " property instead."); \
         mp_camera_obj_t *self = MP_OBJ_TO_PTR(self_in); \
         return get_function(mp_camera_hal_get_##property(self)); \
     } \
     static MP_DEFINE_CONST_FUN_OBJ_1(camera_get_##property##_obj, camera_get_##property);
 
 #define CREATE_SETTER(property, set_conversion) \
     static mp_obj_t camera_set_##property(const mp_obj_t self_in, const mp_obj_t arg) { \
-        mp_warning(NULL, "set_" #property "() is deprecated. Use the " #property " property instead."); \
         mp_camera_obj_t *self = MP_OBJ_TO_PTR(self_in); \
         mp_camera_hal_set_##property(self, set_conversion(arg)); \
         if (mp_camera_hal_get_##property(self) != set_conversion(arg)) { \