@pdftron/pdfnet-node-samples 9.4.2 → 9.5.0-beta

package/samples/PDFPackageTest/NODEJS/PDFPackageTest.js

@@ -0,0 +1,112 @@
+//---------------------------------------------------------------------------------------
+// Copyright (c) 2001-2021 by PDFTron Systems Inc. All Rights Reserved.
+// Consult legal.txt regarding legal and license information.
+//---------------------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------------
+/// This sample illustrates how to create, extract, and manipulate PDF Portfolios
+/// (a.k.a. PDF Packages) using PDFNet SDK.
+//-----------------------------------------------------------------------------------
+
+const { PDFNet } = require('../../../lib/pdfnet.js');
+const PDFTronLicense = require('../../LicenseKey/NODEJS/LicenseKey');
+
+((exports) => {
+  'use strict';
+
+  exports.runPDFPackageTest = () => {
+    // Relative path to the folder containing test files.
+    const inputPath = '../../TestFiles/';
+    const outputPath = inputPath + 'Output/';
+
+    const addPackage = async (doc, file, desc) => {
+      const files = await PDFNet.NameTree.create(doc, 'EmbeddedFiles');
+      const fs = await PDFNet.FileSpec.create(doc, file, true);
+      files.put(file, await fs.getSDFObj());
+      fs.setDesc(desc);
+
+      const root = await doc.getRoot();
+      let collection = await root.findObj('Collection');
+      if (!collection) collection = await root.putDict('Collection');
+
+      // You could here manipulate any entry in the Collection dictionary. 
+      // For example, the following line sets the tile mode for initial view mode
+      // Please refer to section '2.3.5 Collections' in PDF Reference for details.
+      collection.putName('View', 'T');
+    }
+
+    const addCoverPage = async (doc) => {
+      // Here we dynamically generate cover page (please see ElementBuilder 
+      // sample for more extensive coverage of PDF creation API).
+      const page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 200, 200));
+
+      const b = await PDFNet.ElementBuilder.create();
+      const w = await PDFNet.ElementWriter.create();
+      w.beginOnPage(page);
+      const font = await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_helvetica);
+      w.writeElement(await b.createTextBeginWithFont(font, 12));
+      const e = await b.createNewTextRun('My PDF Collection');
+      e.setTextMatrixEntries(1, 0, 0, 1, 50, 96);
+      const gstate = await e.getGState();
+      gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+      gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0));
+      w.writeElement(e);
+      w.writeElement(await b.createTextEnd());
+      w.end();
+      doc.pagePushBack(page);
+
+      // Alternatively we could import a PDF page from a template PDF document
+      // (for an example please see PDFPage sample project).
+    }
+
+    const main = async () => {
+
+      // Create a PDF Package.
+      try {
+        const doc = await PDFNet.PDFDoc.create();
+        await addPackage(doc, inputPath + 'numbered.pdf', 'My File 1');
+        await addPackage(doc, inputPath + 'newsletter.pdf', 'My Newsletter...');
+        await addPackage(doc, inputPath + 'peppers.jpg', 'An image');
+        await addCoverPage(doc);
+        await doc.save(outputPath + 'package.pdf', PDFNet.SDFDoc.SaveOptions.e_linearized);
+        console.log('Done.');
+      } catch (err) {
+        console.log(err);
+      }
+
+      try {
+        const doc = await PDFNet.PDFDoc.createFromFilePath(outputPath + 'package.pdf');
+        await doc.initSecurityHandler();
+
+        const files = await PDFNet.NameTree.find(doc, 'EmbeddedFiles');
+        if (await files.isValid()) {
+          // Traverse the list of embedded files.
+          const i = await files.getIteratorBegin();
+          for (var counter = 0; await i.hasNext(); await i.next(), ++counter) {
+            const entry_name = await i.key().then(key => key.getAsPDFText());
+            console.log('Part: ' + entry_name);
+            const file_spec = await PDFNet.FileSpec.createFromObj(await i.value());
+            const stm = await file_spec.getFileData();
+            if (stm) {
+              let ext = '.pdf';
+              if (entry_name.includes('.')) {
+                ext = entry_name.substr(entry_name.lastIndexOf('.'));
+              }
+              stm.writeToFile(outputPath + 'extract_' + counter + ext, false);
+            }
+          }
+        }
+
+        console.log('Done.');
+      } catch (err) {
+        console.log(err);
+      }
+    }
+    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error) {
+      console.log('Error: ' + JSON.stringify(error));
+    }).then(function(){ return PDFNet.shutdown(); });
+  };
+  exports.runPDFPackageTest();
+})(exports);
+  // eslint-disable-next-line spaced-comment
+  //# sourceURL=PDFPackageTest.js

package/samples/PDFPackageTest/NODEJS/RunTest.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+node PDFPackageTest.js

package/samples/PDFPackageTest/PDFPackageTest.js

@@ -1,112 +1,112 @@
-//---------------------------------------------------------------------------------------
-// Copyright (c) 2001-2022 by PDFTron Systems Inc. All Rights Reserved.
-// Consult legal.txt regarding legal and license information.
-//---------------------------------------------------------------------------------------
-
-//-----------------------------------------------------------------------------------
-/// This sample illustrates how to create, extract, and manipulate PDF Portfolios
-/// (a.k.a. PDF Packages) using PDFNet SDK.
-//-----------------------------------------------------------------------------------
-
-const { PDFNet } = require('@pdftron/pdfnet-node');
-const PDFTronLicense = require('../LicenseKey/LicenseKey');
-
-((exports) => {
-  'use strict';
-
-  exports.runPDFPackageTest = () => {
-    // Relative path to the folder containing test files.
-    const inputPath = '../TestFiles/';
-    const outputPath = inputPath + 'Output/';
-
-    const addPackage = async (doc, file, desc) => {
-      const files = await PDFNet.NameTree.create(doc, 'EmbeddedFiles');
-      const fs = await PDFNet.FileSpec.create(doc, file, true);
-      files.put(file, await fs.getSDFObj());
-      fs.setDesc(desc);
-
-      const root = await doc.getRoot();
-      let collection = await root.findObj('Collection');
-      if (!collection) collection = await root.putDict('Collection');
-
-      // You could here manipulate any entry in the Collection dictionary. 
-      // For example, the following line sets the tile mode for initial view mode
-      // Please refer to section '2.3.5 Collections' in PDF Reference for details.
-      collection.putName('View', 'T');
-    }
-
-    const addCoverPage = async (doc) => {
-      // Here we dynamically generate cover page (please see ElementBuilder 
-      // sample for more extensive coverage of PDF creation API).
-      const page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 200, 200));
-
-      const b = await PDFNet.ElementBuilder.create();
-      const w = await PDFNet.ElementWriter.create();
-      w.beginOnPage(page);
-      const font = await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_helvetica);
-      w.writeElement(await b.createTextBeginWithFont(font, 12));
-      const e = await b.createNewTextRun('My PDF Collection');
-      e.setTextMatrixEntries(1, 0, 0, 1, 50, 96);
-      const gstate = await e.getGState();
-      gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
-      gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0));
-      w.writeElement(e);
-      w.writeElement(await b.createTextEnd());
-      w.end();
-      doc.pagePushBack(page);
-
-      // Alternatively we could import a PDF page from a template PDF document
-      // (for an example please see PDFPage sample project).
-    }
-
-    const main = async () => {
-
-      // Create a PDF Package.
-      try {
-        const doc = await PDFNet.PDFDoc.create();
-        await addPackage(doc, inputPath + 'numbered.pdf', 'My File 1');
-        await addPackage(doc, inputPath + 'newsletter.pdf', 'My Newsletter...');
-        await addPackage(doc, inputPath + 'peppers.jpg', 'An image');
-        await addCoverPage(doc);
-        await doc.save(outputPath + 'package.pdf', PDFNet.SDFDoc.SaveOptions.e_linearized);
-        console.log('Done.');
-      } catch (err) {
-        console.log(err);
-      }
-
-      try {
-        const doc = await PDFNet.PDFDoc.createFromFilePath(outputPath + 'package.pdf');
-        await doc.initSecurityHandler();
-
-        const files = await PDFNet.NameTree.find(doc, 'EmbeddedFiles');
-        if (await files.isValid()) {
-          // Traverse the list of embedded files.
-          const i = await files.getIteratorBegin();
-          for (var counter = 0; await i.hasNext(); await i.next(), ++counter) {
-            const entry_name = await i.key().then(key => key.getAsPDFText());
-            console.log('Part: ' + entry_name);
-            const file_spec = await PDFNet.FileSpec.createFromObj(await i.value());
-            const stm = await file_spec.getFileData();
-            if (stm) {
-              let ext = '.pdf';
-              if (entry_name.includes('.')) {
-                ext = entry_name.substr(entry_name.lastIndexOf('.'));
-              }
-              stm.writeToFile(outputPath + 'extract_' + counter + ext, false);
-            }
-          }
-        }
-
-        console.log('Done.');
-      } catch (err) {
-        console.log(err);
-      }
-    }
-    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error) {
-      console.log('Error: ' + JSON.stringify(error));
-    }).then(function(){ return PDFNet.shutdown(); });
-  };
-  exports.runPDFPackageTest();
-})(exports);
-  // eslint-disable-next-line spaced-comment
+//---------------------------------------------------------------------------------------
+// Copyright (c) 2001-2023 by PDFTron Systems Inc. All Rights Reserved.
+// Consult legal.txt regarding legal and license information.
+//---------------------------------------------------------------------------------------
+
+//-----------------------------------------------------------------------------------
+/// This sample illustrates how to create, extract, and manipulate PDF Portfolios
+/// (a.k.a. PDF Packages) using PDFNet SDK.
+//-----------------------------------------------------------------------------------
+
+const { PDFNet } = require('@pdftron/pdfnet-node');
+const PDFTronLicense = require('../LicenseKey/LicenseKey');
+
+((exports) => {
+  'use strict';
+
+  exports.runPDFPackageTest = () => {
+    // Relative path to the folder containing test files.
+    const inputPath = '../TestFiles/';
+    const outputPath = inputPath + 'Output/';
+
+    const addPackage = async (doc, file, desc) => {
+      const files = await PDFNet.NameTree.create(doc, 'EmbeddedFiles');
+      const fs = await PDFNet.FileSpec.create(doc, file, true);
+      files.put(file, await fs.getSDFObj());
+      fs.setDesc(desc);
+
+      const root = await doc.getRoot();
+      let collection = await root.findObj('Collection');
+      if (!collection) collection = await root.putDict('Collection');
+
+      // You could here manipulate any entry in the Collection dictionary. 
+      // For example, the following line sets the tile mode for initial view mode
+      // Please refer to section '2.3.5 Collections' in PDF Reference for details.
+      collection.putName('View', 'T');
+    }
+
+    const addCoverPage = async (doc) => {
+      // Here we dynamically generate cover page (please see ElementBuilder 
+      // sample for more extensive coverage of PDF creation API).
+      const page = await doc.pageCreate(await PDFNet.Rect.init(0, 0, 200, 200));
+
+      const b = await PDFNet.ElementBuilder.create();
+      const w = await PDFNet.ElementWriter.create();
+      w.beginOnPage(page);
+      const font = await PDFNet.Font.create(doc, PDFNet.Font.StandardType1Font.e_helvetica);
+      w.writeElement(await b.createTextBeginWithFont(font, 12));
+      const e = await b.createNewTextRun('My PDF Collection');
+      e.setTextMatrixEntries(1, 0, 0, 1, 50, 96);
+      const gstate = await e.getGState();
+      gstate.setFillColorSpace(await PDFNet.ColorSpace.createDeviceRGB());
+      gstate.setFillColorWithColorPt(await PDFNet.ColorPt.init(1, 0, 0));
+      w.writeElement(e);
+      w.writeElement(await b.createTextEnd());
+      w.end();
+      doc.pagePushBack(page);
+
+      // Alternatively we could import a PDF page from a template PDF document
+      // (for an example please see PDFPage sample project).
+    }
+
+    const main = async () => {
+
+      // Create a PDF Package.
+      try {
+        const doc = await PDFNet.PDFDoc.create();
+        await addPackage(doc, inputPath + 'numbered.pdf', 'My File 1');
+        await addPackage(doc, inputPath + 'newsletter.pdf', 'My Newsletter...');
+        await addPackage(doc, inputPath + 'peppers.jpg', 'An image');
+        await addCoverPage(doc);
+        await doc.save(outputPath + 'package.pdf', PDFNet.SDFDoc.SaveOptions.e_linearized);
+        console.log('Done.');
+      } catch (err) {
+        console.log(err);
+      }
+
+      try {
+        const doc = await PDFNet.PDFDoc.createFromFilePath(outputPath + 'package.pdf');
+        await doc.initSecurityHandler();
+
+        const files = await PDFNet.NameTree.find(doc, 'EmbeddedFiles');
+        if (await files.isValid()) {
+          // Traverse the list of embedded files.
+          const i = await files.getIteratorBegin();
+          for (var counter = 0; await i.hasNext(); await i.next(), ++counter) {
+            const entry_name = await i.key().then(key => key.getAsPDFText());
+            console.log('Part: ' + entry_name);
+            const file_spec = await PDFNet.FileSpec.createFromObj(await i.value());
+            const stm = await file_spec.getFileData();
+            if (stm) {
+              let ext = '.pdf';
+              if (entry_name.includes('.')) {
+                ext = entry_name.substr(entry_name.lastIndexOf('.'));
+              }
+              stm.writeToFile(outputPath + 'extract_' + counter + ext, false);
+            }
+          }
+        }
+
+        console.log('Done.');
+      } catch (err) {
+        console.log(err);
+      }
+    }
+    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error) {
+      console.log('Error: ' + JSON.stringify(error));
+    }).then(function(){ return PDFNet.shutdown(); });
+  };
+  exports.runPDFPackageTest();
+})(exports);
+  // eslint-disable-next-line spaced-comment
   //# sourceURL=PDFPackageTest.js

package/samples/PDFPageTest/NODEJS/PDFPageTest.js

@@ -0,0 +1,190 @@
+//---------------------------------------------------------------------------------------
+// Copyright (c) 2001-2021 by PDFTron Systems Inc. All Rights Reserved.
+// Consult legal.txt regarding legal and license information.
+//---------------------------------------------------------------------------------------
+
+const { PDFNet } = require('../../../lib/pdfnet.js');
+const PDFTronLicense = require('../../LicenseKey/NODEJS/LicenseKey');
+
+((exports) => {
+
+  exports.runPDFPageTest = () => {
+
+    const main = async () => {
+      // Relative path to the folder containing test files.
+      const inputPath = '../../TestFiles/';
+      const outputPath = inputPath + 'Output/';
+
+      // Sample 1 - Split a PDF document into multiple pages
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 1 - Split a PDF document into multiple pages...');
+        console.log('Opening the input pdf...');
+        const inDoc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'newsletter.pdf');
+        inDoc.initSecurityHandler();
+
+        const pageCount = await inDoc.getPageCount();
+        for (let i = 1; i <= pageCount; ++i) {
+          const newDoc = await PDFNet.PDFDoc.create();
+          const filename = 'newsletter_split_page_' + i + '.pdf';
+          newDoc.insertPages(0, inDoc, i, i, PDFNet.PDFDoc.InsertFlag.e_none);
+          await newDoc.save(outputPath + filename, PDFNet.SDFDoc.SaveOptions.e_remove_unused);
+          console.log('Done. Result saved in ' + filename);
+        }
+      } catch (err) {
+        // console.log(err);
+        console.log(err.stack);
+      }
+
+      // Sample 2 - Merge several PDF documents into one
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 2 - Merge several PDF documents into one...');
+
+        // start stack-based deallocation with startDeallocateStack. Later on when endDeallocateStack is called,
+        // all objects in memory that were initialized since the most recent startDeallocateStack call will be
+        // cleaned up. Doing this makes sure that memory growth does not get too high.
+        await PDFNet.startDeallocateStack();
+        const newDoc = await PDFNet.PDFDoc.create();
+        newDoc.initSecurityHandler();
+
+        const pageNum = 15
+        for (let i = 1; i <= pageNum; ++i) {
+          const fname = 'newsletter_split_page_' + i + '.pdf';
+          console.log('Opening ' + fname);
+          const currDoc = await PDFNet.PDFDoc.createFromFilePath(outputPath + fname);
+          const currDocPageCount = await currDoc.getPageCount();
+          newDoc.insertPages(i, currDoc, 1, currDocPageCount, PDFNet.PDFDoc.InsertFlag.e_none);
+        }
+        await newDoc.save(outputPath + 'newsletter_merge_pages.pdf', PDFNet.SDFDoc.SaveOptions.e_remove_unused);
+        console.log('Done. Result saved in newsletter_merge_pages.pdf');
+        await PDFNet.endDeallocateStack();
+      } catch (err) {
+        // console.log(err);
+        console.log(err.stack);
+        ret = 1;
+      }
+
+      // Sample 3 - Delete every second page
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 3 - Delete every second page...');
+        console.log('Opening the input pdf...');
+        await PDFNet.startDeallocateStack();
+        const inDoc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'newsletter.pdf');
+        inDoc.initSecurityHandler();
+
+        let pageNum = await inDoc.getPageCount();
+
+        while (pageNum >= 1) {
+          const itr = await inDoc.getPageIterator(pageNum);
+          inDoc.pageRemove(itr);
+          pageNum -= 2;
+        }
+
+        await inDoc.save(outputPath + 'newsletter_page_remove.pdf', 0);
+        console.log('Done. Result saved in newsletter_page_remove.pdf...');
+        await PDFNet.endDeallocateStack();
+      } catch (err) {
+        console.log(err);
+        ret = 1;
+      }
+
+      // Sample 4 - Inserts a page from one document at different 
+      // locations within another document
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 4 - Insert a page at different locations...');
+        console.log('Opening the input pdf...');
+        await PDFNet.startDeallocateStack();
+        const in1Doc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'newsletter.pdf');
+        in1Doc.initSecurityHandler();
+
+        const in2Doc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'fish.pdf');
+        in2Doc.initSecurityHandler();
+
+        const srcPage = await in2Doc.getPageIterator();
+        const dstPage = await in1Doc.getPageIterator();
+        let pageNum = 1;
+        while (await dstPage.hasNext()) {
+          if (pageNum++ % 3 === 0) {
+            in1Doc.pageInsert(dstPage, await srcPage.current());
+          }
+          dstPage.next();
+        }
+
+        await in1Doc.save(outputPath + 'newsletter_page_insert.pdf', 0);
+        console.log('Done. Result saved in newsletter_page_insert.pdf...');
+        await PDFNet.endDeallocateStack();
+      } catch (err) {
+        console.log(err.stack);
+        ret = 1;
+      }
+
+      // Sample 5 - Replicate pages within a single document
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 5 - Replicate pages within a single document...');
+        console.log('Opening the input pdf...');
+        await PDFNet.startDeallocateStack();
+        const doc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'newsletter.pdf');
+        doc.initSecurityHandler();
+
+        // Replicate the cover page three times (copy page #1 and place it before the
+        // seventh page in the document page sequence)
+        const cover = await doc.getPage(1);
+        const p7 = await doc.getPageIterator(7);
+        doc.pageInsert(p7, cover);
+        doc.pageInsert(p7, cover);
+        doc.pageInsert(p7, cover);
+        // replicate cover page two more times by placing it before and after existing pages
+        doc.pagePushFront(cover);
+        doc.pagePushBack(cover);
+
+        await doc.save(outputPath + 'newsletter_page_clone.pdf', 0);
+        console.log('Done. Result saved in newsletter_page_clone.pdf...');
+        await PDFNet.endDeallocateStack();
+      } catch (err) {
+        console.log(err.stack);
+        ret = 1;
+      }
+
+      // Sample 6 - Use ImportPages() in order to copy multiple pages at once 
+      // in order to preserve shared resources between pages (e.g. images, fonts, 
+      // colorspaces, etc.)
+      try {
+        console.log('_______________________________________________');
+        console.log('Sample 6 - Preserving shared resources using ImportPages...');
+        console.log('Opening the input pdf...');
+        const in_doc = await PDFNet.PDFDoc.createFromFilePath(inputPath + 'newsletter.pdf');
+        in_doc.initSecurityHandler();
+
+        const new_doc = await PDFNet.PDFDoc.create();
+
+        const copy_pages = [];
+        for (const itr = await in_doc.getPageIterator(); await itr.hasNext(); await itr.next()) {
+          copy_pages.push(await itr.current());
+        }
+
+        const imported_pages = await new_doc.importPages(copy_pages);
+        for (var i = 0; i < imported_pages.length; ++i) {
+          new_doc.pagePushFront(imported_pages[i]); // Order pages in reverse order. 
+          // Use PagePushBack() if you would like to preserve the same order.
+        }
+
+        await new_doc.save(outputPath + 'newsletter_import_pages.pdf', 0);
+        console.log('Done. Result saved in newsletter_import_pages.pdf...\n');
+        console.log('Note that the output file size is less than half the size\n'
+         + 'of the file produced using individual page copy operations\n'
+          + 'between two documents');
+      } catch (err) {
+        console.log(err.stack);
+      }
+    };
+
+    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function (error) { console.log('Error: ' + JSON.stringify(error)); }).then(function () { return PDFNet.shutdown(); });
+  };
+  exports.runPDFPageTest();
+})(exports);
+// eslint-disable-next-line spaced-comment
+//# sourceURL=PDFPageTest.js

package/samples/PDFPageTest/NODEJS/RunTest.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+node PDFPageTest.js

package/samples/PDFPageTest/PDFPageTest.js

@@ -1,5 +1,5 @@
 //---------------------------------------------------------------------------------------
-// Copyright (c) 2001-2022 by PDFTron Systems Inc. All Rights Reserved.
+// Copyright (c) 2001-2023 by PDFTron Systems Inc. All Rights Reserved.
 // Consult legal.txt regarding legal and license information.
 //---------------------------------------------------------------------------------------
 

package/samples/PDFRedactTest/NODEJS/PDFRedactTest.js

@@ -0,0 +1,75 @@
+//---------------------------------------------------------------------------------------
+// Copyright (c) 2001-2021 by PDFTron Systems Inc. All Rights Reserved.
+// Consult legal.txt regarding legal and license information.
+//---------------------------------------------------------------------------------------
+
+// PDF Redactor is a separately licensable Add-on that offers options to remove 
+// (not just covering or obscuring) content within a region of PDF. 
+// With printed pages, redaction involves blacking-out or cutting-out areas of 
+// the printed page. With electronic documents that use formats such as PDF, 
+// redaction typically involves removing sensitive content within documents for 
+// safe distribution to courts, patent and government institutions, the media, 
+// customers, vendors or any other audience with restricted access to the content. 
+//
+// The redaction process in PDFNet consists of two steps:
+// 
+//  a) Content identification: A user applies redact annotations that specify the 
+// pieces or regions of content that should be removed. The content for redaction 
+// can be identified either interactively (e.g. using 'pdftron.PDF.PDFViewCtrl' 
+// as shown in PDFView sample) or programmatically (e.g. using 'pdftron.PDF.TextSearch'
+// or 'pdftron.PDF.TextExtractor'). Up until the next step is performed, the user 
+// can see, move and redefine these annotations.
+//  b) Content removal: Using 'pdftron.PDF.Redactor.Redact()' the user instructs 
+// PDFNet to apply the redact regions, after which the content in the area specified 
+// by the redact annotations is removed. The redaction function includes number of 
+// options to control the style of the redaction overlay (including color, text, 
+// font, border, transparency, etc.).
+// 
+// PDFTron Redactor makes sure that if a portion of an image, text, or vector graphics 
+// is contained in a redaction region, that portion of the image or path data is 
+// destroyed and is not simply hidden with clipping or image masks. PDFNet API can also 
+// be used to review and remove metadata and other content that can exist in a PDF 
+// document, including XML Forms Architecture (XFA) content and Extensible Metadata 
+// Platform (XMP) content.
+
+const { PDFNet } = require('../../../lib/pdfnet.js');
+const PDFTronLicense = require('../../LicenseKey/NODEJS/LicenseKey');
+
+((exports) => {
+
+  exports.runPDFRedactTest = () => {
+    const redact = async(input, output, vec, app) => {
+      const doc = await PDFNet.PDFDoc.createFromFilePath(input);
+      if (await doc.initSecurityHandler()) {
+        PDFNet.Redactor.redact(doc, vec, app, false, true);
+        await doc.save(output, PDFNet.SDFDoc.SaveOptions.e_linearized);
+      }
+    };
+
+    const main = async() => {
+      // Relative path to the folder containing test files.
+      const inputPath = '../../TestFiles/';
+      try {
+        const redactionArray = []; // we will contain a list of redaction objects in this array
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(1, (await PDFNet.Rect.init(100, 100, 550, 600)), false, 'Top Secret'));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(2, (await PDFNet.Rect.init(30, 30, 450, 450)), true, 'Negative Redaction'));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(2, (await PDFNet.Rect.init(0, 0, 100, 100)), false, 'Positive'));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(2, (await PDFNet.Rect.init(100, 100, 200, 200)), false, 'Positive'));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(2, (await PDFNet.Rect.init(300, 300, 400, 400)), false, ''));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(2, (await PDFNet.Rect.init(500, 500, 600, 600)), false, ''));
+        redactionArray.push(await PDFNet.Redactor.redactionCreate(3, (await PDFNet.Rect.init(0, 0, 700, 20)), false, ''));
+
+        const appear = { redaction_overlay: true, border: false, show_redacted_content_regions: true };
+        await redact(inputPath + 'newsletter.pdf', inputPath + 'Output/redacted.pdf', redactionArray, appear);
+
+        console.log('Done...');
+      } catch (err) {
+        console.log(err.stack);
+      }
+    };
+    PDFNet.runWithCleanup(main, PDFTronLicense.Key).catch(function(error){console.log('Error: ' + JSON.stringify(error));}).then(function(){return PDFNet.shutdown();});
+  };
+  exports.runPDFRedactTest();
+})(exports);
+// eslint-disable-next-line spaced-comment
+//# sourceURL=PDFRedactTest.js

package/samples/PDFRedactTest/NODEJS/RunTest.sh

@@ -0,0 +1,2 @@
+#!/bin/sh
+node PDFRedactTest.js

package/samples/PDFRedactTest/PDFRedactTest.js

@@ -1,5 +1,5 @@
 //---------------------------------------------------------------------------------------
-// Copyright (c) 2001-2022 by PDFTron Systems Inc. All Rights Reserved.
+// Copyright (c) 2001-2023 by PDFTron Systems Inc. All Rights Reserved.
 // Consult legal.txt regarding legal and license information.
 //---------------------------------------------------------------------------------------