Merge branch 'master' into new-kb-add-watermark-pdf-radpdfprocessing-148c1282b51b44c38dd649ca2925a3e3

Author: dessyordanova

getting-started/Installation/nuget-packages.md

@@ -14,8 +14,6 @@ Telerik provides NuGet packages with the assemblies for all five Document Proces
 
 If your workflow relies on NuGet for package management, you can take advantage of the packages that we describe in this article. There is no need to download and install the Document Processing libraries by using other methods.
 
-> The improved Telerik NuGet v3 is now available at https://nuget.telerik.com/v3/index.json. The new v3 API is faster, lighter, and reduces the number of requests from NuGet clients. The old https://nuget.telerik.com/nuget server will be deprecated and we encourage our clients to switch to the v3 API and use https://nuget.telerik.com/v3/index.json to access it.
-
 >caution The old **https://nuget.telerik.com/nuget** server is deprecated and we encourage our clients to switch to the v3 API. The new v3 API is faster, lighter, and reduces the number of requests from NuGet clients. The **NuGet v2** server at https://nuget.telerik.com/nuget will be sunset in **November 2024**. The new v3 protocol offers faster package searches and restores, improved security, and more reliable infrastructure. To redirect your feed to the NuGet v3 protocol, all you have to do is to change your NuGet package source URL to https://nuget.telerik.com/v3/index.json.  
 
 #### This article contains the following sections:

getting-started/first-steps.md

@@ -19,8 +19,6 @@ Since we distribute Telerik Document Processing libraries as an addition to seve
 
 >tipRegardless of the Telerik UI components suite that you use, you can always get the Document Processing assemblies as NuGet packages from the [Telerik NuGet server]({%slug installation-nuget-packages%}).
 
-> The improved Telerik NuGet v3 is now available at **https://nuget.telerik.com/v3/index.json**. The new v3 API is faster, lighter, and reduces the number of requests from NuGet clients. The old https://nuget.telerik.com/nuget server will be deprecated and we encourage our clients to switch to the v3 API and use https://nuget.telerik.com/v3/index.json to access it.
-
 >caution The old **https://nuget.telerik.com/nuget** server is deprecated and we encourage our clients to switch to the v3 API. The new v3 API is faster, lighter, and reduces the number of requests from NuGet clients. The **NuGet v2** server at https://nuget.telerik.com/nuget will be sunset in **November 2024**. The new v3 protocol offers faster package searches and restores, improved security, and more reliable infrastructure. To redirect your feed to the NuGet v3 protocol, all you have to do is to change your NuGet package source URL to https://nuget.telerik.com/v3/index.json.  
 
 | UI Components suite | Installation instructions | Default location of the Document Processing assemblies |

knowledge-base/add-barcode-to-pdf-telerik.md

@@ -0,0 +1,72 @@
+---
+title: Adding a Barcode to a PDF Document using PdfProcessing and the WinForms BarcodeView
+description: Learn how to generate a barcode and incorporate it into a PDF document using Telerik products.
+type: how-to
+page_title: How to Add a Barcode to a PDF with PdfProcessing and the WinForms BarcodeView
+slug: add-barcode-to-pdf-telerik
+tags: radpdfprocessing, document processing, barcode, pdf, telerik reporting, winforms, barcodeview
+res_type: kb
+ticketid: 1657503
+---
+
+## Environment
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.2.426| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+Learn how to generate a PDF document and add a barcode to it.  
+
+![Pdf with Barcodes](images/pdf-with-barcodes.png)  
+
+## Solution
+
+To add a barcode to a PDF document, consider using the [WinForms BarcodeView](https://docs.telerik.com/devtools/winforms/controls/barcodeview/overview): 
+
+1\. First, [generate an image of the barcode](https://docs.telerik.com/devtools/winforms/controls/barcodeview/how-to/export-to-image)
+
+2\. Then, add the [image to the PDF document]({%slug pdf-from-images-with-radfixeddocumenteditor%}). Here is a sample code snippet:
+
+ ```csharp
+    Telerik.WinControls.UI.Barcode.QRCode qrCode1 = new Telerik.WinControls.UI.Barcode.QRCode();
+    RadBarcodeView radBarcodeView = new RadBarcodeView();
+    radBarcodeView.BindingContext = new BindingContext();
+    qrCode1.Version = 1;
+    radBarcodeView.Symbology = qrCode1;
+    radBarcodeView.Text = "radBarcodeView1";
+    radBarcodeView.Value = "1234567";
+    radBarcodeView.Invalidate();
+    System.Drawing.Image img = radBarcodeView.ExportToImage(200, 200);
+    string imageFilePath = "barcodeImage.png";
+    img.Save(imageFilePath, System.Drawing.Imaging.ImageFormat.Png);
+
+    RadFixedDocument fixedDocument = new RadFixedDocument();     
+    RadFixedDocumentEditor documentEditor = new RadFixedDocumentEditor(fixedDocument);
+    FileStream fileStream = new FileStream(imageFilePath, FileMode.Open);
+    Telerik.Windows.Documents.Fixed.Model.Resources.ImageSource _imageSource = new Telerik.Windows.Documents.Fixed.Model.Resources.ImageSource(fileStream);
+    documentEditor.InsertImageInline(_imageSource);
+    documentEditor.InsertLineBreak();
+    documentEditor.Dispose();
+    PdfFormatProvider provider = new PdfFormatProvider();
+    string outputFilePath = "output.pdf";
+    File.Delete(outputFilePath);
+    using (Stream output = File.OpenWrite(outputFilePath))
+    {
+        provider.Export(fixedDocument, output);
+    }
+    Process.Start(new ProcessStartInfo() { FileName = outputFilePath, UseShellExecute = true });
+  ```
+
+## Notes
+
+- The WinForms BarcodeView method is suitable for applications where a barcode image can be generated and saved before adding it to the PDF: [Generating a Bar Code Image outside WinForms](https://docs.telerik.com/devtools/winforms/knowledge-base/gridview-generating-barcode-image-non-winforms).
+
+## See Also
+
+- [RadPdfProcessing Documentation]({%slug radpdfprocessing-overview%})
+- [WinForms BarcodeView](https://docs.telerik.com/devtools/winforms/controls/barcodeview/overview)
+- [Exporting BarcodeView to Image](https://docs.telerik.com/devtools/winforms/controls/barcodeview/how-to/export-to-image)
+- [Generating a Barcode Image outside WinForms](https://docs.telerik.com/devtools/winforms/knowledge-base/gridview-generating-barcode-image-non-winforms)
+

knowledge-base/add-shadow-image-radpdfprocessing.md

@@ -0,0 +1,100 @@
+---
+title: Adding Images with a Shadow in PDF Documents
+description: Learn how to add a shadow effect when inserting images into PDF documents using RadPdfProcessing.
+type: how-to
+page_title: How to Simulate Shadow Effects for Images in PDFs with RadPdfProcessing
+slug: add-shadow-image-radpdfprocessing
+tags: radpdfprocessing, document processing, image, shadow, insertimage, path, geometry
+res_type: kb
+ticketid: 1655064
+---
+
+## Environment
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.2.426| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+When inserting an image into a PDF document using the [Block.InsertImage](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/block#inserting-image) method, you might want to add a shadow effect to enhance its appearance. [RadPdfProcessing](%slug radpdfprocessing-overview%) provides functionalities to draw paths and geometries, enabling the simulation of shadows around images. This KB article demonstrates how to add a shadow to an image in a PDF document.
+
+## Solution
+
+To add a shadow to an image, utilize [paths]({%slug radpdfprocessing-model-path%}) with specific [geometries]({%slug radpdfprocessing-concepts-geometry%}) to simulate the shadow effect. The following example outlines the necessary steps to insert an image and draw a shadow around it using RadPdfProcessing:
+
+1. **Prepare the environment**: Ensure that [ImagePropertiesResolver](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/cross-platform/images#imagepropertiesresolver) and [JpegImageConverter](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/cross-platform/images#jpegimageconverter) are set for cross-platform image scenarios. Refer to the RadPdfProcessing documentation on [cross-platform image handling]({%slug radpdfprocessing-cross-platform-images%}).
+
+2. **Insert the image**: Use the `Block.InsertImage` method to insert the image into a block.
+
+3. **Draw the shadow**: Create a `RectangleGeometry` around the image's location with an offset to simulate the shadow effect. Use a dark color for the shadow and adjust its opacity as needed.
+
+4. **Export the PDF document**: Use the [PdfFormatProvider]({%slug radpdfprocessing-formats-and-conversion-pdf-pdfformatprovider%}) to export the document to a PDF file.
+
+```csharp
+public static Padding pageMarginsValue = new Telerik.Windows.Documents.Primitives.Padding(
+     Unit.MmToDip(20), //left
+     Unit.MmToDip(20), //top
+     Unit.MmToDip(0),  //right
+     Unit.MmToDip(0)); //bottom
+
+static void Main(string[] args)
+{
+    // Setup the environment for image handling
+    Telerik.Documents.ImageUtils.ImagePropertiesResolver defaultImagePropertiesResolver = new Telerik.Documents.ImageUtils.ImagePropertiesResolver();
+    Telerik.Windows.Documents.Extensibility.FixedExtensibilityManager.ImagePropertiesResolver = defaultImagePropertiesResolver;
+    Telerik.Windows.Documents.Extensibility.JpegImageConverterBase defaultJpegImageConverter = new Telerik.Documents.ImageUtils.JpegImageConverter();
+    Telerik.Windows.Documents.Extensibility.FixedExtensibilityManager.JpegImageConverter = defaultJpegImageConverter;
+
+    RadFixedDocument fixedDocument = new RadFixedDocument();
+    RadFixedPage fixedPage = fixedDocument.Pages.AddPage();
+    FixedContentEditor fixedContentEditor = new FixedContentEditor(fixedPage);
+
+    using (Stream imageStream = File.OpenRead("ninja.png"))
+    {
+        Block imageBlock = new Block();
+        imageBlock.SpacingAfter = 0;
+        imageBlock.HorizontalAlignment = Telerik.Windows.Documents.Fixed.Model.Editing.Flow.HorizontalAlignment.Center;
+        Telerik.Windows.Documents.Fixed.Model.Resources.ImageSource _imageSource =
+            new Telerik.Windows.Documents.Fixed.Model.Resources.ImageSource(imageStream);
+        imageBlock.InsertImage(_imageSource);
+        Size imageBlockDesiredSize = imageBlock.Measure();
+        int shadowWidth = 10;
+
+        // DrawShadow
+        RectangleGeometry rectangleGeometry = new RectangleGeometry();
+        rectangleGeometry.Rect = new Rect(pageMarginsValue.Left + shadowWidth, pageMarginsValue.Top + shadowWidth, imageBlockDesiredSize.Width, imageBlockDesiredSize.Height);
+        Telerik.Windows.Documents.Fixed.Model.Graphics.Path path = fixedPage.Content.AddPath();
+        path.IsFilled = true;
+        path.IsStroked = false;
+        RgbColor shadowColor = new RgbColor(80, 0, 0, 0);
+        path.Fill = shadowColor;
+        path.Geometry = rectangleGeometry;
+                 
+        fixedContentEditor.DrawBlock(imageBlock);                     
+
+        // Export the document
+        PdfFormatProvider provider = new PdfFormatProvider();
+        string outputFilePath = @"sample.pdf";
+        using (Stream output = File.OpenWrite(outputFilePath))
+        {
+            provider.Export(fixedDocument, output);
+        }
+        Process.Start(new ProcessStartInfo() { FileName = outputFilePath, UseShellExecute = true });
+    } 
+}
+```
+ ![Image Shadon in PDF](images/image-shadow-pdf.png)  
+
+Adjust the shadow's size, color, and opacity according to your requirements. This approach can be customized to fit specific needs or visual styles.
+
+## Notes
+
+- The provided example is a basic approach to simulating a shadow and might not cover all use cases.
+- Experiment with different geometry shapes and colors to achieve the desired shadow effect.
+
+## See Also
+
+- [RadPdfProcessing Documentation]({%slug radpdfprocessing-overview%})
+- [Drawing Geometries in PDF Documents](https://docs.telerik.com/devtools/document-processing/libraries/radpdfprocessing/editing/fixedcontenteditor#inserting-geometries)
+- [Handling Images in Cross-Platform Scenarios]({%slug radpdfprocessing-cross-platform-images%})

knowledge-base/convert-tiff-to-pdf-radpdfprocessing.md

@@ -110,6 +110,6 @@ This approach ensures the TIFF images are converted to PDF format without any pa
 
 ## See Also
 
-- [RadPdfProcessing Documentation]({%slug radpdfprocessing-overview%}})
-- [How to Generate a PDF Document from Images with FixedContentEditor]({%slug pdf-from-images-with-fixedcontenteditor%}})
-- [How to Generate a PDF Document from Images with RadFixedDocumentEditor]({%slug pdf-from-images-with-radfixeddocumenteditor%}})
+- [RadPdfProcessing Documentation]({%slug radpdfprocessing-overview%})
+- [How to Generate a PDF Document from Images with FixedContentEditor]({%slug pdf-from-images-with-fixedcontenteditor%})
+- [How to Generate a PDF Document from Images with RadFixedDocumentEditor]({%slug pdf-from-images-with-radfixeddocumenteditor%})

knowledge-base/create-cropped-pdf-radpdfprocessing.md

@@ -0,0 +1,74 @@
+---
+title: Creating a Cropped PDF from an Existing PDF Page Using RadPdfProcessing
+description: Learn how to generate a new PDF document by cropping a page from an existing PDF using RadPdfProcessing.
+type: how-to
+page_title: How to Crop a Page from an Existing PDF and Create a New Document with RadPdfProcessing
+slug: create-cropped-pdf-radpdfprocessing
+tags: radpdfprocessing, document processing, pdf, crop, pdfstreamwriter
+res_type: kb
+ticketid: 1653594
+---
+
+## Environment
+
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.2.426| RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+When working with PDF documents, you might encounter scenarios where you need to extract and crop a specific page to create a new PDF document. This article demonstrates how to use [RadPdfProcessing]({%slug radpdfprocessing-overview%}) to crop a page from an existing PDF and save the cropped content as a new PDF document.
+
+## Solution
+
+To create a new PDF document from a cropped page of an existing PDF, follow these steps:
+
+1. **Extract the desired page from the original PDF document.** Use the [PdfFileSource]({%slug radpdfprocessing-formats-and-conversion-pdf-pdfstreamwriter-pdffilesource%}) class to access the pages of the original PDF.
+
+2. **Create a new PDF document with the extracted page.** Utilize the [PdfStreamWriter]({%slug radpdfprocessing-formats-and-conversion-pdf-pdfstreamwriter-overview%}) class to write the extracted page into a new PDF document.
+
+3. **Crop the content of the newly created PDF.** Modify the `CropBox` of the `RadFixedPage` to specify the cropped area.
+
+4. **Export the cropped document as a new PDF file.**
+
+Here's a complete code snippet illustrating the process:
+
+```csharp
+        private static void CreateCroppedPagePDF()
+        {
+            string originalFilePath = @"WinForms PdfViewer.pdf";
+            int pageIndex = 3;
+            string outputPageFilePath = @"..\..\page3.pdf";
+            File.Delete(outputPageFilePath);
+            using (PdfFileSource fileToSplit = new PdfFileSource(File.OpenRead(originalFilePath)))
+            {
+                PdfPageSource page = fileToSplit.Pages[pageIndex];
+
+                using (PdfStreamWriter fileWriter = new PdfStreamWriter(File.OpenWrite(outputPageFilePath)))
+                {
+                    fileWriter.WritePage(page);
+                }
+            }
+            PdfFormatProvider provider = new PdfFormatProvider();
+            RadFixedDocument croppedDocument = provider.Import(File.ReadAllBytes(outputPageFilePath));
+            Rect middleRectangle = new Rect(0, croppedDocument.Pages.First().Size.Height / 3, croppedDocument.Pages.First().Size.Width, croppedDocument.Pages.First().Size.Height / 3);
+            foreach (RadFixedPage page in croppedDocument.Pages)
+            {
+                page.CropBox = middleRectangle;
+            }
+            File.WriteAllBytes(outputPageFilePath, provider.Export(croppedDocument));
+            Process.Start(new ProcessStartInfo() { FileName = outputPageFilePath, UseShellExecute = true });
+        }
+```
+
+This code snippet demonstrates how to create a new PDF by cropping the center third of a specific page from an existing PDF document. The observed result is illustrated below:
+
+![New PDF document with Cropped Content](images/pdf-with-cropped-page.png) 
+
+## See Also
+
+- [RadPdfProcessing Documentation]({%slug radpdfprocessing-overview%})
+- [PdfStreamWriter]({%slug radpdfprocessing-formats-and-conversion-pdf-pdfstreamwriter-overview%}) 
+- [Telerik Document Processing SDK Repository](https://github.com/telerik/document-processing-sdk)
+- [Cropping PDF Pages and Saving as Images Using RadPdfProcessing]({%slug crop-save-pdf-pages-as-images-radpdfprocessing%})
+---