Artifact
a0e1a757d3c6a0a211409014466c9c4f0314b22d19827d923f8087ade6357e72:
0000: 27 75 73 65 20 73 74 72 69 63 74 27 3b 0a 0a 6c 'use strict';..l
0010: 65 74 20 6d 61 74 68 20 3d 20 72 65 71 75 69 72 et math = requir
0020: 65 28 27 2e 2e 2f 75 74 69 6c 2f 6d 61 74 68 27 e('../util/math'
0030: 29 3b 0a 0a 2f 2a 2a 0a 20 20 43 72 65 61 74 65 );../**. Create
0040: 73 20 61 20 73 74 65 70 70 61 62 6c 65 20 76 61 s a steppable va
0050: 6c 75 65 20 77 69 74 68 20 6d 69 6e 69 6d 75 6d lue with minimum
0060: 2c 20 6d 61 78 69 6d 75 6d 2c 20 61 6e 64 20 73 , maximum, and s
0070: 74 65 70 20 73 69 7a 65 2e 20 54 68 69 73 20 69 tep size. This i
0080: 73 20 75 73 65 64 20 69 6e 20 6d 61 6e 79 20 69 s used in many i
0090: 6e 74 65 72 66 61 63 65 73 20 74 6f 20 63 6f 6e nterfaces to con
00a0: 73 74 72 69 63 74 20 74 68 65 69 72 20 76 61 6c strict their val
00b0: 75 65 73 20 74 6f 20 63 65 72 74 61 69 6e 20 72 ues to certain r
00c0: 61 6e 67 65 73 2e 0a 20 20 40 70 61 72 61 6d 20 anges.. @param
00d0: 7b 6e 75 6d 62 65 72 7d 20 5b 6d 69 6e 3d 30 5d {number} [min=0]
00e0: 20 6d 69 6e 69 6d 75 6d 0a 20 20 40 70 61 72 61 minimum. @para
00f0: 6d 20 7b 6e 75 6d 62 65 72 7d 20 5b 6d 61 78 3d m {number} [max=
0100: 31 5d 20 6d 61 78 69 6d 75 6d 0a 20 20 40 70 61 1] maximum. @pa
0110: 72 61 6d 20 7b 6e 75 6d 62 65 72 7d 20 5b 73 74 ram {number} [st
0120: 65 70 3d 30 5d 0a 20 20 40 70 61 72 61 6d 20 7b ep=0]. @param {
0130: 6e 75 6d 62 65 72 7d 20 5b 76 61 6c 75 65 3d 30 number} [value=0
0140: 5d 20 69 6e 69 74 69 61 6c 20 76 61 6c 75 65 0a ] initial value.
0150: 20 20 40 72 65 74 75 72 6e 73 20 7b 4f 62 6a 65 @returns {Obje
0160: 63 74 7d 20 53 74 65 70 0a 2a 2f 0a 0a 65 78 70 ct} Step.*/..exp
0170: 6f 72 74 20 64 65 66 61 75 6c 74 20 63 6c 61 73 ort default clas
0180: 73 20 53 74 65 70 20 7b 0a 0a 20 20 63 6f 6e 73 s Step {.. cons
0190: 74 72 75 63 74 6f 72 28 6d 69 6e 20 3d 20 30 2c tructor(min = 0,
01a0: 6d 61 78 20 3d 20 31 2c 73 74 65 70 20 3d 20 30 max = 1,step = 0
01b0: 2c 76 61 6c 75 65 20 3d 20 30 29 20 7b 0a 20 20 ,value = 0) {.
01c0: 20 20 2f 2f 4f 62 6a 65 63 74 2e 61 73 73 69 67 //Object.assig
01d0: 6e 28 74 68 69 73 2c 7b 6d 69 6e 2c 6d 61 78 2c n(this,{min,max,
01e0: 73 74 65 70 7d 29 3b 0a 20 20 20 20 2f 2f 43 61 step});. //Ca
01f0: 6e 6e 6f 74 20 75 73 65 20 4f 62 6a 65 63 74 2e nnot use Object.
0200: 61 73 73 69 67 6e 20 62 65 63 61 75 73 65 20 6e assign because n
0210: 6f 74 20 73 75 70 70 6f 72 74 65 64 20 69 6e 20 ot supported in
0220: 53 61 66 61 72 69 2e 0a 20 20 20 20 2f 2f 49 20 Safari.. //I
0230: 77 6f 75 6c 64 20 65 78 70 65 63 74 20 66 6f 72 would expect for
0240: 20 42 61 62 65 6c 20 74 6f 20 74 61 6b 65 20 63 Babel to take c
0250: 61 72 65 20 6f 66 20 74 68 69 73 20 62 75 74 20 are of this but
0260: 69 74 20 69 73 20 6e 6f 74 2e 0a 20 20 20 20 74 it is not.. t
0270: 68 69 73 2e 6d 69 6e 20 3d 20 6d 69 6e 3b 0a 20 his.min = min;.
0280: 20 20 20 74 68 69 73 2e 6d 61 78 20 3d 20 6d 61 this.max = ma
0290: 78 3b 0a 20 20 20 20 74 68 69 73 2e 73 74 65 70 x;. this.step
02a0: 20 3d 20 73 74 65 70 3b 0a 20 20 20 20 74 68 69 = step;. thi
02b0: 73 2e 76 61 6c 75 65 20 3d 20 76 61 6c 75 65 3b s.value = value;
02c0: 0a 20 20 20 20 74 68 69 73 2e 63 68 61 6e 67 65 . this.change
02d0: 64 20 3d 20 66 61 6c 73 65 3b 0a 20 20 20 20 74 d = false;. t
02e0: 68 69 73 2e 6f 6c 64 56 61 6c 75 65 20 3d 20 66 his.oldValue = f
02f0: 61 6c 73 65 3b 0a 20 20 20 20 74 68 69 73 2e 75 alse;. this.u
0300: 70 64 61 74 65 28 74 68 69 73 2e 76 61 6c 75 65 pdate(this.value
0310: 29 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 2a 0a 20 20 );. }.. /**.
0320: 20 20 55 70 64 61 74 65 20 77 69 74 68 20 61 20 Update with a
0330: 6e 65 77 20 76 61 6c 75 65 2e 20 54 68 65 20 76 new value. The v
0340: 61 6c 75 65 20 77 69 6c 6c 20 62 65 20 61 75 74 alue will be aut
0350: 6f 2d 61 64 6a 75 73 74 65 64 20 74 6f 20 66 69 o-adjusted to fi
0360: 74 20 74 68 65 20 6d 69 6e 2f 6d 61 78 2f 73 74 t the min/max/st
0370: 65 70 2e 0a 20 20 20 20 40 70 61 72 61 6d 20 7b ep.. @param {
0380: 6e 75 6d 62 65 72 7d 20 76 61 6c 75 65 0a 20 20 number} value.
0390: 2a 2f 0a 0a 20 20 75 70 64 61 74 65 28 76 61 6c */.. update(val
03a0: 75 65 29 20 7b 0a 20 20 20 20 69 66 20 28 74 68 ue) {. if (th
03b0: 69 73 2e 73 74 65 70 29 20 7b 0a 20 20 20 20 20 is.step) {.
03c0: 20 2f 2f 20 74 68 69 73 2e 76 61 6c 75 65 20 3d // this.value =
03d0: 20 6d 61 74 68 2e 63 6c 69 70 28 4d 61 74 68 2e math.clip(Math.
03e0: 72 6f 75 6e 64 28 76 61 6c 75 65 20 2f 20 28 74 round(value / (t
03f0: 68 69 73 2e 73 74 65 70 29 29 20 2a 20 74 68 69 his.step)) * thi
0400: 73 2e 73 74 65 70 2c 20 74 68 69 73 2e 6d 69 6e s.step, this.min
0410: 2c 74 68 69 73 2e 6d 61 78 29 3b 0a 20 20 20 20 ,this.max);.
0420: 20 20 74 68 69 73 2e 76 61 6c 75 65 20 3d 20 6d this.value = m
0430: 61 74 68 2e 63 6c 69 70 28 4d 61 74 68 2e 72 6f ath.clip(Math.ro
0440: 75 6e 64 28 28 76 61 6c 75 65 2d 74 68 69 73 2e und((value-this.
0450: 6d 69 6e 29 20 2f 20 28 74 68 69 73 2e 73 74 65 min) / (this.ste
0460: 70 29 29 20 2a 20 74 68 69 73 2e 73 74 65 70 20 p)) * this.step
0470: 2b 20 74 68 69 73 2e 6d 69 6e 2c 20 74 68 69 73 + this.min, this
0480: 2e 6d 69 6e 2c 74 68 69 73 2e 6d 61 78 29 3b 0a .min,this.max);.
0490: 20 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 } else {.
04a0: 20 20 20 74 68 69 73 2e 76 61 6c 75 65 20 3d 20 this.value =
04b0: 6d 61 74 68 2e 63 6c 69 70 28 76 61 6c 75 65 2c math.clip(value,
04c0: 74 68 69 73 2e 6d 69 6e 2c 74 68 69 73 2e 6d 61 this.min,this.ma
04d0: 78 29 3b 0a 20 20 20 20 7d 0a 20 20 20 20 69 66 x);. }. if
04e0: 20 28 74 68 69 73 2e 6f 6c 64 56 61 6c 75 65 20 (this.oldValue
04f0: 21 3d 3d 20 74 68 69 73 2e 76 61 6c 75 65 29 20 !== this.value)
0500: 7b 0a 20 20 20 20 20 20 74 68 69 73 2e 6f 6c 64 {. this.old
0510: 56 61 6c 75 65 20 3d 20 74 68 69 73 2e 76 61 6c Value = this.val
0520: 75 65 3b 0a 20 20 20 20 20 20 74 68 69 73 2e 63 ue;. this.c
0530: 68 61 6e 67 65 64 20 3d 20 74 72 75 65 3b 0a 20 hanged = true;.
0540: 20 20 20 7d 20 65 6c 73 65 20 7b 0a 20 20 20 20 } else {.
0550: 20 20 74 68 69 73 2e 63 68 61 6e 67 65 64 20 3d this.changed =
0560: 20 66 61 6c 73 65 3b 0a 20 20 20 20 7d 0a 20 20 false;. }.
0570: 20 20 72 65 74 75 72 6e 20 74 68 69 73 2e 76 61 return this.va
0580: 6c 75 65 3b 0a 20 20 7d 0a 0a 20 20 2f 2a 2a 0a lue;. }.. /**.
0590: 20 20 20 20 55 70 64 61 74 65 20 77 69 74 68 20 Update with
05a0: 61 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 76 61 6c a normalized val
05b0: 75 65 20 30 2d 31 2e 0a 20 20 20 20 40 70 61 72 ue 0-1.. @par
05c0: 61 6d 20 7b 6e 75 6d 62 65 72 7d 20 76 61 6c 75 am {number} valu
05d0: 65 0a 20 20 2a 2f 0a 20 20 75 70 64 61 74 65 4e e. */. updateN
05e0: 6f 72 6d 61 6c 28 76 61 6c 75 65 29 20 7b 0a 20 ormal(value) {.
05f0: 20 20 20 74 68 69 73 2e 76 61 6c 75 65 20 3d 20 this.value =
0600: 6d 61 74 68 2e 73 63 61 6c 65 28 76 61 6c 75 65 math.scale(value
0610: 2c 30 2c 31 2c 74 68 69 73 2e 6d 69 6e 2c 74 68 ,0,1,this.min,th
0620: 69 73 2e 6d 61 78 29 3b 0a 20 20 20 20 72 65 74 is.max);. ret
0630: 75 72 6e 20 74 68 69 73 2e 75 70 64 61 74 65 28 urn this.update(
0640: 74 68 69 73 2e 76 61 6c 75 65 29 3b 0a 20 20 7d this.value);. }
0650: 0a 0a 20 20 2f 2a 2a 0a 20 20 20 20 47 65 74 20 .. /**. Get
0660: 61 20 6e 6f 72 6d 61 6c 69 7a 65 64 20 76 65 72 a normalized ver
0670: 73 69 6f 6e 20 6f 66 20 74 68 69 73 2e 76 61 6c sion of this.val
0680: 75 65 20 2e 20 4e 6f 74 20 73 65 74 74 61 62 6c ue . Not settabl
0690: 65 2e 0a 20 20 2a 2f 0a 20 20 67 65 74 20 6e 6f e.. */. get no
06a0: 72 6d 61 6c 69 7a 65 64 28 29 20 7b 0a 20 20 20 rmalized() {.
06b0: 20 72 65 74 75 72 6e 20 6d 61 74 68 2e 6e 6f 72 return math.nor
06c0: 6d 61 6c 69 7a 65 28 74 68 69 73 2e 76 61 6c 75 malize(this.valu
06d0: 65 2c 74 68 69 73 2e 6d 69 6e 2c 74 68 69 73 2e e,this.min,this.
06e0: 6d 61 78 29 3b 0a 20 20 7d 0a 0a 7d 0a max);. }..}.