Merge pull request #397 from telerik/new-kb-inserting-special-symbols…

…-pdf-radpdfprocessing-edb732d7e0be4da39da3676e06ecdab3 Added new kb article inserting-special-symbols-pdf-radpdfprocessing
telerik · Apr 9, 2024 · cf9e4fd · cf9e4fd
2 parents be722b5 + e6ec105
commit cf9e4fd
Show file tree

Hide file tree

Showing 4 changed files with 134 additions and 2 deletions.
diff --git a/knowledge-base/images/inserting-special-symbols-pdf-radpdfprocessing.png b/knowledge-base/images/inserting-special-symbols-pdf-radpdfprocessing.png
diff --git a/knowledge-base/inserting-special-symbols-pdf-radpdfprocessing.md b/knowledge-base/inserting-special-symbols-pdf-radpdfprocessing.md
@@ -0,0 +1,126 @@
+---
+title: Inserting Special Symbols in PDF using RadPdfProcessing
+description: This article explains how to insert special symbols, such as "↓", in a PDF document using RadPdfProcessing.
+type: how-to
+page_title: Inserting Special Symbols in PDF using RadPdfProcessing
+slug: inserting-special-symbols-pdf-radpdfprocessing
+tags: radpdfprocessing, pdf, special symbols, insert, visual studio
+res_type: kb
+---
+
+## Environment
+| Version | Product | Author | 
+| --- | --- | ---- | 
+| 2024.1.124 | RadPdfProcessing |[Desislava Yordanova](https://www.telerik.com/blogs/author/desislava-yordanova)| 
+
+## Description
+
+This article shows how to insert special symbols, such as "↓", in a PDF document using RadPdfProcessing.
+
+![Special Symbols in PdfProcessing](images/inserting-special-symbols-pdf-radpdfprocessing.png)   
+
+## Solution
+
+When using the Telerik Document Processing's .NET Standard assemblies/NuGet packages and want to export a document to PDF format, the PdfProcessing library needs to have access to the specific font's data so that it can read it and add it to the PDF file. That is why, to allow the library to create and use fonts, you will need to provide an implementation of the FontsProviderBase abstract class and set this implementation to the FontsProvider property of FixedExtensibilityManager. 
+
+```csharp
+
+
+using System.Diagnostics;
+using Telerik.Documents.Core.Fonts;
+using Telerik.Windows.Documents.Fixed.FormatProviders.Pdf;
+using Telerik.Windows.Documents.Fixed.Model;
+using Telerik.Windows.Documents.Fixed.Model.Editing;
+using Telerik.Windows.Documents.Fixed.Model.Editing.Tables;
+
+Telerik.Windows.Documents.Extensibility.FontsProviderBase fontsProvider = new FontsProvider();
+Telerik.Windows.Documents.Extensibility.FixedExtensibilityManager.FontsProvider = fontsProvider;
+
+RadFixedDocument document = new RadFixedDocument();
+RadFixedDocumentEditor editor = new RadFixedDocumentEditor(document);
+
+Table table = new Table();
+TableRow row = table.Rows.AddTableRow();
+TableCell valueCell = row.Cells.AddTableCell();
+Block valueCellBlock = valueCell.Blocks.AddBlock();
+valueCellBlock.InsertText(new FontFamily("Arial"),"36 °C");
+row = table.Rows.AddTableRow();
+valueCell = row.Cells.AddTableCell();
+valueCellBlock = valueCell.Blocks.AddBlock();
+valueCellBlock.InsertText(new FontFamily("Calibri"), "↓");
+editor.InsertTable(table);
+
+string outputdDocumentName = "Exported.pdf";
+if (File.Exists(outputdDocumentName))
+{
+    File.Delete(outputdDocumentName);
+}
+
+PdfFormatProvider provider = new PdfFormatProvider();
+using (Stream stream = new FileStream(outputdDocumentName, FileMode.OpenOrCreate))
+{
+    provider.Export(document, stream);
+}
+
+Process.Start(new ProcessStartInfo() { FileName = outputdDocumentName, UseShellExecute = true });
+
+internal class FontsProvider : Telerik.Windows.Documents.Extensibility.FontsProviderBase
+{
+    private readonly string fontFolder = Environment.GetFolderPath(Environment.SpecialFolder.Fonts);
+
+    public override byte[] GetFontData(Telerik.Windows.Documents.Core.Fonts.FontProperties fontProperties)
+    {
+        string fontFamilyName = fontProperties.FontFamilyName;
+        bool isBold = fontProperties.FontWeight == Telerik.Documents.Core.Fonts.FontWeights.Bold;
+        string fontFolder = Environment.GetFolderPath(Environment.SpecialFolder.Fonts);
+        if (fontFamilyName == "Arial" && isBold)
+        {
+            using (FileStream fileStream = File.OpenRead(fontFolder + "\\arialbd.ttf"))
+            {
+                using (MemoryStream memoryStream = new MemoryStream())
+                {
+                    fileStream.CopyTo(memoryStream);
+                    return memoryStream.ToArray();
+                }
+            }
+        }
+        else if (fontFamilyName == "Arial")
+        {
+            return this.GetFontDataFromFontFolder("arial.ttf");
+        }
+        else if (fontFamilyName == "Calibri" && isBold)
+        {
+            return this.GetFontDataFromFontFolder("calibrib.ttf");
+        }
+        else if (fontFamilyName == "Calibri")
+        {
+            return this.GetFontDataFromFontFolder("calibri.ttf");
+        }
+        else if (fontFamilyName == "Segoe UI")
+        {
+            return this.GetFontDataFromFontFolder("segoeui.ttf");
+        }
+
+        return null;
+    }
+
+    private byte[] GetFontDataFromFontFolder(string fontFileName)
+    {
+        using (FileStream fileStream = File.OpenRead(this.fontFolder + "\\" + fontFileName))
+        {
+            using (MemoryStream memoryStream = new MemoryStream())
+            {
+                fileStream.CopyTo(memoryStream);
+                return memoryStream.ToArray();
+            }
+        }
+    }
+}
+
+```
+
+## See Also
+- [Standard Fonts]({%slug radpdfprocessing-concepts-fonts%})
+- [Cross-Platform Support]({%slug radpdfprocessing-cross-platform%})
+- [Cross-Platform Support >> Fonts]({%slug radpdfprocessing-cross-platform-fonts%})
+- [How to Implement FontsProvider]({%slug pdfprocessing-implement-fontsprovider%})
diff --git a/knowledge-base/pdfprocessing-implement-fontsprovider.md b/knowledge-base/pdfprocessing-implement-fontsprovider.md
@@ -118,4 +118,5 @@ In the validation, each font name (FontFamilyName) must be explicitly specified
 
 ## See Also
  * [Standard Fonts]({%slug radpdfprocessing-concepts-fonts%})
- * [Cross-Platform Support]({%slug radpdfprocessing-cross-platform%})
+ * [Cross-Platform Support]({%slug radpdfprocessing-cross-platform%}) 
+ * [Inserting Special Symbols in PDF using RadPdfProcessing]({%slug inserting-special-symbols-pdf-radpdfprocessing%})
diff --git a/libraries/radpdfprocessing/cross-platform/fonts.md b/libraries/radpdfprocessing/cross-platform/fonts.md
@@ -21,4 +21,9 @@ You can find a detailed **FixedExtensibilityManager** and **FontsProvider** desc
 >important If the FontsProvider property is not set, a default font will be used when exporting the document.
 	
 ## See Also
-- [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+
+ * [Standard Fonts]({%slug radpdfprocessing-concepts-fonts%})
+ * [Cross-Platform Support]({%slug radpdfprocessing-cross-platform%})
+ * [Inserting Special Symbols in PDF using RadPdfProcessing]({%slug inserting-special-symbols-pdf-radpdfprocessing%})
+ * [How to Eliminate Formatting Issues when Exporting XLSX to PDF Format]({%slug exporting-xlsx-to-pdf-formatting-issues%})
+