FontResourcesSubsettingSizeThreshold

HtmlSaveOptions.FontResourcesSubsettingSizeThreshold property

Управляет тем, какие ресурсы шрифтов необходимо подмножество при сохранении в HTML, MHTML или EPUB. Значение по умолчанию:0 .

public int FontResourcesSubsettingSizeThreshold { get; set; }

Примечания

ExportFontResources позволяет экспортировать шрифты как вспомогательные файлы или как части пакета output . Если в документе используется много шрифтов, особенно с большим количеством глифов, то размер вывода может значительно вырасти . Поднабор шрифтов уменьшает размер экспортируемого ресурса шрифта за счет фильтрации глифов, которые не используются в текущем документе.

Поднабор шрифтов работает следующим образом:

  • По умолчанию все экспортированные шрифты имеют подмножества.
  • ПараметрFontResourcesSubsettingSizeThresholdна положительное значение указывает Aspose.Words подмножество шрифтов, размер файла которых превышает указанное значение.
  • Установка свойства наMaxValue подавляет поднабор шрифта.

Важный! При экспорте ресурсов шрифтов следует учитывать вопросы лицензирования шрифтов. Авторы, которые хотят использовать определенные шрифты с помощью механизма шрифтов downloadable , должны всегда тщательно проверять, что их предполагаемое использование находится в рамках лицензии на шрифт. Многие коммерческие шрифты в настоящее время не позволяют загружать их через Интернет в любой форме. В лицензионных соглашениях, охватывающих некоторые шрифты, особо отмечается, что их использование через**@font-face** Rules в таблицах стилей CSS не допускается. Подмножество шрифтов также может нарушать условия лицензии.

Примеры

Показывает, как работать с поднабором шрифтов.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

builder.Font.Name = "Arial";
builder.Writeln("Hello world!");
builder.Font.Name = "Times New Roman";
builder.Writeln("Hello world!");
builder.Font.Name = "Courier New";
builder.Writeln("Hello world!");

// Когда мы сохраняем документ в HTML, мы можем передать объекту SaveOptions настройку поднабора шрифта.
// Предположим, мы установили для флага «ExportFontResources» значение «true», а также назвали папку в свойстве «FontsFolder».
// В этом случае операция сохранения создаст эту папку и поместит в нее файл .ttf.
// эта папка для каждого шрифта, который использует наш документ.
// Каждый файл .ttf будет содержать весь набор глифов этого шрифта,
// что потенциально может привести к созданию очень большого файла, сопровождающего документ.
// Когда мы применяем поднабор к шрифту, его экспортированные необработанные данные будут содержать только те глифы, которые есть в документе
// используем вместо всего набора глифов. Если текст в нашем документе использует лишь небольшую часть шрифта
// набор глифов, то подмножество значительно уменьшит размер наших выходных документов.
// Мы можем использовать свойство FontResourcesSubsettingSizeThreshold, чтобы определить размер файла .ttf в байтах.
 // Если экспортированный шрифт создает файл большего размера, чем этот, то операция сохранения применит поднабор к этому шрифту.
// Установка порога 0 применяет подмножество ко всем шрифтам,
// и установка значения «int.MaxValue» фактически отключает подмножество.
string fontsFolder = ArtifactsDir + "HtmlSaveOptions.FontSubsetting.Fonts";

HtmlSaveOptions options = new HtmlSaveOptions
{
    ExportFontResources = true,
    FontsFolder = fontsFolder,
    FontResourcesSubsettingSizeThreshold = fontResourcesSubsettingSizeThreshold
};

doc.Save(ArtifactsDir + "HtmlSaveOptions.FontSubsetting.html", options);

string[] fontFileNames = Directory.GetFiles(fontsFolder).Where(s => s.EndsWith(".ttf")).ToArray();

Assert.AreEqual(3, fontFileNames.Length);

foreach (string filename in fontFileNames)
{
    // По умолчанию файлы .ttf для каждого из трех наших шрифтов будут иметь размер более 700 МБ.
    // Подмножество уменьшит их все до менее 30 МБ.
    FileInfo fontFileInfo = new FileInfo(filename);

    Assert.True(fontFileInfo.Length > 700000 || fontFileInfo.Length < 30000);
    Assert.True(Math.Max(fontResourcesSubsettingSizeThreshold, 30000) > new FileInfo(filename).Length);
}

Смотрите также

HtmlSaveOptions.ExportXhtmlTransitional HtmlSaveOptions.FontSavingCallback