Utiliser des polices personnalisées pour les filigranes

GroupDocs.Watermark est une bibliothèque robuste pour la gestion des filigranes dans des documents de divers formats, offrant un large éventail d’options de personnalisation. Parmi ses fonctionnalités puissantes se trouve la capacité d’utiliser des polices personnalisées, permettant aux développeurs d’incorporer une typographie unique dans leurs filigranes.

Dans cet article, nous allons explorer comment utiliser des polices personnalisées qui ne sont pas installées sur le système. De plus, nous allons démontrer comment configurer un conteneur Docker Linux pour des scénarios de test où des polices spécifiques sont installées directement dans l’environnement du conteneur.

Pourquoi utiliser des polices personnalisées pour les filigranes ?

Utiliser des polices personnalisées pour les filigranes présente plusieurs avantages :

  1. Identité de marque : Assurez-vous que vos documents sont conformes aux directives typographiques de votre organisation.
  2. Indépendance du système : Évitez de dépendre des polices installées sur le système, assurant ainsi la portabilité et la compatibilité à travers différents environnements.

Comment GroupDocs.Watermark permet-il d’activer des polices personnalisées ?

GroupDocs.Watermark simplifie l’utilisation de polices personnalisées en permettant aux développeurs de spécifier un dossier contenant des fichiers de police. Vous pouvez ensuite faire référence à la police souhaitée par son nom de famille, ce qui rend le processus de filigrane flexible et facile à intégrer dans votre flux de travail.

L’implémentation implique trois étapes principales :

  1. Spécifiez le dossier contenant les polices : Définissez le chemin vers un répertoire contenant vos fichiers de police (par exemple, .ttf, .otf).
  2. Définir la police pour le filigrane : Utilisez la classe Font pour initialiser la police avec son nom de famille, le chemin du dossier et la taille.
  3. Ajoutez le filigrane au document : Appliquez le filigrane configuré à votre document cible.

Étapes de mise en œuvre en C#

Voici comment vous pouvez utiliser des polices personnalisées dans votre solution de filigrane avec GroupDocs.Watermark :

Étapes Clés :

  • Spécifiez le chemin vers le document et le fichier de sortie.
  • Définissez le chemin du dossier où se trouvent les fichiers de police personnalisés.
  • Initialisez l’objet Font avec le nom de la famille et les propriétés.
  • Créez un filigrane textuel et configurez ses propriétés.
  • Ajoutez le filigrane au document et enregistrez-le.
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);
        }
    }
}

Testing GroupDocs.Watermark in a Linux Docker Container

Lorsque vous testez GroupDocs.Watermark dans un conteneur Docker Linux, vous pouvez rencontrer des scénarios où vous souhaitez supposer que des polices spécifiques sont installées dans le système. Cela est particulièrement utile pour vérifier les fonctionnalités dépendantes des polices ou pour des environnements où la configuration du dossier de polices n’est pas réalisable.

Voici comment configurer un conteneur Docker pour installer les dépendances requises et les polices personnalisées.

Dockerfile pour les tests

Below is a sample Dockerfile for running a .NET project named WebApp in a Linux Docker container. The file also demonstrates how to install a custom font (MyFont.ttf) and the dependencies required for 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"]

Points clés dans le Dockerfile

Installation des bibliothèques requises :

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

Ces bibliothèques sont essentielles pour le rendu correct des images sous Linux.

Installation des polices par défaut :

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

RUN fc-cache -f -v

Cette étape installe les polices par défaut, qui sont requises si vous utilisez GroupDocs.Watermark sans définir de licence.

Ajouter une police personnalisée :

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

RUN fc-cache -f -v

Cette commande copie la police personnalisée (MyFont.ttf) dans le répertoire de polices approprié dans le conteneur et met à jour le cache des polices.

Construire et exécuter l’application :

Les commandes restantes configurent le conteneur Docker pour construire et exécuter votre application .NET (WebApp), en veillant à ce que la police personnalisée soit disponible pendant l’exécution.

Activer le support Unix dans .csproj

En raison des limitations de la bibliothèque System.Drawing.Common dans .NET 6 pour Linux, vous devez activer la prise en charge Unix en ajoutant un paramètre spécifique à votre fichier .csproj. Pour plus de détails sur ces limitations, consultez la documentation Microsoft.

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

Ce paramètre garantit que les fonctionnalités System.Drawing fonctionnent correctement dans un environnement Linux, ce qui est essentiel pour un rendu approprié lors de l’utilisation de GroupDocs.Watermark.

Meilleures pratiques pour l’utilisation de polices personnalisées

Pour tirer le meilleur parti de cette fonctionnalité, suivez ces meilleures pratiques :

  1. Organiser les polices : Gardez vos polices personnalisées organisées dans un dossier dédié pour un accès facile.
  2. Validez les noms de police : Assurez-vous de spécifier correctement le nom de la famille de police pour éviter les problèmes de rendu.
  3. Test dans un environnement conteneurisé : utilisez des conteneurs Docker pour tester votre application dans un environnement contrôlé basé sur Linux.

Conclusion

La capacité d’utiliser des polices personnalisées dans GroupDocs.Watermark améliore votre contrôle sur la conception des filigranes, vous permettant de répondre à des exigences spécifiques en matière de marque et de style. En spécifiant un dossier de polices ou en installant des polices dans un conteneur Linux, vous pouvez tester et déployer votre application de manière transparente dans n’importe quel environnement.

Le Dockerfile fourni et les exemples en C# servent de guide complet pour mettre en œuvre et tester cette fonctionnalité. Essayez-les pour vous assurer que votre solution de filigrane est flexible, portable et prête pour la production.

Obtenez un essai gratuit

Vous pouvez essayer les API GroupDocs.Watermark gratuitement en téléchargeant et en installant simplement la dernière version sur notre release downloads website.

Vous pouvez également obtenir une licence temporaire pour tester toutes les fonctionnalités de la bibliothèque sans aucune contrainte. Rendez-vous sur la page de licence temporaire pour demander une licence temporaire.

Voir aussi

Pour plus d’informations et des ressources supplémentaires, vous trouverez peut-être les liens suivants utiles :