Merge branch 'master' into develop

Author: andruhovski

javascript-cpp/overview/installation/_index.md

@@ -13,15 +13,24 @@ sitemap:
 
 # Installation
 
-**Aspose.PDF for JavaScript via C++** is a easy and secure toolkit used to work with PDF directly in the web browser. 
+**Aspose.PDF for JavaScript via C++** is a easy and secure toolkit used to work with PDF directly in the web browser.
 
 To install and use Aspose.PDF for JavaScript via C++ from a -*ZIP archive, follow the following instructions:
+
 - extract the files from the ZIP archive
 - encrypt your *.lic file using 'encrypt_lic.html'
 - edit  'settings.json' and setup your settings.
 
 Follow the link for [Direct Download](https://releases.aspose.com/pdf/javascriptcpp/)
 
+To install and use Aspose.PDF for JavaScript via C++ from NPMJS, follow the following instructions:
+
+- `npm i aspose-pdf-js`
+
+To install and use Aspose.PDF for JavaScript via C++ from GITHUB, follow the following instructions:
+
+- `npm install git+https://github.com/aspose-pdf/Aspose.PDF-for-JavaScript-via-CPP`
+
 If there is no web server installed you can run the examples locally, using Python. So, if you are using Linux or Mac OS X, everything is ready on your system. If you are a Windows user, you can download the installation file from the Python home page:
 
 - go to [python.org](https://www.python.org/)

net/advanced-operations/annotations/_index.md

@@ -93,6 +93,7 @@ You are able to do the following:
 - [Overview of Annotations](/pdf/net/overview-of-annotations/) - learn which types of annotations are defined by the PDF specification, and what Aspose.PDF supports.
 - [Add, Delete and Get Annotation](/pdf/net/add-delete-and-get-annotation/) - this section explains how to work with all types of allowed annotations.
 - [Import and export annotation with XFDF format](/pdf/net/import-export-xfdf/) - Aspose.PDF library provided methods to import and export annotations data to XFDF files.
+- [Import FDF format annotations to PDF](/pdf/net/import-fdf/) - Aspose.PDF library provided method to import FDF format annotations to PDF files.
 
 <script type="application/ld+json">
 {

net/advanced-operations/annotations/import-fdf/_index.md

@@ -0,0 +1,55 @@
+---
+title: Import FDF format annotations to PDF via C#
+linktitle: Import FDF format annotations to PDF
+type: docs
+weight: 50
+url: /net/import-fdf/
+description: Use existing Form.ImportFdf() or add PdfAnnotationEditor.ImportAnnotationsFromFdf() methods for import FDF format annotations to PDF with Aspose.PDF for .NET.
+lastmod: "2024-09-17"
+sitemap:
+    changefreq: "monthly"
+    priority: 0.7
+---
+
+{{% alert color="primary" %}}
+
+FDF (Forms Data Format) is a file format that stores and transmits form data and annotations in PDF documents. It is a lightweight PDF version that contains only the form field values or comments, without the full content of the original PDF file. FDF files are often used when submitting form data to a server, or when exchanging annotations without needing to send the entire PDF file. They can be imported back into a PDF to fill in form fields or apply comments.
+
+{{% /alert %}}
+
+[PDFAnnotationEditor](https://reference.aspose.com/pdf/net/aspose.pdf.facades/pdfannotationeditor/) class contains method to work with import of annotations from FDF file. [PdfAnnotationEditor.ImportAnnotationsFromFdf](https://reference.aspose.com/pdf/net/aspose.pdf.facades/pdfannotationeditor/importannotationsfromfdf/) method provides the functionality to import annotations from a FDF document to PDF file.
+
+Also, [Class Form](https://reference.aspose.com/pdf/net/aspose.pdf.facades/form/) include the [Form.ImportFdf](https://reference.aspose.com/pdf/net/aspose.pdf.facades/form/importfdf/) method - imports the content of the fields from the FDF file and put them into the new PDF.
+
+The following code snippet shows you how to Import FDF format annotations to PDF with Form.ImportFdf() method:
+
+```csharp
+
+    var fdfPath = Params.InputPath + "test.fdf";
+    var templatePath = Params.InputPath + "Empty.pdf";
+    var outputPath = Params.OutputPath + "test_form.pdf";
+
+    using (var form = new Aspose.Pdf.Facades.Form(templatePath))
+    {
+        using (var fdfInputStream = new FileStream(fdfPath, FileMode.Open))
+        {
+            form.ImportFdf(fdfInputStream);
+        }
+
+        form.Save(outputPath);
+    }
+```
+
+The next code snippet shows how to import FDF format annotations to PDF with PdfAnnotationEditor.ImportAnnotationsFromFdf() method:
+
+```csharp
+
+    var fdfPath = Params.InputPath + "test.fdf";
+    var templatePath = Params.InputPath + "Empty.pdf";
+    var outputPath = Params.OutputPath + "test_annEditor.pdf";
+
+    var editor = new PdfAnnotationEditor();
+    editor.BindPdf(new Document(templatePath));
+    editor.ImportAnnotationsFromFdf(fdfPath);
+    editor.Save(outputPath);
+```

net/get-started/licensing/_index.md

@@ -15,12 +15,12 @@ sitemap:
 
 We want our customers to test our components thoroughly before buying so the evaluation version allows you to use it as you would normally.
 
-- **PDF created with an evaluation watermark.** The evaluation version of Aspose.PDF for .NET provides full product functionality, but all the pages in the generated PDF documents are watermarked with "Evaluation Only. Created with Aspose.PDF. Copyright 2002-2020 Aspose Pty Ltd" at the top.
+- **PDF created with an evaluation watermark.** The evaluation version of Aspose.PDF for .NET provides full product functionality, but all pages in the generated PDF documents are watermarked with the text "Evaluation Only. Created with Aspose.PDF. Copyright 2002-2024 Aspose Pty Ltd." at the top.
 
-- **The limit of the number of collection items that can be processed.**
-In the evaluation version from any collection, you can process only four elements (for example, only 4 pages, 4 form fields, etc.).
+- **Limit the number of pages that can be processed.**
+In the evaluation version, you can only process the first four pages of a document.
 
->If you want to test Aspose.HTML for .NET without the evaluation version limitations, you can also request a 30-day Temporary License. Please refer to [How to get a Temporary License?](https://purchase.aspose.com/temporary-license)
+>If you want to test Aspose.PDF for .NET without the evaluation version limitations, you can also request a 30-day Temporary License. Please refer to [How to get a Temporary License?](https://purchase.aspose.com/temporary-license)
 
 ## Classic license
 
@@ -142,6 +142,4 @@ namespace Aspose.Pdf.Examples
     }
 }
 ```
-### Applying a License Bought Before 2005/01/22
 
-Aspose.PDF for .NET no longer supports the old-style licenses. If you have a license from before 22 January 2005 and you have updated to a more recent version of Aspose.PDF, please contact our Sales team to get a new license file.

net/get-started/supported-file-formats/_index.md

@@ -11,7 +11,7 @@ sitemap:
     priority: 0.7
 ---
 
-The following table indicates the file formats that Aspose.PDF C# can load and Save.
+The following table indicates the file formats that Aspose.PDF for .NET can load and save.
 
 |**Format**|**Description**|**Load**|**Save**|**Remarks**|
 | :- | :- | :- | :- | :- |
@@ -33,9 +33,12 @@ The following table indicates the file formats that Aspose.PDF C# can load and S
 |[PPTX](https://docs.fileformat.com/presentation/pptx/)|Saves the document in the Microsoft PowerPoint Presentations format| |{{< emoticons/tick >}}| |
 |[DOC](https://docs.fileformat.com/word-processing/doc/)|Saves the document in the Microsoft Word format| |{{< emoticons/tick >}}| |
 |[DOCX](https://docs.fileformat.com/word-processing/docx/)|Saves the document in the Microsoft Word format| |{{< emoticons/tick >}}| |
+|[DJVU](https://docs.fileformat.com/image/djvu/)|DjVu is a graphics file format intended for scanned documents and books developed by AT&T Labs|{{< emoticons/tick >}}| | |
+|[CDR](https://docs.fileformat.com/image/cdr/)|A CDR file is a vector drawing image file that is natively created with CorelDRAW|{{< emoticons/tick >}}| | |
 |[MobiXML](https://docs.fileformat.com/ebook/mobi/)|Saves the document in eBook MobiXML Standard format| |{{< emoticons/tick >}}| |
 |[JPEG](https://docs.fileformat.com/image/jpeg/)|Saves the document in JPEG Format|{{< emoticons/tick >}}|{{< emoticons/tick >}}| |
 |[EMF](https://docs.fileformat.com/image/emf/)|Enhanced metafile format (EMF)|{{< emoticons/tick >}}|{{< emoticons/tick >}}| |
+|[PCL](https://docs.fileformat.com/page-description-language/pcl/)|Printer Command Language which is a Page Description Language introduced by Hewlett Packard (HP)|{{< emoticons/tick >}}| | |
 |[PNG](https://docs.fileformat.com/image/png/)|Saves the document in PNG Format|{{< emoticons/tick >}}|{{< emoticons/tick >}}| |
 |[BMP](https://docs.fileformat.com/image/bmp/)|Saves the document in BMP Format|{{< emoticons/tick >}}|{{< emoticons/tick >}}| |
 |[GIF](https://docs.fileformat.com/image/gif/)|Graphic Interchange Format| |{{< emoticons/tick >}}| |

net/whatsnew/_index.md

@@ -11,6 +11,102 @@ sitemap:
 lastmod: "2024-09-06"
 ---
 
+## What's new in Aspose.PDF 24.9
+
+Since version 24.9, it has been possible to generate a crash report when the library throws an exception. A crash report includes information about the type of exception, application title, Aspose.Pdf version, OS version, error message, and stack trace.
+
+The following code snippet demonstrates a common scenario for generating a crash report:
+
+```cs
+
+     try
+     {
+        //some code that generates exception
+         throw new Exception("message", new Exception("inner message"));
+     }
+     catch (Exception ex)
+     {
+        PdfException.GenerateCrashReport(new CrashReportOptions(ex));
+     }
+```
+
+Extracting an PDF document layer elements and saving into new PDF stream are available from now. In PDF documents, layers (also known as Optional Content Groups or OCGs) are used for various purposes, primarily to manage and control the visibility of content within the document. This functionality is particularly useful in design, engineering, and publishing. For example: blueprint aspects, complex diagram components, language versions of the same content.
+
+```cs
+
+     var documentPath = "";
+     var resultPdfPath ="";
+
+     var inputDocument = new Document(documentPath);
+     var inputPage = inputDocument.Pages[1];
+
+     var layers = inputPage.Layers;
+
+     foreach (var layer in layers)
+     {
+         var outputPdf = string.Format("{0}_{1}.pdf", resultPdfPath, layer.Id);
+
+         using (var stream = File.Create(outputPdf))
+         {
+             layer.Save(stream);
+         }
+     }
+```
+
+The `GraphicalPdfComparer` class is added for the graphic comparison of PDF documents and pages. Graphic comparison deals with document page images. It returns the result as an `ImagesDifference` object or as a PDF document that contains images merged from the original and the differences. Graphic comparison is most useful for documents that have minor differences in text or graphic content.
+
+The following code snippet demonstrates the graphic comparison of two PDF documents and saves an image with the differences into the resultant PDF document:
+
+```cs
+
+     var firstDocumentPath = "";
+     var secondDocumentPath = "";
+     var resultPdfPath ="";
+
+    using (Document doc1 = new Document(firstDocumentPath), doc2 = new Document(secondDocumentPath))
+    {
+        GraphicalPdfComparer comparer = new GraphicalPdfComparer()
+        {
+            Threshold = 3.0,
+            Color = Color.Red,
+            Resolution = new Resolution(300)
+        };
+        comparer.CompareDocumentsToPdf(doc1, doc2, resultPdfPath);
+    }
+```
+
+API implemented for integrating FileFormat.HEIC and Aspose.PDF. The HEIC (High-Efficiency Image Coding) is a modern image file format introduced by Apple with iOS 11 in 2017 as the default image format for iPhones and iPads.
+
+To convert HEIC images to PDF user should add the reference to `FileFormat.HEIC` NuGet package and use the following code snippet:
+
+```cs
+
+     var heicImagePath = "iphone_photo.heic";
+     var resultPdfPath ="iphone_photo.pdf";
+
+     using (var fs = new FileStream(heicImagePath, FileMode.Open))
+     {
+         HeicImage image = HeicImage.Load(fs);
+         var pixels = image.GetByteArray(PixelFormat.Rgb24);
+         var width = (int)image.Width;
+         var height = (int)image.Height;
+
+         var document = new Document();
+         Aspose.Pdf.Page page = document.Pages.Add();
+         Aspose.Pdf.Image asposeImage = new Aspose.Pdf.Image();
+         asposeImage.BitmapInfo = new BitmapInfo(pixels, width, height, BitmapInfo.PixelFormat.Rgb24);
+         page.PageInfo.Height = height;
+         page.PageInfo.Width = width;
+         page.PageInfo.Margin.Bottom = 0;
+         page.PageInfo.Margin.Top = 0;
+         page.PageInfo.Margin.Right = 0;
+         page.PageInfo.Margin.Left = 0;
+
+         page.Paragraphs.Add(asposeImage);
+         document.Save(resultPdfPath);
+     }
+```
+
 ## What's new in Aspose.PDF 24.8
 
 Converting PDF Documents into PDF/A-4 format