scichart 2.1.2294 → 2.1.2301

package/Charting/Model/BaseHeatmapDataSeries.d.ts

@@ -252,13 +252,13 @@ export declare abstract class BaseHeatmapDataSeries implements IHeatmapSeries {
      * @param colorMap the {@link IColorMapParams} provides properties used to map heatmap Z-values into colors
      * for rendering in SciChart's {@link https://www.scichart.com/javascript-chart-features | Realtime JavaScript Charts}
      */
-    getNormalizedVector(colorMap: IColorMapParams): FloatVector;
+    getNormalizedVector(colorMap: IColorMapParams, fillValuesOutOfRange?: boolean): FloatVector;
     /**
      * Recreates the normalized vector (internally used for drawing heatmap) according to zMin and zMax values
      * @param zMin
      * @param zMax
      */
-    recreateNormalizedVector(zMin: number, zMax: number): void;
+    recreateNormalizedVector(zMin: number, zMax: number, fillValuesOutOfRange?: boolean): void;
     /**
      * Gets the metadata by Y and X indexes
      * @param yIndex The Y index

package/Charting/Model/BaseHeatmapDataSeries.js

@@ -401,7 +401,7 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
      * @param colorMap the {@link IColorMapParams} provides properties used to map heatmap Z-values into colors
      * for rendering in SciChart's {@link https://www.scichart.com/javascript-chart-features | Realtime JavaScript Charts}
      */
-    BaseHeatmapDataSeries.prototype.getNormalizedVector = function (colorMap) {
+    BaseHeatmapDataSeries.prototype.getNormalizedVector = function (colorMap, fillValuesOutOfRange) {
         Guard_1.Guard.notNull(colorMap, "colorMap");
         Guard_1.Guard.argumentIsRealNumber(colorMap.minimum, "colorMap.minimum");
         Guard_1.Guard.argumentIsRealNumber(colorMap.maximum, "colorMap.maximum");
@@ -410,7 +410,7 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
             size !== this.normalizedVector.size() ||
             colorMap.minimum !== this.lastZMin ||
             colorMap.maximum !== this.lastZMax) {
-            this.recreateNormalizedVector(colorMap.minimum, colorMap.maximum);
+            this.recreateNormalizedVector(colorMap.minimum, colorMap.maximum, fillValuesOutOfRange);
             this.lastZMin = colorMap.minimum;
             this.lastZMax = colorMap.maximum;
             this.hasDataChangesProperty = false;
@@ -422,7 +422,7 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
      * @param zMin
      * @param zMax
      */
-    BaseHeatmapDataSeries.prototype.recreateNormalizedVector = function (zMin, zMax) {
+    BaseHeatmapDataSeries.prototype.recreateNormalizedVector = function (zMin, zMax, fillValuesOutOfRange) {
         var size = this.arrayWidth * this.arrayHeight;
         this.normalizedVector.clear();
         this.normalizedVector.resize(size, 0);
@@ -437,7 +437,16 @@ var BaseHeatmapDataSeries = /** @class */ (function () {
         for (var y = 0; y < this.arrayHeight; y++) {
             for (var x = 0; x < this.arrayWidth; x++) {
                 // normalized value from 0..1 = (zValue - zMin) / ((zMax - zMin))
-                var zValue = isNaN(this.zValuesProperty[y][x]) ? 0 : this.zValuesProperty[y][x] - newZMin;
+                var zValue = this.zValuesProperty[y][x] - newZMin;
+                if (isNaN(this.zValuesProperty[y][x])) {
+                    zValue = 0;
+                }
+                else if (zValue < newZMin) {
+                    zValue = fillValuesOutOfRange ? zMin - newZMin : 0;
+                }
+                else if (zValue > zMax - newZMin) {
+                    zValue = fillValuesOutOfRange ? zMax - newZMin : 0;
+                }
                 var normalizedZValue = zValue * normalizationFactor;
                 this.normalizedVector.set(index++, normalizedZValue);
             }

package/Charting/Visuals/RenderableSeries/DrawingProviders/UniformHeatmapDrawingProvider.js

@@ -94,7 +94,7 @@ var UniformHeatmapDrawingProvider = /** @class */ (function (_super) {
         var heatTexture = (_a = this.heatTextureCache) === null || _a === void 0 ? void 0 : _a.value;
         if (heatTexture) {
             var dataSeries = this.parentSeries.dataSeries;
-            var zValuesVector = dataSeries.getNormalizedVector(this.parentSeries.colorMap);
+            var zValuesVector = dataSeries.getNormalizedVector(this.parentSeries.colorMap, this.parentSeries.fillValuesOutOfRange);
             this.packedFloatParams = this.webAssemblyContext.SCRTFillTextureFloat32(heatTexture, dataSeries.arrayWidth, dataSeries.arrayHeight, zValuesVector);
             this.packedFloatParams.x = 0;
             this.packedFloatParams.y = 1;

package/Charting/Visuals/RenderableSeries/UniformHeatmapRenderableSeries.d.ts

@@ -26,6 +26,10 @@ export interface IHeatmapRenderableSeriesOptions extends IBaseRenderableSeriesOp
      * The flag whether to make the heatmap linearly interpolated or smoothed between cells
      */
     useLinearTextureFiltering?: boolean;
+    /**
+     * The flag whether to fill cells with edge color if its value is outside of {@link colorMap.minimum} to {@link colorMap.maximum} range
+     */
+    fillValuesOutOfRange?: boolean;
 }
 /** @ignore */
 export declare const COLOR_MAP_PREFIX = "colorMap.";
@@ -72,6 +76,7 @@ export declare class UniformHeatmapRenderableSeries extends BaseRenderableSeries
     readonly type: ESeriesType;
     private colorMapProperty;
     private useLinearTextureFilteringProperty;
+    private fillValuesOutOfRangeProperty;
     private zLabelProviderProperty;
     /**
      * Creates an instance of the {@link UniformHeatmapRenderableSeries}
@@ -100,6 +105,14 @@ export declare class UniformHeatmapRenderableSeries extends BaseRenderableSeries
     checkIsOutOfDataRange(xValue: number, yValue: number): boolean;
     get zLabelProvider(): LabelProvider;
     set zLabelProvider(labelProvider: LabelProvider);
+    /**
+     * Gets or sets whether to fill cells with edge color if its value is outside of {@link colorMap.minimum} to {@link colorMap.maximum} range
+     */
+    get fillValuesOutOfRange(): boolean;
+    /**
+     * Gets or sets whether to fill cells with edge color if its value is outside of {@link colorMap.minimum} to {@link colorMap.maximum} range
+     */
+    set fillValuesOutOfRange(value: boolean);
     /** @inheritDoc */
     toPointSeries(resamplingParams?: ResamplingParams): IPointSeries;
     /** @inheritDoc */

package/Charting/Visuals/RenderableSeries/UniformHeatmapRenderableSeries.js

@@ -75,10 +75,11 @@ var UniformHeatmapRenderableSeries = /** @class */ (function (_super) {
      * @param options optional parameters of type {@link IHeatmapRenderableSeriesOptions} applied when constructing the series type
      */
     function UniformHeatmapRenderableSeries(webAssemblyContext, options) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f;
         var _this = _super.call(this, webAssemblyContext, options) || this;
         _this.type = SeriesType_1.ESeriesType.UniformHeatmapSeries;
         _this.useLinearTextureFilteringProperty = false;
+        _this.fillValuesOutOfRangeProperty = true;
         _this.colorMapPropertyChanged = _this.colorMapPropertyChanged.bind(_this);
         if (options === null || options === void 0 ? void 0 : options.colorMap) {
             if (!("toJSON" in options.colorMap)) {
@@ -91,9 +92,10 @@ var UniformHeatmapRenderableSeries = /** @class */ (function (_super) {
         _this.xAxisId = (_b = options === null || options === void 0 ? void 0 : options.yAxisId) !== null && _b !== void 0 ? _b : AxisCore_1.AxisCore.DEFAULT_AXIS_ID;
         _this.useLinearTextureFilteringProperty =
             (_c = options === null || options === void 0 ? void 0 : options.useLinearTextureFiltering) !== null && _c !== void 0 ? _c : _this.useLinearTextureFilteringProperty;
+        _this.fillValuesOutOfRangeProperty = (_d = options === null || options === void 0 ? void 0 : options.fillValuesOutOfRange) !== null && _d !== void 0 ? _d : _this.fillValuesOutOfRangeProperty;
         // Must be called here for the series type to be available
-        if ((_d = _this.paletteProvider) === null || _d === void 0 ? void 0 : _d.onAttached) {
-            (_e = _this.paletteProvider) === null || _e === void 0 ? void 0 : _e.onAttached(_this);
+        if ((_e = _this.paletteProvider) === null || _e === void 0 ? void 0 : _e.onAttached) {
+            (_f = _this.paletteProvider) === null || _f === void 0 ? void 0 : _f.onAttached(_this);
         }
         _this.drawingProviders = [];
         if (!app_1.IS_TEST_ENV) {
@@ -159,6 +161,23 @@ var UniformHeatmapRenderableSeries = /** @class */ (function (_super) {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(UniformHeatmapRenderableSeries.prototype, "fillValuesOutOfRange", {
+        /**
+         * Gets or sets whether to fill cells with edge color if its value is outside of {@link colorMap.minimum} to {@link colorMap.maximum} range
+         */
+        get: function () {
+            return this.fillValuesOutOfRangeProperty;
+        },
+        /**
+         * Gets or sets whether to fill cells with edge color if its value is outside of {@link colorMap.minimum} to {@link colorMap.maximum} range
+         */
+        set: function (value) {
+            this.fillValuesOutOfRangeProperty = value;
+            this.notifyPropertyChanged(constants_1.PROPERTY.FILL_VALUES_OUT_OF_RANGE);
+        },
+        enumerable: false,
+        configurable: true
+    });
     /** @inheritDoc */
     UniformHeatmapRenderableSeries.prototype.toPointSeries = function (resamplingParams) {
         // not used for Heatmap
@@ -171,6 +190,7 @@ var UniformHeatmapRenderableSeries = /** @class */ (function (_super) {
         var json = _super.prototype.toJSON.call(this, excludeData);
         var options = {
             colorMap: (_a = this.colorMap) === null || _a === void 0 ? void 0 : _a.toJSON(),
+            fillValuesOutOfRange: this.fillValuesOutOfRange,
             useLinearTextureFiltering: this.useLinearTextureFiltering
         };
         Object.assign(json.options, options);

package/Charting/Visuals/RenderableSeries/constants.d.ts

@@ -16,6 +16,7 @@ export declare enum PROPERTY {
     FILL = "fill",
     FILL_Y1 = "FILL_Y1",
     FILL_LINEAR_GRADIENT = "FILL_LINEAR_GRADIENT",
+    FILL_VALUES_OUT_OF_RANGE = "FILL_VALUES_OUT_OF_RANGE",
     GRADIENT_STOPS = "GRADIENT_STOPS",
     HOVERED = "HOVERED",
     INTERPOLATION_POINTS = "INTERPOLATION_POINTS",

package/Charting/Visuals/RenderableSeries/constants.js

@@ -20,6 +20,7 @@ var PROPERTY;
     PROPERTY["FILL"] = "fill";
     PROPERTY["FILL_Y1"] = "FILL_Y1";
     PROPERTY["FILL_LINEAR_GRADIENT"] = "FILL_LINEAR_GRADIENT";
+    PROPERTY["FILL_VALUES_OUT_OF_RANGE"] = "FILL_VALUES_OUT_OF_RANGE";
     PROPERTY["GRADIENT_STOPS"] = "GRADIENT_STOPS";
     PROPERTY["HOVERED"] = "HOVERED";
     PROPERTY["INTERPOLATION_POINTS"] = "INTERPOLATION_POINTS";

package/Core/BuildStamp.d.ts

@@ -1,4 +1,4 @@
 import { TSciChart } from "../types/TSciChart";
 import { TSciChart3D } from "../types/TSciChart3D";
-export declare const libraryVersion = "2.1.2294";
+export declare const libraryVersion = "2.1.2301";
 export declare const checkBuildStamp: (wasmContext: TSciChart | TSciChart3D) => boolean;

package/Core/BuildStamp.js

@@ -1,10 +1,10 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.checkBuildStamp = exports.libraryVersion = void 0;
-var buildStamp = "2022-03-16T00:00:00";
+var buildStamp = "2022-03-30T00:00:00";
 var result;
 // tslint:disable-next-line:no-var-requires
-exports.libraryVersion = "2.1.2294";
+exports.libraryVersion = "2.1.2301";
 var checkBuildStamp = function (wasmContext) {
     if (result !== undefined)
         return result;