ある範囲の数値を別の範囲に再マッピングします。
例えば、map(2, 0, 10, 0, 100)
を呼び出すと20が返されます。最初の3つの 引数は元の値を2に設定し、元の範囲を0から10に設定します。 最後の2つの引数は目標範囲を0から100に設定します。20の目標範囲[0, 100]における 位置は、2の元の範囲[0, 10]における位置に比例しています。
6番目のパラメータwithinBounds
はオプションです。デフォルトでは、map()
は 目標範囲外の値を返すことができます。例えば、 map(11, 0, 10, 0, 100)
は110を返します。6番目のパラメータとしてtrue
を渡すと、 再マッピングされた値を目標範囲内に制限します。例えば、 map(11, 0, 10, 0, 100, true)
は100を返します。
実例
シンタックス
map(value, start1, stop1, start2, stop2, [withinBounds])
パラメーター
value
Number:
再マッピングする値。
start1
Number:
現在の値の範囲の下限。
stop1
Number:
現在の値の範囲の上限。
start2
Number:
目標範囲の下限。
stop2
Number:
目標範囲の上限。
withinBounds
Boolean:
値を新しくマッピングされた範囲内に制限します。
リターン
Number: 再マッピングされた数値。
Notice any errors or typos? Please let us know. Please feel free to edit src/math/calculation.js and open a pull request!