@syncfusion/ej2-pdf-export 25.2.3 → 26.2.4

package/dist/ts/implementation/graphics/brushes/enum.ts

@@ -0,0 +1,237 @@
+
+/**
+ * Specifies the constant values specifying whether to extend the shading
+ * beyond the starting and ending points of the axis.
+ */
+export enum PdfExtend {
+    /**
+     * Do not extend any point.
+     */
+    None = 0,
+    /**
+     * Extend start point.
+     */
+    Start = 1,
+    /**
+     * Extend end point.
+     */
+    End = 2,
+    /**
+     * Extend both start and end points.
+     */
+    Both = Start | End,
+}
+/**
+ * Specifies the gradient direction of the linear gradient brush.
+ */
+export enum PdfLinearGradientMode {
+    /**
+     * Specifies a gradient from upper right to lower left.
+     */
+    BackwardDiagonal,
+    /**
+     * Specifies a gradient from upper left to lower right.
+     */
+    ForwardDiagonal,
+    /**
+     * Specifies a gradient from left to right.
+     */
+    Horizontal,
+    /**
+     * Specifies a gradient from top to bottom.
+     */
+    Vertical,
+}
+/**
+ * Shading type constants.
+ */
+export enum ShadingType {
+    /**
+     * Function-based shading.
+     */
+    Function = 1,
+    /**
+     * Axial shading.
+     */
+    Axial = 2,
+    /**
+     * Radial shading.
+     */
+    Radial = 3
+}
+export enum KnownColor {
+    ActiveBorder = 1,
+    ActiveCaption = 2,
+    ActiveCaptionText = 3,
+    AppWorkspace = 4,
+    Control = 5,
+    ControlDark = 6,
+    ControlDarkDark = 7,
+    ControlLight = 8,
+    ControlLightLight = 9,
+    ControlText = 10,
+    Desktop = 11,
+    GrayText = 12,
+    Highlight = 13,
+    HighlightText = 14,
+    HotTrack = 15,
+    InactiveBorder = 16,
+    InactiveCaption = 17,
+    InactiveCaptionText = 18,
+    Info = 19,
+    InfoText = 20,
+    Menu = 21,
+    MenuText = 22,
+    ScrollBar = 23,
+    Window = 24,
+    WindowFrame = 25,
+    WindowText = 26,
+    Transparent = 27,
+    AliceBlue = 28,
+    AntiqueWhite = 29,
+    Aqua = 30,
+    Aquamarine = 31,
+    Azure = 32,
+    Beige = 33,
+    Bisque = 34,
+    Black = 35,
+    BlanchedAlmond = 36,
+    Blue = 37,
+    BlueViolet = 38,
+    Brown = 39,
+    BurlyWood = 40,
+    CadetBlue = 41,
+    Chartreuse = 42,
+    Chocolate = 43,
+    Coral = 44,
+    CornflowerBlue = 45,
+    Cornsilk = 46,
+    Crimson = 47,
+    Cyan = 48,
+    DarkBlue = 49,
+    DarkCyan = 50,
+    DarkGoldenrod = 51,
+    DarkGray = 52,
+    DarkGreen = 53,
+    DarkKhaki = 54,
+    DarkMagenta = 55,
+    DarkOliveGreen = 56,
+    DarkOrange = 57,
+    DarkOrchid = 58,
+    DarkRed = 59,
+    DarkSalmon = 60,
+    DarkSeaGreen = 61,
+    DarkSlateBlue = 62,
+    DarkSlateGray = 63,
+    DarkTurquoise = 64,
+    DarkViolet = 65,
+    DeepPink = 66,
+    DeepSkyBlue = 67,
+    DimGray = 68,
+    DodgerBlue = 69,
+    Firebrick = 70,
+    FloralWhite = 71,
+    ForestGreen = 72,
+    Fuchsia = 73,
+    Gainsboro = 74,
+    GhostWhite = 75,
+    Gold = 76,
+    Goldenrod = 77,
+    Gray = 78,
+    Green = 79,
+    GreenYellow = 80,
+    Honeydew = 81,
+    HotPink = 82,
+    IndianRed = 83,
+    Indigo = 84,
+    Ivory = 85,
+    Khaki = 86,
+    Lavender = 87,
+    LavenderBlush = 88,
+    LawnGreen = 89,
+    LemonChiffon = 90,
+    LightBlue = 91,
+    LightCoral = 92,
+    LightCyan = 93,
+    LightGoldenrodYellow = 94,
+    LightGray = 95,
+    LightGreen = 96,
+    LightPink = 97,
+    LightSalmon = 98,
+    LightSeaGreen = 99,
+    LightSkyBlue = 100,
+    LightSlateGray = 101,
+    LightSteelBlue = 102,
+    LightYellow = 103,
+    Lime = 104,
+    LimeGreen = 105,
+    Linen = 106,
+    Magenta = 107,
+    Maroon = 108,
+    MediumAquamarine = 109,
+    MediumBlue = 110,
+    MediumOrchid = 111,
+    MediumPurple = 112,
+    MediumSeaGreen = 113,
+    MediumSlateBlue = 114,
+    MediumSpringGreen = 115,
+    MediumTurquoise = 116,
+    MediumVioletRed = 117,
+    MidnightBlue = 118,
+    MintCream = 119,
+    MistyRose = 120,
+    Moccasin = 121,
+    NavajoWhite = 122,
+    Navy = 123,
+    OldLace = 124,
+    Olive = 125,
+    OliveDrab = 126,
+    Orange = 127,
+    OrangeRed = 128,
+    Orchid = 129,
+    PaleGoldenrod = 130,
+    PaleGreen = 131,
+    PaleTurquoise = 132,
+    PaleVioletRed = 133,
+    PapayaWhip = 134,
+    PeachPuff = 135,
+    Peru = 136,
+    Pink = 137,
+    Plum = 138,
+    PowderBlue = 139,
+    Purple = 140,
+    Red = 141,
+    RosyBrown = 142,
+    RoyalBlue = 143,
+    SaddleBrown = 144,
+    Salmon = 145,
+    SandyBrown = 146,
+    SeaGreen = 147,
+    SeaShell = 148,
+    Sienna = 149,
+    Silver = 150,
+    SkyBlue = 151,
+    SlateBlue = 152,
+    SlateGray = 153,
+    Snow = 154,
+    SpringGreen = 155,
+    SteelBlue = 156,
+    Tan = 157,
+    Teal = 158,
+    Thistle = 159,
+    Tomato = 160,
+    Turquoise = 161,
+    Violet = 162,
+    Wheat = 163,
+    White = 164,
+    WhiteSmoke = 165,
+    Yellow = 166,
+    YellowGreen = 167,
+    ButtonFace = 168,
+    ButtonHighlight = 169,
+    ButtonShadow = 170,
+    GradientActiveCaption = 171,
+    GradientInactiveCaption = 172,
+    MenuBar = 173,
+    MenuHighlight = 174
+}

package/dist/ts/implementation/graphics/brushes/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Collections classes
+ * @hidden
+ */
+export * from './pdf-brush';
+export * from './pdf-solid-brush';
+export * from './pdf-blend';
+export * from './pdf-linear-gradient-brush';
+export * from './pdf-gradient-brush';
+export * from './pdf-color-blend';
+export * from './pdf-radial-gradient-brush';
+export * from './pdf-tiling-brush';
+export * from './pdf-brushes';

package/dist/ts/implementation/graphics/brushes/index.ts

@@ -0,0 +1,13 @@
+/**
+ * Collections classes
+ * @hidden
+ */
+export * from './pdf-brush';
+export * from './pdf-solid-brush';
+export * from './pdf-blend';
+export * from './pdf-linear-gradient-brush';
+export * from './pdf-gradient-brush';
+export * from './pdf-color-blend';
+export * from './pdf-radial-gradient-brush';
+export * from './pdf-tiling-brush';
+export * from './pdf-brushes';

package/dist/ts/implementation/graphics/brushes/pdf-blend.d.ts

@@ -0,0 +1,105 @@
+/**
+ * PdfBlend.ts class for EJ2-PDF
+ */
+import { PdfColorSpace } from './../enum';
+import { PdfColor } from './../pdf-color';
+import { PdfColorBlend } from './pdf-color-blend';
+/**
+ * `PdfBlend` Represents the blend color space
+ * @private
+ */
+export declare class PdfBlend {
+    /**
+     * precision of the GCD calculations.
+     * @private
+     */
+    private precision;
+    /**
+     * Local variable to store the count.
+     * @private
+     */
+    private mCount;
+    /**
+     * Local variable to store the positions.
+     * @private
+     */
+    private mPositions;
+    /**
+     * Local variable to store the factors
+     * @private.
+     */
+    private mFactors;
+    /**
+     * Initializes a new instance of the `PdfBlend` class.
+     * @public
+     */
+    constructor();
+    /**
+     * Initializes a new instance of the `PdfBlend` class.
+     * @public
+     */
+    constructor(count: number);
+    /**
+     * Gets or sets the array of factor to the blend.
+     * @public
+     */
+    factors: number[];
+    /**
+     * 'positions' Gets or sets the array of positions
+     * @public
+     */
+    positions: number[];
+    /**
+     * Gets the number of elements that specify the blend.
+     * @protected
+     */
+    protected readonly count: number;
+    /**
+     * Generates a correct color blend.
+     * @param colours The colours.
+     * @param colorSpace The color space.
+     */
+    generateColorBlend(colours: PdfColor[], colorSpace: PdfColorSpace): PdfColorBlend;
+    /**
+     * 'clonePdfBlend' Clones this instance.
+     * @public
+     */
+    clonePdfBlend(): PdfBlend;
+    /**
+     * Calculate the GCD of the specified values.
+     * @param u The values.
+     */
+    protected gcd(u: number[]): number;
+    /**
+     * Determines greatest common divisor of the specified u and v.
+     * @param u The u.
+     * @param v The v.
+     */
+    protected gcd(u: number, v: number): number;
+    /**
+     * Calculate the GCD int of the specified values.
+     * @param u The u.
+     * @param v The v.
+     */
+    protected gcdInt(u: number, v: number): number;
+    /**
+     * Determines if the u value is even.
+     * @param u The u value.
+     */
+    private isEven;
+    /**
+     * Interpolates the specified colours according to the t value.
+     * @param t The t value, which show the imagine position on a line from 0 to 1.
+     * @param v1 The minimal value.
+     * @param v2 The maximal value.
+     */
+    protected interpolate(t: number, v1: number, v2: number): number;
+    /**
+     * Interpolates the specified colours according to the t value.
+     * @param t The t value, which show the imagine position on a line from 0 to 1.
+     * @param color1 The minimal colour.
+     * @param color2 The maximal colour.
+     * @param colorSpace The color space.
+     */
+    protected interpolate(t: number, color1: PdfColor, color2: PdfColor, colorSpace: PdfColorSpace): PdfColor;
+}

package/dist/ts/implementation/graphics/brushes/pdf-blend.ts

@@ -0,0 +1,294 @@
+/**
+ * PdfBlend.ts class for EJ2-PDF
+ */
+import { PdfColorSpace } from './../enum';
+import { PdfColor } from './../pdf-color';
+import { PdfColorBlend } from './pdf-color-blend';
+/**
+ * `PdfBlend` Represents the blend color space
+ * @private
+ */
+export class PdfBlend {
+    //Constants
+    /**
+     * precision of the GCD calculations.
+     * @private
+     */
+    private precision: number = 1000;
+    //Fields
+    /**
+     * Local variable to store the count.
+     * @private
+     */
+    private mCount: number;
+    /**
+     * Local variable to store the positions.
+     * @private
+     */
+    private mPositions: number[];
+    /**
+     * Local variable to store the factors
+     * @private.
+     */
+    private mFactors: number[];
+    //Constructor
+    /**
+     * Initializes a new instance of the `PdfBlend` class.
+     * @public
+     */
+    public constructor ()
+    /**
+     * Initializes a new instance of the `PdfBlend` class.
+     * @public
+     */
+    public constructor (count : number)
+    public constructor (count ?: number) {
+        //
+    }
+    //Properties
+    /**
+     * Gets or sets the array of factor to the blend.
+     * @public
+     */
+    public get factors(): number[] {
+        return this.mFactors;
+    }
+    public set factors(value: number[])  {
+        if ((value == null)) {
+            throw new Error('ArgumentNullException : Factors');
+        }
+        this.mFactors = value;
+    }
+    /**
+     * 'positions' Gets or sets the array of positions
+     * @public
+     */
+    public get positions(): number[] {
+        return this.mPositions;
+    }
+    public set positions(value: number[]) {
+        let positionarray: number[] = value;
+        for (let i: number = 0; i < positionarray.length; i++) {
+            if (((positionarray[i] < 0) || (positionarray[i] > 1))) {
+                positionarray[i] = 0;
+            }
+        }
+        this.mPositions = positionarray;
+        this.mPositions = value;
+    }
+    /**
+     * Gets the number of elements that specify the blend.
+     * @protected
+     */
+    protected get count(): number {
+        return this.mCount;
+    }
+    //Implementation
+    /**
+     * Generates a correct color blend.
+     * @param colours The colours.
+     * @param colorSpace The color space.
+     */
+    public generateColorBlend(colours: PdfColor[], colorSpace: PdfColorSpace): PdfColorBlend {
+        if ((colours == null)) {
+            throw new Error('ArgumentNullException : colours');
+        }
+        if ((this.positions == null)) {
+            this.positions = [0];
+        }
+        let cBlend: PdfColorBlend = new PdfColorBlend(this.count);
+        let positions: number[] = this.positions;
+        let clrs: PdfColor[] = null;
+        if ((positions.length === 1)) {
+            positions = [3];
+            positions[0] = 0;
+            positions[1] = this.positions[0];
+            positions[2] = 1;
+            /* tslint:disable */
+            clrs = new Array(3);
+            clrs[0] = colours[0];
+            clrs[1] = colours[0];
+            clrs[2] = colours[1];
+        } else {
+            let c1: PdfColor = colours[0];
+            let c2: PdfColor = colours[1];
+            /* tslint:disable */
+            clrs = new Array(this.count);
+            let i: number = 0;
+            let count : number = this.count;
+            for (i = 0; i < count; ++i) {
+                clrs[i] = this.interpolate(this.mFactors[i], c1, c2, colorSpace);
+            }
+        }
+        cBlend.positions = positions;
+        cBlend.colors = clrs;
+        return cBlend;
+    }
+    /**
+     * 'clonePdfBlend' Clones this instance.
+     * @public
+     */
+    public clonePdfBlend(): PdfBlend {
+        let blend: PdfBlend = this;
+        if ((this.mFactors != null)) {
+            blend.factors = (<number[]>(this.mFactors));
+        }
+        if ((this.positions != null)) {
+            blend.positions = (<number[]>(this.positions));
+        }
+        return blend;
+    }
+    /**
+     * Calculate the GCD of the specified values.
+     * @param u The values.
+     */
+    protected gcd(u: number[]): number
+    /**
+     * Determines greatest common divisor of the specified u and v.
+     * @param u The u.
+     * @param v The v.
+     */
+    protected gcd(u: number, v: number): number
+    protected gcd(u?: number|number[], v?: number): number {
+        if ( typeof u === 'number' && typeof v === 'number' && typeof v !== 'undefined') {
+            if (((u < 0) || (u > 1))) {
+                throw new Error('ArgumentOutOfRangeException : u');
+            }
+            if (((v < 0) || (v > 1))) {
+                throw new Error('ArgumentOutOfRangeException : v');
+            }
+            let iU: number = (<number>(Math.max(1, (u * this.precision))));
+            let iV: number = (<number>(Math.max(1, (v * this.precision))));
+            let iResult: number = this.gcdInt(iU, iV);
+            let result: number = ((<number>(iResult)) / this.precision);
+            return result;
+        } else {
+            let values : number[] = u as number[];
+            if ((values == null)) {
+                throw new Error('ArgumentNullException : values');
+            }
+            if ((values.length < 1)) {
+                throw new Error('ArgumentException : Not enough values in the array. - values');
+            }
+            let gcd: number = values[0];
+            if ((values.length > 1)) {
+                let count: number = values.length;
+                for (let i : number = 1; i < count; ++i) {
+                    gcd = this.gcd(values[i], gcd);
+                    if ((gcd === (1 / this.precision))) {
+                        break;
+                    }
+                }
+            }
+            return gcd;
+        }
+    }
+    /**
+     * Calculate the GCD int of the specified values.
+     * @param u The u.
+     * @param v The v.
+     */
+    protected gcdInt(u: number, v: number): number {
+        if ((u <= 0)) {
+            throw new Error('ArgumentOutOfRangeException' + u + 'The arguments cannot be less or equal to zero.');
+        }
+        if ((v <= 0)) {
+            throw new Error('ArgumentOutOfRangeException' + v + 'The arguments cannot be less or equal to zero.');
+        }
+        if (((u === 1) || (v === 1))) {
+            return 1;
+        }
+        let shift: number = 0;
+        while (this.isEven(u, v)) {
+            ++shift;
+            u >>= 1;
+            v >>= 1;
+        }
+        while (((u & 1) <= 0)) {
+            u >>= 1;
+        }
+        do {
+            while ((v & 1) <= 0) {
+                v >>= 1;
+            }
+            if (u > v) {
+                let t : number = v; v = u; u = t;
+            }
+            v = v - u;
+        } while (v !== 0);
+        return (u << shift);
+    }
+    /**
+     * Determines if the u value is even.
+     * @param u The u value.
+     */
+    private isEven(u: number): boolean
+    /**
+     * Determines if both parameters are even numbers.
+     * @param u The first value.
+     * @param v The second value.
+     */
+    private isEven(u: number, v: number): boolean
+    private isEven(arg1?: number, arg2?: number): boolean {
+        if (typeof arg2 === 'number' && typeof arg2 !== 'undefined') {
+            let result : boolean = true;
+            result = (result && ((arg1 & 1) <= 0)); //  Is u even?
+            result = (result && ((arg2 & 1) <= 0)); //  Is v even?
+            return result;
+        } else {
+            return ((arg1 & 1) <= 0);
+        }
+    }
+    /**
+     * Interpolates the specified colours according to the t value.
+     * @param t The t value, which show the imagine position on a line from 0 to 1.
+     * @param v1 The minimal value.
+     * @param v2 The maximal value.
+     */
+    protected interpolate(t: number, v1: number, v2: number): number
+    /**
+     * Interpolates the specified colours according to the t value.
+     * @param t The t value, which show the imagine position on a line from 0 to 1.
+     * @param color1 The minimal colour.
+     * @param color2 The maximal colour.
+     * @param colorSpace The color space.
+     */
+    protected interpolate(t: number, color1: PdfColor, color2: PdfColor, colorSpace: PdfColorSpace): PdfColor
+    protected interpolate(t: number, color1: number|PdfColor, color2: number|PdfColor, colorSpace?: PdfColorSpace): PdfColor|number {
+        if (color1 instanceof PdfColor) {
+            let color: PdfColor = new PdfColor();
+            switch (colorSpace) {
+                case PdfColorSpace.Rgb:
+                    let red: number = (<number>(this.interpolate(t, color1.red, (color2 as PdfColor).red)));
+                    let green: number = (<number>(this.interpolate(t, color1.green, (color2 as PdfColor).green)));
+                    let blue: number = (<number>(this.interpolate(t, color1.blue, (color2 as PdfColor).blue)));
+                    color = new PdfColor(red, green, blue);
+                    break;
+                    case PdfColorSpace.GrayScale:
+                    let gray: number = (<number>(this.interpolate(t, color1.gray, (color2 as PdfColor).gray)));
+                    color = new PdfColor(gray);
+                    break;
+                case PdfColorSpace.Cmyk:
+                    let cyan: number = (<number>(this.interpolate(t, color1.c, (color2 as PdfColor).c)));
+                    let magenta: number = (<number>(this.interpolate(t, color1.m, (color2 as PdfColor).m)));
+                    let yellow: number = (<number>(this.interpolate(t, color1.y, (color2 as PdfColor).y)));
+                    let black: number = (<number>(this.interpolate(t, color1.k, (color2 as PdfColor).k)));
+                    color = new PdfColor(cyan, magenta, yellow, black);
+                    break;
+            }
+            return color;
+        } else {
+            let t0: number = 0;
+            let t1: number = 1;
+            let result: number = 0;
+            if ((t === t0)) {
+                result = color1;
+            } else if ((t === t1)) {
+                result = <number>color2;
+            } else {
+                result = (color1 + ((t - t0) * (((color2 as number) - color1) / (t1 - t0))));
+            }
+            return result;
+        }
+    }
+}