LlosLab Software Development BlogEngineering notes for PDF, Delphi, and document software developers.

기술 문서

HotPDF 구성 요소의 RtLTextOut 기능

· PDF 프로그래밍

PDF 생성 시 좌우 문자 방향: HotPDF의 RtLTextOut 함수 소개

좌우 문자 방향 언어 소개

좌우 문자 방향(RTL) 언어는 전 세계 문자 커뮤니케이션 시스템의 상당 부분을 차지하며, 전 세계 4억 명이 넘는 사람들에게 사용됩니다. 이러한 언어에는 아랍어, 히브리어, 페르시아어(파르시어), 우르두어, 파슈토어 및 기타 여러 언어가 포함되며, 각 언어는 고유한 특징과 문화적 중요성을 가지고 있습니다.

역사적, 문화적 배경

좌우 문자 방향 표기 시스템은 수천 년 전으로 거슬러 올라가는 고대 기원을 가지고 있습니다. 예를 들어, 아랍어는 나바테아 문자에서 파생되었으며, 초기 이슬람 시대에 표준화되었습니다. 히브리어는 훨씬 더 오랜 역사를 가지고 있으며, 기원전 10세기로 거슬러 올라가는 고대 히브리어 비문이 있습니다. 이러한 표기 시스템은 라틴 문자 기반 표기 시스템과는 독립적으로 발전했으며, 서면 정보를 구성하는 데 대한 다른 접근 방식을 반영합니다.

좌우 문자 방향 언어의 언어학적 특징

좌우 문자 방향 언어는 디지털 텍스트 처리에 영향을 미치는 여러 가지 독특한 특징을 가지고 있습니다.

  • 문자 방향텍스트는 유럽 언어와 반대로 오른쪽에서 왼쪽으로 흐릅니다.
  • 문맥에 따른 글자 형태많은 오른쪽에서 왼쪽으로 쓰는 문자 체계에서, 글자의 모양이 위치(초성, 중성, 말성, 단독)에 따라 다릅니다.
  • 연결 문자글자가 종종 연결되어 연속적인 단어를 형성하므로, 정교한 렌더링이 필요합니다.
  • 부호모음 부호 및 기타 부호는 기본 글자 위에 또는 아래에 나타납니다.
  • 양방향 텍스트RTL 문서에는 종종 포함된 LTR 요소(숫자, 라틴어 텍스트, URL)가 자주 포함됩니다.

디지털 과제 및 유니코드 표준

RTL 언어의 디지털 표현은 고유한 기술적 과제를 제시합니다.

  1. 문자 인코딩유니코드는 RTL 문자에 대한 표준화된 코드 포인트를 제공합니다.
    • 아랍어: U+0600-U+06FF (아랍어 블록)
    • 히브리어: U+0590-U+05FF (히브리어 블록)
    • 아랍어 보충: U+0750-U+077F
    • 아랍 확장 문자 A: U+08A0-U+08FF
  2. 양방향 알고리즘: Unicode 양방향 알고리즘(UBA)은 혼합된 오른쪽에서 왼쪽/왼쪽에서 오른쪽 텍스트가 어떻게 처리되어야 하는지를 정의합니다.
  3. 글꼴 요구 사항: 오른쪽에서 왼쪽 텍스트는 적절한 글리프 지원 및 모양 기능을 갖춘 글꼴이 필요합니다.
  4. 레이아웃 고려 사항: 사용자 인터페이스 및 문서는 오른쪽에서 왼쪽 읽기 방식을 수용해야 합니다.

글로벌 시장 중요성

RTL(Right-to-Left) 언어 지원은 다양한 시장에서 활동하는 기업 및 조직에게 매우 중요합니다.

  • 아랍어 사용 지역: 22개국, 3억 명 이상의 원어민.: 22개국, 3억 명 이상의 원어민.
  • 히브리어 시장: 이스라엘 및 전 세계 유대인 커뮤니티.: 이스라엘 및 전 세계 유대인 커뮤니티.
  • 페르시아어/파르시어: 이란, 아프가니스탄, 타지키스탄.: 이란, 아프가니스탄, 타지키스탄.
  • 우르두어.파키스탄 및 인도 일부 지역.
  • 경제적 영향RTL 언어권 지역의 총 GDP는 4조 달러를 초과합니다.

오늘날의 세계화된 시대에, 여러 언어와 문자 체계를 제대로 지원하는 PDF 문서를 만드는 것이 점점 더 중요해지고 있습니다. 대부분의 PDF 생성 라이브러리는 영어, 프랑스어, 독일어와 같은 왼쪽에서 오른쪽으로 쓰는(LTR) 언어를 쉽게 처리하지만, 아랍어, 히브리어와 같은 오른쪽에서 왼쪽으로 쓰는(RTL) 언어를 지원하는 것은 독특한 어려움을 야기합니다. 이 기사에서는 혁신적인 RtLTextOut HotPDF Delphi 컴포넌트 내의 함수를 설명하고, 포괄적인 데모 애플리케이션을 통해 실제 구현 방법을 보여줍니다.

PDF 파일에서 오른쪽에서 왼쪽(RTL) 텍스트 처리의 어려움 이해.

다음은 오른쪽에서 왼쪽으로 쓰는 언어가 디지털 문서에서 특별한 처리가 필요한 몇 가지 이유입니다.

  1. 문자 순서RTL 텍스트는 왼쪽에서 오른쪽으로 흐르지 않고, LTR 언어와 반대 방향으로 흐릅니다.
  2. 양방향 텍스트문서에는 종종 RTL과 LTR 콘텐츠가 혼합되어 있습니다.
  3. PDF 뷰어 동작PDF 리더는 텍스트를 올바르게 표시하기 위해 적절한 방향 정보를 필요로 합니다.
  4. 유니코드 복잡성RTL 문자는 특정 유니코드 범위를 가지며, 이를 감지하고 처리해야 합니다.

기존의 PDF 생성 방식은 RTL 텍스트를 처리할 때 종종 실패하여, 문자가 반전되거나, 읽기 순서가 틀리거나, 완전히 엉망이 될 수 있습니다.

RTL Text Processing Workflow Diagram showing the complete process from input text analysis through character segmentation, segment-based processing algorithm, to final bidirectional output in PDF format
그림 1: HotPDF의 RTL 텍스트 처리 워크플로우 – PDF 문서에서 올바른 양방향 표시를 위해 원래 순서대로 RTL 세그먼트를 유지하면서 내부적으로 LTR 세그먼트를 반전시키는 세그먼트 기반 알고리즘을 보여줍니다.

HotPDF의 RtLTextOut 함수 소개

HotPDF 구성 요소는 정교한 기능을 통해 이러한 과제를 해결합니다. RtLTextOut 이 함수는 고급 양방향 텍스트 처리 알고리즘을 구현합니다. 단순한 문자 반전 방식과 달리, RtLTextOut 세그먼트 기반 처리를 사용하여 혼합된 RTL/LTR 콘텐츠를 지능적으로 처리합니다.

함수 시그니처

The RtLTextOut 이 함수는 최대의 유연성을 제공하기 위해 두 가지 오버로드 버전을 제공합니다.

1
2
3
4
5
// PWORD version for direct Unicode character array access
procedure RtLTextOut(X, Y: Single; angle: Extended; Text: PWORD; TextLength: Integer);
 
// WideString version for convenient string handling
procedure RtLTextOut(X, Y: Single; angle: Extended; Text: WideString);

핵심 알고리즘: 세그먼트 기반 처리

이것의 핵심은 RtLTextOut 이 기능의 핵심은 세그먼트 기반의 양방향 알고리즘에 있습니다. 이 함수는 모든 문자를 단순히 뒤집는 방식 대신:

  1. 문자 유형 분석.: RTL(오른쪽에서 왼쪽) 문자를 식별합니다 (아랍어: U+0600-U+06FF, 히브리어: U+0590-U+05FF).
  2. 세그먼트 텍스트.: 동일한 유형(LTR 또는 RTL)의 연속된 문자를 그룹화합니다.
  3. 선택적 처리 적용.:
    • RTL 세그먼트는 원래 순서를 유지합니다.
    • LTR 세그먼트는 내부적으로 반전됩니다.
  4. 올바른 출력을 생성합니다.: 패턴을 생성합니다. Reversed(C)+B+Reversed(A) 세그먼트에 대해. A+B+C

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
// Core segment processing logic
I := 0;
while I < TextLength do begin // Determine if current character starts an RTL or LTR segment IsRTLChar := ((ReversedText[I] >= $0600) and (ReversedText[I] <= $06FF)) or // Arabic ((ReversedText[I] >= $0590) and (ReversedText[I] <= $05FF));      // Hebrew
  
  CurrentSegmentIsRTL := IsRTLChar;
  SegmentStart := I;
  
  // Find the end of current segment (same character type)
  while (I < TextLength) do begin IsRTLChar := ((ReversedText[I] >= $0600) and (ReversedText[I] <= $06FF)) or ((ReversedText[I] >= $0590) and (ReversedText[I] <= $05FF));
    
    if IsRTLChar <> CurrentSegmentIsRTL then
      Break;
    Inc(I);
  end;
  
  SegmentEnd := I - 1;
  
  // Process the segment
  if CurrentSegmentIsRTL then
  begin
    // RTL segment: keep original order
    for J := SegmentStart to SegmentEnd do
      OutputText[J] := ReversedText[J];
  end
  else
  begin
    // LTR segment: reverse the segment internally
    for J := SegmentStart to SegmentEnd do
      OutputText[J] := ReversedText[SegmentEnd - (J - SegmentStart)];
  end;
end;

PDF 방향 자동 구성.

텍스트 처리 외에도, RtLTextOut PDF 문서를 최적의 RTL 표시를 위해 자동으로 구성합니다.

1
2
3
4
5
// Store original direction and set to RightToLeft
OriginalDirection := FParent.FDirection;
FParent.FDirection := RightToLeft;
FParent.FViewerPreference := FParent.FViewerPreference + [vpDirection];
FParent.FVPChanged := true;

이를 통해 PDF 뷰어가 문서를 올바른 읽기 방향으로 열어 사용자에게 직관적인 읽기 경험을 제공합니다.

RtLTextOut 데모 애플리케이션 살펴보기.

HotPDF 라이브러리에는 포괄적인 데모 애플리케이션이 포함되어 있습니다.Demo\Delphi\RtLTextOut\RtLTextOut.dpr)이 보여주는 RtLTextOut 다양한 시나리오에서 함수의 기능을 활용할 수 있습니다.

데모 구조 및 기능.

데모 애플리케이션은 다음을 보여줍니다:

  • 기본 아랍어 텍스트 출력.: 간단한 RTL 텍스트 렌더링.
  • 히브리어 텍스트 지원: 포괄적인 히브리어 문자 처리
  • : 혼합 언어 콘텐츠: RTL/LTR 텍스트 조합
  • 기술 문서: 구현 방법 및 모범 사례

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
program RtLTextOut;
{$I ..\..\..\Lib\HotPDF.inc}
 
{$APPTYPE CONSOLE}
 
uses
  {$IFDEF XE2+}
  System.SysUtils,
  Vcl.Graphics,
  {$ELSE}
  SysUtils,
  Graphics,
  {$ENDIF}
  HPDFDoc;
 
var
  HotPDF: THotPDF;
begin
  try
    HotPDF := THotPDF.Create(nil);
    try
      HotPDF.FileName := 'RtLTextOut.pdf';
      HotPDF.Title := 'RtLTextOut Function Test - Right-to-Left Text Output';
 
      HotPDF.BeginDoc;
 
      // Title
      HotPDF.CurrentPage.SetFont('Arial', [fsBold], 18, 0, False);
      HotPDF.CurrentPage.TextOut(40, 50, 0, 'RtLTextOut Function Demonstration');
 
      // Arabic text demonstration
      HotPDF.CurrentPage.SetFont('Arial Unicode MS', [], 12, 178, False);
      HotPDF.CurrentPage.TextOut(40, 160, 0, 'RtLTextOut:');
      HotPDF.CurrentPage.RtLTextOut(40, 180, 0, 'يوضح ملف PDF هذا كيفية التعامل بشكل صحيح مع النص العربي من اليمين إلى اليسار.');
 
      // Hebrew text demonstration
      HotPDF.CurrentPage.SetFont('Arial Unicode MS', [], 12, 177, False);
      HotPDF.CurrentPage.RtLTextOut(40, 370, 0, 'קובץ PDF זה מדגים כיצד לטפל כראוי בטקסט עברי הזורם מימין לשמאל.');
 
      // Mixed text demonstration
      HotPDF.CurrentPage.RtLTextOut(40, 550, 0, 'مرحبا بالعالم! اكتب في مستندات PDF التي تم إنشاؤها بواسطة مكون HotPDF');
 
      HotPDF.EndDoc;
      Writeln('RtLTextOut.pdf created successfully!');
 
    finally
      HotPDF.Free;
    end;
  except
    on E: Exception do
      Writeln('Error: ', E.Message);
  end;
end.

주요 데모 하이라이트

아랍어 텍스트 처리: 데모는 어떻게 RtLTextOut 가 복잡한 아랍어 문장을 올바른 문자 흐름과 간격으로 처리하는지 보여줍니다.

: 히브리어 지원: 히브리어 텍스트 렌더링을 올바른 오른쪽에서 왼쪽 방향으로 보여줍니다.

: 혼합 언어 콘텐츠: 함수가 RTL 및 LTR 요소를 모두 포함하는 텍스트를 어떻게 지능적으로 처리하는지 보여줍니다.

: 글꼴 구성: 올바른 유니코드 글꼴 선택 방법을 보여줍니다.Arial Unicode MSRTL 문자 지원을 위한 설정.

기술 구현 세부 정보

유니코드 문자 감지

이 함수는 강력한 유니코드 범위 감지 기능을 사용합니다.

  • 아랍어: U+0600부터 U+06FF (1536-1791, 10진수)
  • 히브리어: U+0590부터 U+05FF (1424-1535, 10진수)

메모리 관리

효율적인 배열 처리를 통해 최적의 성능을 보장합니다.

1
2
3
4
5
6
7
8
9
10
// Initialize arrays
SetLength(ReversedText, TextLength);
SetLength(OutputText, TextLength);
 
// Copy original text first
for I := 0 to TextLength - 1 do
begin
  ReversedText[I] := TempText^;
  Inc(TempText);
end;

수직 텍스트 지원

이 기능은 수직 글꼴에 대한 특수 처리를 포함합니다.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
if CurrentFontObj.IsVertical then
begin
  DeltaH := TextHeight('Zj');
  DeltaW := TextWidth('W');
  HorizontalLine := Y;
  ChBuff := @ChCode;
  for I := 0 to TextLength - 1 do
  begin
    ChCode := OutputText[I];
    if (ChCode = $30FC) then
      ChCode := $7C;
    InternUnicodeTextOut(X + (DeltaW / 2), HorizontalLine - DeltaH, 0, ChBuff, 1);
    HorizontalLine := HorizontalLine + DeltaH;
  end;
end
else
  InternUnicodeTextOut(X, Y, angle, @OutputText[0], TextLength);

PDF에서 오른쪽에서 왼쪽(RTL) 텍스트 사용에 대한 모범 사례

글꼴 선택

대상 RTL 언어를 지원하는 Unicode 기능을 갖춘 글꼴을 선택하십시오.

  • Arial Unicode MS포괄적인 유니코드 지원
  • Times New Roman혼합 콘텐츠에 적합
  • Tahoma뛰어난 아랍어 지원

텍스트 인코딩

원본 텍스트에 올바른 유니코드 인코딩이 적용되었는지 확인하십시오.

1
2
3
4
5
6
7
// Use WideString for Unicode text
var
  ArabicText: WideString;
begin
  ArabicText := 'النص العربي';
  HotPDF.CurrentPage.RtLTextOut(X, Y, 0, ArabicText);
end;

PDF 뷰어 호환성

자동 방향 설정은 모든 PDF 뷰어와의 호환성을 보장합니다.

  • Adobe Acrobat Reader
  • Foxit Reader
  • Chrome PDF 뷰어
  • Firefox PDF 뷰어

성능 고려 사항

세그먼트 기반 알고리즘은 뛰어난 성능 특성을 제공합니다.

  1. 선형 시간 복잡도: O(n) 처리 시간
  2. : 최소한의 메모리 오버헤드: 효율적인 배열 관리
  3. : 단일 패스 처리: 반복이 필요하지 않습니다
  4. : 최적화된 문자 감지: 빠른 유니코드 범위 검사

: 실제 응용 분야

문서 현지화

The RtLTextOut 이 기능은 RTL 시장을 위한 원활한 문서 현지화를 지원합니다.

  • 아랍어 법률 문서
  • 히브리어 기술 매뉴얼
  • 다국어 양식 및 계약서
  • 교육 자료

국제 비즈니스

RTL 언어 시장에서 사업을 운영하는 기업은 이 기능을 다음과 같은 용도로 활용할 수 있습니다.

  • 송장 생성
  • 보고서 작성
  • 증명서 인쇄
  • 마케팅 자료

일반 문제 해결

문자 인코딩 문제

문제: 깨지거나 누락된 문자
해결 방법: 올바른 Unicode 인코딩 및 글꼴 선택을 확인하십시오.

1
2
3
4
5
// Correct approach
HotPDF.CurrentPage.SetFont('Arial Unicode MS', [], 12, 178, False);
var
  Text: WideString := 'النص العربي';
HotPDF.CurrentPage.RtLTextOut(X, Y, 0, Text);

방향 문제

문제: 텍스트가 잘못된 방향으로 표시됩니다.
해결 방법: 다음이 사용되었는지 확인하십시오. RtLTextOut 대신 일반 텍스트를 사용하지 않았는지 확인하십시오. TextOut

혼합 콘텐츠 문제

문제: 혼합 RTL/LTR 텍스트에서 잘못된 순서
해결 방법: 세그먼트 기반 알고리즘이 이를 자동으로 처리합니다.

향후 개선 사항 및 로드맵

HotPDF 개발팀은 RTL 지원을 지속적으로 개선하고 있습니다.

  1. 확장된 언어 지원추가적인 RTL(Right-to-Left) 언어 지원
  2. 복잡한 문자 처리고급 타이포그래피 기능
  3. 성능 최적화추가적인 속도 향상
  4. 향상된 디버깅 기능더 나은 진단 도구

마무리 语

The RtLTextOut HotPDF의 function은 오른쪽에서 왼쪽(RTL) 언어에 대한 PDF 생성 기술의 중요한 발전을 나타냅니다. 정교한 세그먼트 기반 처리 알고리즘과 자동 PDF 구성 기능을 결합하여 개발자가 진정으로 국제적인 PDF 문서를 만들 수 있는 강력한 도구를 제공합니다.

포괄적인 데모 애플리케이션은 학습 자료이자 실용적인 구현 가이드 역할을 하며, 실제 시나리오에서 RTL 텍스트 처리에 대한 모범 사례를 보여줍니다. 아랍어 사용자를 위한 애플리케이션을 개발하거나, 히브리어 문서를 만들거나, 다국어 시스템을 구축하든, RtLTextOut function은 전문적인 품질의 PDF 생성을 위한 견고한 기반을 제공합니다.

이러한 기술을 이해하고 구현함으로써 개발자는 전 세계 청중에게 적합한 PDF 문서를 만들 수 있으며, 언어 장벽을 허물고 사용되는 작성 시스템과 관계없이 콘텐츠가 접근 가능하고 읽기 쉬운지 확인할 수 있습니다.

HotPDF 및 고급 기능에 대한 자세한 내용은 공식 문서를 참조하거나 구성 요소에 포함된 포괄적인 데모 애플리케이션을 살펴보십시오.