Allow registring of custom font mappings and directories

Author: eXpl0it3r

Source/HtmlRenderer.PdfSharp/Adapters/PdfSharpAdapter.cs

@@ -33,6 +33,11 @@ internal sealed class PdfSharpAdapter : RAdapter
         /// </summary>
         private static readonly PdfSharpAdapter _instance = new PdfSharpAdapter();
 
+        /// <summary>
+        /// Font resolver instance for managing font discovery and resolution.
+        /// </summary>
+        private FontResolver _fontResolver;
+
         #endregion
 
 
@@ -41,12 +46,12 @@ internal sealed class PdfSharpAdapter : RAdapter
         /// </summary>
         private PdfSharpAdapter()
         {
-            var fontResolver = FontResolver.Register();
+            _fontResolver = FontResolver.Register();
 
             AddFontFamilyMapping("monospace", "Courier New");
             AddFontFamilyMapping("Helvetica", "Arial");
 
-            var fontFamilies = fontResolver.DiscoverFontFamilies();
+            var fontFamilies = _fontResolver.DiscoverFontFamilies();
 
             foreach (var fontFamily in fontFamilies)
             {
@@ -62,6 +67,14 @@ public static PdfSharpAdapter Instance
             get { return _instance; }
         }
 
+        /// <summary>
+        /// Get the FontResolver instance for advanced font management.
+        /// </summary>
+        internal FontResolver FontResolver
+        {
+            get { return _fontResolver; }
+        }
+
         protected override RColor GetColorInt(string colorName)
         {
             try

Source/HtmlRenderer.PdfSharp/FontResolution/FontResolver.cs

@@ -101,6 +101,9 @@ public byte[] GetFont(string faceName)
         public void RegisterCustomFontDirectory(string fontDirectory)
         {
             _fontDiscoveryService.RegisterCustomFontDirectory(fontDirectory);
+            
+            // Invalidate the cache to trigger discovery
+            _fontMetadataCache.Clear();
         }
 
         public List<string> DiscoverFontFamilies()

Source/HtmlRenderer.PdfSharp/PdfGenerator.cs

@@ -14,6 +14,7 @@
 using PdfSharp.Drawing;
 using PdfSharp.Pdf;
 using System;
+using TheArtOfDev.HtmlRenderer.Adapters;
 using TheArtOfDev.HtmlRenderer.Core;
 using TheArtOfDev.HtmlRenderer.Core.Entities;
 using TheArtOfDev.HtmlRenderer.Core.Utils;
@@ -28,11 +29,11 @@ public static class PdfGenerator
     {
         /// <summary>
         /// Adds a font mapping from <paramref name="fromFamily"/> to <paramref name="toFamily"/> iff the <paramref name="fromFamily"/> is not found.<br/>
-        /// When the <paramref name="fromFamily"/> font is used in rendered html and is not found in existing 
+        /// When the <paramref name="fromFamily"/> font is used in rendered HTML and is not found in existing 
         /// fonts (installed or added) it will be replaced by <paramref name="toFamily"/>.<br/>
         /// </summary>
         /// <remarks>
-        /// This fonts mapping can be used as a fallback in case the requested font is not installed in the client system.
+        /// This font mapping can be used as a fallback in case the requested font is not installed in the client system.
         /// </remarks>
         /// <param name="fromFamily">the font family to replace</param>
         /// <param name="toFamily">the font family to replace with</param>
@@ -44,15 +45,44 @@ public static void AddFontFamilyMapping(string fromFamily, string toFamily)
             PdfSharpAdapter.Instance.AddFontFamilyMapping(fromFamily, toFamily);
         }
 
+        /// <summary>
+        /// Adds a custom font family to be used during HTML rendering.<br/>
+        /// </summary>
+        /// <remarks>
+        /// This allows you to register fonts that are not installed on the system.
+        /// </remarks>
+        /// <param name="fontFamily">the font family to add</param>
+        public static void AddFontFamily(RFontFamily fontFamily)
+        {
+            ArgChecker.AssertArgNotNull(fontFamily, "fontFamily");
+
+            PdfSharpAdapter.Instance.AddFontFamily(fontFamily);
+        }
+
+        /// <summary>
+        /// Registers a custom directory to search for font files (TTF/OTF).<br/>
+        /// Fonts in this directory will be discovered and made available for rendering.
+        /// </summary>
+        /// <remarks>
+        /// After calling this method, you should call <see cref="AddFontFamily"/> with fonts from this directory.
+        /// </remarks>
+        /// <param name="fontDirectory">the directory path containing font files</param>
+        public static void RegisterCustomFontDirectory(string fontDirectory)
+        {
+            ArgChecker.AssertArgNotNullOrEmpty(fontDirectory, "fontDirectory");
+
+            PdfSharpAdapter.Instance.FontResolver.RegisterCustomFontDirectory(fontDirectory);
+        }
+
         /// <summary>
         /// Parse the given stylesheet to <see cref="CssData"/> object.<br/>
-        /// If <paramref name="combineWithDefault"/> is true the parsed css blocks are added to the 
-        /// default css data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned.
+        /// If <paramref name="combineWithDefault"/> is true the parsed CSS blocks are added to the 
+        /// default CSS data (as defined by W3), merged if class name already exists. If false only the data in the given stylesheet is returned.
         /// </summary>
         /// <seealso cref="http://www.w3.org/TR/CSS21/sample.html"/>
         /// <param name="stylesheet">the stylesheet source to parse</param>
-        /// <param name="combineWithDefault">true - combine the parsed css data with default css data, false - return only the parsed css data</param>
-        /// <returns>the parsed css data</returns>
+        /// <param name="combineWithDefault">true - combine the parsed CSS data with default CSS data, false - return only the parsed CSS data</param>
+        /// <returns>the parsed CSS data</returns>
         public static CssData ParseStyleSheet(string stylesheet, bool combineWithDefault = true)
         {
             return CssData.Parse(PdfSharpAdapter.Instance, stylesheet, combineWithDefault);
@@ -64,10 +94,10 @@ public static CssData ParseStyleSheet(string stylesheet, bool combineWithDefault
         /// <param name="html">HTML source to create PDF from</param>
         /// <param name="pageSize">the page size to use for each page in the generated pdf </param>
         /// <param name="margin">the margin to use between the HTML and the edges of each page</param>
-        /// <param name="cssData">optional: the style to use for html rendering (default - use W3 default style)</param>
+        /// <param name="cssData">optional: the style to use for HTML rendering (default - use W3 default style)</param>
         /// <param name="stylesheetLoad">optional: can be used to overwrite stylesheet resolution logic</param>
         /// <param name="imageLoad">optional: can be used to overwrite image resolution logic</param>
-        /// <returns>the generated image of the html</returns>
+        /// <returns>the generated image of the HTML</returns>
         public static PdfDocument GeneratePdf(string html, PageSize pageSize, int margin = 20, CssData cssData = null, EventHandler<HtmlStylesheetLoadEventArgs> stylesheetLoad = null, EventHandler<HtmlImageLoadEventArgs> imageLoad = null)
         {
             var config = new PdfGenerateConfig();
@@ -81,10 +111,10 @@ public static PdfDocument GeneratePdf(string html, PageSize pageSize, int margin
         /// </summary>
         /// <param name="html">HTML source to create PDF from</param>
         /// <param name="config">the configuration to use for the PDF generation (page size/page orientation/margins/etc.)</param>
-        /// <param name="cssData">optional: the style to use for html rendering (default - use W3 default style)</param>
+        /// <param name="cssData">optional: the style to use for HTML rendering (default - use W3 default style)</param>
         /// <param name="stylesheetLoad">optional: can be used to overwrite stylesheet resolution logic</param>
         /// <param name="imageLoad">optional: can be used to overwrite image resolution logic</param>
-        /// <returns>the generated image of the html</returns>
+        /// <returns>the generated image of the HTML</returns>
         public static PdfDocument GeneratePdf(string html, PdfGenerateConfig config, CssData cssData = null, EventHandler<HtmlStylesheetLoadEventArgs> stylesheetLoad = null, EventHandler<HtmlImageLoadEventArgs> imageLoad = null)
         {
             // create PDF document to render the HTML into
@@ -103,10 +133,10 @@ public static PdfDocument GeneratePdf(string html, PdfGenerateConfig config, Css
         /// <param name="html">HTML source to create PDF from</param>
         /// <param name="pageSize">the page size to use for each page in the generated pdf </param>
         /// <param name="margin">the margin to use between the HTML and the edges of each page</param>
-        /// <param name="cssData">optional: the style to use for html rendering (default - use W3 default style)</param>
+        /// <param name="cssData">optional: the style to use for HTML rendering (default - use W3 default style)</param>
         /// <param name="stylesheetLoad">optional: can be used to overwrite stylesheet resolution logic</param>
         /// <param name="imageLoad">optional: can be used to overwrite image resolution logic</param>
-        /// <returns>the generated image of the html</returns>
+        /// <returns>the generated image of the HTML</returns>
         public static void AddPdfPages(PdfDocument document, string html, PageSize pageSize, int margin = 20, CssData cssData = null, EventHandler<HtmlStylesheetLoadEventArgs> stylesheetLoad = null, EventHandler<HtmlImageLoadEventArgs> imageLoad = null)
         {
             var config = new PdfGenerateConfig();
@@ -121,10 +151,10 @@ public static void AddPdfPages(PdfDocument document, string html, PageSize pageS
         /// <param name="document">PDF document to append pages to</param>
         /// <param name="html">HTML source to create PDF from</param>
         /// <param name="config">the configuration to use for the PDF generation (page size/page orientation/margins/etc.)</param>
-        /// <param name="cssData">optional: the style to use for html rendering (default - use W3 default style)</param>
+        /// <param name="cssData">optional: the style to use for HTML rendering (default - use W3 default style)</param>
         /// <param name="stylesheetLoad">optional: can be used to overwrite stylesheet resolution logic</param>
         /// <param name="imageLoad">optional: can be used to overwrite image resolution logic</param>
-        /// <returns>the generated image of the html</returns>
+        /// <returns>the generated image of the HTML</returns>
         public static void AddPdfPages(PdfDocument document, string html, PdfGenerateConfig config, CssData cssData = null, EventHandler<HtmlStylesheetLoadEventArgs> stylesheetLoad = null, EventHandler<HtmlImageLoadEventArgs> imageLoad = null)
         {
             XSize orgPageSize;