pxt-calliope/docs/reference/input/rotation.md
2016-03-25 16:47:20 -07:00

49 lines
1.2 KiB
Markdown

# Rotation
Get a rotation angle in degrees inferred from the accelerometer readings.
```sig
input.rotation(Rotation.Roll);
```
### Parameters
* kind: [String](/microbit/reference/types/string) - one of values specifying the kind of rotation: ``pitch`` (up/down around the ``x`` axis); ``roll`` (left/right around the ``y`` axis)
### Returns
* [Number](/microbit/reference/types/number) - angle, in degrees.
### Example: micro:bit leveller
The following example uses the `rotation` and the `plot leds` function to help you move the BBC micro:bit until it's level: when it is level, a smiley shows up on the screen. When running this code in a web browser, move your mouse to simulate the rotation.
```sig
basic.forever(() => {
let pitch = input.rotation(Rotation.Pitch)
let roll = input.rotation(Rotation.Roll)
if (Math.abs(pitch) < 10 && Math.abs(roll) < 10) {
basic.plotLeds(`
. . . . .
. # . # .
. . . . .
# . . . #
. # # # .
`)
} else {
basic.plotLeds(`
# . . . #
. # . # .
. . # . .
. # . # .
# . . . #
`)
}
})
```
### See also
[acceleration](/microbit/reference/input/acceleration), [compass-heading](/microbit/reference/input/compass-heading)