@syncfusion/ej2-pdf-export 21.2.10 → 22.1.34

package/dist/ts/implementation/pages/pdf-page-layer-collection.ts

@@ -0,0 +1,348 @@
+/**
+ * PdfPageLayerCollection.ts class for EJ2-PDF
+ */
+import { PdfPageBase } from './pdf-page-base';
+import { PdfPage } from './pdf-page';
+import { PdfDictionary } from './../primitives/pdf-dictionary';
+import { PdfPageLayer } from './pdf-page-layer';
+import { PdfCollection } from './../general/pdf-collection';
+import { PdfReferenceHolder } from './../primitives/pdf-reference';
+import { PdfArray } from './../primitives/pdf-array';
+import { PdfCrossTable } from './../input-output/pdf-cross-table';
+import { PdfStream } from './../primitives/pdf-stream';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+/**
+ * The class provides methods and properties to handle the collections of `PdfPageLayer`.
+ */
+export class PdfPageLayerCollection extends PdfCollection {
+    // Fields
+    /**
+     * Parent `page`.
+     * @private
+     */
+    private page : PdfPageBase;
+    /**
+     * Stores the `number of first level layers` in the document.
+     * @default 0
+     * @private
+     */
+    private parentLayerCount : number = 0;
+    /**
+     * Indicates if `Sublayer` is present.
+     * @default false
+     * @private
+     */
+    public sublayer : boolean = false;
+    /**
+     * Stores the `optional content dictionary`.
+     * @private
+     */
+    public optionalContent : PdfDictionary = new PdfDictionary();
+    // Properties
+    /**
+     * Return the `PdfLayer` from the layer collection by index.
+     * @private
+     */
+    public items(index : number) : PdfPageLayer
+    /**
+     * Stores the `layer` into layer collection with specified index.
+     * @private
+     */
+    public items(index : number, value : PdfPageLayer) : void
+    public items(index : number, value ?: PdfPageLayer) : void|PdfPageLayer {
+        if (typeof index === 'number' && typeof value === 'undefined') {
+            let obj : Object = this.list[index];
+            return (obj as PdfPageLayer);
+        } else {
+            if (value == null) {
+                throw new Error('ArgumentNullException: layer');
+            }
+            if (value.page !== this.page) {
+                throw new Error('ArgumentException: The layer belongs to another page');
+            }
+            // // Add/remove the layer.
+            // let layer : PdfPageLayer = this.items(index);
+            // if (layer != null) {
+            //     this.RemoveLayer(layer);
+            // }
+            // this.List[index] = value;
+            // this.InsertLayer(index, value);
+        }
+    }
+    //  Constructors
+    /**
+     * Initializes a new instance of the `PdfPageLayerCollection` class
+     * @private
+     */
+    public constructor()
+    /**
+     * Initializes a new instance of the `PdfPageLayerCollection` class
+     * @private
+     */
+    public constructor(page : PdfPageBase)
+    public constructor(page? : PdfPageBase) {
+        super();
+        if (page instanceof PdfPageBase) {
+            // if (page == null) {
+            //     throw new Error('ArgumentNullException:page');
+            // }
+            this.page = page;
+            let lPage : PdfPageBase = page;
+            // if (lPage != null) {
+            this.parseLayers(lPage);
+            // }
+        }
+    }
+    // Implementation
+    /**
+     * Creates a new `PdfPageLayer` and adds it to the end of the collection.
+     * @private
+     */
+    public add() : PdfPageLayer
+    /**
+     * Creates a new `PdfPageLayer` and adds it to the end of the collection.
+     * @private
+     */
+    public add(layerName : string, visible : boolean) : PdfPageLayer
+    /**
+     * Creates a new `PdfPageLayer` and adds it to the end of the collection.
+     * @private
+     */
+    public add(layerName : string) : PdfPageLayer
+    /**
+     * Creates a new `PdfPageLayer` and adds it to the end of the collection.
+     * @private
+     */
+    public add(layer : PdfPageLayer) : number
+    public add(firstArgument ?: PdfPageLayer|string, secondArgument ?: boolean) : PdfPageLayer|number {
+        if (typeof firstArgument === 'undefined') {
+            let layer : PdfPageLayer = new PdfPageLayer(this.page);
+            layer.name = '';
+            this.add(layer);
+            return layer;
+        } else if (firstArgument instanceof PdfPageLayer) {
+            // if (layer == null)
+            //     throw new ArgumentNullException("layer");
+            // if (layer.Page != m_page)
+            //     throw new ArgumentException("The layer belongs to another page");
+            let index : number = this.list.push(firstArgument);
+            // Register layer.
+            this.addLayer(index, firstArgument);
+            return index;
+        } else {
+            return 0;
+        }
+    }
+    /**
+     * Registers `layer` at the page.
+     * @private
+     */
+    private addLayer(index : number, layer : PdfPageLayer) : void {
+        let reference : PdfReferenceHolder = new PdfReferenceHolder(layer);
+        this.page.contents.add(reference);
+    }
+    // private RemoveLayer(layer : PdfPageLayer) : void {
+    //     if (layer == null) {
+    //         throw new Error('ArgumentNullException:layer');
+    //     }
+    //     let reference : PdfReferenceHolder = new PdfReferenceHolder(layer);
+    //     if (this.page != null) {
+    //         this.page.Contents.Remove(reference);
+    //     }
+    // }
+    /**
+     * Inserts `PdfPageLayer` into the collection at specified index.
+     * @private
+     */
+    public insert(index : number, layer : PdfPageLayer) : void {
+        // if (index < 0)
+        //     throw new ArgumentOutOfRangeException("index", "Value can not be less 0");
+        // if (layer == null)
+        //     throw new ArgumentNullException("layer");
+        // if (layer.Page != m_page)
+        //     throw new ArgumentException("The layer belongs to another page");
+        let list : Object[] = [];
+        let length : number = this.list.length;
+        for (let i : number = index; i < length; i++) {
+            list.push(this.list.pop());
+        }
+        this.list.push(layer);
+        for (let i : number = 0; i < list.length; i++) {
+            this.list.push(list[i]);
+        }
+        // Register layer.
+        this.insertLayer(index, layer);
+    }
+    /**
+     * Registers layer at the page.
+     * @private
+     */
+    private insertLayer(index : number, layer : PdfPageLayer) : void {
+        if (layer == null) {
+            throw new Error('ArgumentNullException:layer');
+        }
+        let reference : PdfReferenceHolder = new PdfReferenceHolder(layer);
+        this.page.contents.insert(index, reference);
+    }
+    // tslint:disable
+    /**
+     * `Parses the layers`.
+     * @private
+     */
+    private parseLayers(loadedPage : PdfPageBase) : void {// tslint:enable
+        // if (loadedPage == null) {
+        //     throw new Error('ArgumentNullException:loadedPage');
+        // }
+        let contents : PdfArray = this.page.contents;
+        let resource : PdfDictionary = this.page.getResources();
+        let crossTable : PdfCrossTable = null;
+        let ocproperties : PdfDictionary = null;
+        let propertie : PdfDictionary = null;
+        let isLayerAdded : boolean = false;
+        // if (loadedPage instanceof PdfPage) {
+        crossTable = (loadedPage as PdfPage).crossTable;
+        // } else {
+        //     crossTable = (loadedPage as PdfLoadedPage).CrossTable;
+        //     Propertie = PdfCrossTable.Dereference(Resource[DictionaryProperties.Properties]) as PdfDictionary;
+        //     ocproperties = PdfCrossTable.Dereference((loadedPage as PdfLoadedPage).
+        //     Document.Catalog[DictionaryProperties.OCProperties]) as PdfDictionary;
+        // }
+        let saveStream : PdfStream = new PdfStream();
+        let restoreStream : PdfStream = new PdfStream();
+        let saveState : string = 'q';
+        let newLine : string = '\n';
+        let restoreState : string = 'Q';
+        // for (let index : number = 0; index < contents.Items.length; index++) {
+        //     let obj : IPdfPrimitive = contents[index];
+        //     let stream : PdfStream = crossTable.GetObject(obj) as PdfStream;
+
+        //     if (stream == null)
+        //         throw new PdfDocumentException("Invalid contents array.");
+
+        //     // if (stream.Compress)
+        //     {
+        //         if (!loadedPage.Imported)
+        //             stream.Decompress();
+        //     }
+
+        //     byte[] contentId = stream.Data;
+        //     string str = PdfString.ByteToString(contentId);
+
+        //     if (!loadedPage.Imported && (contents.Count == 1) && ((stream.Data[stream.Data.Length - 2] ==
+        //     RestoreState) || (stream.Data[stream.Data.Length - 1] == RestoreState)))
+        //     {
+        //         byte[] content = stream.Data;
+        //         byte[] data = new byte[content.Length + 4];
+        //         data[0] = SaveState;
+        //         data[1] = NewLine;
+        //         content.CopyTo(data, 2);
+        //         data[data.Length - 2] = NewLine;
+        //         data[data.Length - 1] = RestoreState;
+        //         stream.Data = data;
+        //     }
+
+        //     if (ocproperties != null)
+        //     {
+        //         if (Propertie != null)
+        //         {
+        //             foreach (KeyValuePair<PdfName, IPdfPrimitive> prop in Propertie.Items)
+        //             {
+        //                 String Key = prop.Key.ToString();
+        //                 PdfReferenceHolder refh = prop.Value as PdfReferenceHolder;
+        //                 PdfDictionary Dict = null;
+        //                 if (refh != null)
+        //                 {
+        //                     Dict = refh.Object as PdfDictionary;
+        //                 }
+        //                 else
+        //                 {
+        //                     Dict = prop.Value as PdfDictionary;
+        //                 }
+        //                 PdfDictionary m_usage = PdfCrossTable.Dereference(Dict[DictionaryProperties.Usage]) as PdfDictionary;
+        //                 if (m_usage != null)
+        //                 {
+
+        //                     if (str.Contains(Key))
+        //                     {
+        //                         PdfPageLayer layer = new PdfPageLayer(loadedPage, stream);
+        //                         PdfDictionary printoption = PdfCrossTable.Dereference(m_usage[DictionaryProperties.Print])
+        //                         as PdfDictionary;
+        //                         if (printoption != null)
+        //                         {
+        //                             layer.m_printOption = printoption;
+
+        //                             foreach (KeyValuePair<PdfName, IPdfPrimitive> value in printoption.Items)
+        //                             {
+        //                                 if (value.Key.Value.Equals(DictionaryProperties.PrintState))
+        //                                 {
+        //                                     string printState = (value.Value as PdfName).Value;
+        //                                     if (printState.Equals(DictionaryProperties.OCGON))
+        //                                     {
+        //                                         layer.PrintState = PdfPrintState.AlwaysPrint;
+        //                                         break;
+        //                                     }
+        //                                     else
+        //                                     {
+        //                                         layer.PrintState = PdfPrintState.NeverPrint;
+        //                                         break;
+        //                                     }
+        //                                 }
+        //                             }
+        //                         }
+        //                         PdfString layerName = PdfCrossTable.Dereference(Dict[DictionaryProperties.Name]) as PdfString;
+        //                         layer.Name = layerName.Value;
+        //                         List.add(layer);
+        //                         isLayerAdded = true;
+        //                         if(!str.Contains("EMC"))
+        //                         break;
+        //                     }
+        //                 }
+        //                 else
+        //                 {
+
+        //                     if (str.Contains(Key))
+        //                     {
+        //                         PdfPageLayer layer = new PdfPageLayer(loadedPage, stream);
+        //                         List.add(layer);
+        //                         if(Dict.ContainsKey(DictionaryProperties.Name))
+        //                         {
+        //                         PdfString layerName = PdfCrossTable.Dereference(Dict[DictionaryProperties.Name]) as PdfString;
+        //                         layer.Name = layerName.Value;
+        //                         }
+        //                         isLayerAdded = true;
+        //                         break;
+        //                     }
+        //                 }
+        //             }
+        //         }
+
+        //     }
+        //     if (!isLayerAdded)
+        //     {
+        //         PdfPageLayer layer = new PdfPageLayer(loadedPage, stream);
+        //         List.add(layer);
+        //     }
+        //     else
+        //         isLayerAdded = false;
+        // }
+        let saveData : string[] = [];
+        saveData.push(saveState);
+        saveStream.data = saveData;
+        contents.insert(0, new PdfReferenceHolder(saveStream));
+        saveData = [];
+        saveData.push(restoreState);
+        restoreStream.data = saveData;
+        contents.insert(contents.count, new PdfReferenceHolder(restoreStream));
+    }
+    /**
+     * Returns `index of` the `PdfPageLayer` in the collection if exists, -1 otherwise.
+     * @private
+     */
+    public indexOf(layer : PdfPageLayer) : number {
+        if (layer == null) {
+            throw new Error('ArgumentNullException: layer');
+        }
+        let index : number = this.list.indexOf(layer);
+        return index;
+    }
+}

package/dist/ts/implementation/pages/pdf-page-layer.ts

@@ -0,0 +1,271 @@
+/**
+ * PdfPageLayer.ts class for EJ2-PDF
+ */
+import { IPdfWrapper } from './../../interfaces/i-pdf-wrapper';
+import { IPdfPrimitive } from './../../interfaces/i-pdf-primitives';
+import { PdfPageBase } from './pdf-page-base';
+import { PdfStream } from './../primitives/pdf-stream';
+import { PdfDictionary } from './../primitives/pdf-dictionary';
+import { PdfGraphics, GetResourceEventHandler } from './../graphics/pdf-graphics';
+import { PdfPageLayerCollection } from './pdf-page-layer-collection';
+import { DictionaryProperties } from './../input-output/pdf-dictionary-properties';
+import { PdfArray } from './../primitives/pdf-array';
+import { PdfPage } from './pdf-page';
+import { RectangleF } from './../drawing/pdf-drawing';
+import { PdfSectionCollection } from './../pages/pdf-section-collection';
+import { PdfColorSpace } from './../graphics/enum';
+import { PdfMargins } from './../graphics/pdf-margins';
+/**
+ * The `PdfPageLayer` used to create layers in PDF document.
+ * @private
+ */
+export class PdfPageLayer implements IPdfWrapper {
+    // Fields
+    /**
+     * Parent `page` of the layer.
+     * @private
+     */
+    private pdfPage : PdfPageBase;
+    /**
+     * `Graphics context` of the layer.
+     * @private
+     */
+    private pdfGraphics : PdfGraphics;
+    /**
+     * `Content` of the object.
+     * @private
+     */
+    private content : PdfStream;
+    /**
+     * Indicates whether the layer should `clip page template` dimensions or not.
+     * @private
+     */
+    private clipPageTemplates : boolean;
+    // private bSaved : boolean;
+    /**
+     * Local Variable to store the `color space` of the document.
+     * @private
+     */
+    private pdfColorSpace : PdfColorSpace = PdfColorSpace.Rgb;
+    /**
+     * Local Variable to store the `layer id`.
+     * @private
+     */
+    private layerid : string;
+    /**
+     * Local Variable to store the `name`.
+     * @private
+     */
+    private layerName : string;
+    /**
+     * Local Variable to set `visibility`.
+     * @default true
+     * @private
+     */
+    private isVisible : boolean = true;
+    /**
+     * Collection of the `layers` of the page.
+     * @private
+     */
+    private layer : PdfPageLayerCollection;
+    /**
+     * Indicates if `Sublayer` is present.
+     * @default false
+     * @private
+     */
+    public sublayer : boolean = false;
+    /**
+     * Local variable to store `length` of the graphics.
+     * @default 0
+     * @private
+     */
+    public contentLength : number = 0;
+    /**
+     * Stores the `print Option` dictionary.
+     * @private
+     */
+    public printOption : PdfDictionary;
+    /**
+     * Stores the `usage` dictionary.
+     * @private
+     */
+    public usage : PdfDictionary;
+    /**
+     * Instance for `PdfDictionaryProperties` Class.
+     * @private
+     */
+    private dictionaryProperties : DictionaryProperties = new DictionaryProperties();
+    // Properties
+    /**
+     * Get or set the `color space`.
+     * @private
+     */
+    public get colorSpace() : PdfColorSpace {
+        return this.pdfColorSpace;
+    }
+    public set colorSpace(value : PdfColorSpace) {
+        this.pdfColorSpace = value;
+    }
+    /**
+     * Gets parent `page` of the layer.
+     * @private
+     */
+    public get page() : PdfPageBase {
+        return this.pdfPage;
+    }
+    /**
+     * Gets and Sets the `id of the layer`.
+     * @private
+     */
+    public get layerId() : string {
+        return this.layerid;
+    }
+    public set layerId(value : string) {
+        this.layerid = value;
+    }
+    /**
+     * Gets or sets the `name` of the layer.
+     * @private
+     */
+    public get name() : string {
+        return this.layerName;
+    }
+    public set name(value : string) {
+        this.layerName = value;
+    }
+    /**
+     * Gets or sets the `visibility` of the layer.
+     * @private
+     */
+    public get visible() : boolean {
+        return this.isVisible;
+    }
+    public set visible(value : boolean) {
+        this.isVisible = value;
+    }
+    /**
+     * Gets `Graphics` context of the layer, used to draw various graphical content on layer.
+     * @private
+     */
+    public get graphics() : PdfGraphics {
+        if ((this.pdfGraphics == null)) {
+            this.initializeGraphics(this.page);
+        }
+        return this.pdfGraphics;
+    }
+    /**
+     * Gets the collection of `PdfPageLayer`, this collection handle by the class 'PdfPageLayerCollection'.
+     * @private
+     */
+    public get layers() : PdfPageLayerCollection {
+        if (this.layer == null) {
+            this.layer = new PdfPageLayerCollection(this.page);
+            this.layer.sublayer  = true;
+            return this.layer;
+        } else {
+            return this.layer;
+        }
+    }
+    // Constructors
+    /**
+     * Initializes a new instance of the `PdfPageLayer` class with specified PDF page.
+     * @private
+     */
+    public constructor(page : PdfPageBase)
+    /**
+     * Initializes a new instance of the `PdfPageLayer` class with specified PDF page and PDF stream.
+     * @private
+     */
+    public constructor(page : PdfPageBase, stream : PdfStream)
+    /**
+     * Initializes a new instance of the `PdfPageLayer` class.
+     * @private
+     */
+    public constructor(page : PdfPageBase, clipPageTemplates : boolean)
+    public constructor(page : PdfPageBase, streamClipPageTemplates ?: boolean|PdfStream) {
+        if (page === null) {
+            throw new Error('ArgumentNullException:page');
+        }
+        this.pdfPage = page;
+        this.clipPageTemplates = true;
+        if (typeof streamClipPageTemplates === 'undefined') {
+             this.content = new PdfStream();
+        } else if (streamClipPageTemplates instanceof PdfStream || streamClipPageTemplates === null) {
+            if (streamClipPageTemplates === null) {
+                throw new Error('ArgumentNullException:stream');
+            }
+            this.content = streamClipPageTemplates as PdfStream;
+        } else {
+            this.content = new PdfStream();
+            this.clipPageTemplates = streamClipPageTemplates;
+        }
+    }
+    // Implementation
+    /**
+     * `Adds` a new PDF Page layer.
+     * @private
+     */
+    public add() : PdfPageLayer {
+        let layer : PdfPageLayer = new PdfPageLayer(this.pdfPage);
+        layer.name = '';
+        return layer;
+    }
+    /**
+     * Returns a value indicating the `sign` of a single-precision floating-point number.
+     * @private
+     */
+    private sign(number : number) : number {
+        if (number === 0) {
+            return 0;
+        } else if (number > 0) {
+            return 1;
+        } else {
+            return -1;
+        }
+    }
+    /**
+     * `Initializes Graphics context` of the layer.
+     * @private
+     */
+    private initializeGraphics(page : PdfPageBase) : void {
+        let oPage : PdfPage = page as PdfPage;
+        let gr : GetResourceEventHandler = new GetResourceEventHandler(this.page);
+        let cropBox : PdfArray = null;
+        this.pdfGraphics = new PdfGraphics(page.size, gr, this.content);
+        this.pdfGraphics.mediaBoxUpperRightBound = 0;
+        if (oPage != null) {
+            let sc : PdfSectionCollection = oPage.section.parent;
+            if (sc != null) {
+                this.pdfGraphics.colorSpace = sc.document.colorSpace;
+                this.colorSpace = sc.document.colorSpace;
+            }
+        }
+        // Transform coordinates to the left/top and activate margins.
+        let isSame : boolean = (this.sign(page.origin.y) === this.sign(page.origin.x));
+        // if (page != null) {
+        if (page.origin.x >= 0 && page.origin.y >= 0 || !(isSame)) {
+            this.pdfGraphics.initializeCoordinates();
+        } else {
+            // this.m_graphics.InitializeCoordinates(page);
+        }
+        let clipRect : RectangleF = oPage.section.getActualBounds(oPage, true);
+        let margins : PdfMargins = oPage.section.pageSettings.margins;
+        if (this.clipPageTemplates) {
+            if (page.origin.x >= 0 && page.origin.y >= 0) {
+                this.pdfGraphics.clipTranslateMargins(clipRect);
+            }
+        } else {
+            this.graphics.clipTranslateMargins(clipRect.x, clipRect.y, margins.left, margins.top, margins.right, margins.bottom);
+        }
+        this.pdfGraphics.setLayer(this);
+        // this.bSaved = false;
+    }
+    // IPdfWrapper Members
+    /**
+     * Gets the wrapped `element`.
+     * @private
+     */
+    public get element() : IPdfPrimitive {
+        return this.content;
+    }
+}