@syncfusion/ej2-pdf-export 24.1.41 → 24.2.3

package/dist/ts/implementation/graphics/images/pdf-image.ts

@@ -1,132 +0,0 @@
-/**
- * PdfImage.ts class for EJ2-PDF
- */
-import { IPdfWrapper } from './../../../interfaces/i-pdf-wrapper';
-import { IPdfPrimitive } from './../../../interfaces/i-pdf-primitives';
-import { PdfStream } from './../../primitives/pdf-stream';
-import { SizeF } from './../../drawing/pdf-drawing';
-import { PdfGraphicsUnit } from './../enum';
-import { PdfUnitConverter } from './../unit-convertor';
-import { PdfBitmap } from './pdf-bitmap';
-/**
- * `PdfImage` class represents the base class for images and provides functionality for the 'PdfBitmap' class.
- * @private
- */
-export abstract class PdfImage implements IPdfWrapper {
-    /**
-     * `Width` of an image.
-     * @private
-     */
-    private imageWidth : number;
-    /**
-     * `Height` of an image.
-     * @private
-     */
-    private imageHeight : number;
-    /**
-     * `Bits per component` of an image.
-     * @hidden
-     * @private
-     */
-    public bitsPerComponent : number;
-    /**
-     * `horizontal resolution` of an image.
-     * @hidden
-     * @private
-     */
-    public horizontalResolution : number;
-    /**
-     * `Vertical resolution` of an image.
-     * @hidden
-     * @private
-     */
-    public verticalResolution : number;
-    /**
-     * `physical dimension` of an image.
-     * @hidden
-     * @private
-     */
-    private imagePhysicalDimension : SizeF;
-    /**
-     * Gets and Sets the `width` of an image.
-     * @private
-     */
-    public get width() : number {
-        return this.imageWidth;
-    }
-    public set width(value : number) {
-        this.imageWidth = value;
-    }
-    /**
-     * Gets and Sets the `height` of an image.
-     * @private
-     */
-    public get height() : number {
-        return this.imageHeight;
-    }
-    public set height(value : number) {
-        this.imageHeight = value;
-    }
-    /**
-     * Gets or sets the size of the image.
-     * @private
-     */
-    public set size(value : SizeF) {
-        this.width = value.width;
-        this.height = value.height;
-    }
-    /**
-     * Gets the `physical dimension` of an image.
-     * @private
-     */
-    public get physicalDimension() : SizeF {
-        this.imagePhysicalDimension = this.getPointSize(this.width, this.height, this.horizontalResolution, this.verticalResolution);
-        return new SizeF(this.width, this.height);
-    }
-    /**
-     * return the stored `stream of an image`.
-     * @private
-     */
-    public imageStream : PdfStream;
-    // /**
-    //  * Gets the `image stream as string`.
-    //  * @private
-    //  */
-    // public static fromString(string : string) : PdfImage {
-    //     let image : PdfImage = new PdfBitmap(string);
-    //     return image;
-    // }
-    /**
-     * Gets the `element` image stream.
-     * @private
-     */
-    public get element() : IPdfPrimitive {
-        return this.imageStream;
-    }
-    /**
-     * `Save` the image stream.
-     * @private
-     */
-    public abstract save() : void;
-    /**
-     * Return the value of `width and height of an image` in points.
-     * @private
-     */
-    public getPointSize(width : number, height : number) : SizeF
-    public getPointSize(width : number, height : number, horizontalResolution : number, verticalResolution : number) : SizeF
-    public getPointSize(width : number, height : number, horizontalResolution ?: number, verticalResolution ?: number) : SizeF {
-        if (typeof horizontalResolution === 'undefined') {
-            let dpiX : number = PdfUnitConverter.horizontalResolution;
-            let dpiY : number = PdfUnitConverter.verticalResolution;
-            let size : SizeF = this.getPointSize(width, height, dpiX, dpiY);
-            return size;
-        } else {
-            let ucX : PdfUnitConverter = new PdfUnitConverter(horizontalResolution);
-            let ucY : PdfUnitConverter = new PdfUnitConverter(verticalResolution);
-            let ptWidth : number = ucX.convertUnits(width, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point);
-            let ptHeight : number = ucY.convertUnits(height, PdfGraphicsUnit.Pixel, PdfGraphicsUnit.Point);
-            let size : SizeF = new SizeF(ptWidth, ptHeight);
-            return size;
-        }
-    }
-}

package/dist/ts/implementation/graphics/pdf-color.ts

@@ -1,478 +0,0 @@
-import { PdfColorSpace } from './enum';
-import { Operators } from './../input-output/pdf-operators';
-import { Dictionary } from './../collections/dictionary';
-import { PdfNumber } from './../primitives/pdf-number';
-import { PdfArray } from './../primitives/pdf-array';
-/**
- * Implements structures and routines working with `color`.
- * ```typescript
- * // create a new PDF document
- * let document : PdfDocument = new PdfDocument();
- * // add a new page to the document
- * let page1 : PdfPage = document.pages.add();
- * // set the font
- * let font : PdfStandardFont = new PdfStandardFont(PdfFontFamily.Helvetica, 20);
- * //
- * // set color
- * let brushColor : PdfColor = new PdfColor(0, 0, 0);
- * //
- * // create black brush
- * let blackBrush : PdfSolidBrush = new PdfSolidBrush(brushColor);
- * // draw the text
- * page1.graphics.drawString('Hello World', font, blackBrush, new PointF(0, 0));
- * // save the document
- * document.save('output.pdf');
- * // destroy the document
- * document.destroy();
- * ```
- * @default black color
- */
-export class PdfColor {
-    //Fields
-    /**
-     * Holds `RGB colors` converted into strings.
-     * @private
-     */
-    private static rgbStrings : Dictionary<number, Object> = new Dictionary<number, Object>();
-    /**
-     * Holds Gray scale colors converted into strings for `stroking`.
-     * @private
-     */
-    private static grayStringsSroke : Dictionary<number, Object> = new Dictionary<number, Object>();
-    /**
-     * Holds Gray scale colors converted into strings for `filling`.
-     * @private
-     */
-    private static grayStringsFill : Dictionary<number, Object> = new Dictionary<number, Object>();
-    /**
-     * Value of `Red` channel.
-     * @private
-     */
-    private redColor : number;
-    /**
-     * Value of `Cyan` channel.
-     * @private
-     */
-    private cyanColor : number;
-    /**
-     * Value of `Green` channel.
-     * @private
-     */
-    private greenColor : number;
-    /**
-     * Value of `Magenta` channel.
-     * @private
-     */
-    private magentaColor : number;
-    /**
-     * Value of `Blue` channel.
-     * @private
-     */
-    private blueColor : number;
-    /**
-     * Value of `Yellow` channel.
-     * @private
-     */
-    private yellowColor : number;
-    /**
-     * Value of `Black` channel.
-     * @private
-     */
-    private blackColor : number;
-    /**
-     * Value of `Gray` channel.
-     * @private
-     */
-    private grayColor : number;
-    /**
-     * `Alpha` channel.
-     * @private
-     */
-    private alpha : number;
-    /**
-     * Shows if the color `is empty`.
-     * @private
-     */
-    private filled : boolean;
-    /**
-     * `Max value` of color channel.
-     * @private
-     */
-    public static readonly maxColourChannelValue : number = 255.0;
-
-    //constructor
-    /**
-     * Initialize a new instance for `PdfColor` class.
-     */
-    public constructor()
-    public constructor(color1 : PdfColor)
-    public constructor(color1 : number)
-    public constructor(color1 : number, color2 : number, color3 : number)
-    public constructor(color1 : number, color2 : number, color3 : number, color4 : number)
-    public constructor(color1 ?: number|PdfColor, color2 ?: number, color3 ?: number, color4 ?: number) {
-        if (typeof color1 === 'undefined') {
-            if (typeof color2 !== 'undefined' && typeof color3 !== 'undefined' && typeof color4 !== 'undefined') {
-                this.assignRGB(color2, color3, color4);
-            } else {
-                this.filled = false;
-            }
-        } else if (color1 instanceof PdfColor) {
-            this.redColor = color1.r;
-            this.greenColor = color1.g;
-            this.blueColor = color1.b;
-            this.grayColor = color1.gray;
-            this.alpha = color1.alpha;
-            this.filled = (this.alpha !== 0);
-            /* tslint:disable-next-line:max-line-length */
-        } else if (typeof color1 === 'number' && typeof color2 === 'undefined' && typeof color3 === 'undefined' && typeof color4 === 'undefined') {
-            if (color1 < 0) {
-                color1 = 0;
-            }
-            if (color1 > 1) {
-                color1 = 1;
-            }
-            this.redColor = color1 * PdfColor.maxColourChannelValue;
-            this.greenColor = color1 * PdfColor.maxColourChannelValue;
-            this.blueColor = color1 * PdfColor.maxColourChannelValue;
-            this.cyanColor = color1;
-            this.magentaColor = color1;
-            this.yellowColor = color1;
-            this.blackColor = color1;
-            this.grayColor = color1;
-            this.alpha = PdfColor.maxColourChannelValue;
-            this.filled = true;
-        } else if (typeof color4 === 'undefined') {
-            this.assignRGB(color1, color2, color3);
-        } else {
-            this.assignRGB(color2, color3, color4, color1);
-        }
-    }
-    /**
-     * `Assign` red, green, blue colors with alpha value..
-     * @private
-     */
-    private assignRGB(r : number, g : number, b : number, a ?: number) : void {
-        if (typeof r === 'undefined' || typeof g === 'undefined' || typeof b === 'undefined') {
-            this.filled = false;
-        } else {
-            this.cyanColor = 0;
-            this.magentaColor = 0;
-            this.yellowColor = 0;
-            this.blackColor = 0;
-            this.grayColor = 0;
-            this.redColor = r;
-            this.greenColor = g;
-            this.blueColor = b;
-            if ( typeof a === 'undefined') {
-               this.alpha = PdfColor.maxColourChannelValue;
-            } else {
-                this.alpha = a;
-            }
-            this.filled = true;
-            this.assignCMYK(r, g, b);
-        }
-    }
-    /**
-     * `Calculate and assign` cyan, megenta, yellow colors from rgb values..
-     * @private
-     */
-    private assignCMYK(r : number, g : number, b : number) : void {
-        let red : number = r / PdfColor.maxColourChannelValue;
-        let green : number = g / PdfColor.maxColourChannelValue;
-        let blue : number = b / PdfColor.maxColourChannelValue;
-        let black : number = PdfNumber.min(1 - red, 1 - green, 1 - blue);
-        let cyan : number = (black === 1.0) ? 0 : (1 - red - black) / (1 - black);
-        let magenta : number = (black === 1.0) ? 0 : (1 - green - black) / (1 - black);
-        let yellow : number = (black === 1.0) ? 0 : (1 - blue - black) / (1 - black);
-        this.blackColor = black;
-        this.cyanColor = cyan;
-        this.magentaColor = magenta;
-        this.yellowColor = yellow;
-    }
-
-    //Properties
-    // public static get Empty():PdfColor
-    // {
-    //     return this.s_emptyColor
-    // }
-    /**
-     * Gets or sets `Red` channel value.
-     * @private
-     */
-    public get r() : number {
-        return this.redColor;
-    }
-    public set r(value : number) {
-        this.redColor = value;
-        this.assignCMYK(this.redColor, this.greenColor, this.blueColor);
-        this.filled = true;
-    }
-    /**
-     * Gets the `Red` color
-     * @private
-     */
-    public get red() : number {
-        return (this.r / PdfColor.maxColourChannelValue);
-    }
-    /**
-     * Gets or sets `Blue` channel value.
-     * @private
-     */
-    public get b() : number {
-        return this.blueColor;
-    }
-    public set b(value : number) {
-        this.blueColor = value;
-        this.assignCMYK(this.redColor, this.greenColor, this.blueColor);
-        this.filled = true;
-    }
-    /**
-     * Gets the `blue` color.
-     * @private
-     */
-    public get blue() : number {
-        return (this.b / PdfColor.maxColourChannelValue);
-    }
-    /**
-     * Gets or sets `Cyan` channel value.
-     * @private
-     */
-    public get c() : number {
-        return this.cyanColor;
-    }
-    public set c(value : number) {
-        if (value < 0) {
-            this.cyanColor = 0;
-        } else if (value > 1) {
-            this.cyanColor = 1;
-        } else {
-            this.cyanColor = value;
-        }
-        this.assignRGB(this.cyanColor, this.magentaColor, this.yellowColor, this.blackColor);
-        this.filled = true;
-    }
-    /**
-     * Gets or sets `Black` channel value.
-     * @private
-     */
-    public get k(): number {
-        return this.blackColor;
-    }
-    public set k(value: number)  {
-        if ((value < 0)) {
-            this.blackColor = 0;
-        } else if ((value > 1)) {
-            this.blackColor = 1;
-        } else {
-            this.blackColor = value;
-        }
-        this.assignRGB(this.cyanColor, this.magentaColor, this.yellowColor, this.blackColor);
-        this.filled = true;
-    }
-    /**
-     * Gets or sets `Magenta` channel value.
-     * @private
-     */
-    public get m(): number {
-        return this.magentaColor;
-    }
-    public set m(value: number)  {
-        if ((value < 0)) {
-            this.magentaColor = 0;
-        } else if ((value > 1)) {
-            this.magentaColor = 1;
-        } else {
-            this.magentaColor = value;
-        }
-        this.assignRGB(this.cyanColor, this.magentaColor, this.yellowColor, this.blackColor);
-        this.filled = true;
-    }
-    /**
-     * Gets or sets `Yellow` channel value.
-     * @private
-     */
-    public get y(): number {
-        return this.yellowColor;
-    }
-    public set y(value: number)  {
-        if ((value < 0)) {
-            this.yellowColor = 0;
-        } else if ((value > 1)) {
-            this.yellowColor = 1;
-        } else {
-            this.yellowColor = value;
-        }
-        this.assignRGB(this.cyanColor, this.magentaColor, this.yellowColor, this.blackColor);
-        this.filled = true;
-    }
-    /**
-     *  Gets or sets `Green` channel value.
-     * @private
-     */
-    public get g() : number {
-        return this.greenColor;
-    }
-    public set g(value : number) {
-        this.greenColor = value;
-        this.assignCMYK(this.redColor, this.greenColor, this.blueColor);
-        this.filled = true;
-    }
-    /**
-     * Gets the `Green` color.
-     * @private
-     */
-    public get green() : number {
-        return (this.g / PdfColor.maxColourChannelValue);
-    }
-    /**
-     * Gets or sets `Gray` channel value.
-     * @private
-     */
-    public get gray() : number
-    {
-        return ((((this.redColor + this.greenColor) + this.blueColor)) / (PdfColor.maxColourChannelValue * 3));
-    }
-    public set gray(value : number) {
-        if (value < 0) {
-            this.grayColor = 0;
-        } else if (value > 1) {
-            this.grayColor = 1;
-        } else {
-            this.grayColor = value;
-        }
-        this.r = (this.grayColor * PdfColor.maxColourChannelValue);
-        this.g = (this.grayColor * PdfColor.maxColourChannelValue);
-        this.b = (this.grayColor * PdfColor.maxColourChannelValue);
-        this.assignCMYK(this.redColor, this.greenColor, this.blueColor);
-        this.filled = true;
-    }
-    /**
-     * Gets whether the PDFColor `is Empty` or not.
-     * @private
-     */
-    public get isEmpty() : boolean
-    {
-        return !this.filled;
-    }
-    /**
-     * Gets or sets `Alpha` channel value.
-     * @private
-     */
-    public get a() : number
-    {
-        return this.alpha;
-    }
-    public set a(value : number) {
-        if (value < 0) {
-            this.alpha = 0;
-        } else {
-            // if (this.alpha !== value) {
-            this.alpha = value;
-            // }
-        }
-        this.filled = true;
-    }
-    //Public methods
-    /**
-     * Converts `PDFColor to PDF string` representation.
-     * @private
-     */
-    public toString(colorSpace : PdfColorSpace, stroke : boolean) : string {
-        if (this.isEmpty) {
-            return '';
-        }
-        let str : string = '';
-        switch (colorSpace) {
-            case PdfColorSpace.Rgb:
-                str = this.rgbToString(stroke);
-                break;
-            case PdfColorSpace.GrayScale:
-                str = this.grayScaleToString(stroke);
-                break;
-            case PdfColorSpace.Cmyk:
-                str = this.cmykToString(stroke);
-                break;
-        }
-        return str;
-    }
-    /**
-     * Sets `GrayScale` color.
-     * @private
-     */
-    private grayScaleToString(ifStroking : boolean) : string {
-        let gray : number = this.gray;
-        let colour : string = '';
-        let obj : Object = null;
-        /* tslint:disable-next-line:max-line-length */
-        obj = (ifStroking) ? PdfColor.grayStringsSroke.containsKey(gray) ? PdfColor.grayStringsSroke.getValue(gray) : null : PdfColor.grayStringsFill.containsKey(gray) ? PdfColor.grayStringsFill.getValue(gray) : null;
-        if (obj == null) {
-            if (ifStroking) {
-                colour = gray.toString() + ' G';
-                PdfColor.grayStringsSroke.setValue(gray, colour);
-            }
-        } else {
-            colour = obj.toString();
-        }
-        return colour + Operators.newLine;
-    }
-    /**
-     * Sets `RGB` color.
-     * @private
-     */
-    private rgbToString(ifStroking : boolean) : string {
-        let r : number = this.r;
-        let g : number = this.g;
-        let b : number = this.b;
-        let key : number = (r << 16) + (g << 8) + b;
-        if (ifStroking) {
-            key += 1 << 24;
-        }
-        let colour : string = '';
-        let obj : Object = null;
-        if (PdfColor.rgbStrings.containsKey(key)) {
-            obj = PdfColor.rgbStrings.getValue(key);
-        }
-        if (obj == null) {
-            let red : number = r / PdfColor.maxColourChannelValue;
-            let green : number = g / PdfColor.maxColourChannelValue;
-            let blue : number = b / PdfColor.maxColourChannelValue;
-            if (ifStroking) {
-                colour = red.toString() + ' ' + green.toString() + ' ' + blue.toString() + ' RG';
-            } else {
-                colour = red.toString() + ' ' + green.toString() + ' ' + blue.toString() + ' rg';
-            }
-            PdfColor.rgbStrings.setValue(key, colour);
-        } else {
-            colour = obj.toString();
-        }
-        return colour + Operators.newLine;
-    }
-    /***
-     * Sets `CMYK` color.
-     * @private
-     */
-    private cmykToString(ifStroking : boolean) : string {
-        let cyan : number = this.c;
-        let magenta : number = this.m;
-        let yellow : number = this.y;
-        let black : number = this.b;
-        let colour : string = '';
-        colour = cyan.toString() + ' ' + magenta.toString() + ' ' + yellow.toString() + ' ' + black.toString() + ' K';
-        return colour + Operators.newLine;
-    }
-    /**
-     * Converts `colour to a PDF array`.
-     * @private
-     */
-    public toArray(colorSpace : PdfColorSpace) : PdfArray {
-        let array : PdfArray = new PdfArray();
-        switch (colorSpace) {
-            case PdfColorSpace.Rgb:
-                array.add(new PdfNumber(this.red));
-                array.add(new PdfNumber(this.green));
-                array.add(new PdfNumber(this.blue));
-                break;
-        }
-        return array;
-    }
-}