setters: SetHmirror SetVflip

refs #55

Author: yoursunny

examples/AsyncCam/handlers.cpp

@@ -11,6 +11,10 @@ Resolution
 <select id="resolution" required>%RESOLUTION_OPTIONS%</select>
 <input type="submit" value="change">
 </p></form>
+<p id="toggles">
+<label><input type="checkbox" data-act="hmirror">hmirror</label>
+<label><input type="checkbox" data-act="vflip">vflip</label>
+</p>
 <p id="controls">
 <button data-act="mjpeg">show Motion JPEG stream</button>
 <button data-act="jpg">show still JPEG image</button>
@@ -34,7 +38,7 @@ const $resolution = document.querySelector("#resolution");
   evt.preventDefault();
   const [width, height] = $resolution.value.split("x");
   try {
-    const change = await fetchText("/change-resolution.cgi", {
+    await fetchText("/change-resolution.cgi", {
       method: "POST",
       body: new URLSearchParams({ width, height }),
     });
@@ -43,6 +47,21 @@ const $resolution = document.querySelector("#resolution");
   }
 });
 
+for (const $ctrl of document.querySelectorAll("#toggles input[type=checkbox]")) {
+  $ctrl.addEventListener("change", async (evt) => {
+    evt.preventDefault();
+    const act = evt.target.getAttribute("data-act");
+    try {
+      await fetchText(`/set-${act}.cgi`, {
+        method: "POST",
+        body: new URLSearchParams({ enable: Number(evt.target.checked) }),
+      });
+    } catch (err) {
+      $display.textContent = err.toString();
+    }
+  });
+}
+
 for (const $ctrl of document.querySelectorAll("#controls button")) {
   $ctrl.addEventListener("click", (evt) => {
     evt.preventDefault();
@@ -116,6 +135,26 @@ addRequestHandlers() {
     request->send(200, "text/plain", static_cast<String>(b));
   });
 
+  server.on("/set-hmirror.cgi", HTTP_POST, [](AsyncWebServerRequest* request) {
+    long enable = request->arg("enable").toInt();
+    if (!esp32cam::Camera.update(esp32cam::SetHmirror(enable != 0))) {
+      request->send(500, "text/plain", "SetHmirror error\n");
+      return;
+    }
+    Serial.printf("SetHmirror(%ld) success\n", enable);
+    request->send(200, "text/plain", "SetHmirror success\n");
+  });
+
+  server.on("/set-vflip.cgi", HTTP_POST, [](AsyncWebServerRequest* request) {
+    long enable = request->arg("enable").toInt();
+    if (!esp32cam::Camera.update(esp32cam::SetVflip(enable != 0))) {
+      request->send(500, "text/plain", "SetVflip error\n");
+      return;
+    }
+    Serial.printf("SetVflip(%ld) success\n", enable);
+    request->send(200, "text/plain", "SetVflip success\n");
+  });
+
   server.on("/cam.jpg", esp32cam::asyncweb::handleStill);
   server.on("/cam.mjpeg", esp32cam::asyncweb::handleMjpeg);
 }

src/esp32cam/camera.cpp

@@ -54,6 +54,15 @@ CameraClass::changeResolution(const Resolution& resolution, int sleepFor) {
   return true;
 }
 
+bool
+CameraClass::update(const SensorSetter& setter) {
+  sensor_t* sensor = esp_camera_sensor_get();
+  if (sensor == nullptr) {
+    return false;
+  }
+  return setter(sensor);
+}
+
 std::unique_ptr<Frame>
 CameraClass::capture() {
   camera_fb_t* fb = esp_camera_fb_get();

src/esp32cam/camera.hpp

@@ -3,6 +3,7 @@
 
 #include "config.hpp"
 #include "mjpeg.hpp"
+#include "setters.hpp"
 
 namespace esp32cam {
 
@@ -34,6 +35,18 @@ class CameraClass {
    */
   bool changeResolution(const Resolution& resolution, int sleepFor = 500);
 
+  /**
+   * @brief Update camera configuration.
+   * @param setter See `setters.hpp`.
+   * @return whether success.
+   *
+   * Example:
+   * @code
+   * bool ok = Camera.update(SetVflip(true));
+   * @endcode
+   */
+  bool update(const SensorSetter& setter);
+
   /**
    * @brief Capture a frame of picture.
    * @pre Camera is enabled.

src/esp32cam/setters.cpp

@@ -0,0 +1,23 @@
+#include "setters.hpp"
+#include <esp_camera.h>
+
+namespace esp32cam {
+
+SensorSetterInt::SensorSetterInt(size_t fn, int value)
+  : m_fn(fn)
+  , m_value(value) {}
+
+bool
+SensorSetterInt::operator()(sensor_t* sensor) const {
+  using Fn = int (*)(sensor_t*, int);
+  Fn* fn = reinterpret_cast<Fn*>(reinterpret_cast<uintptr_t>(sensor) + m_fn);
+  return (*fn)(sensor, m_value) == 0;
+}
+
+SetHmirror::SetHmirror(bool enable)
+  : SensorSetterInt(offsetof(sensor_t, set_hmirror), static_cast<int>(enable)) {}
+
+SetVflip::SetVflip(bool enable)
+  : SensorSetterInt(offsetof(sensor_t, set_vflip), static_cast<int>(enable)) {}
+
+} // namespace esp32cam

src/esp32cam/setters.hpp

@@ -0,0 +1,51 @@
+#ifndef ESP32CAM_SETTERS_HPP
+#define ESP32CAM_SETTERS_HPP
+
+#include <cstddef>
+
+extern "C" {
+typedef struct _sensor sensor_t;
+} // extern "C"
+
+namespace esp32cam {
+
+class SensorSetter {
+public:
+  virtual ~SensorSetter() {}
+
+  virtual bool operator()(sensor_t* sensor) const = 0;
+};
+
+class SensorSetterInt : public SensorSetter {
+public:
+  bool operator()(sensor_t* sensor) const override;
+
+protected:
+  explicit SensorSetterInt(size_t fn, int value);
+
+private:
+  size_t m_fn;
+  int m_value;
+};
+
+/**
+ * @brief Enable or disable horizontal flip.
+ * @sa Camera.update()
+ */
+class SetHmirror : public SensorSetterInt {
+public:
+  explicit SetHmirror(bool enable);
+};
+
+/**
+ * @brief Enable or disable vertical flip.
+ * @sa Camera.update()
+ */
+class SetVflip : public SensorSetterInt {
+public:
+  explicit SetVflip(bool enable);
+};
+
+} // namespace esp32cam
+
+#endif // ESP32CAM_SETTERS_HPP