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
Number:

el valor que se va a reasignar.

start1
Number:

límite inferior del rango original.

stop1
Number:

límite superior del rango original.

start2
Number:

límite inferior del rango objetivo.

stop2
Number:

límite superior del rango objetivo.

withinBounds
Boolean:

restringe el valor al rango recién asignado.

Returns

Number: número reasignado.
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