Використання спеціальних шрифтів для водяних знаків

GroupDocs.Watermark є потужною бібліотекою для управління водяними знаками в документах різних форматів, що пропонує широкий спектр опцій налаштування. Серед її потужних можливостей є можливість використовувати власні шрифти, що дозволяє розробникам інтегрувати унікальну типографіку у свої водяні знаки.

У цій статті ми розглянемо, як використовувати користувацькі шрифти, які не встановлені в системі. Додатково ми продемонструємо, як налаштувати контейнер Docker на Linux для сценаріїв тестування, де конкретні шрифти встановлені безпосередньо в середовищі контейнера.

Чому використовувати власні шрифти для водяних знаків?

Використання кастомних шрифтів для водяних знаків має кілька переваг:

  1. Ідентичність бренду: Переконайтеся, що ваші документи відповідають типографічним правилам вашої організації.
  2. Системна незалежність: Уникайте залежності від шрифтів, встановлених у системі, забезпечуючи портативність і сумісність в різних середовищах.

Як GroupDocs.Watermark дозволяє використовувати власні шрифти?

GroupDocs.Watermark спрощує використання користувацьких шрифтів, дозволяючи розробникам вказувати папку, що містить файли шрифтів. Ви можете потім посилатися на потрібний шрифт за його назвою, що робить процес водяного знака гнучким і легким для інтеграції у ваш робочий процес.

Впровадження включає три основні етапи:

  1. Вкажіть папку, що містить шрифти: Визначте шлях до каталогу, який містить ваші шрифти (наприклад, .ttf, .otf).
  2. Встановіть шрифт для водяного знака: Використовуйте клас Font, щоб ініціалізувати шрифт з його ім’ям сім’ї, шляхом до папки та розміром.
  3. Додайте водяний знак до документа: Застосуйте налаштований водяний знак до вашого цільового документа.

Покрокова реалізація в C#

Ось як ви можете використовувати власні шрифти у вашому рішенні для водяних знаків за допомогою GroupDocs.Watermark:

Ключові кроки:

  • Вкажіть шлях до документа та вихідного файлу.
  • Встановіть шлях до папки, де розташовані файли нестандартних шрифтів.
  • Ініціалізуйте об’єкт Font з назвою сімейства та властивостями.
  • Створіть текстовий водяний знак та налаштуйте його властивості.
  • Додайте водяний знак до документа та збережіть його.
using GroupDocs.Watermark;
using GroupDocs.Watermark.Options; 
using GroupDocs.Watermark.Watermarks; 

class Program
{
    static void Main()
    {
        string documentPath = "path-to-your-document.docx"; 
        string outputFileName = "path-to-output/document-with-watermark.docx"; 

        // Initialize the Watermarker
        using (Watermarker watermarker = new Watermarker(documentPath))
        {
            // Specify the folder containing custom font files
            string fontsFolder = "path-to-folder_with_fonts";

            // Initialize the font to be used for the watermark
            Font font = new Font("font_family_name", fontsFolder, 36, FontStyle.Bold); // Font family name, size and style

            // Create the watermark object
            TextWatermark watermark = new TextWatermark("Test watermark", font);

            // Set additional watermark properties
            watermark.ForegroundColor = Color.Blue; // Set the foreground color of the watermark
            watermark.Opacity = 0.4; // Set the opacity of the watermark
            watermark.HorizontalAlignment = HorizontalAlignment.Center; // Center horizontally
            watermark.VerticalAlignment = VerticalAlignment.Center; // Center vertically

            // Add the watermark to the document
            watermarker.Add(watermark);

            // Save the watermarked document
            watermarker.Save(outputFileName);
        }
    }
}

Тестування GroupDocs.Watermark в контейнері Docker на Linux

When testing GroupDocs.Watermark in a Linux Docker container, you may encounter scenarios where you want to assume that specific fonts are installed in the system. This is particularly useful for verifying font-dependent functionality or for environments where font folder configuration is not feasible.

Ось як налаштувати контейнер Docker для встановлення необхідних залежностей та кастомних шрифтів.

Dockerfile для тестування

Нижче наведено зразок Dockerfile для запуску .NET проекту з назвою WebApp у контейнері Docker на базі Linux. Файл також демонструє, як встановити власний шрифт (MyFont.ttf) і залежності, необхідні для GroupDocs.Watermark:

# Use ASP.NET runtime as base image
FROM mcr.microsoft.com/dotnet/aspnet:6.0 AS base
WORKDIR /app
EXPOSE 80

# Add libgdiplus and libc6-dev for graphics support
RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

# Add `contrib` archive area to package sources list
RUN sed -i'.bak' 's/$/ contrib/' /etc/apt/sources.list

# Add default fonts
RUN apt-get update && apt-get install -y ttf-mscorefonts-installer fontconfig
RUN fc-cache -f -v # Refresh font cache

# Copy custom font to the font directory
COPY ["WebApp/MyFont.ttf", "/usr/share/fonts/truetype/"]
RUN fc-cache -f -v # Refresh font cache again

# Building the .NET application
FROM mcr.microsoft.com/dotnet/sdk:6.0 AS build
WORKDIR /src
COPY ["WebApp/WebApp.csproj", "WebApp/"]
RUN dotnet restore "WebApp/WebApp.csproj"
COPY . .
WORKDIR "/src/WebApp"
RUN dotnet build "WebApp.csproj" -c Release -o /app/build

# Publish the application
FROM build AS publish
RUN dotnet publish "WebApp.csproj" -c Release -o /app/publish /p:UseAppHost=false

# Final stage with ASP.NET runtime
FROM base AS final
WORKDIR /app
COPY --from=publish /app/publish .

# Set the entry point for the container
ENTRYPOINT ["dotnet", "WebApp.dll"]

Ключові моменти в Dockerfile

Встановлення необхідних бібліотек:

RUN apt-get update && apt-get install -y apt-utils libgdiplus libc6-dev

Ці бібліотеки є необхідними для правильного відображення зображень у Linux.

Встановлення стандартних шрифтів:

RUN apt-get update && apt-get install -y ttf-mscorefonts-installer fontconfig

RUN fc-cache -f -v

Цей крок встановлює шрифти за замовчуванням, які потрібні, якщо ви використовуєте GroupDocs.Watermark без активації ліцензії.

Додавання користувацького шрифта:

COPY ["WebApp/MyFont.ttf", "/usr/share/fonts/truetype/"]

RUN fc-cache -f -v

Ця команда копіює користувацький шрифт (MyFont.ttf) до відповідного каталогу шрифтів у контейнері і оновлює кеш шрифтів.

Створення та запуск програми:

Залишкові команди налаштовують контейнер Docker для збірки та запуску вашого .NET застосунку (WebApp), забезпечуючи доступність користувацького шрифта під час виконання.

Увімкнення підтримки Unix у .csproj

Через обмеження у бібліотеці System.Drawing.Common в .NET 6 для Linux, вам потрібно увімкнути підтримку Unix, додавши конкретну настройку до вашого .csproj файлу. Для отримання додаткової інформації про ці обмеження, зверніться до документації Microsoft.

<ItemGroup>
    <RuntimeHostConfigurationOption Include="System.Drawing.EnableUnixSupport" Value="true" />
</ItemGroup>

Ця настройка забезпечує правильну роботу функцій System.Drawing у середовищі Linux, що є важливим для коректного відображення при використанні GroupDocs.Watermark.

Найкращі практики використання користувацьких шрифтів

Щоб максимально використовувати цю функцію, дотримуйтеся цих найкращих практик:

  1. Organize Fonts: Keep your custom fonts organized in a dedicated folder for easy reference.
  2. Перевірте назви шрифтів: Переконайтесь, що ви правильно вказуєте назву сім’ї шрифтів, щоб уникнути проблем з відображенням.
  3. Тестування в контейнеризованому середовищі: Використовуйте контейнери Docker для тестування вашого застосунку в контрольованому, базованому на Linux середовищі.

Висновок

Можливість використовувати власні шрифти в GroupDocs.Watermark підвищує ваш контроль над дизайном водяного знака, дозволяючи вам відповідати конкретним вимогам брендингу та стилю. Вказавши папку зі шрифтами або встановивши шрифти в контейнері Linux, ви можете безперешкодно тестувати та розгортати свій додаток в будь-якому середовищі.

Наданий Dockerfile та приклади C# слугують всебічним посібником для реалізації та тестування цієї функціональності. Спробуйте їх, щоб переконатися, що ваше рішення для водяних знаків є гнучким, портативним та готовим до виробництва.

Отримати безкоштовну пробну версію

Ви можете спробувати GroupDocs.Watermark APIs безкоштовно, просто завантаживши та встановивши останню версію на нашому release downloads website.

Ви також можете отримати тимчасову ліцензію, щоб протестувати всі функції бібліотеки без будь-яких обмежень. Перейдіть на temporary license page, щоб подати заявку на тимчасову ліцензію.

Дивіться також

Для отримання додаткової інформації та ресурсів ви можете знайти наступні посилання корисними: