Skip to content

Commit

Permalink
Add Device Motion package
Browse files Browse the repository at this point in the history
Introduces smart-phone device's acceleration, gravity, rotation, and orientation signals for dynamic pattern creation in Strudel.
  • Loading branch information
nkymut committed Nov 21, 2024
1 parent 726abf7 commit f33ec0e
Show file tree
Hide file tree
Showing 7 changed files with 495 additions and 1 deletion.
66 changes: 66 additions & 0 deletions packages/motion/README.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,66 @@
# @strudel/motion

This package adds device motion sensing functionality to strudel Patterns.

## Install

```sh
npm i @strudel/motion --save
```

## Setup SSL for Local Development
`DeviceMotionEvent` only work over HTTPS, so you'll need to set up SSL for local development.
install SSL plugin for Vite
`pnpm install -D @vitejs/plugin-basic-ssl`

add the basicSsl plugin to the defineConfig block in `strudel/website/astro.config.mjs`
```
vite: {
plugins: [basicSsl()],
server: {
host: '0.0.0.0', // Ensures it binds to all network interfaces
// https: {
// key: '../../key.pem', //
// cert: '../../cert.pem',
// },
},
},
```

generate SSL cert if its necessary

`openssl req -new -newkey rsa:2048 -days 365 -nodes -x509 -keyout key.pem -out cert.pem`

## Usage

| Motion | Long Names & Aliases | Description |
|----------------------------|-----------------------------------------------------------|------------------------------------------|
| Acceleration | accelerationX (accX), accelerationY (accY), accelerationZ (accZ) | X, Y, Z-axis acceleration values |
| Gravity | gravityX (gravX), gravityY (gravY), gravityZ (gravZ) | X, Y, Z-axis gravity values |
| Rotation | rotationAlpha (rotA, rotZ), rotationBeta (rotB, rotX), rotationGamma (rotG, rotY) | Rotation around alpha, beta, gamma axes and mapped to X, Y, Z |
| Orientation | orientationAlpha (oriA, oriZ), orientationBeta (oriB, oriX), orientationGamma (oriG, oriY) | Orientation alpha, beta, gamma values and mapped to X, Y, Z |
| Absolute Orientation | absoluteOrientationAlpha (absOriA, absOriZ), absoluteOrientationBeta (absOriB, absOriX), absoluteOrientationGamma (absOriG, absOriY) | Absolute orientation alpha, beta, gamma values and mapped to X, Y, Z |

## Example

```
enableMotion() //enable DeviceMotion
let tempo = 200
$_: accX.segment(16).gain().log()
$:n("[0 1 3 1 5 4]/4")
.scale("Bb:lydian")
.sometimesBy(0.5,sub(note(12)))
.lpf(gravityY.range(20,1000))
.lpq(gravityZ.range(1,30))
.lpenv(gravityX.range(2,2))
.gain(oriX.range(0.2,0.8))
.room(oriZ.range(0,0.5))
.attack(oriY.range(0,0.3))
.delay(rotG.range(0,1))
.decay(rotA.range(0,1))
.attack(rotB.range(0,0.1))
.sound("sawtooth").cpm(tempo)
```
3 changes: 3 additions & 0 deletions packages/motion/index.mjs
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
import './motion.mjs';

export * from './motion.mjs';
Loading

0 comments on commit f33ec0e

Please sign in to comment.