Menggunakan font kustom untuk watermark

GroupDocs.Watermark adalah perpustakaan yang kuat untuk mengelola watermark dalam dokumen dengan berbagai format, menawarkan berbagai pilihan kustomisasi. Di antara fitur-fitur bertenaga adalah kemampuan untuk menggunakan font kustom, memungkinkan pengembang untuk mengintegrasikan tipografi unik ke dalam watermark mereka.

Dalam artikel ini, kami akan menjelajahi cara menggunakan font kustom yang tidak terinstal di sistem. Selain itu, kami akan mendemonstrasikan cara mengonfigurasi kontainer Docker Linux untuk skenario pengujian di mana font tertentu diinstal langsung di lingkungan kontainer.

Mengapa Menggunakan Font Kustom untuk Watermark?

Menggunakan font kustom untuk watermark menawarkan beberapa keuntungan:

  1. Identitas Merek: Pastikan dokumen Anda sesuai dengan pedoman tipografi organisasi Anda.
  2. Independensi Sistem: Hindari ketergantungan pada font yang terinstal di sistem, memastikan portabilitas dan kompatibilitas di berbagai lingkungan.

Bagaimana GroupDocs.Watermark Mengaktifkan Font Kustom?

GroupDocs.Watermark menyederhanakan penggunaan font kustom dengan memungkinkan pengembang untuk menentukan folder yang berisi file font. Anda kemudian dapat merujuk ke font yang diinginkan dengan nama keluarganya, yang membuat proses watermarking fleksibel dan mudah diintegrasikan ke dalam alur kerja Anda.

Implementasi melibatkan tiga langkah utama:

  1. Tentukan Folder yang Berisi Font: Definisikan jalur ke direktori yang menyimpan file font Anda (misalnya, .ttf, .otf).
  2. Atur Font untuk Tanda Air: Gunakan kelas Font untuk menginisialisasi font dengan nama keluarga, jalur folder, dan ukuran.
  3. Tambahkan Tanda Air ke Dokumen: Terapkan tanda air yang telah dikonfigurasi ke dokumen target Anda.

Langkah-demi-Langkah Implementasi dalam C#

Berikut adalah cara Anda dapat menggunakan font khusus dalam solusi watermarking Anda dengan GroupDocs.Watermark:

Key Steps:

  • Tentukan jalur ke dokumen dan file keluaran.
  • Setel jalur folder tempat file font kustom berada.
  • Inisialisasi objek Font dengan nama keluarga dan properti.
  • Buat watermark teks dan atur propertinya.
  • Tambahkan watermark ke dokumen dan simpan.
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);
        }
    }
}

Menguji GroupDocs.Watermark di Kontainer 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.

Ini cara mengonfigurasi kontainer Docker untuk menginstal dependensi yang diperlukan dan font kustom.

Dockerfile untuk Pengujian

Berikut adalah contoh Dockerfile untuk menjalankan proyek .NET bernama WebApp di dalam kontainer Docker Linux. File ini juga menunjukkan cara untuk menginstal font kustom (MyFont.ttf) dan ketergantungan yang diperlukan untuk 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"]

Poin Utama dalam Dockerfile

Menginstal Perpustakaan yang Diperlukan:

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

Perpustakaan ini sangat penting untuk pemrosesan gambar yang tepat di Linux.

Menginstal Font Default:

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

RUN fc-cache -f -v

Langkah ini menginstal font default, yang diperlukan jika Anda menggunakan GroupDocs.Watermark tanpa menetapkan lisensi.

Menambahkan Font Kustom:

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

RUN fc-cache -f -v

Perintah ini menyalin font kustom (MyFont.ttf) ke direktori font yang sesuai di dalam kontainer dan memperbarui cache font.

Membangun dan Menjalankan Aplikasi:

Perintah yang tersisa mengonfigurasi kontainer Docker untuk membangun dan menjalankan aplikasi .NET Anda (WebApp), memastikan bahwa font kustom tersedia selama waktu berjalan.

Mengaktifkan Dukungan Unix di .csproj

Karena keterbatasan dalam pustaka System.Drawing.Common di .NET 6 untuk Linux, Anda perlu mengaktifkan dukungan Unix dengan menambahkan pengaturan tertentu ke file .csproj Anda. Untuk informasi lebih lanjut tentang keterbatasan ini, silakan merujuk ke Microsoft documentation.

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

Pengaturan ini memastikan bahwa fungsionalitas System.Drawing bekerja dengan benar di lingkungan Linux, yang sangat penting untuk rendering yang tepat saat menggunakan GroupDocs.Watermark.

Best Practices for Using Custom Fonts

Untuk memaksimalkan fitur ini, ikuti praktik terbaik ini:

  1. Organisasi Font: Simpan font kustom Anda di folder khusus untuk referensi yang mudah.
  2. Validasi Nama Font: Pastikan Anda dengan benar menentukan nama keluarga font untuk menghindari masalah rendering.
  3. Test in a Containerized Environment: Gunakan kontainer Docker untuk menguji aplikasi Anda di lingkungan berbasis Linux yang terkontrol.

Kesimpulan

Kemampuan untuk menggunakan font kustom di GroupDocs.Watermark meningkatkan kontrol Anda atas desain watermark, memungkinkan Anda untuk memenuhi kebutuhan branding dan gaya tertentu. Dengan menentukan folder font atau menginstal font di kontainer Linux, Anda dapat dengan mudah menguji dan menerapkan aplikasi Anda di lingkungan mana pun.

Dockerfile dan contoh C# yang disediakan berfungsi sebagai panduan komprehensif untuk mengimplementasikan dan menguji fungsionalitas ini. Cobalah untuk memastikan solusi watermarking Anda fleksibel, portabel, dan siap untuk produksi.

Dapatkan Uji Coba Gratis

Anda dapat mencoba API GroupDocs.Watermark secara gratis dengan hanya mengunduh dan menginstal versi terbaru di release downloads website.

Anda juga dapat mendapatkan lisensi sementara untuk menguji semua fungsi perpustakaan tanpa kendala. Kunjungi halaman temporary license page untuk mendaftar lisensi sementara.

Lihat Juga

Untuk informasi lebih lanjut dan sumber tambahan, Anda mungkin menemukan tautan berikut berguna: