pxt-calliope/docs/reference/input/acceleration.md

43 lines
1.1 KiB
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Acceleration
Get the acceleration value (milli g-force), in one of three specified dimensions.
Find the acceleration of the micro:bit (how fast it is speeding up or slowing down).
2016-03-26 00:47:20 +01:00
```sig
input.acceleration(Dimension.X);
```
## ~hint
2016-03-26 00:47:20 +01:00
You measure acceleration with the **milli-g**, which is 1/1000 of a **g**.
A **g** is as much acceleration as you get from Earth's gravity.
2016-03-26 00:47:20 +01:00
## ~
2016-03-26 00:47:20 +01:00
### Parameters
2016-03-26 00:47:20 +01:00
* which direction you are checking for acceleration, either `Dimension.X` (left and right), `Dimension.Y` (forward and backward), or `Dimension.Z` (up and down)
### Returns
* a [number](/reference/types/number) that means the amount of acceleration. When the micro:bit is lying flat on a surface with the screen pointing up, `x` is `0`, `y` is `0`, and `z` is `-1023`.
2016-03-26 00:47:20 +01:00
### Example: bar chart
2016-03-26 00:47:20 +01:00
This example shows the acceleration of the micro:bit with a bar graph.
2016-03-26 00:47:20 +01:00
```blocks
basic.forever(() => {
led.plotBarGraph(input.acceleration(Dimension.X), 1023)
2016-03-26 00:47:20 +01:00
})
```
### See also
2016-06-15 14:09:40 +02:00
[compass-heading](/reference/input/compass-heading), [lightlevel](/reference/input/light-level)
2016-03-26 00:47:20 +01:00