Merge pull request #3866 from thyttan/msgtwistscroll

msgtwscr: Temporarily activate scroll on twist function when a new message triggers the message app.

apps/msgtwscr/ChangeLog

@@ -0,0 +1 @@
+0.01: New App!

apps/msgtwscr/README.md

@@ -0,0 +1,15 @@
+# Message Twist to Scroll
+
+Temporarily activate scroll on twist function when a new message triggers the message app. This way it's possible to scroll through a message in the message scroller hands free.
+
+## Usage
+
+This is a bootloader app and only needs to be installed to add the functionality to the watch.
+
+## Requests
+
+Mention @thyttan in an issue on the espruino/BangleApps repository.
+
+## Creator
+
+thyttan

apps/msgtwscr/boot.js

@@ -0,0 +1,63 @@
+{
+  // twistThreshold How much acceleration to register a twist of the watch strap? Can be negative for opposite direction. default = 800
+  // twistMaxY Maximum acceleration in Y to trigger a twist (low Y means watch is facing the right way up). default = -800
+  // twistTimeout How little time (in ms) must a twist take from low->high acceleration? default = 1000
+  let onTwistEmitDrag = ()=>{
+    Bangle.setOptions({twistThreshold:2500, twistMaxY:-800, twistTimeout:400});
+    let isTwistDragging = false;
+    let twistHandler = ()=>{
+      if (!isTwistDragging) {
+        isTwistDragging = true;
+        Bangle.setLocked(false);
+        Bangle.setLCDPower(true);
+        let i = 25;
+        const int = setInterval(() => {
+          Bangle.emit("drag", {dy:-3, b:i===0?0:1})
+          i--;
+          if (i<0) {
+            clearInterval(int);
+            isTwistDragging = false;
+          }
+        }, 10);
+      }
+    }
+    Bangle.on("twist", twistHandler);
+    // Give messagegui some extra time to add its remove function to
+    // Bangle.uiRemove, then attach msgtwscr remove logic.
+    setTimeout(
+      ()=>{if (Bangle.uiRemove) {
+        let showMessageUIRemove = Bangle.uiRemove;
+        Bangle.uiRemove = function () {
+          Bangle.removeListener("twist", twistHandler)
+          showMessageUIRemove();
+          // Reset twist drag logic if we go to next message.
+          attachAfterTimeout();
+        }
+      }},
+      800)
+  }
+
+  // If doing regular loads, not Bangle.load, this is used:
+  if (global.__FILE__=="messagegui.new.js") {
+    onTwistEmitDrag();
+  }
+
+  let attachAfterTimeout = ()=>{
+    setTimeout(()=>{
+      if (global.__FILE__=="messagegui.new.js") {
+        onTwistEmitDrag();
+      }
+    },700)
+    // It feels like there's a more elegant solution than checking the filename
+    // after 700 milliseconds. But this at least seems to work w/o sometimes
+    // activating when it shouldn't.
+    // Maybe we could add events for when fast load and/or Bangle.uiRemove occurs?
+    // Then that could be used similarly to boot code and/or the `kill` event.
+  }
+
+  // If Fastload Utils is installed this is used:
+  Bangle.on("message", (_, msg)=>{if (Bangle.CLOCK && msg.new) {
+    attachAfterTimeout();
+  }});
+
+}

apps/msgtwscr/metadata.json

@@ -0,0 +1,13 @@
+{ "id": "msgtwscr",
+  "name": "Message Twist to Scroll",
+  "version":"0.01",
+  "description": "Temporarily activate scroll on twist function when a new message triggers the message app.",
+  "icon": "app.png",
+  "tags": "messages,tweak,scroll",
+  "type": "bootloader",
+  "supports" : ["BANGLEJS2"],
+  "readme": "README.md",
+  "storage": [
+    {"name":"msgtwscr.boot.js","url":"boot.js"}
+  ]
+}