@syncfusion/ej2-pdf-export 25.2.3 → 26.2.4

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

@@ -0,0 +1,88 @@
+/**
+ * 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';
+/**
+ * `PdfImage` class represents the base class for images and provides functionality for the 'PdfBitmap' class.
+ * @private
+ */
+export declare abstract class PdfImage implements IPdfWrapper {
+    /**
+     * `Width` of an image.
+     * @private
+     */
+    private imageWidth;
+    /**
+     * `Height` of an image.
+     * @private
+     */
+    private imageHeight;
+    /**
+     * `Bits per component` of an image.
+     * @hidden
+     * @private
+     */
+    bitsPerComponent: number;
+    /**
+     * `horizontal resolution` of an image.
+     * @hidden
+     * @private
+     */
+    horizontalResolution: number;
+    /**
+     * `Vertical resolution` of an image.
+     * @hidden
+     * @private
+     */
+    verticalResolution: number;
+    /**
+     * `physical dimension` of an image.
+     * @hidden
+     * @private
+     */
+    private imagePhysicalDimension;
+    /**
+     * Gets and Sets the `width` of an image.
+     * @private
+     */
+    width: number;
+    /**
+     * Gets and Sets the `height` of an image.
+     * @private
+     */
+    height: number;
+    /**
+     * Gets or sets the size of the image.
+     * @private
+     */
+    size: SizeF;
+    /**
+     * Gets the `physical dimension` of an image.
+     * @private
+     */
+    readonly physicalDimension: SizeF;
+    /**
+     * return the stored `stream of an image`.
+     * @private
+     */
+    imageStream: PdfStream;
+    /**
+     * Gets the `element` image stream.
+     * @private
+     */
+    readonly element: IPdfPrimitive;
+    /**
+     * `Save` the image stream.
+     * @private
+     */
+    abstract save(): void;
+    /**
+     * Return the value of `width and height of an image` in points.
+     * @private
+     */
+    getPointSize(width: number, height: number): SizeF;
+    getPointSize(width: number, height: number, horizontalResolution: number, verticalResolution: number): SizeF;
+}

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

@@ -0,0 +1,132 @@
+/**
+ * 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/index.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Graphics classes
+ * @hidden
+ */
+export * from './constants';
+export * from './enum';
+export * from './pdf-color';
+export * from './pdf-graphics';
+export * from './pdf-margins';
+export * from './pdf-pen';
+export * from './pdf-resources';
+export * from './pdf-transformation-matrix';
+export * from './pdf-transparency';
+export * from './brushes/pdf-brush';
+export * from './brushes/pdf-solid-brush';
+export * from './brushes/pdf-gradient-brush';
+export * from './brushes/pdf-linear-gradient-brush';
+export * from './brushes/pdf-radial-gradient-brush';
+export * from './brushes/pdf-tiling-brush';
+export * from './brushes/pdf-color-blend';
+export * from './brushes/pdf-blend';
+export * from './brushes/pdf-brushes';
+export * from './figures/pdf-template';
+export * from './fonts/enum';
+export * from './fonts/pdf-font';
+export * from './fonts/pdf-font-metrics';
+export * from './fonts/pdf-standard-font';
+export * from './fonts/pdf-standard-font-metrics-factory';
+export * from './fonts/pdf-string-format';
+export * from './fonts/string-layouter';
+export * from './fonts/string-tokenizer';
+export * from './fonts/pdf-true-type-font';
+export * from './fonts/unicode-true-type-font';
+export * from './fonts/ttf-reader';
+export * from './fonts/ttf-table-info';

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

@@ -0,0 +1,46 @@
+/**
+ * Graphics classes
+ * @hidden
+ */
+export * from './constants';
+export * from './enum'
+export * from './pdf-color';
+export * from './pdf-graphics';
+export * from './pdf-margins';
+export * from './pdf-pen';
+export * from './pdf-resources';
+export * from './pdf-transformation-matrix';
+export * from './pdf-transparency';
+// export * from './UnitConvertor';
+export * from './brushes/pdf-brush';
+export * from './brushes/pdf-solid-brush';
+export * from './brushes/pdf-gradient-brush';
+export * from './brushes/pdf-linear-gradient-brush';
+export * from './brushes/pdf-radial-gradient-brush';
+export * from './brushes/pdf-tiling-brush';
+export * from './brushes/pdf-color-blend';
+export * from './brushes/pdf-blend';
+export * from './brushes/pdf-brushes';
+export * from './figures/pdf-template';
+// export * from './Figures/LayoutElement';
+// export * from './Figures/TextElement';
+// export * from './Figures/Base/ElementLayouter';
+// export * from './Figures/Base/TextLayouter';
+export * from './fonts/enum';
+export * from './fonts/pdf-font';
+export * from './fonts/pdf-font-metrics';
+export * from './fonts/pdf-standard-font';
+export * from './fonts/pdf-standard-font-metrics-factory';
+export * from './fonts/pdf-string-format';
+export * from './fonts/string-layouter';
+export * from './fonts/string-tokenizer';
+export * from './fonts/pdf-true-type-font';
+export * from './fonts/unicode-true-type-font';
+export * from './fonts/ttf-reader';
+export * from './fonts/ttf-table-info';
+// export * from './Images/byte-array';
+// export * from './Images/ImageDecoder';
+// export * from './Images/PdfBitmap';
+// export * from './Images/PdfImage';
+// export * from './Images/PdfMetafile';
+// export * from './Images/type-cast-and-shift';

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

@@ -0,0 +1,206 @@
+import { PdfColorSpace } from './enum';
+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 declare class PdfColor {
+    /**
+     * Holds `RGB colors` converted into strings.
+     * @private
+     */
+    private static rgbStrings;
+    /**
+     * Holds Gray scale colors converted into strings for `stroking`.
+     * @private
+     */
+    private static grayStringsSroke;
+    /**
+     * Holds Gray scale colors converted into strings for `filling`.
+     * @private
+     */
+    private static grayStringsFill;
+    /**
+     * Value of `Red` channel.
+     * @private
+     */
+    private redColor;
+    /**
+     * Value of `Cyan` channel.
+     * @private
+     */
+    private cyanColor;
+    /**
+     * Value of `Green` channel.
+     * @private
+     */
+    private greenColor;
+    /**
+     * Value of `Magenta` channel.
+     * @private
+     */
+    private magentaColor;
+    /**
+     * Value of `Blue` channel.
+     * @private
+     */
+    private blueColor;
+    /**
+     * Value of `Yellow` channel.
+     * @private
+     */
+    private yellowColor;
+    /**
+     * Value of `Black` channel.
+     * @private
+     */
+    private blackColor;
+    /**
+     * Value of `Gray` channel.
+     * @private
+     */
+    private grayColor;
+    /**
+     * `Alpha` channel.
+     * @private
+     */
+    private alpha;
+    /**
+     * Shows if the color `is empty`.
+     * @private
+     */
+    private filled;
+    /**
+     * `Max value` of color channel.
+     * @private
+     */
+    static readonly maxColourChannelValue: number;
+    /**
+     * Initialize a new instance for `PdfColor` class.
+     */
+    constructor();
+    constructor(color1: PdfColor);
+    constructor(color1: number);
+    constructor(color1: number, color2: number, color3: number);
+    constructor(color1: number, color2: number, color3: number, color4: number);
+    /**
+     * `Assign` red, green, blue colors with alpha value..
+     * @private
+     */
+    private assignRGB;
+    /**
+     * `Calculate and assign` cyan, megenta, yellow colors from rgb values..
+     * @private
+     */
+    private assignCMYK;
+    /**
+     * Gets or sets `Red` channel value.
+     * @private
+     */
+    r: number;
+    /**
+     * Gets the `Red` color
+     * @private
+     */
+    readonly red: number;
+    /**
+     * Gets or sets `Blue` channel value.
+     * @private
+     */
+    b: number;
+    /**
+     * Gets the `blue` color.
+     * @private
+     */
+    readonly blue: number;
+    /**
+     * Gets or sets `Cyan` channel value.
+     * @private
+     */
+    c: number;
+    /**
+     * Gets or sets `Black` channel value.
+     * @private
+     */
+    k: number;
+    /**
+     * Gets or sets `Magenta` channel value.
+     * @private
+     */
+    m: number;
+    /**
+     * Gets or sets `Yellow` channel value.
+     * @private
+     */
+    y: number;
+    /**
+     *  Gets or sets `Green` channel value.
+     * @private
+     */
+    g: number;
+    /**
+     * Gets the `Green` color.
+     * @private
+     */
+    readonly green: number;
+    /**
+     * Gets or sets `Gray` channel value.
+     * @private
+     */
+    gray: number;
+    /**
+     * Gets whether the PDFColor `is Empty` or not.
+     * @private
+     */
+    readonly isEmpty: boolean;
+    /**
+     * Gets or sets `Alpha` channel value.
+     * @private
+     */
+    a: number;
+    /**
+     * Converts `PDFColor to PDF string` representation.
+     * @private
+     */
+    toString(colorSpace: PdfColorSpace, stroke: boolean): string;
+    /**
+     * Sets `GrayScale` color.
+     * @private
+     */
+    private grayScaleToString;
+    /**
+     * Sets `RGB` color.
+     * @private
+     */
+    private rgbToString;
+    /***
+     * Sets `CMYK` color.
+     * @private
+     */
+    private cmykToString;
+    /**
+     * Converts `colour to a PDF array`.
+     * @private
+     */
+    toArray(colorSpace: PdfColorSpace): PdfArray;
+}