pxt-calliope/docs/reference/pins/map.md
Sam El-Husseini e3975e65e5 pxt-microbit Accessibility PR ()
* Accessibility changes
2017-09-07 13:42:08 -07:00

1.2 KiB

Map

Remaps the specified value from one range to another. This function maps the value of from low to the value of to low, the value of from high to the value of to high, and intermediate values to intermediate values.

This function does not constrain values to the ranges, because out-of-range values are sometimes intended and useful. If you need to limit a range, you can use the Math.clamp function before or after calling this function.

pins.map(0, 0, 4, 0, 1023);

Parameters

  • value: a number that specifies the value to map
  • fromLow: a number that specifies the lower bound of the origin interval
  • fromHigh: a number that specifies the upper bound of the origin interval
  • toLow: a number that specifies the lower bound of the target interval
  • toHigh: a number that specifies the upper bound of the target interval

Example

This example maps the value read from the analog pin P0 to an LED coordinate between 0 and 4.

let value1 = pins.analogReadPin(AnalogPin.P0)
let index = pins.map(value1, 0, 1023, 0, 4)
led.plot(0, index)

See also

analog read pin