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

Fachartikel

RtLTextOut-Funktion in der HotPDF-Komponente

· PDF-Programmierung

Textausrichtung von rechts nach links bei der PDF-Generierung: Einführung der RtLTextOut-Funktion von HotPDF.

Einführung in Sprachen mit Textausrichtung von rechts nach links.

Sprachen mit Textausrichtung von rechts nach links (RTL) stellen einen bedeutenden Teil der weltweit verwendeten Schriftsysteme dar und werden von über 400 Millionen Menschen weltweit genutzt. Zu diesen Sprachen gehören Arabisch, Hebräisch, Persisch (Farsi), Urdu, Paschtu und viele andere, die jeweils ihre eigenen einzigartigen Merkmale und kulturelle Bedeutung haben.

Historischer und kultureller Kontext.

Schriftsysteme mit Textausrichtung von rechts nach links haben uralte Ursprünge, die Tausende von Jahren zurückreichen. Arabisch hat sich beispielsweise aus der nabatäischen Schrift entwickelt und wurde in der frühen islamischen Zeit standardisiert. Hebräisch hat eine noch längere Geschichte, mit alten hebräischen Inschriften, die bis ins 10. Jahrhundert v. Chr. zurückreichen. Diese Schriftsysteme entwickelten sich unabhängig von lateinbasierten Schriften und spiegeln unterschiedliche Ansätze zur Organisation von schriftlichen Informationen wider.

Linguistische Merkmale von RTL-Sprachen.

RTL-Sprachen weisen mehrere charakteristische Merkmale auf, die sich auf die digitale Textverarbeitung auswirken:

  • Textrichtung.Der Text verläuft von rechts nach links, im Gegensatz zu europäischen Sprachen.
  • Kontextabhängige Buchstabenformen.Viele RTL-Schriften verwenden unterschiedliche Buchstabenformen, abhängig von der Position (anfänglich, medial, final, isoliert).
  • Ligaturen und Verbindungen.Buchstaben verbinden oft zu kontinuierlichen Wörtern, was eine ausgefeilte Darstellung erfordert.
  • Diakritische Zeichen.Vokalphoneme und andere Diakritika erscheinen oberhalb oder unterhalb der Basiszeichen.
  • Bidirektionaler Text.RTL-Dokumente enthalten häufig eingebettete LTR-Elemente (Zahlen, lateinischer Text, URLs).

Digitale Herausforderungen und Unicode-Standards.

Die digitale Darstellung von RTL-Sprachen stellt einzigartige technische Herausforderungen dar:

  1. Zeichenkodierung.Unicode bietet standardisierte Codepunkte für RTL-Zeichen:
    • Arabisch: U+0600-U+06FF (Arabischer Block).
    • Hebräisch: U+0590-U+05FF (Hebräischer Block).
    • Arabisches Supplement: U+0750-U+077F.
    • Arabisch erweitert-A: U+08A0-U+08FF
  2. Bidirektionale Algorithmus: Der Unicode-Bidirektionsalgorithmus (UBA) definiert, wie gemischter RTL/LTR-Text verarbeitet werden soll.
  3. Schriftanforderungen: RTL-Text benötigt Schriften mit geeigneter Glyphenabdeckung und Formungsfähigkeiten.
  4. Layout-Überlegungen: Benutzeroberflächen und Dokumente müssen Rechts-nach-links-Lesemuster berücksichtigen.

Globale Marktrelevanz

Die Unterstützung von RTL-Sprachen ist entscheidend für Unternehmen und Organisationen, die in verschiedenen Märkten tätig sind:

  • arabischsprachige RegionenIn 22 Ländern mit über 300 Millionen Muttersprachlern.
  • Israelischer Markt.: Israel und jüdische Gemeinden weltweit.
  • Persisch/FarsiIran, Afghanistan und Tadschikistan.
  • UrduPakistan und Teile Indiens.
  • Wirtschaftliche Auswirkungen.Die kombinierte Wirtschaftsleistung der Regionen, in denen RTL-Sprachen gesprochen werden, übersteigt 4 Billionen US-Dollar.

In der heutigen globalisierten Welt ist es immer wichtiger geworden, PDF-Dokumente zu erstellen, die mehrere Sprachen und Schriftsysteme korrekt unterstützen. Während die meisten PDF-Generierungsbibliotheken Sprachen, die von links nach rechts (LTR) geschrieben werden, wie Englisch, Französisch und Deutsch, problemlos verarbeiten können, stellt die Unterstützung von Sprachen, die von rechts nach links (RTL) geschrieben werden, wie Arabisch und Hebräisch, besondere Herausforderungen dar. Dieser Artikel untersucht die innovativen RtLTextOut Diese Funktion ist in dem HotPDF Delphi-Komponenten enthalten und wird durch eine umfassende Demo-Anwendung praktisch demonstriert.

Das Verständnis der Herausforderungen bei RTL-Text in PDFs.

Sprachen, die von rechts nach links geschrieben werden, erfordern eine spezielle Behandlung in digitalen Dokumenten aus verschiedenen Gründen:

  1. Zeichenreihenfolge.RTL-Text fließt von rechts nach links, im Gegensatz zu LTR-Sprachen.
  2. Bidirektionaler Text.Dokumente enthalten oft eine Mischung aus RTL- und LTR-Inhalten.
  3. Verhalten des PDF-Betrachters.PDF-Reader benötigen korrekte Richtungsangaben, um Text richtig anzuzeigen.
  4. Unicode-Komplexität.RTL-Zeichen haben bestimmte Unicode-Bereiche, die erkannt und verarbeitet werden müssen.

Traditionelle PDF-Generierungsansätze schlagen oft fehl, wenn es um RTL-Text geht, was zu umgekehrten Zeichenfolgen, falscher Lesereihenfolge oder völlig unleserlichen Ausgaben führt.

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
Abbildung 1: RTL-Textverarbeitungsworkflow in HotPDF – Veranschaulichung des segmentbasierten Algorithmus, der gemischten RTL/LTR-Text verarbeitet, indem RTL-Segmente in der ursprünglichen Reihenfolge beibehalten und LTR-Segmente intern umgekehrt werden, um eine korrekte bidirektionale Anzeige in PDF-Dokumenten zu gewährleisten.

Wir stellen HotPDFs RtLTextOut-Funktion vor.

Der HotPDF-Komponente adressiert diese Herausforderungen durch ihre ausgefeilte RtLTextOut eine Funktion, die fortschrittliche bidirektionale Textverarbeitungsalgorithmen implementiert. Im Gegensatz zu einfachen Zeichenumkehrungsansätzen, RtLTextOut verwendet segmentbasierte Verarbeitung, um gemischten RTL/LTR-Inhalt intelligent zu verarbeiten.

Funktionssignaturen.

Der RtLTextOut Die Funktion bietet zwei überladene Versionen für maximale Flexibilität:

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);

Kernalgorithmus: Segmentbasierte Verarbeitung.

Das Herzstück von liegt in seinem segmentbasierten bidirektionalen Algorithmus. RtLTextOut Anstatt eine allgemeine Zeichenumkehrung anzuwenden, analysiert die Funktion:

  1. Analysiert Zeichentypen: Identifiziert RTL-Zeichen (Arabisch: U+0600-U+06FF, Hebräisch: U+0590-U+05FF)
  2. Segmentiert Text: Gruppiert aufeinanderfolgende Zeichen desselben Typs (RTL oder LTR)
  3. Wendet selektive Verarbeitung an:
    • RTL-Segmente behalten ihre ursprüngliche Reihenfolge.
    • LTR-Segmente werden intern umgekehrt.
  4. Erzeugt die korrekte Ausgabe.Führt zu dem Muster. Reversed(C)+B+Reversed(A) für Segmente. 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;

Automatische PDF-Richtungs-Konfiguration.

Neben der Textverarbeitung, RtLTextOut konfiguriert das PDF-Dokument automatisch für die optimale RTL-Anzeige:

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;

Dies stellt sicher, dass PDF-Viewer das Dokument mit der korrekten Lesrichtung öffnen, was den Benutzern ein intuitives Leseerlebnis bietet.

Erkundung der RtLTextOut Demo-Anwendung.

Die HotPDF-Bibliothek enthält eine umfassende Demo-Anwendung (Demo\Delphi\RtLTextOut\RtLTextOut.dpr), die die RtLTextOut Funktionen in verschiedenen Szenarien demonstriert.

Struktur und Funktionen der Demo.

Die Demo-Anwendung demonstriert:

  • Grundlegende arabische Textausgabe.Einfache RTL-Textdarstellung.
  • Unterstützung für hebräische Texte.Umfassende Verarbeitung hebräischer Zeichen.
  • Mehrsprachige InhalteKombinationen aus Text in Schreibrichtung von rechts nach links (RTL) und von links nach rechts (LTR).
  • Technische Dokumentation.Implementierungsanmerkungen und bewährte Verfahren.

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.

Wichtige Demo-Highlights.

Verarbeitung arabischer Texte.: Die Demo zeigt, wie RtLTextOut komplexe arabische Sätze mit korrekter Zeichenausrichtung und Abstand verarbeitet.

Hebräische Unterstützung: Demonstriert die Darstellung von hebräischem Text mit der korrekten Rechts-nach-links-Ausrichtung.

Mehrsprachige Inhalte: Zeigt, wie die Funktion intelligent Text verarbeitet, der sowohl RTL- als auch LTR-Elemente enthält.

Schriftkonfiguration: Veranschaulicht die korrekte Auswahl von Unicode-Schriften (Arial Unicode MS) für die Unterstützung von RTL-Zeichen.

Technische Implementierungsdetails

Unicode-Zeichenerkennung

Die Funktion verwendet eine robuste Unicode-Bereichserkennung:

  • Arabisch: U+0600 bis U+06FF (1536-1791 dezimal)
  • Hebräisch: U+0590 bis U+05FF (1424-1535 dezimal)

Speicherverwaltung

Effiziente Array-Verarbeitung sorgt für optimale Leistung:

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;

Unterstützung für vertikale Textausrichtung

Die Funktion enthält spezielle Verarbeitung für vertikale Schriftarten:

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);

Best Practices für RTL-Text in PDFs

Schriftartauswahl

Wählen Sie Unicode-fähige Schriftarten aus, die Ihre Ziel-RTL-Sprachen unterstützen:

  • Arial Unicode MSUmfassende Unicode-Unterstützung.
  • Times New Roman.Gut geeignet für Inhalte mit verschiedenen Formaten.
  • Tahoma.Ausgezeichnete Unterstützung für die arabische Sprache.

Textkodierung.

Stellen Sie sicher, dass Ihr Quelltext die korrekte Unicode-Kodierung verwendet.

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;

Kompatibilität mit PDF-Betrachtern.

Die automatische Richtungsfestlegung gewährleistet die Kompatibilität über verschiedene PDF-Viewer hinweg:

  • Adobe Acrobat Reader
  • Foxit Reader
  • Chrome PDF Viewer
  • Firefox PDF Viewer

Leistungsüberlegungen

Der segmentbasierte Algorithmus bietet hervorragende Leistungseigenschaften:

  1. Lineare ZeitkomplexitätO(n) Verarbeitungszeit.
  2. Minimale Speicherbelastung.Effiziente Array-Verwaltung.
  3. Verarbeitung in einem Durchgang.Keine mehrfachen Iterationen erforderlich.
  4. Optimierte Zeichenerkennung.Schnelle Unicode-Bereichsprüfungen.

Anwendungen im realen Einsatz.

Dokumentlokalisierung.

Der RtLTextOut Diese Funktion ermöglicht eine nahtlose Dokumentlokalisierung für RTL-Märkte:

  • Rechtsdokumente auf Arabisch.
  • Hebräische technische Handbücher.
  • Mehrsprachige Formulare und Verträge.
  • Lehrmaterialien.

Internationales Geschäft.

Unternehmen, die in RTL-Sprachmärkten tätig sind, können diese Funktionalität für Folgendes nutzen:

  • Erstellung von Rechnungen.
  • Erstellung von Berichten.
  • Drucken von Zertifikaten.
  • Marketingmaterialien.

Fehlerbehebung bei häufigen Problemen.

Probleme mit der Zeichenkodierung.

Problem.: Verfremdete oder fehlende Zeichen.
Lösung.Stellen Sie sicher, dass die korrekte Unicode-Kodierung und die richtige Schriftart ausgewählt sind.

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);

Probleme mit der Richtung

Problem.Der Text wird in der falschen Richtung angezeigt.
Lösung.Überprüfen Sie, ob RtLTextOut anstelle der normalen Schriftart verwendet wird. TextOut

Probleme mit gemischten Inhalten.

Problem.: Falsche Reihenfolge in Texten mit gemischter RTL/LTR-Ausrichtung.
Lösung.: Der segmentbasierte Algorithmus behandelt dies automatisch.

Zukünftige Erweiterungen und Roadmap.

Das HotPDF-Entwicklungsteam arbeitet kontinuierlich an der Verbesserung der RTL-Unterstützung:

  1. Erweiterte Sprachunterstützung.Zusätzliche RTL-Sprachen.
  2. Erweiterte Unterstützung für komplexe Schriftsysteme.Erweiterte Typografie-Funktionen.
  3. Leistungsoptimierungen.Weitere Geschwindigkeitsverbesserungen.
  4. Verbesserte Debugging-Funktionen.Bessere Diagnosewerkzeuge.

Abschließende Bemerkungen.

Der RtLTextOut Die Funktion in HotPDF stellt einen bedeutenden Fortschritt in der PDF-Generierungstechnologie für RTL-Sprachen dar. Ihr ausgeklügelter, segmentbasierter Verarbeitungsprozess, kombiniert mit automatischer PDF-Konfiguration, bietet Entwicklern ein leistungsstarkes Werkzeug zur Erstellung wirklich internationaler PDF-Dokumente.

Die umfassende Demo-Anwendung dient sowohl als Lernressource als auch als praktischer Implementierungsleitfaden und demonstriert Best Practices für die Verarbeitung von RTL-Text in realen Szenarien. Egal, ob Sie Anwendungen für arabischsprachige Märkte entwickeln, Hebräisch-Dokumentationen erstellen oder mehrsprachige Systeme aufbauen, RtLTextOut Diese Funktion bietet die solide Grundlage, die für die Erstellung von PDF-Dokumenten in professioneller Qualität erforderlich ist.

Durch das Verständnis und die Implementierung dieser Techniken können Entwickler PDF-Dokumente erstellen, die globale Zielgruppen optimal bedienen, Sprachbarrieren überwinden und sicherstellen, dass Inhalte zugänglich und lesbar sind, unabhängig vom verwendeten Schriftsystem.

Für weitere Informationen über HotPDF und seine erweiterten Funktionen besuchen Sie die offizielle Dokumentation oder erkunden Sie die umfassenden Demo-Anwendungen, die mit dem Component enthalten sind.