pxt-calliope/docs/reference/input/magnetic-force.md

43 lines
941 B
Markdown
Raw Normal View History

2016-03-26 00:47:20 +01:00
# Magnetic Force
Find the amount of magnetic force (the strength of a magnet) in the direction you say.
2016-03-26 00:47:20 +01:00
```sig
input.magneticForce(Dimension.X);
```
## ~hint
The micro:bit measures magnetic force with **microteslas**.
## ~
2016-03-26 00:47:20 +01:00
### Parameters
2016-07-15 23:53:52 +02:00
* ``dimension`` means which direction the micro:bit should measure
magnetic force in: either `Dimension.X` (the left-right direction),
`Dimension.Y` (the forward/backward direction), or `Dimension.Z`
(the up/down direction)
2016-03-26 00:47:20 +01:00
### Returns
* a [number](/reference/types/number) of microteslas that means the strength of the magnet
2016-03-26 00:47:20 +01:00
### Example: metal detector
This program makes the center LED of the micro:bit get brighter when
the magnetic force is stronger, and dimmer when it is weaker.
2016-03-26 00:47:20 +01:00
```blocks
led.plot(2, 2)
basic.forever(() => {
let f = input.magneticForce(Dimension.X)
2016-03-26 00:47:20 +01:00
led.setBrightness(f / 2000)
})
```
### See also
2016-04-18 18:47:34 +02:00
[compass heading](/reference/input/compass-heading)