map()

map() reasigna un número que se encuentra en un rango inicial, dentro de un nuevo rango.

Por ejemplo, si llamamos map(2, 0, 10, 0, 100) obtenemos 20 como resultado. Los primeros tres argumentos definen el valor de 2 dentro del rango original que va de 0 a 10. Los últimos dos argumentos definen el nuevo rango, que va de 0 a 100. La posición de 20 en el rango [0, 100] es proporcional a la posición de 2 en el rango original [0, 10].

map() puede tomar un sexto argumento, el cual es opcional. Por defecto, map() puede devolver valores que se encuentran fuera del rango objetivo. Por ejemplo, si llamamos map(11, 0, 10, 0, 100) obtenemos 110 como resultado, a pesar de que está fuera del rango [0, 100]. Cuando pasamos true como sexto parámetro, estamos restringiendo el valor dentro del rango objetivo. Entonces, si llamamos map(11, 0, 10, 0, 100, true), obtenemos 100 como resultado.

Ejemplos

Sintaxis

map(value, start1, stop1, start2, stop2, [withinBounds])

Parámetros

value

el valor que se va a reasignar.

start1

límite inferior del rango original.

stop1

límite superior del rango original.

start2

límite inferior del rango objetivo.

stop2

límite superior del rango objetivo.

withinBounds

restringe el valor al rango recién asignado.

Notice any errors or typos? Please let us know. Please feel free to edit src/math/calculation.js and open a pull request!

Referencias Relacionadas