Exclude fonts

By default, GroupDocs.Viewer includes (exports) the fonts used in the loaded document into the produced HTML. This ensures correct display regardless of the required fonts existing on the viewer device. Depending on the type of HTML rendering, fonts are included as follows:

  1. Embedded resources — font content is embedded (inlined, backed) directly inside the HTML-markup using the data URI scheme through base64 encoding.
  2. External resources — font content is stored aside from the HTML document, externally; each font may be stored as a distinct file on the disk or its content may be written to the byte stream, specified by the user through a CreateResourceStream delegate.

GroupDocs.Viewer supports a lot of document formats, and not for all of them it is possible to export the fonts to the resultant produced HTML. A list of file formats that support font export when rendering them to HTML format is provided in the list below:

  1. Portable Document Format (PDF)
  2. Microsoft Word formats (DOC, DOCX, DOCM, DOT, DOTX, DOTM)
  3. Microsoft PowerPoint formats (PPT, PPTX, PPS, PPSX)
  4. Microsoft Outlook formats (MSG, EML)
  5. Apple Mail (EMLX)
  6. OpenDocument formats (ODT, OTT, ODP)
  7. Rich Text Format (RTF)
  8. e-Books formats (Electronic publication (EPUB), Mobipocket (MOBI), AZW3)
  9. LaTeX (TEX)
  10. Vector images (SVG)

Sometimes including fonts to the produced HTML document is unwanted: for example, user masy have all the font installed on the operating system, where the HTML document should be viewed, and browser can use system-installed fonts. Also when fonts are included, they significantly increase the size of the produced HTML document. To prevent adding fonts that are available on most devices to produced HTML, the GroupDocs.Viewer provides two options: exclude all fonts (complete fonts exclusion) and exclude specified fonts only (selective fonts exclusion).

Both these options are represented in the HtmlViewOptions class as different properties:

  • ExcludeFonts is a flag that disables export of all used fonts to the produced HTML document, when enabled (true). By default this option is disabled (false).
  • FontsToExclude is a list of string, each one represents one font name, that should be excluded from the produced HTML document. By default this list is empty — no fonts are excluded. Please note that this options works only if the ExcludeFonts property is disabled (false).

The folowing code snippet shows how to exclude all fonts from the produced HTML document with the ExcludeFonts flag.

using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();    
    viewOptions.ExcludeFonts = true;
    viewer.View(viewOptions);
}
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()            
            viewOptions.ExcludeFonts = True
            viewer.View(viewOptions)
        End Using
    End Sub
End Module

The following code snippet demonstrates the work of the FontsToExclude property — it shows how to prevent adding the Times New Roman and Arial fonts to HTML.

using GroupDocs.Viewer;
using GroupDocs.Viewer.Options;
// ...

using (Viewer viewer = new Viewer("sample.docx"))
{
    // Create an HTML file.
    var viewOptions = HtmlViewOptions.ForEmbeddedResources();    
    viewOptions.FontsToExclude.Add("Times New Roman");// Exclude the Times New Roman font.
    viewOptions.FontsToExclude.Add("Arial");// Exclude the Arial font.
    viewer.View(viewOptions);
}
Imports GroupDocs.Viewer
Imports GroupDocs.Viewer.Options
' ...

Module Program
    Sub Main(args As String())
        Using viewer As Viewer = New Viewer("sample.docx")
            ' Create an HTML file.
            Dim viewOptions = HtmlViewOptions.ForEmbeddedResources()            
            viewOptions.FontsToExclude.Add("Times New Roman")' Exclude the Times New Roman font.
            viewOptions.FontsToExclude.Add("Arial")' Exclude the Arial font.
            viewer.View(viewOptions)
        End Using
    End Sub
End Module

Supported formats for exclusion

Need to mention that not all formats, listed above, support the complete and selective font exclusion. Two lists below show which formats are supported:

Complete fonts exclusion using ExcludeFonts:

  1. All Microsoft Word formats (DOX, DOCX, DOCM, …)
  2. All PowerPoint presentation formats (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POX, POTM)
  3. All OpenDocument presentation formats (ODP, FODP, OTP)
  4. PDF
  5. OFD (OpenFixed-layout Document)
  6. XPS (including OpenXPS)
  7. PostScript (includikng Encapsulated PostScript)
  8. ePuB
  9. TeX
  10. PCL
  11. CGM
  12. Microsoft Project documents (MPT, MPP, MPX)
  13. All supported archives
  14. Microsoft OneNote ONE format
  15. Vector images with font support (SVG)
  16. All supported email formats

Selexctinve fonts excludion using FontsToExclude:

  1. All PowerPoint presentation formats (PPT, PPTX, PPTM, PPS, PPSX, PPSM, POT, POX, POTM)
  2. All OpenDocument presentation formats (ODP, FODP, OTP)
  3. PDF
  4. OFD (OpenFixed-layout Document)
  5. XPS (including OpenXPS)
  6. PostScript (includikng Encapsulated PostScript)
  7. ePuB
  8. TeX
  9. PCL
  10. CGM
Close
Loading

Analyzing your prompt, please hold on...

An error occurred while retrieving the results. Please refresh the page and try again.