scichart 2.1.2301 → 2.2.2389

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

@@ -5,5 +5,10 @@ export declare enum PROPERTY {
     IS_SELECTED = "IS_SELECTED",
     PERCENTAGE = "PERCENTAGE",
     TEXT = "TEXT",
-    VALUE = "VALUE"
+    VALUE = "VALUE",
+    SHIFT = "SHIFT",
+    LABEL_PROVIDER = "LABEL_PROVIDER",
+    LABEL_STYLE = "LABEL_STYLE",
+    LABEL_OFFSET = "LABEL_OFFSET",
+    RADIUS_ADJUSTMENT = "RADIUS_ADJUSTMENT"
 }

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

@@ -10,4 +10,9 @@ var PROPERTY;
     PROPERTY["PERCENTAGE"] = "PERCENTAGE";
     PROPERTY["TEXT"] = "TEXT";
     PROPERTY["VALUE"] = "VALUE";
+    PROPERTY["SHIFT"] = "SHIFT";
+    PROPERTY["LABEL_PROVIDER"] = "LABEL_PROVIDER";
+    PROPERTY["LABEL_STYLE"] = "LABEL_STYLE";
+    PROPERTY["LABEL_OFFSET"] = "LABEL_OFFSET";
+    PROPERTY["RADIUS_ADJUSTMENT"] = "RADIUS_ADJUSTMENT";
 })(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 { TTextStyle } from "../Axis/AxisCore";
+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: PieLabelProvider;
     private pieTypeProperty;
     private holeRadiusProperty;
     private holeRadiusSizingModeProperty;
     private seriesSpacingProperty;
+    private labelRadiusProperty;
     private svg;
     private titleDivs;
     private viewRect;
@@ -80,7 +91,27 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     private themeProviderProperty;
     private previousThemeProviderProperty;
     private deletables;
+    private paddingProperty?;
+    private canvasBorderProperty?;
+    private valueModeProperty;
+    private labelStyleProperty;
     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);
+    /**
+     * Gets or sets a {@link TTextStyle} object for styling labels
+     */
+    get labelStyle(): TTextStyle;
+    /**
+     * Gets or sets a {@link TTextStyle} object for styling labels
+     */
+    set labelStyle(textStyle: TTextStyle);
     /**
      * @inheritDoc
      */
@@ -97,7 +128,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 +136,7 @@ export declare class SciChartPieSurface implements ISciChartSurfaceBase {
     /**
      * @inheritDoc
      */
-    delete(): void;
+    delete(isAnimationProgress?: boolean): void;
     /**
      * @inheritDoc
      */
@@ -150,6 +181,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 +222,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,14 +237,19 @@ 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 drawSegmentTitles;
+    private adjustDomContainer;
+    private drawSegmentLabel;
     private pieSegmentsTotalValue;
+    private pieSegmentsTotalOldValue;
     private applySciChartBackground;
 }
 /** @ignore */