scichart 2.1.2301 → 2.2.2351

package/Charting/Visuals/SciChartPieSurface/PieSegment/PieSegment.d.ts

@@ -1,5 +1,6 @@
 import { GradientParams } from "../../../../Core/GradientParams";
 import { RequiredOwnProps } from "../../../../types/HelperTypes";
+import { PieLabelProvider } from "../../Axis/LabelProvider/PieLabelProvider";
 import { SciChartPieSurface } from "../SciChartPieSurface";
 import { IPieSegment } from "./IPieSegment";
 export interface IPieSegmentOptions {
@@ -10,16 +11,20 @@ export interface IPieSegmentOptions {
     colorLinearGradient?: GradientParams;
     isSelected?: boolean;
     delta?: number;
+    labelProvider?: PieLabelProvider;
 }
 export declare class PieSegment implements IPieSegment {
-    static readonly DEFAULT_DELTA = 15;
     readonly id: string;
     private colorProperty;
     private colorLinearGradientProperty;
     private isSelectedProperty;
     private textProperty;
     private valueProperty;
+    private oldValueProperty;
     private deltaProperty;
+    private shiftProperty;
+    private parentSurface;
+    private labelProviderProperty;
     private invalidateParentCallback;
     constructor(options?: IPieSegmentOptions);
     onAttach(scps: SciChartPieSurface): void;
@@ -32,11 +37,17 @@ export declare class PieSegment implements IPieSegment {
     set isSelected(value: boolean);
     get text(): string;
     set text(value: string);
-    getPercentage(total: number): string;
+    get labelProvider(): PieLabelProvider;
+    set labelProvider(value: PieLabelProvider);
+    getPercentage(total: number): number;
     get value(): number;
     set value(value: number);
+    get oldValue(): number;
     get delta(): number;
     set delta(value: number);
+    get shift(): number;
+    set shift(value: number);
     toJSON(): RequiredOwnProps<IPieSegmentOptions>;
+    getLabelText(total: number): string;
     private notifyPropertyChanged;
 }

package/Charting/Visuals/SciChartPieSurface/PieSegment/PieSegment.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.PieSegment = void 0;
 var guid_1 = require("../../../../utils/guid");
+var PieLabelProvider_1 = require("../../Axis/LabelProvider/PieLabelProvider");
 var constants_1 = require("./constants");
 var PieSegment = /** @class */ (function () {
     function PieSegment(options) {
@@ -9,16 +10,22 @@ var PieSegment = /** @class */ (function () {
         this.colorProperty = "grey";
         this.isSelectedProperty = false;
         this.textProperty = "";
-        this.deltaProperty = 0;
+        this.deltaProperty = 15;
+        this.shiftProperty = 0;
         this.id = (_a = options === null || options === void 0 ? void 0 : options.id) !== null && _a !== void 0 ? _a : (0, guid_1.generateGuid)();
         this.colorProperty = (_b = options === null || options === void 0 ? void 0 : options.color) !== null && _b !== void 0 ? _b : this.colorProperty;
         this.colorLinearGradientProperty = (_c = options === null || options === void 0 ? void 0 : options.colorLinearGradient) !== null && _c !== void 0 ? _c : this.colorLinearGradientProperty;
         this.isSelectedProperty = (_d = options === null || options === void 0 ? void 0 : options.isSelected) !== null && _d !== void 0 ? _d : this.isSelectedProperty;
         this.textProperty = (_e = options === null || options === void 0 ? void 0 : options.text) !== null && _e !== void 0 ? _e : this.textProperty;
         this.valueProperty = (_f = options === null || options === void 0 ? void 0 : options.value) !== null && _f !== void 0 ? _f : this.valueProperty;
-        this.delta = (_g = options === null || options === void 0 ? void 0 : options.delta) !== null && _g !== void 0 ? _g : this.deltaProperty;
+        this.deltaProperty = (_g = options === null || options === void 0 ? void 0 : options.delta) !== null && _g !== void 0 ? _g : this.deltaProperty;
+        this.labelProviderProperty = options === null || options === void 0 ? void 0 : options.labelProvider; // No default here as we default to labelprovider on parent surface
     }
     PieSegment.prototype.onAttach = function (scps) {
+        this.parentSurface = scps;
+        if (this.labelProviderProperty) {
+            this.labelProviderProperty.attachedToSurface(scps);
+        }
         this.invalidateParentCallback = scps.invalidateElement;
     };
     PieSegment.prototype.onDetach = function () {
@@ -52,14 +59,10 @@ var PieSegment = /** @class */ (function () {
             return this.isSelectedProperty;
         },
         set: function (value) {
-            this.isSelectedProperty = value;
-            if (value) {
-                this.deltaProperty = PieSegment.DEFAULT_DELTA;
-            }
-            else {
-                this.deltaProperty = 0;
+            if (this.isSelectedProperty !== value) {
+                this.isSelectedProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.IS_SELECTED);
             }
-            this.notifyPropertyChanged(constants_1.PROPERTY.IS_SELECTED);
         },
         enumerable: false,
         configurable: true
@@ -75,34 +78,65 @@ var PieSegment = /** @class */ (function () {
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(PieSegment.prototype, "labelProvider", {
+        get: function () {
+            // Create a labelProvider if it is accessed.  This will override behaviour from the parent surface
+            if (this.labelProviderProperty === undefined) {
+                this.labelProvider = new PieLabelProvider_1.PieLabelProvider();
+            }
+            return this.labelProviderProperty;
+        },
+        set: function (value) {
+            this.labelProviderProperty = value;
+            this.notifyPropertyChanged(constants_1.PROPERTY.LABEL_PROVIDER);
+        },
+        enumerable: false,
+        configurable: true
+    });
     PieSegment.prototype.getPercentage = function (total) {
-        var pers = (100 * this.value) / total;
-        return pers.toFixed(2) + " %";
+        return (100 * this.value) / total;
     };
     Object.defineProperty(PieSegment.prototype, "value", {
         get: function () {
             return this.valueProperty;
         },
         set: function (value) {
+            this.oldValueProperty = this.valueProperty;
             this.valueProperty = value;
             this.notifyPropertyChanged(constants_1.PROPERTY.VALUE);
         },
         enumerable: false,
         configurable: true
     });
+    Object.defineProperty(PieSegment.prototype, "oldValue", {
+        get: function () {
+            return this.oldValueProperty;
+        },
+        enumerable: false,
+        configurable: true
+    });
     Object.defineProperty(PieSegment.prototype, "delta", {
         get: function () {
             return this.deltaProperty;
         },
         set: function (value) {
-            if (this.deltaProperty === PieSegment.DEFAULT_DELTA && value < PieSegment.DEFAULT_DELTA) {
-                this.isSelectedProperty = false;
+            if (this.deltaProperty !== value) {
+                this.deltaProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.DELTA);
             }
-            else if (this.deltaProperty === 0 && value > 0) {
-                this.isSelectedProperty = true;
+        },
+        enumerable: false,
+        configurable: true
+    });
+    Object.defineProperty(PieSegment.prototype, "shift", {
+        get: function () {
+            return this.shiftProperty;
+        },
+        set: function (value) {
+            if (this.shiftProperty !== value) {
+                this.shiftProperty = value;
+                this.notifyPropertyChanged(constants_1.PROPERTY.SHIFT);
             }
-            this.deltaProperty = value;
-            this.notifyPropertyChanged(constants_1.PROPERTY.DELTA);
         },
         enumerable: false,
         configurable: true
@@ -115,15 +149,27 @@ var PieSegment = /** @class */ (function () {
             isSelected: this.isSelected,
             delta: this.delta,
             text: this.text,
-            value: this.value
+            value: this.value,
+            // @ts-ignore
+            labelProvider: this.labelProvider.toJSON()
         };
     };
+    PieSegment.prototype.getLabelText = function (total) {
+        if (this.labelProviderProperty) {
+            return this.labelProvider.getSegmentText(this, total);
+        }
+        else {
+            return this.parentSurface.labelProvider.getSegmentText(this, total);
+        }
+    };
     PieSegment.prototype.notifyPropertyChanged = function (propertyName) {
+        if (propertyName === constants_1.PROPERTY.LABEL_PROVIDER) {
+            this.labelProvider.attachedToSurface(this.parentSurface);
+        }
         if (this.invalidateParentCallback) {
-            this.invalidateParentCallback();
+            this.invalidateParentCallback(propertyName);
         }
     };
-    PieSegment.DEFAULT_DELTA = 15;
     return PieSegment;
 }());
 exports.PieSegment = PieSegment;

package/Charting/Visuals/SciChartPieSurface/PieSegment/constants.d.ts

@@ -5,5 +5,7 @@ export declare enum PROPERTY {
     IS_SELECTED = "IS_SELECTED",
     PERCENTAGE = "PERCENTAGE",
     TEXT = "TEXT",
-    VALUE = "VALUE"
+    VALUE = "VALUE",
+    SHIFT = "SHIFT",
+    LABEL_PROVIDER = "LABEL_PROVIDER"
 }

package/Charting/Visuals/SciChartPieSurface/PieSegment/constants.js

@@ -10,4 +10,6 @@ var PROPERTY;
     PROPERTY["PERCENTAGE"] = "PERCENTAGE";
     PROPERTY["TEXT"] = "TEXT";
     PROPERTY["VALUE"] = "VALUE";
+    PROPERTY["SHIFT"] = "SHIFT";
+    PROPERTY["LABEL_PROVIDER"] = "LABEL_PROVIDER";
 })(PROPERTY = exports.PROPERTY || (exports.PROPERTY = {}));

package/Charting/Visuals/SciChartPieSurface/SciChartPieSurface.d.ts

@@ -1,9 +1,13 @@
 import { ISciChartPieDefinition } from "../../../Builder/buildSurface";
 import { IDeletable } from "../../../Core/IDeletable";
 import { ObservableArray } from "../../../Core/ObservableArray";
+import { Thickness } from "../../../Core/Thickness";
 import { ESciChartSurfaceType } from "../../../types/SciChartSurfaceType";
+import { TBorder } from "../../../types/TBorder";
 import { TSciChartSurfaceCanvases } from "../../../types/TSciChartSurfaceCanvases";
 import { IThemeProvider } from "../../Themes/IThemeProvider";
+import { LabelProvider } from "../Axis/LabelProvider/LabelProvider";
+import { PieLabelProvider } from "../Axis/LabelProvider/PieLabelProvider";
 import { IEventSubscriptionItem } from "../Legend/SciChartLegendBase";
 import { SciChartPieLegend } from "../Legend/SciChartPieLegend";
 import { ISciChartSurfaceBase } from "../SciChartSurfaceBase";
@@ -23,6 +27,10 @@ export declare enum EPieType {
     Pie = "Pie",
     Donut = "Donut"
 }
+export declare enum EPieValueMode {
+    Percentage = 0,
+    Raw = 1
+}
 /**
  * @summary The {@link SciChartPieSurface} is the root Pie and Donut Chart control in SciChart's High Performance Real-time
  * {@link https://www.scichart.com/javascript-chart-features | JavaScript Chart Library}
@@ -61,6 +69,7 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     readonly domSvgAdornerLayer: SVGSVGElement;
     readonly domDivContainer: HTMLDivElement;
     animate: boolean;
+    animationFrames: number;
     /**
      * An optional legend of type {@link SciChartPieLegend} which may be added to the Pie chart
      */
@@ -68,10 +77,12 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     onCreatedName: string;
     protected widthAspect: number;
     protected heightAspect: number;
+    protected labelProviderProperty: LabelProvider;
     private pieTypeProperty;
     private holeRadiusProperty;
     private holeRadiusSizingModeProperty;
     private seriesSpacingProperty;
+    private labelRadiusProperty;
     private svg;
     private titleDivs;
     private viewRect;
@@ -80,7 +91,18 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     private themeProviderProperty;
     private previousThemeProviderProperty;
     private deletables;
+    private paddingProperty?;
+    private canvasBorderProperty?;
+    private valueModeProperty;
     constructor(canvases?: TSciChartSurfaceCanvases, options?: IPieSurfaceOptions);
+    /**
+     * Gets or sets a {@link LabelProvider} - a class which is responsible for formatting axis labels and cursor labels from numeric values
+     */
+    get labelProvider(): PieLabelProvider;
+    /**
+     * Gets or sets a {@link LabelProvider} - a class which is responsible for formatting axis labels and cursor labels from numeric values
+     */
+    set labelProvider(labelProvider: PieLabelProvider);
     /**
      * @inheritDoc
      */
@@ -97,7 +119,7 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
      * Call invalidateElement() to trigger a redraw of the {@link SciChartPieSurface}. SciChart's rendering
      * engine will schedule a redraw a the next time the renderer is free.
      */
-    invalidateElement(): void;
+    invalidateElement(propertyName?: string): void;
     /**
      * Called internally - Updates and draws the Pie Chart
      */
@@ -105,7 +127,7 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     /**
      * @inheritDoc
      */
-    delete(): void;
+    delete(isAnimationProgress?: boolean): void;
     /**
      * @inheritDoc
      */
@@ -150,6 +172,39 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
      * which sets the size of a Donut Chart hole
      */
     set holeRadiusSizingMode(holeRadiusSizingMode: ESizingMode);
+    /**
+     * Gets or sets padding
+     */
+    get padding(): Thickness;
+    /**
+     * Gets or sets padding
+     */
+    set padding(value: Thickness);
+    /**
+     * Gets or sets canvas border
+     */
+    get canvasBorder(): TBorder;
+    /**
+     * Gets or sets canvas border
+     */
+    set canvasBorder(value: TBorder);
+    get seriesSpacing(): number;
+    set seriesSpacing(value: number);
+    /** Whether to show labels as percentages, or raw values.  Default to percentages */
+    get valueMode(): EPieValueMode;
+    /** Whether to show labels as percentages, or raw values.  Default to percentages */
+    set valueMode(value: EPieValueMode);
+    /**
+     * Use this to adjust the position of the labels.  1 is the default.  Larger values will shift the labels outwards.
+     * For Pie charts, 1.7 will place the labels outside the pie
+     * If you want more detailed control you can override calcTitlePosition.
+     */
+    get labelRadiusAdjustment(): number;
+    /**
+     * Use this to adjust the position of the labels.  1 is the default.  Larger values will shift the labels outwards.
+     * If you want more detailed control you can override calcTitlePosition.
+     */
+    set labelRadiusAdjustment(value: number);
     /**
      * Convert the surface to a {@link TSurfaceDefinition}
      * @param excludedata If false, segments will be included in the json
@@ -158,6 +213,11 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
         type: ESciChartSurfaceType;
         options: ISciChartPieDefinition;
     };
+    /** The method used to calculate the label position for each segment */
+    calcTitlePosition(x: number, y: number, outerRadius: number, innerRadius: number, a1: number, a2: number, delta: number, divWidth: number, divHeight: number): {
+        left: number;
+        top: number;
+    };
     /**
      * Changes the size of the DOM element where the {@link SciChartSurfaceBase} resides.
      * @param width
@@ -168,12 +228,16 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     private isValidToDraw;
     private detachPieSegment;
     private attachPieSegment;
+    private updateLegendMargin;
+    private calculateViewRectWidth;
+    private calculateViewRectHeight;
     private draw;
     /**
      * @description Draws pie chart itself
      * @param animationProgress - Current progress from 0 to 1, is being used for sweep animation on start.
      */
     private drawChart;
+    private adjustDomContainer;
     private drawSegmentTitles;
     private pieSegmentsTotalValue;
     private applySciChartBackground;