map()

한 범위에서 다른 범위로 숫자를 다시 매핑합니다.

예를 들어, map(2, 0, 10, 0, 100)를 호출하면 20을 반환합니다. 처음 세 매개변수는 원래 값을 2로, 원래의 범위를 0에서 10으로 설정합니다. 마지막 두 매개변수는 목표 범위를 0에서 100으로 설정합니다. 목표 범위인 [0, 100]에서 20의 위치는 원래의 범위인 [0, 10]에서 2의 위치에 비례합니다.

여섯번째 매개변수인 withinBounds는 선택 사항입니다. 기본적으로 map()은 목표 범위를 벗어난 값을 반환할 수 있습니다. 예를 들어, map(11, 0, 10, 0, 100)는 110을 반환합니다. true를 여섯번째 매개변수에 전달하면 목표 범위로 다시 매핑된 값을 제한할 수 있습니다. 예를 들어, map(11, 0, 10, 0, 100, true)는 100을 반환합니다.

예제

구문

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

매개변수

value
Number:

다시 매핑될 값

start1
Number:

현재 범위의 하계 (lower bound)

stop1
Number:

현재 범위의 상계 (upper bound)

start2
Number:

목표 범위의 하계 (lower bound)

stop2
Number:

목표 범위의 상계 (upper bound)

withinBounds
Boolean:

새롭게 매핑된 범위에서의 값 제한

Returns

Number: 다시 매핑된 숫자
Notice any errors or typos? Please let us know. Please feel free to edit src/math/calculation.js and open a pull request!

관련 레퍼런스