워터마크에 사용자 지정 글꼴 사용하기

GroupDocs.Watermark는 다양한 형식의 문서에서 워터마크를 관리하기 위한 안정적인 라이브러리로, 다양한 사용자 정의 옵션을 제공합니다. 이 강력한 기능 중 하나는 사용자 정의 글꼴을 사용할 수 있는 능력으로, 개발자가 워터마크에 독특한 타이포그래피를 통합할 수 있게 합니다.

이 기사에서는 시스템에 설치되지 않은 사용자 정의 글꼴을 사용하는 방법에 대해 알아보겠습니다. 또한 특정 글꼴이 컨테이너 환경에 직접 설치된 테스트 시나리오를 위해 Linux Docker 컨테이너를 구성하는 방법을 보여줄 것입니다.

왜 워터마크에 사용자 정의 글꼴을 사용하나요?

사용자 정의 글꼴을 워터마크에 사용하는 것은 여러 가지 장점이 있습니다:

  1. 브랜드 아이덴티티: 귀하의 문서가 귀 조직의 타이포그래피 가이드라인에 부합하는지 확인하십시오.
  2. 시스템 독립성: 시스템에 설치된 글꼴에 대한 의존성을 피하여 다양한 환경에서의 이식성과 호환성을 보장합니다.

GroupDocs.Watermark는 사용자 지정 글꼴을 어떻게 지원합니까?

GroupDocs.Watermark 는 개발자가 글꼴 파일이 포함된 폴더를 지정할 수 있도록 하여 사용자 정의 글꼴 사용을 간소화합니다. 그런 다음 원하는 글꼴을 그 패밀리 이름으로 참조할 수 있어 워터마크 프로세스가 유연하고 작업 흐름에 쉽게 통합될 수 있습니다.

구현에는 세 가지 주요 단계가 포함됩니다:

  1. 글꼴이 포함된 폴더 지정: 글꼴 파일(예: .ttf, .otf)이 들어 있는 디렉터리의 경로를 정의합니다.
  2. 워터마크의 폰트 설정: Font 클래스를 사용하여 폰트를 가족 이름, 폴더 경로 및 크기로 초기화합니다.
  3. 문서에 워터마크 추가: 구성된 워터마크를 대상 문서에 적용하십시오.

C#에서 단계별 구현

여기 GroupDocs.Watermark로 워터마크 솔루션에서 사용자 정의 글꼴을 사용하는 방법입니다:

Key Steps:

  • 문서와 출력 파일의 경로를 지정하십시오.
  • 사용자 정의 글꼴 파일이 있는 폴더 경로를 설정합니다.
  • 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);
        }
    }
}

Testing GroupDocs.Watermark in a Linux Docker Container

Linux Docker 컨테이너에서 GroupDocs.Watermark를 테스트할 때 특정 글꼴이 시스템에 설치되어 있다고 가정해야 하는 시나리오를 만날 수 있습니다. 이는 글꼴 의존 기능을 검증하거나 글꼴 폴더 구성이 불가능한 환경에서 특히 유용합니다.

여기에서 필요한 종속성과 사용자 정의 글꼴을 설치하기 위해 Docker 컨테이너를 구성하는 방법을 설명합니다.

테스트용 Dockerfile

아래는 .NET 프로젝트인 WebApp을 Linux Docker 컨테이너에서 실행하기 위한 샘플 Dockerfile입니다. 이 파일은 또한 커스텀 글꼴(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

이 라이브러리는 리눅스에서 이미지의 적절한 렌더링을 위해 필수적입니다.

기본 글꼴 설치:

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)을 빌드하고 실행하며, 런타임 중에 사용자 정의 글꼴이 사용 가능하도록 합니다.

.csproj에서 Unix 지원 활성화하기

.NET 6의 System.Drawing.Common 라이브러리의 제한으로 인해 Linux에서 Unix 지원을 활성화하려면 .csproj 파일에 특정 설정을 추가해야 합니다. 이러한 제한에 대한 자세한 내용은 Microsoft documentation를 참조하십시오.

<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# 예제는 이 기능을 구현하고 테스트하는 포괄적인 가이드 역할을 합니다. 여러분의 워터마킹 솔루션이 유연하고, 이식 가능하며, 생산 준비가 되었는지 확인하기 위해 사용해 보세요.

무료 체험을 받으세요

You can try GroupDocs.Watermark APIs for free by just downloading and installing the latest version on our release downloads website.

모든 라이브러리의 기능을 제약 없이 테스트할 수 있는 임시 라이센스를 받을 수도 있습니다. 임시 라이센스 페이지로 가서 임시 라이센스를 신청하세요.

See Also

자세한 정보와 추가 자료를 원하신다면, 다음 링크가 유용할 것입니다: