ScaleLinear
A linear continuous scale defined over a numeric domain.
Continuous scales map a continuous, quantitative input domain to a continuous output range. Each range value y can be expressed as a function of the domain value x: y = mx + b.
If the range is also numeric, the mapping may be inverted.
Note that the data types of the range and output of the scale must be compatible with the interpolator applied by the scale.
The first generic corresponds to the data type of the range elements.
The second generic corresponds to the data type of the output elements generated by the scale.
The third generic corresponds to the data type of the unknown value.
If range element and output element type differ, the interpolator factory used with the scale must match this behavior and convert the interpolated range element to a corresponding output element.
§Extends
§Methods
Returns the scale’s current interpolator factory, which defaults to interpolate.
Sets the scale’s range interpolator factory. This interpolator factory is used to create interpolators for each adjacent pair of values from the range; these interpolators then map a normalized domain parameter t in [0, 1] to the corresponding value in the range.
Note: the default interpolator may reuse return values. For example, if the range values are objects, then the value interpolator always returns the same object, modifying it in-place. If the scale is used to set an attribute or style, this is typically acceptable (and desirable for performance); however, if you need to store the scale’s return value, you must specify your own interpolator or make a copy as appropriate.
As part of the interpolation process the interpolated value from the range may be converted to a corresponding output value.
An interpolation factory. The generics for Range and Output of the scale must correspond to the interpolation factory applied to the scale.
Sets the scale’s range interpolator factory. This interpolator factory is used to create interpolators for each adjacent pair of values from the range; these interpolators then map a normalized domain parameter t in [0, 1] to the corresponding value in the range.
Note: the default interpolator may reuse return values. For example, if the range values are objects, then the value interpolator always returns the same object, modifying it in-place. If the scale is used to set an attribute or style, this is typically acceptable (and desirable for performance); however, if you need to store the scale’s return value, you must specify your own interpolator or make a copy as appropriate.
As part of the interpolation process the interpolated value from the range may be converted to a corresponding output value.
The generic "NewOutput" can be used to change the scale to have a different output element type corresponding to the new interpolation factory.
An interpolation factory. The generics for Range and Output of the scale must correspond to the interpolation factory applied to the scale.
Returns the current unknown value, which defaults to undefined.