PHP를 사용한 프레젠테이션에서 폰트 대체 구성
개요
Font substitution은 Aspose.Slides가 프레젠테이션을 렌더링하거나 변환할 때 접근할 수 없는 폰트를 사용할 수 있는 폰트로 대체하도록 합니다. 대체는 렌더링된 출력에만 영향을 주며, 프레젠테이션 내용에 지정된 폰트를 변경하지는 않습니다.
특정 폰트를 사용할 수 없을 때 사용할 폰트를 정의할 수 있으며, 렌더링 중 Aspose.Slides가 수행할 대체를 확인할 수 있습니다. 이를 통해 설치된 폰트가 다른 환경에서도 출력 결과를 일관되게 유지할 수 있습니다.
폰트 대체 가져오기
FontsManager::getSubstitutions 메서드를 사용하여 프레젠테이션이 렌더링될 때 어떤 폰트가 대체되는지 확인합니다. 이 메서드는 원본 폰트와 대체 폰트 이름을 식별하는 FontSubstitutionInfo 객체를 반환합니다.
다음 PHP 예제는 프레젠테이션에 대한 모든 폰트 대체를 나열합니다:
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$enumerator = $presentation->getFontsManager()->getSubstitutions()->iterator();
try {
while (java_values($enumerator->hasNext())) {
$substitution = $enumerator->next();
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
}
} finally {
$enumerator->dispose();
}
} finally {
$presentation->dispose();
}
선택된 슬라이드에 대한 폰트 대체 가져오기
int[] slides 인수를 사용한 FontsManager::getSubstitutions 오버로드를 호출하면 특정 슬라이드에 필요한 대체만 확인할 수 있습니다. 이는 프레젠테이션의 일부를 렌더링하거나 내보낼 때, 대형 프레젠테이션을 점진적으로 검사할 때, 사용 불가능한 폰트에 의존하는 슬라이드를 찾을 때, 서버 또는 컨테이너용 최소 폰트 패키지를 준비할 때, 또는 관련 없는 슬라이드를 처리하지 않고 렌더링 차이를 진단할 때 유용합니다.
slides 배열은 1부터 시작하는 슬라이드 인덱스를 포함합니다: 1은 첫 번째 슬라이드를 나타냅니다. 반면에 Presentation::getSlides 컬렉션 접근자는 0부터 시작하는 인덱스를 사용하므로 동일한 슬라이드는 $presentation->getSlides()->get_Item(0)와 같이 접근합니다. 배열을 구성할 때 이 차이를 기억하여 오프바이원 오류를 방지하십시오.
Presentation::getFontsManager 메서드를 통해 오버로드를 호출합니다. 선택된 슬라이드를 렌더링하는 동안 결정된 대체만 반환합니다. 각 결과는 원본 및 대체 폰트 이름을 포함하는 FontSubstitutionInfo 객체입니다. 결과는 현재 폰트 환경, 구성된 폰트 대체 규칙, FontSubstRuleCollection에 저장된 대체 규칙 및 외부 로드된 폰트를 반영합니다.
같은 대체가 둘 이상의 선택된 슬라이드에서 필요할 수 있습니다. 폰트 인벤토리 또는 사전 검사 보고서를 만들 때 결과를 중복 제거하십시오. 다음 예제는 반환된 모든 대체를 보고한 다음 고유 폰트 매핑의 정렬된 목록을 생성합니다:
use aspose\slides\Presentation;
$presentation = new Presentation("Presentation.pptx");
try {
$selectedSlides = [1, 3, 5];
$substitutions = [];
$enumerator = $presentation->getFontsManager()->getSubstitutions($selectedSlides)->iterator();
try {
while (java_values($enumerator->hasNext())) {
$substitutions[] = $enumerator->next();
}
} finally {
$enumerator->dispose();
}
echo "Substitutions for the selected slides:" . PHP_EOL;
foreach ($substitutions as $substitution) {
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
echo $originalFontName . " -> " . $substitutedFontName . PHP_EOL;
}
$sortedPreflightEntries = [];
foreach ($substitutions as $substitution) {
$originalFontName = java_values($substitution->getOriginalFontName());
$substitutedFontName = java_values($substitution->getSubstitutedFontName());
$entry = $originalFontName . " -> " . $substitutedFontName;
$sortedPreflightEntries[strtolower($entry)] = $entry;
}
ksort($sortedPreflightEntries, SORT_NATURAL | SORT_FLAG_CASE);
echo "Deduplicated font preflight report:" . PHP_EOL;
foreach ($sortedPreflightEntries as $entry) {
echo $entry . PHP_EOL;
}
} finally {
$presentation->dispose();
}
FontsManager 클래스는 두 오버로드를 모두 제공합니다. 렌더링 작업의 범위에 따라 적절한 것을 선택하십시오:
| 오버로드 | 사용 상황 |
|---|---|
| getSubstitutions (인수 없음) | 전체 프레젠테이션에 대한 대체가 필요할 때 |
getSubstitutions (int[] slides) |
선택된 범위, 점진적 검사 또는 부분 내보내기가 필요할 때 |
폰트 대체 규칙 설정
원본 폰트를 사용할 수 없을 때 Aspose.Slides가 사용할 폰트를 지정하려면:
- 프레젠테이션을 로드합니다.
- 원본 폰트와 대체 폰트에 대한 정의를 생성합니다.
- WhenInaccessible 조건을 사용하여 FontSubstRule을 만듭니다.
- 해당 규칙을 FontSubstRuleCollection에 추가합니다.
- FontsManager::setFontSubstRuleList 메서드를 사용해 컬렉션을 할당합니다.
- 프레젠테이션을 렌더링하거나 변환합니다.
다음 PHP 예제는 SomeRareFont가 없을 때 Arial을 대체 폰트로 사용하고, 첫 번째 슬라이드를 렌더링하여 결과를 확인합니다. 대체 폰트는 Aspose.Slides에서 사용할 수 있어야 합니다.
use aspose\slides\FontData;
use aspose\slides\FontSubstCondition;
use aspose\slides\FontSubstRule;
use aspose\slides\FontSubstRuleCollection;
use aspose\slides\ImageFormat;
use aspose\slides\Presentation;
$presentation = new Presentation("Fonts.pptx");
try {
$sourceFont = new FontData("SomeRareFont");
$substituteFont = new FontData("Arial");
$substitutionRule = new FontSubstRule($sourceFont, $substituteFont, FontSubstCondition::WhenInaccessible);
$substitutionRules = new FontSubstRuleCollection();
$substitutionRules->add($substitutionRule);
$presentation->getFontsManager()->setFontSubstRuleList($substitutionRules);
$image = $presentation->getSlides()->get_Item(0)->getImage(1.0, 1.0);
try {
$image->save("slide.jpg", ImageFormat::Jpeg);
} finally {
$image->dispose();
}
} finally {
$presentation->dispose();
}
Note
프레젠테이션 전체에 사용되는 폰트를 무조건 변경하려면 Font Replacement를 참조하십시오.수식 폰트에 대한 제한 사항
폰트 대체 규칙은 렌더링 및 변환 중에 사용되는 표준 폰트 선택 프로세스의 일부입니다. 접근할 수 없는 폰트를 규칙에 지정된 사용 가능한 폰트로 교체할 수 있는 일반 텍스트에 대해 작동합니다.
Office Math 수식에는 추가 요구 사항이 있습니다. 수식이 Cambria Math를 사용하면 Aspose.Slides는 수식 레이아웃을 계산하고 렌더링하기 위해 정확히 해당 폰트가 필요할 수 있습니다. STIX Two Math와 같은 다른 수학 폰트로 대체하는 규칙은 Cambria Math를 대신할 수 없으며, 렌더링 시 여전히 Cambria Math가 필요하다고 보고될 수 있습니다.
이러한 프레젠테이션을 렌더링하거나 변환하려면 Cambria Math를 Aspose.Slides에서 사용할 수 있게 해야 합니다. 운영 체제에 설치하거나 외부 폰트로 로드하십시오.
이 제한은 수식 레이아웃에만 적용됩니다. 위에서 설명한 대체 규칙은 일반 프레젠테이션 텍스트에는 계속 적용됩니다.
FAQ
폰트 교체와 폰트 대체의 차이점은 무엇인가요?
Font replacement는 프레젠테이션 전체에서 하나의 폰트를 다른 폰트로 의도적으로 바꾸는 것입니다. 폰트 대체는 원본 폰트를 사용할 수 없을 때와 같이 설정된 조건이 충족될 때 렌더링된 출력에 사용할 폰트를 선택합니다.
대체 규칙은 언제 적용되나요?
규칙은 렌더링 및 변환 중 font selection sequence에 참여합니다. WhenInaccessible 조건을 사용하면 Aspose.Slides가 원본 폰트에 접근할 수 없을 때만 규칙이 적용됩니다.
폰트가 없고 대체 규칙이 설정되지 않으면 어떻게 되나요?
Aspose.Slides는 폰트 선택 프로세스에 따라 가장 가까운 사용 가능한 폰트를 선택합니다. 결과는 런타임 환경에 설치된 폰트에 따라 달라집니다.
외부 폰트를 로드해서 대체를 피할 수 있나요?
예. 외부 폰트 로드를 통해 렌더링 및 변환 시 Aspose.Slides가 해당 폰트를 사용할 수 있게 할 수 있습니다.
Aspose가 라이브러리와 함께 폰트를 배포하나요?
아니요. 폰트 제공 및 라이선스 준수는 사용자의 책임입니다.
Windows, Linux, macOS 간에 대체 결과가 달라질 수 있나요?
예. 운영 체제마다 설치된 폰트와 폰트 검색 위치가 다르기 때문에 한 머신에서는 사용 가능한 폰트가 다른 머신에서는 대체가 필요할 수 있습니다.
배치 변환에서 폰트 선택을 일관되게 하려면 어떻게 해야 하나요?
모든 머신이나 컨테이너에 동일한 폰트 파일과 버전을 사용하고, 필요한 외부 폰트를 로드하며, 라이선스가 허용되는 경우 폰트 임베드를 사용하십시오. 또한 내보내기 전에 FontsManager::getSubstitutions을 호출하여 예상치 못한 대체를 확인할 수 있습니다.