애플리케이션과 함께 글꼴 패키징

  • 아티클

이 항목에서는 WPF(Windows Presentation Foundation) 애플리케이션과 함께 글꼴을 패키징하는 방법에 대한 개요를 제공합니다.

참고

대부분의 소프트웨어와 마찬가지로 글꼴 파일도 판매되는 것이 아니라 사용이 허가됩니다. 글꼴 사용을 관리하는 라이선스는 공급업체마다 다르지만 일반적으로 Microsoft가 애플리케이션 및 Windows와 함께 제공하는 글꼴을 관리하는 라이선스를 비롯하여 대부분의 라이선스에서는 애플리케이션 내에 글꼴을 포함하거나 기타 다른 방법으로 재배포하는 것을 허용하지 않습니다. 따라서 개발자는 애플리케이션 내에 포함하거나 기타 다른 방법으로 재배포하려는 글꼴에 대해 필요한 라이선스 권한이 있는지 확인해야 합니다.

글꼴 패키징 소개

간편하게 글꼴을 WPF 애플리케이션 내에 리소스로 패키지하여 사용자 인터페이스 텍스트 및 다른 형식의 텍스트 기반 콘텐츠를 표시할 수 있습니다. 글꼴은 애플리케이션의 어셈블리 파일 내에 포함하거나 별도로 저장할 수 있습니다. 리소스 전용 글꼴 라이브러리를 만들어 애플리케이션에서 이를 참조하도록 할 수도 있습니다.

OpenType 및 TrueType® 글꼴에는 글꼴에 대한 글꼴 포함 라이선스 권한을 나타내는 fsType이라는 형식 플래그가 포함되어 있습니다. 그러나 이 형식 플래그는 문서에 저장된 포함된 글꼴만 참조하고 애플리케이션에 포함된 글꼴은 참조하지 않습니다. GlyphTypeface 개체를 만들어 해당 EmbeddingRights 속성을 참조하면 글꼴에 대한 글꼴 포함 권한을 검색할 수 있습니다. fsType 플래그에 대한 자세한 내용은 OpenType 사양의 "OS/2 및 Windows 메트릭" 섹션을 참조하세요.

Microsoft 입력 체계 웹 사이트에서는 특정 글꼴 공급업체 또는 사용자 지정 작업에 필요한 글꼴 공급업체를 찾는 데 유용한 연락처 정보를 제공합니다.

콘텐츠 항목으로 글꼴 추가

애플리케이션의 어셈블리 파일과는 별도의 프로젝트 콘텐츠 항목으로 애플리케이션에 글꼴을 추가할 수 있습니다. 이 경우 콘텐츠 항목이 어셈블리에 리소스로 포함되지 않습니다. 다음 프로젝트 파일 예제에서는 콘텐츠 항목을 정의하는 방법을 보여 줍니다.

<Project DefaultTargets="Build"  
                xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
  <!-- Other project build settings ... -->  
  
  <ItemGroup>  
    <Content Include="Peric.ttf" />  
    <Content Include="Pericl.ttf" />  
  </ItemGroup>  
</Project>

애플리케이션에서 런타임에 글꼴을 사용할 수 있도록 하려면 애플리케이션의 배포 디렉터리에서 해당 글꼴에 액세스할 수 있어야 합니다. 애플리케이션 프로젝트 파일의 <CopyToOutputDirectory> 요소를 사용하면 빌드 프로세스 동안 글꼴을 애플리케이션 배포 디렉터리에 자동으로 복사할 수 있습니다. 다음 프로젝트 파일 예제에서는 글꼴을 배포 디렉터리에 복사하는 방법을 보여 줍니다.

<ItemGroup>  
  <Content Include="Peric.ttf">  
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>  
  </Content>  
  <Content Include="Pericl.ttf">  
    <CopyToOutputDirectory>PreserveNewest</CopyToOutputDirectory>  
  </Content>  
</ItemGroup>

다음 코드 예제에서는 애플리케이션의 글꼴을 콘텐츠 항목으로 참조하는 방법을 보여 줍니다. 참조되는 콘텐츠 항목은 애플리케이션의 어셈블리 파일과 동일한 디렉터리에 있어야 합니다.

<TextBlock FontFamily="./#Pericles Light">
  Aegean Sea
</TextBlock>

리소스 항목으로 글꼴 추가

애플리케이션의 어셈블리 파일에 포함된 프로젝트 리소스 항목으로 애플리케이션에 글꼴을 추가할 수 있습니다. 리소스에 별도의 하위 디렉터리를 사용하면 애플리케이션의 프로젝트 파일을 보다 간편하게 구성할 수 있습니다. 다음 프로젝트 파일 예제에서는 별도의 하위 디렉터리에 리소스 항목으로 글꼴을 정의하는 방법을 보여 줍니다.

<Project DefaultTargets="Build"  
                xmlns="http://schemas.microsoft.com/developer/msbuild/2003">  
  <!-- Other project build settings ... -->  
  
  <ItemGroup>  
    <Resource Include="resources\Peric.ttf" />  
    <Resource Include="resources\Pericl.ttf" />  
  </ItemGroup>  
</Project>

참고

글꼴을 리소스로 애플리케이션에 추가할 때는 애플리케이션의 프로젝트 파일에서 <EmbeddedResource> 요소가 아니라 <Resource> 요소를 설정해야 합니다. 빌드 작업에는 <EmbeddedResource> 요소가 지원되지 않습니다.

다음 태그 예제에서는 애플리케이션의 글꼴 리소스를 참조하는 방법을 보여 줍니다.

<TextBlock FontFamily="./resources/#Pericles Light">
  Aegean Sea
</TextBlock>

코드에서 글꼴 리소스 항목 참조

코드에서 글꼴 리소스 항목을 참조하려면 기본 URI(Uniform Resource Identifier)와 글꼴 위치 참조의 두 부분으로 구성된 글꼴 리소스 참조를 제공해야 합니다. 이러한 값은 FontFamily 메서드의 매개 변수로 사용됩니다. 다음 코드 예제에서는 resources라는 프로젝트 하위 디렉터리에 있는 애플리케이션 글꼴 리소스를 참조하는 방법을 보여 줍니다.

// The font resource reference includes the base URI reference (application directory level),
// and a relative URI reference.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "./resources/#Pericles Light");

' The font resource reference includes the base URI reference (application directory level),
' and a relative URI reference.
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "./resources/#Pericles Light")

기본 URI(Uniform Resource Identifier)에는 글꼴 리소스가 있는 애플리케이션 하위 디렉터리가 포함될 수 있습니다. 이 경우 글꼴 위치 참조에서 디렉터리를 지정할 필요가 없지만 글꼴 리소스가 기본 URI(Uniform Resource Identifier)에 지정된 것과 동일한 디렉터리에 있음을 나타내는 "./"를 앞에 포함해야 합니다. 다음 코드 예제에서는 위의 코드 예제에 나오는 것과 동일한 글꼴 리소스 항목을 참조하는 다른 방법을 보여 줍니다.

// The base URI reference can include an application subdirectory.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/resources/"), "./#Pericles Light");

' The base URI reference can include an application subdirectory.
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/resources/"), "./#Pericles Light")

동일한 애플리케이션 하위 디렉터리에서 글꼴 참조

애플리케이션 콘텐츠와 리소스 파일을 모두 애플리케이션 프로젝트의 동일한 사용자 정의 하위 디렉터리에 배치할 수 있습니다. 다음 프로젝트 파일 예제에서는 동일한 하위 디렉터리에 정의된 콘텐츠 페이지와 글꼴 리소스를 보여 줍니다.

<ItemGroup>  
  <Page Include="pages\HomePage.xaml" />  
</ItemGroup>  
<ItemGroup>  
  <Resource Include="pages\Peric.ttf" />  
  <Resource Include="pages\Pericl.ttf" />  
</ItemGroup>

애플리케이션 콘텐츠와 글꼴이 동일한 하위 디렉터리에 있으므로 글꼴 참조가 애플리케이션 콘텐츠를 기준으로 합니다. 다음 예제에서는 글꼴이 애플리케이션과 동일한 디렉터리에 있는 경우 애플리케이션의 글꼴 리소스를 참조하는 방법을 보여 줍니다.

<TextBlock FontFamily="./#Pericles Light">
  Aegean Sea
</TextBlock>

// The font resource reference includes the base Uri (application directory level),
// and the file resource location, which is relative to the base Uri.
myTextBlock.FontFamily = new FontFamily(new Uri("pack://application:,,,/"), "/pages/#Pericles Light");

' The font resource reference includes the base Uri (application directory level),
' and the file resource location, which is relative to the base Uri.
myTextBlock.FontFamily = New FontFamily(New Uri("pack://application:,,,/"), "/pages/#Pericles Light")

애플리케이션의 글꼴 열거

글꼴을 애플리케이션의 리소스 항목으로 열거하려면 GetFontFamilies 또는 GetTypefaces 메서드를 사용합니다. 다음 예제에서는 GetFontFamilies 메서드를 사용하여 애플리케이션 글꼴 위치에서 FontFamily 개체의 컬렉션을 반환하는 방법을 보여 줍니다. 이 경우에는 애플리케이션에 “resources”라는 하위 디렉터리가 있습니다.

foreach (FontFamily fontFamily in Fonts.GetFontFamilies(new Uri("pack://application:,,,/"), "./resources/"))
{
    // Perform action.
}

For Each fontFamily As FontFamily In Fonts.GetFontFamilies(New Uri("pack://application:,,,/"), "./resources/")
    ' Perform action.
Next fontFamily

다음 예제에서는 GetTypefaces 메서드를 사용하여 애플리케이션 글꼴 위치에서 Typeface 개체의 컬렉션을 반환하는 방법을 보여 줍니다. 이 경우에는 애플리케이션에 “resources”라는 하위 디렉터리가 있습니다.

foreach (Typeface typeface in Fonts.GetTypefaces(new Uri("pack://application:,,,/"), "./resources/"))
{
    // Perform action.
}

For Each typeface As Typeface In Fonts.GetTypefaces(New Uri("pack://application:,,,/"), "./resources/")
    ' Perform action.
Next typeface

글꼴 리소스 라이브러리 만들기

글꼴만 포함된 리소스 전용 라이브러리를 만들 수 있습니다. 이러한 유형의 라이브러리 프로젝트에는 코드가 포함되지 않습니다. 리소스 전용 라이브러리는 일반적으로 리소스와 리소스를 사용하는 애플리케이션 코드를 분리하려는 경우에 만듭니다. 리소스 전용 라이브러리를 만들면 라이브러리 어셈블리를 여러 애플리케이션 프로젝트에 포함할 수 있습니다. 다음 프로젝트 파일 예제에서는 리소스 전용 라이브러리 프로젝트의 주요 부분을 보여 줍니다.

<PropertyGroup>  
  <AssemblyName>FontLibrary</AssemblyName>  
  <OutputType>library</OutputType>  
  ...  
</PropertyGroup>  
...
<ItemGroup>  
  <Resource Include="Kooten.ttf" />  
  <Resource Include="Pesca.ttf" />  
</ItemGroup

리소스 라이브러리의 글꼴 참조

애플리케이션에서 리소스 라이브러리의 글꼴을 참조하려면 라이브러리 어셈블리의 이름을 글꼴 참조의 접두사로 지정해야 합니다. 이 경우 글꼴 리소스 어셈블리는 “FontLibrary”입니다. 어셈블리 이름을 어셈블리 내의 참조와 구분하려면 ‘;’ 문자를 사용합니다. 글꼴 이름에 “Component” 키워드와 참조를 차례로 추가하면 글꼴 라이브러리의 리소스에 대한 전체 참조가 완성됩니다. 다음 코드 예제에서는 리소스 라이브러리 어셈블리의 글꼴을 참조하는 방법을 보여 줍니다.

<Run FontFamily="/FontLibrary;Component/#Kootenay" FontSize="36">
  ABCDEFGHIJKLMNOPQRSTUVWXYZ
</Run>

참고

이 SDK에는 WPF 애플리케이션과 함께 사용할 수 있는 샘플 OpenType 글꼴 세트가 포함되어 있습니다. 글꼴은 리소스 전용 라이브러리에 정의되어 있습니다. 자세한 내용은 샘플 OpenType 글꼴 팩을 참조하세요.

글꼴 사용의 제한 사항

다음 목록에서는 WPF 애플리케이션의 글꼴 사용 및 패키징과 관련된 몇 가지 제한 사항에 대해 설명합니다.

  • 글꼴 포함 권한 비트: WPF 애플리케이션은 글꼴 포함 권한 비트를 확인하거나 적용하지 않습니다. 자세한 내용은 글꼴 패키징 소개 섹션을 참조하세요.

  • 원래 사이트 글꼴: WPF 애플리케이션은 http 또는 ftp URI(Uniform Resource Identifier)에 대한 글꼴 참조를 허용하지 않습니다.

  • pack: 표기를 사용한 절대 URI: WPF 애플리케이션은 글꼴에 대한 절대 URI(Uniform Resource Identifier) 참조의 일부로 "pack:"을 사용하여 프로그래밍 방식으로 FontFamily 개체를 만드는 것을 허용하지 않습니다. 예를 들어, "pack://application:,,,/resources/#Pericles Light"는 잘못된 글꼴 참조입니다.

  • 자동 글꼴 포함: 디자인 타임에는 애플리케이션에서 사용하는 글꼴을 검색하여 애플리케이션의 리소스에 자동으로 해당 글꼴을 포함하는 기능이 지원되지 않습니다.

  • 글꼴 하위 집합: WPF 애플리케이션은 고정되지 않은 문서에 대해서는 글꼴 하위 집합을 만드는 것을 지원하지 않습니다.

  • 올바르지 않은 참조가 있는 경우 애플리케이션에서는 사용 가능한 글꼴로 대체합니다.

참고 항목