npm - @pdftron/pdfnet-node-samples - Versions diffs - 10.9.0 → 10.10.0-beta - Mend

@pdftron/pdfnet-node-samples 10.9.0 → 10.10.0-beta

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (135) hide show

package/{samples/ElementBuilderTest → ElementBuilderTest}/ElementBuilderTest.js RENAMED Viewed

@@ -1,514 +1,514 @@
-//---------------------------------------------------------------------------------------
-// Copyright (c) 2001-2024 by Apryse Software Inc. All Rights Reserved.
-// Consult legal.txt regarding legal and license information.
-//---------------------------------------------------------------------------------------
-const { PDFNet } = require('@pdftron/pdfnet-node');
-const PDFTronLicense = require('../LicenseKey/LicenseKey');
-((exports) => {
-  exports.runElementBuilderTest = () => {
-    const main = async() => {
-      let ret = 0;
-      // Relative path to the folder containing test files.
-      const inputPath = '../TestFiles/';
-      try {
-        const doc = await PDFNet.PDFDoc.create();
-        // ElementBuilder is used to build new Element objects
-        const eb = await PDFNet.ElementBuilder.create();
-        // ElementWriter is used to write Elements to the page
-        const writer = await PDFNet.ElementWriter.create();
-        let element;
-        let gstate;
-        // Start a new page ------------------------------------
-        const pageRect = await PDFNet.Rect.init(0, 0, 612, 794);
-        let page = await doc.pageCreate(pageRect);
-        // begin writing to the page
-        writer.beginOnPage(page);
-        // Create an Image that can be reused in the document or on the same page.
-        const img = await PDFNet.Image.createFromFile(doc, inputPath + 'peppers.jpg');
-        element = await eb.createImageFromMatrix(img, await PDFNet.Matrix2D.create((await img.getImageWidth()) / 2, -145, 20, (await img.getImageHeight()) / 2, 200, 150));
-        writer.writePlacedElement(element);
-        // use the same image (just change its matrix)
-        gstate = await element.getGState();
-        gstate.setTransform(200, 0, 0, 300, 50, 450);
-        writer.writePlacedElement(element);
-        // use the same image again (just change its matrix).
-        writer.writePlacedElement(await eb.createImageScaled(img, 300, 600, 200, -150));
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        // Construct and draw a path object using different styles
-        page = await doc.pageCreate(pageRect);
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        // start constructing the path
-        eb.pathBegin();
-        eb.moveTo(306, 396);
-        eb.curveTo(681, 771, 399.75, 864.75, 306, 771);
-        eb.curveTo(212.25, 864.75, -69, 771, 306, 396);
-        eb.closePath();
-        // the path is now finished
-        element = await eb.pathEnd();
-        // the path should be filled
-        element.setPathFill(true);
-        // Set the path color space and color
-        gstate = await element.getGState();
-        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0)); // cyan
-        gstate.setTransform(0.5, 0, 0, 0.5, -20, 300);
-        writer.writePlacedElement(element);
-        // Draw the same path using a different stroke color
-        // this path is should be filled and stroked
-        element.setPathStroke(true);
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1, 0)); // yellow
-        gstate.setStrokeColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
-        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // red
-        gstate.setTransform(0.5, 0, 0, 0.5, 280, 300);
-        gstate.setLineWidth(20);
-        writer.writePlacedElement(element);
-        // Draw the same path with with a given dash pattern
-        // this path is should be only stroked
-        element.setPathFill(false);
-        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1)); // blue
-        gstate.setTransform(0.5, 0, 0, 0.5, 280, 0);
-        const dashPattern = [];
-        dashPattern.push(30);
-        gstate.setDashPattern(dashPattern, 0);
-        writer.writePlacedElement(element);
-        // Use the path as a clipping path
-        // Save the graphics state
-        writer.writeElement(await eb.createGroupBegin());
-        // Start constructing the new path (the old path was lost when we created
-        // a new Element using CreateGroupBegin()).
-        eb.pathBegin();
-        eb.moveTo(306, 396);
-        eb.curveTo(681, 771, 399.75, 864.75, 306, 771);
-        eb.curveTo(212.25, 864.75, -69, 771, 306, 396);
-        eb.closePath();
-        // path is now constructed
-        element = await eb.pathEnd();
-        // this path is a clipping path
-        element.setPathClip(true);
-        // this path should be filled and stroked
-        element.setPathStroke(true);
-        gstate = await element.getGState();
-        gstate.setTransform(0.5, 0, 0, 0.5, -20, 0);
-        writer.writeElement(element);
-        writer.writeElement(await eb.createImageScaled(img, 100, 300, 400, 600));
-        // Restore the graphics state
-        writer.writeElement(await eb.createGroupEnd());
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        page = await doc.pageCreate(pageRect);
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        // Begin writing a block of text
-        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 12);
-        writer.writeElement(element);
-        element = await eb.createNewTextRun('Hello World!');
-        element.setTextMatrixEntries(10, 0, 0, 10, 0, 600);
-        gstate = await element.getGState();
-        // Set the spacing between lines
-        gstate.setLeading(15);
-        writer.writeElement(element);
-        writer.writeElement(await eb.createTextNewLine()); // New line
-        element = await eb.createNewTextRun('Hello World!');
-        gstate = await element.getGState();
-        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_stroke_text);
-        gstate.setCharSpacing(-1.25);
-        gstate.setWordSpacing(-1.25);
-        writer.writeElement(element);
-        writer.writeElement(await eb.createTextNewLine()); // New line
-        element = await eb.createNewTextRun('Hello World!');
-        gstate = await element.getGState();
-        gstate.setCharSpacing(0);
-        gstate.setWordSpacing(0);
-        gstate.setLineWidth(3);
-        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_fill_stroke_text);
-        gstate.setStrokeColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
-        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // red
-        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0)); // cyan
-        writer.writeElement(element);
-        writer.writeElement(await eb.createTextNewLine()); // New line
-        // Set text as a clipping path to the image.
-        element = await eb.createNewTextRun('Hello World!');
-        gstate = await element.getGState();
-        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_clip_text);
-        writer.writeElement(element);
-        // Finish the block of text
-        writer.writeElement(await eb.createTextEnd());
-        // Draw an image that will be clipped by the above text
-        writer.writeElement(await eb.createImageScaled(img, 10, 100, 1300, 720));
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        //
-        // The example illustrates how to embed the external font in a PDF document.
-        // The example also shows how ElementReader can be used to copy and modify
-        // Elements between pages.
-        const reader = await PDFNet.ElementReader.create();
-        // Start reading Elements from the last page. We will copy all Elements to
-        // a new page but will modify the font associated with text.
-        reader.beginOnPage(await doc.getPage(await doc.getPageCount()));
-        page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 1300, 794));
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        const font = await PDFNet.Font.createTrueTypeFont(doc, inputPath + 'font.ttf');
-        // Read page contents
-        while ((element = await reader.next())) {
-          if ((await element.getType()) === PDFNet.Element.Type.e_text) {
-            (await element.getGState()).setFont(font, 12);
-          }
-          writer.writeElement(element);
-        }
-        reader.end();
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        //
-        // The example also shows how ElementReader can be used to copy and modify
-        // Elements between pages.
-        // Start reading Elements from the last page. We will copy all Elements to
-        // a new page but will modify the font associated with text.
-        reader.beginOnPage(await doc.getPage(await doc.getPageCount()));
-        page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 1300, 794));
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        // Embed an external font in the document.
-        const font2 = await PDFNet.Font.createType1Font(doc, inputPath + 'Misc-Fixed.pfa');
-        // Read page contents
-        while ((element = await reader.next())) {
-          if ((await element.getType()) === PDFNet.Element.Type.e_text) {
-            (await element.getGState()).setFont(font2, 12);
-          }
-          writer.writeElement(element);
-        }
-        reader.end();
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        page = await doc.pageCreate();
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        // Begin writing a block of text
-        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 12);
-        element.setTextMatrixEntries(1.5, 0, 0, 1.5, 50, 600);
-        // Set the spacing between lines
-        (await element.getGState()).setLeading(15);
-        writer.writeElement(element);
-        const para = 'A PDF text object consists of operators that can show '
-                        + 'text strings, move the text position, and set text state and certain '
-                        + 'other parameters. In addition, there are three parameters that are '
-                        + 'defined only within a text object and do not persist from one text '
-                        + 'object to the next: Tm, the text matrix, Tlm, the text line matrix, '
-                        + 'Trm, the text rendering matrix, actually just an intermediate result '
-                        + 'that combines the effects of text state parameters, the text matrix '
-                        + '(Tm), and the current transformation matrix';
-        const paraEnd = para.length;
-        let textRun = 0;
-        let textRunEnd;
-        const paraWidth = 300; // paragraph width is 300 units
-        let curWidth = 0;
-        while (textRun < paraEnd) {
-          textRunEnd = para.indexOf(' ', textRun);
-          if (textRunEnd < 0) {
-            textRunEnd = paraEnd - 1;
-          }
-          let text = para.substring(textRun, textRunEnd + 1);
-          element = await eb.createNewTextRun(text);
-          if (curWidth + (await element.getTextLength()) < paraWidth) {
-            curWidth += await element.getTextLength();
-          } else {
-            writer.writeElement(await eb.createTextNewLine()); // New line
-            element = await eb.createNewTextRun(text);
-            curWidth = await element.getTextLength();
-          }
-          writer.writeElement(element);
-          textRun = textRunEnd + 1;
-        }
-        // -----------------------------------------------------------------------
-        // The following code snippet illustrates how to adjust spacing between
-        // characters (text runs).
-        element = await eb.createTextNewLine();
-        writer.writeElement(element); // Skip 2 lines
-        writer.writeElement(element);
-        writer.writeElement(await eb.createNewTextRun('An example of space adjustments between inter-characters:'));
-        writer.writeElement(await eb.createTextNewLine());
-        // Write string "AWAY" without space adjustments between characters.
-        element = await eb.createNewTextRun('AWAY');
-        writer.writeElement(element);
-        writer.writeElement(await eb.createTextNewLine());
-        // Write string "AWAY" with space adjustments between characters.
-        element = await eb.createNewTextRun('A');
-        writer.writeElement(element);
-        element = await eb.createNewTextRun('W');
-        element.setPosAdjustment(140);
-        writer.writeElement(element);
-        element = await eb.createNewTextRun('A');
-        element.setPosAdjustment(140);
-        writer.writeElement(element);
-        element = await eb.createNewTextRun('Y again');
-        element.setPosAdjustment(115);
-        writer.writeElement(element);
-        // Draw the same strings using direct content output...
-        writer.flush(); // flush pending Element writing operations.
-        // You can also write page content directly to the content stream using
-        // ElementWriter.WriteString(...) and ElementWriter.WriteBuffer(...) methods.
-        // Note that if you are planning to use these functions you need to be familiar
-        // with PDF page content operators (see Appendix A in PDF Reference Manual).
-        // Because it is easy to make mistakes during direct output we recommend that
-        // you use ElementBuilder and Element interface instead.
-        writer.writeString('T* T* '); // Skip 2 lines
-        writer.writeString('(Direct output to PDF page content stream:) Tj  T* ');
-        writer.writeString('(AWAY) Tj T* ');
-        writer.writeString('[(A)140(W)140(A)115(Y again)] TJ ');
-        // Finish the block of text
-        writer.writeElement(await eb.createTextEnd());
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Start a new page ------------------------------------
-        // Image Masks
-        //
-        // In the opaque imaging model, images mark all areas they occupy on the page as
-        // if with opaque paint. All portions of the image, whether black, white, gray,
-        // or color, completely obscure any marks that may previously have existed in the
-        // same place on the page.
-        // In the graphic arts industry and page layout applications, however, it is common
-        // to crop or 'mask out' the background of an image and then place the masked image
-        // on a different background, allowing the existing background to show through the
-        // masked areas. This sample illustrates how to use image masks.
-        page = await doc.pageCreate();
-        // begin writing to the page
-        writer.beginOnPage(page);
-        // Create the Image Mask
-        const embedFile = await PDFNet.Filter.createMappedFileFromUString(inputPath + 'imagemask.dat');
-        const maskRead = await PDFNet.FilterReader.create(embedFile);
-        const deviceGray = await PDFNet.ColorSpace.createDeviceGray();
-        const mask = await PDFNet.Image.createDirectFromStream(doc, maskRead, 64, 64, 1, deviceGray, PDFNet.Image.InputFilter.e_ascii_hex);
-        (await mask.getSDFObj()).putBool('ImageMask', true);
-        element = await eb.createRect(0, 0, 612, 794);
-        element.setPathStroke(false);
-        element.setPathFill(true);
-        gstate = await element.getGState();
-        gstate.setFillColorSpace(deviceGray);
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0.8));
-        writer.writePlacedElement(element);
-        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 40, 680));
-        (await element.getGState()).setFillColorWithColorPt(await PDFNet.ColorPt.init(0.1));
-        writer.writePlacedElement(element);
-        gstate = await element.getGState();
-        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0));
-        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 320, 680));
-        writer.writePlacedElement(element);
-        (await element.getGState()).setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0));
-        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 40, 380));
-        writer.writePlacedElement(element);
-        {
-          // This sample illustrates Explicit Masking.
-          const img = await PDFNet.Image.createFromFile(doc, (inputPath + 'peppers.jpg'));
-          // mask is the explicit mask for the primary (base) image
-          img.setMask(mask);
-          element = await eb.createImageFromMatrix(img, await PDFNet.Matrix2D.create(200, 0, 0, -200, 320, 380));
-          writer.writePlacedElement(element);
-        }
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // Transparency sample ----------------------------------
-        // Start a new page -------------------------------------
-        page = await doc.pageCreate();
-        // begin writing to this page
-        writer.beginOnPage(page);
-        // Reset the GState to default
-        eb.reset();
-        // Write some transparent text at the bottom of the page.
-        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 100);
-        // Set the text knockout attribute. Text knockout must be set outside of
-        // the text group.
-        gstate = await element.getGState();
-        gstate.setTextKnockout(false);
-        gstate.setBlendMode(PDFNet.GState.BlendMode.e_bl_difference);
-        writer.writeElement(element);
-        element = await eb.createNewTextRun('Transparency');
-        element.setTextMatrixEntries(1, 0, 0, 1, 30, 30);
-        gstate = await element.getGState();
-        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0));
-        gstate.setFillOpacity(0.5);
-        writer.writeElement(element);
-        // Write the same text on top the old; shifted by 3 points
-        element.setTextMatrixEntries(1, 0, 0, 1, 33, 33);
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0, 0));
-        gstate.setFillOpacity(0.5);
-        writer.writeElement(element);
-        writer.writeElement(await eb.createTextEnd());
-        // Draw three overlapping transparent circles.
-        // start constructing the path
-        eb.pathBegin();
-        eb.moveTo(459.223, 505.646);
-        eb.curveTo(459.223, 415.841, 389.85, 343.04, 304.273, 343.04);
-        eb.curveTo(218.697, 343.04, 149.324, 415.841, 149.324, 505.646);
-        eb.curveTo(149.324, 595.45, 218.697, 668.25, 304.273, 668.25);
-        eb.curveTo(389.85, 668.25, 459.223, 595.45, 459.223, 505.646);
-        element = await eb.pathEnd();
-        element.setPathFill(true);
-        gstate = await element.getGState();
-        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1)); // Blue Circle
-        gstate.setBlendMode(PDFNet.GState.BlendMode.e_bl_normal);
-        gstate.setFillOpacity(0.5);
-        writer.writeElement(element);
-        // Translate relative to the Blue Circle
-        gstate.setTransform(1, 0, 0, 1, 113, -185);
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0)); // Green Circle
-        gstate.setFillOpacity(0.5);
-        writer.writeElement(element);
-        // Translate relative to the Green Circle
-        gstate.setTransform(1, 0, 0, 1, -220, 0);
-        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // Red Circle
-        gstate.setFillOpacity(0.5);
-        writer.writeElement(element);
-        writer.end(); // save changes to the current page
-        doc.pagePushBack(page);
-        // End page ------------------------------------
-        await doc.save('../TestFiles/Output/element_builder.pdf', PDFNet.SDFDoc.SaveOptions.e_remove_unused);
-        console.log('Done. Result saved in element_builder.pdf...');
-      } catch (e) {
-        console.log(e);
-        ret = 1;
-      }
-      return ret;
-    };
-    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error){console.log('Error: ' + JSON.stringify(error));}).then(function(){return PDFNet.shutdown();});
-  };
-  exports.runElementBuilderTest();
-})(exports);
-// eslint-disable-next-line spaced-comment
+//---------------------------------------------------------------------------------------
+// Copyright (c) 2001-2024 by Apryse Software Inc. All Rights Reserved.
+// Consult legal.txt regarding legal and license information.
+//---------------------------------------------------------------------------------------
+const { PDFNet } = require('@pdftron/pdfnet-node');
+const PDFTronLicense = require('../LicenseKey/LicenseKey');
+((exports) => {
+  exports.runElementBuilderTest = () => {
+    const main = async() => {
+      let ret = 0;
+      // Relative path to the folder containing test files.
+      const inputPath = '../TestFiles/';
+      try {
+        const doc = await PDFNet.PDFDoc.create();
+        // ElementBuilder is used to build new Element objects
+        const eb = await PDFNet.ElementBuilder.create();
+        // ElementWriter is used to write Elements to the page
+        const writer = await PDFNet.ElementWriter.create();
+        let element;
+        let gstate;
+        // Start a new page ------------------------------------
+        const pageRect = await PDFNet.Rect.init(0, 0, 612, 794);
+        let page = await doc.pageCreate(pageRect);
+        // begin writing to the page
+        writer.beginOnPage(page);
+        // Create an Image that can be reused in the document or on the same page.
+        const img = await PDFNet.Image.createFromFile(doc, inputPath + 'peppers.jpg');
+        element = await eb.createImageFromMatrix(img, await PDFNet.Matrix2D.create((await img.getImageWidth()) / 2, -145, 20, (await img.getImageHeight()) / 2, 200, 150));
+        writer.writePlacedElement(element);
+        // use the same image (just change its matrix)
+        gstate = await element.getGState();
+        gstate.setTransform(200, 0, 0, 300, 50, 450);
+        writer.writePlacedElement(element);
+        // use the same image again (just change its matrix).
+        writer.writePlacedElement(await eb.createImageScaled(img, 300, 600, 200, -150));
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        // Construct and draw a path object using different styles
+        page = await doc.pageCreate(pageRect);
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        // start constructing the path
+        eb.pathBegin();
+        eb.moveTo(306, 396);
+        eb.curveTo(681, 771, 399.75, 864.75, 306, 771);
+        eb.curveTo(212.25, 864.75, -69, 771, 306, 396);
+        eb.closePath();
+        // the path is now finished
+        element = await eb.pathEnd();
+        // the path should be filled
+        element.setPathFill(true);
+        // Set the path color space and color
+        gstate = await element.getGState();
+        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0)); // cyan
+        gstate.setTransform(0.5, 0, 0, 0.5, -20, 300);
+        writer.writePlacedElement(element);
+        // Draw the same path using a different stroke color
+        // this path is should be filled and stroked
+        element.setPathStroke(true);
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1, 0)); // yellow
+        gstate.setStrokeColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // red
+        gstate.setTransform(0.5, 0, 0, 0.5, 280, 300);
+        gstate.setLineWidth(20);
+        writer.writePlacedElement(element);
+        // Draw the same path with with a given dash pattern
+        // this path is should be only stroked
+        element.setPathFill(false);
+        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1)); // blue
+        gstate.setTransform(0.5, 0, 0, 0.5, 280, 0);
+        const dashPattern = [];
+        dashPattern.push(30);
+        gstate.setDashPattern(dashPattern, 0);
+        writer.writePlacedElement(element);
+        // Use the path as a clipping path
+        // Save the graphics state
+        writer.writeElement(await eb.createGroupBegin());
+        // Start constructing the new path (the old path was lost when we created
+        // a new Element using CreateGroupBegin()).
+        eb.pathBegin();
+        eb.moveTo(306, 396);
+        eb.curveTo(681, 771, 399.75, 864.75, 306, 771);
+        eb.curveTo(212.25, 864.75, -69, 771, 306, 396);
+        eb.closePath();
+        // path is now constructed
+        element = await eb.pathEnd();
+        // this path is a clipping path
+        element.setPathClip(true);
+        // this path should be filled and stroked
+        element.setPathStroke(true);
+        gstate = await element.getGState();
+        gstate.setTransform(0.5, 0, 0, 0.5, -20, 0);
+        writer.writeElement(element);
+        writer.writeElement(await eb.createImageScaled(img, 100, 300, 400, 600));
+        // Restore the graphics state
+        writer.writeElement(await eb.createGroupEnd());
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        page = await doc.pageCreate(pageRect);
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        // Begin writing a block of text
+        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 12);
+        writer.writeElement(element);
+        element = await eb.createNewTextRun('Hello World!');
+        element.setTextMatrixEntries(10, 0, 0, 10, 0, 600);
+        gstate = await element.getGState();
+        // Set the spacing between lines
+        gstate.setLeading(15);
+        writer.writeElement(element);
+        writer.writeElement(await eb.createTextNewLine()); // New line
+        element = await eb.createNewTextRun('Hello World!');
+        gstate = await element.getGState();
+        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_stroke_text);
+        gstate.setCharSpacing(-1.25);
+        gstate.setWordSpacing(-1.25);
+        writer.writeElement(element);
+        writer.writeElement(await eb.createTextNewLine()); // New line
+        element = await eb.createNewTextRun('Hello World!');
+        gstate = await element.getGState();
+        gstate.setCharSpacing(0);
+        gstate.setWordSpacing(0);
+        gstate.setLineWidth(3);
+        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_fill_stroke_text);
+        gstate.setStrokeColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+        gstate.setStrokeColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // red
+        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0)); // cyan
+        writer.writeElement(element);
+        writer.writeElement(await eb.createTextNewLine()); // New line
+        // Set text as a clipping path to the image.
+        element = await eb.createNewTextRun('Hello World!');
+        gstate = await element.getGState();
+        gstate.setTextRenderMode(PDFNet.GState.TextRenderingMode.e_clip_text);
+        writer.writeElement(element);
+        // Finish the block of text
+        writer.writeElement(await eb.createTextEnd());
+        // Draw an image that will be clipped by the above text
+        writer.writeElement(await eb.createImageScaled(img, 10, 100, 1300, 720));
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        //
+        // The example illustrates how to embed the external font in a PDF document.
+        // The example also shows how ElementReader can be used to copy and modify
+        // Elements between pages.
+        const reader = await PDFNet.ElementReader.create();
+        // Start reading Elements from the last page. We will copy all Elements to
+        // a new page but will modify the font associated with text.
+        reader.beginOnPage(await doc.getPage(await doc.getPageCount()));
+        page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 1300, 794));
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        const font = await PDFNet.Font.createTrueTypeFont(doc, inputPath + 'font.ttf');
+        // Read page contents
+        while ((element = await reader.next())) {
+          if ((await element.getType()) === PDFNet.Element.Type.e_text) {
+            (await element.getGState()).setFont(font, 12);
+          }
+          writer.writeElement(element);
+        }
+        reader.end();
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        //
+        // The example also shows how ElementReader can be used to copy and modify
+        // Elements between pages.
+        // Start reading Elements from the last page. We will copy all Elements to
+        // a new page but will modify the font associated with text.
+        reader.beginOnPage(await doc.getPage(await doc.getPageCount()));
+        page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 1300, 794));
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        // Embed an external font in the document.
+        const font2 = await PDFNet.Font.createType1Font(doc, inputPath + 'Misc-Fixed.pfa');
+        // Read page contents
+        while ((element = await reader.next())) {
+          if ((await element.getType()) === PDFNet.Element.Type.e_text) {
+            (await element.getGState()).setFont(font2, 12);
+          }
+          writer.writeElement(element);
+        }
+        reader.end();
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        page = await doc.pageCreate();
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        // Begin writing a block of text
+        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 12);
+        element.setTextMatrixEntries(1.5, 0, 0, 1.5, 50, 600);
+        // Set the spacing between lines
+        (await element.getGState()).setLeading(15);
+        writer.writeElement(element);
+        const para = 'A PDF text object consists of operators that can show '
+                        + 'text strings, move the text position, and set text state and certain '
+                        + 'other parameters. In addition, there are three parameters that are '
+                        + 'defined only within a text object and do not persist from one text '
+                        + 'object to the next: Tm, the text matrix, Tlm, the text line matrix, '
+                        + 'Trm, the text rendering matrix, actually just an intermediate result '
+                        + 'that combines the effects of text state parameters, the text matrix '
+                        + '(Tm), and the current transformation matrix';
+        const paraEnd = para.length;
+        let textRun = 0;
+        let textRunEnd;
+        const paraWidth = 300; // paragraph width is 300 units
+        let curWidth = 0;
+        while (textRun < paraEnd) {
+          textRunEnd = para.indexOf(' ', textRun);
+          if (textRunEnd < 0) {
+            textRunEnd = paraEnd - 1;
+          }
+          let text = para.substring(textRun, textRunEnd + 1);
+          element = await eb.createNewTextRun(text);
+          if (curWidth + (await element.getTextLength()) < paraWidth) {
+            curWidth += await element.getTextLength();
+          } else {
+            writer.writeElement(await eb.createTextNewLine()); // New line
+            element = await eb.createNewTextRun(text);
+            curWidth = await element.getTextLength();
+          }
+          writer.writeElement(element);
+          textRun = textRunEnd + 1;
+        }
+        // -----------------------------------------------------------------------
+        // The following code snippet illustrates how to adjust spacing between
+        // characters (text runs).
+        element = await eb.createTextNewLine();
+        writer.writeElement(element); // Skip 2 lines
+        writer.writeElement(element);
+        writer.writeElement(await eb.createNewTextRun('An example of space adjustments between inter-characters:'));
+        writer.writeElement(await eb.createTextNewLine());
+        // Write string "AWAY" without space adjustments between characters.
+        element = await eb.createNewTextRun('AWAY');
+        writer.writeElement(element);
+        writer.writeElement(await eb.createTextNewLine());
+        // Write string "AWAY" with space adjustments between characters.
+        element = await eb.createNewTextRun('A');
+        writer.writeElement(element);
+        element = await eb.createNewTextRun('W');
+        element.setPosAdjustment(140);
+        writer.writeElement(element);
+        element = await eb.createNewTextRun('A');
+        element.setPosAdjustment(140);
+        writer.writeElement(element);
+        element = await eb.createNewTextRun('Y again');
+        element.setPosAdjustment(115);
+        writer.writeElement(element);
+        // Draw the same strings using direct content output...
+        writer.flush(); // flush pending Element writing operations.
+        // You can also write page content directly to the content stream using
+        // ElementWriter.WriteString(...) and ElementWriter.WriteBuffer(...) methods.
+        // Note that if you are planning to use these functions you need to be familiar
+        // with PDF page content operators (see Appendix A in PDF Reference Manual).
+        // Because it is easy to make mistakes during direct output we recommend that
+        // you use ElementBuilder and Element interface instead.
+        writer.writeString('T* T* '); // Skip 2 lines
+        writer.writeString('(Direct output to PDF page content stream:) Tj  T* ');
+        writer.writeString('(AWAY) Tj T* ');
+        writer.writeString('[(A)140(W)140(A)115(Y again)] TJ ');
+        // Finish the block of text
+        writer.writeElement(await eb.createTextEnd());
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Start a new page ------------------------------------
+        // Image Masks
+        //
+        // In the opaque imaging model, images mark all areas they occupy on the page as
+        // if with opaque paint. All portions of the image, whether black, white, gray,
+        // or color, completely obscure any marks that may previously have existed in the
+        // same place on the page.
+        // In the graphic arts industry and page layout applications, however, it is common
+        // to crop or 'mask out' the background of an image and then place the masked image
+        // on a different background, allowing the existing background to show through the
+        // masked areas. This sample illustrates how to use image masks.
+        page = await doc.pageCreate();
+        // begin writing to the page
+        writer.beginOnPage(page);
+        // Create the Image Mask
+        const embedFile = await PDFNet.Filter.createMappedFileFromUString(inputPath + 'imagemask.dat');
+        const maskRead = await PDFNet.FilterReader.create(embedFile);
+        const deviceGray = await PDFNet.ColorSpace.createDeviceGray();
+        const mask = await PDFNet.Image.createDirectFromStream(doc, maskRead, 64, 64, 1, deviceGray, PDFNet.Image.InputFilter.e_ascii_hex);
+        (await mask.getSDFObj()).putBool('ImageMask', true);
+        element = await eb.createRect(0, 0, 612, 794);
+        element.setPathStroke(false);
+        element.setPathFill(true);
+        gstate = await element.getGState();
+        gstate.setFillColorSpace(deviceGray);
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0.8));
+        writer.writePlacedElement(element);
+        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 40, 680));
+        (await element.getGState()).setFillColorWithColorPt(await PDFNet.ColorPt.init(0.1));
+        writer.writePlacedElement(element);
+        gstate = await element.getGState();
+        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0));
+        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 320, 680));
+        writer.writePlacedElement(element);
+        (await element.getGState()).setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0));
+        element = await eb.createImageFromMatrix(mask, await PDFNet.Matrix2D.create(200, 0, 0, -200, 40, 380));
+        writer.writePlacedElement(element);
+        {
+          // This sample illustrates Explicit Masking.
+          const img = await PDFNet.Image.createFromFile(doc, (inputPath + 'peppers.jpg'));
+          // mask is the explicit mask for the primary (base) image
+          img.setMask(mask);
+          element = await eb.createImageFromMatrix(img, await PDFNet.Matrix2D.create(200, 0, 0, -200, 320, 380));
+          writer.writePlacedElement(element);
+        }
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // Transparency sample ----------------------------------
+        // Start a new page -------------------------------------
+        page = await doc.pageCreate();
+        // begin writing to this page
+        writer.beginOnPage(page);
+        // Reset the GState to default
+        eb.reset();
+        // Write some transparent text at the bottom of the page.
+        element = await eb.createTextBeginWithFont(await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_times_roman), 100);
+        // Set the text knockout attribute. Text knockout must be set outside of
+        // the text group.
+        gstate = await element.getGState();
+        gstate.setTextKnockout(false);
+        gstate.setBlendMode(PDFNet.GState.BlendMode.e_bl_difference);
+        writer.writeElement(element);
+        element = await eb.createNewTextRun('Transparency');
+        element.setTextMatrixEntries(1, 0, 0, 1, 30, 30);
+        gstate = await element.getGState();
+        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceCMYK());
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0, 0));
+        gstate.setFillOpacity(0.5);
+        writer.writeElement(element);
+        // Write the same text on top the old; shifted by 3 points
+        element.setTextMatrixEntries(1, 0, 0, 1, 33, 33);
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0, 0));
+        gstate.setFillOpacity(0.5);
+        writer.writeElement(element);
+        writer.writeElement(await eb.createTextEnd());
+        // Draw three overlapping transparent circles.
+        // start constructing the path
+        eb.pathBegin();
+        eb.moveTo(459.223, 505.646);
+        eb.curveTo(459.223, 415.841, 389.85, 343.04, 304.273, 343.04);
+        eb.curveTo(218.697, 343.04, 149.324, 415.841, 149.324, 505.646);
+        eb.curveTo(149.324, 595.45, 218.697, 668.25, 304.273, 668.25);
+        eb.curveTo(389.85, 668.25, 459.223, 595.45, 459.223, 505.646);
+        element = await eb.pathEnd();
+        element.setPathFill(true);
+        gstate = await element.getGState();
+        gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 0, 1)); // Blue Circle
+        gstate.setBlendMode(PDFNet.GState.BlendMode.e_bl_normal);
+        gstate.setFillOpacity(0.5);
+        writer.writeElement(element);
+        // Translate relative to the Blue Circle
+        gstate.setTransform(1, 0, 0, 1, 113, -185);
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(0, 1, 0)); // Green Circle
+        gstate.setFillOpacity(0.5);
+        writer.writeElement(element);
+        // Translate relative to the Green Circle
+        gstate.setTransform(1, 0, 0, 1, -220, 0);
+        gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0)); // Red Circle
+        gstate.setFillOpacity(0.5);
+        writer.writeElement(element);
+        writer.end(); // save changes to the current page
+        doc.pagePushBack(page);
+        // End page ------------------------------------
+        await doc.save('../TestFiles/Output/element_builder.pdf', PDFNet.SDFDoc.SaveOptions.e_remove_unused);
+        console.log('Done. Result saved in element_builder.pdf...');
+      } catch (e) {
+        console.log(e);
+        ret = 1;
+      }
+      return ret;
+    };
+    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error){console.log('Error: ' + JSON.stringify(error));}).then(function(){return PDFNet.shutdown();});
+  };
+  exports.runElementBuilderTest();
+})(exports);
+// eslint-disable-next-line spaced-comment
 //# sourceURL=ElementBuilderTest.js