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

Articolo tecnico

Funzione RtLTextOut nel componente HotPDF

· Programmazione PDF

Testo da destra a sinistra nella generazione di PDF: Presentazione della funzione RtLTextOut di HotPDF.

Introduzione alle lingue da destra a sinistra.

Le lingue da destra a sinistra (RTL) rappresentano una parte significativa dei sistemi di comunicazione scritta a livello mondiale, servendo oltre 400 milioni di persone in tutto il mondo. Queste lingue includono l'arabo, l'ebraico, il persiano (farsi), l'urdu, il pashto e molte altre, ognuna con le proprie caratteristiche uniche e importanza culturale.

Contesto storico e culturale.

I sistemi di scrittura RTL hanno origini antiche che risalgono a migliaia di anni fa. L'arabo, ad esempio, si è evoluto dalla scrittura nabatea ed è stato standardizzato durante il periodo islamico iniziale. L'ebraico ha una storia ancora più lunga, con antiche iscrizioni ebraiche che risalgono al 10° secolo a.C. Questi sistemi di scrittura si sono sviluppati indipendentemente dagli script basati sul latino e riflettono approcci diversi all'organizzazione delle informazioni scritte.

Caratteristiche linguistiche delle lingue RTL.

Le lingue RTL possiedono diverse caratteristiche distintive che influenzano l'elaborazione digitale del testo:

  • Direzione dello script.Il testo scorre da destra a sinistra, al contrario delle lingue europee.
  • Forme delle lettere contestuali.Molti sistemi di scrittura RTL utilizzano forme di lettere diverse a seconda della posizione (iniziale, mediale, finale, isolata).
  • Legature e connessioni.Le lettere spesso si collegano per formare parole continue, richiedendo un rendering sofisticato.
  • Segni diacritici.I segni vocalici e altri diacritici appaiono sopra o sotto i caratteri base.
  • Testo bidirezionale.I documenti RTL contengono frequentemente elementi LTR incorporati (numeri, testo latino, URL).

Sfide digitali e standard Unicode.

La rappresentazione digitale delle lingue RTL presenta sfide tecniche uniche:

  1. Codifica dei caratteri.Unicode fornisce punti di codice standardizzati per i caratteri RTL:
    • Arabo: U+0600-U+06FF (blocco arabo).
    • Ebraico: U+0590-U+05FF (blocco ebraico).
    • Supplemento arabo: U+0750-U+077F.
    • Arabico Esteso-A: U+08A0-U+08FF
  2. Algoritmo bidirezionaleL'algoritmo Unicode bidirezionale (UBA) definisce come deve essere elaborato il testo misto da destra a sinistra (RTL) e da sinistra a destra (LTR).
  3. Requisiti dei fontIl testo RTL richiede font con una copertura di glifi adeguata e capacità di formattazione.
  4. Considerazioni sull'impaginazioneLe interfacce utente e i documenti devono supportare la lettura da destra a sinistra.

Importanza nel mercato globale.

Il supporto per le lingue RTL (da destra a sinistra) è fondamentale per le aziende e le organizzazioni che operano in mercati diversi:

  • Regioni di lingua araba: 22 paesi con oltre 300 milioni di parlanti nativi.: 22 paesi con oltre 300 milioni di parlanti nativi.
  • Mercato ebraico: Israele e comunità ebraiche in tutto il mondo.: Israele e comunità ebraiche in tutto il mondo.
  • Persiano/Farsi: Iran, Afghanistan e Tagikistan.: Iran, Afghanistan e Tagikistan.
  • Urdu.Pakistan e alcune parti dell'India.
  • Impatto economico.Il PIL combinato delle regioni di lingua RTL supera i 4 trilioni di dollari.

Nel mondo globalizzato di oggi, creare documenti PDF che supportino correttamente più lingue e sistemi di scrittura è diventato sempre più importante. Sebbene la maggior parte delle librerie di generazione di PDF gestisca facilmente le lingue da sinistra a destra (LTR) come l'inglese, il francese e il tedesco, supportare le lingue da destra a sinistra (RTL) come l'arabo e l'ebraico presenta sfide uniche. Questo articolo esplora le soluzioni innovative. RtLTextOut questa funzione nel componente HotPDF per Delphi e ne dimostra l'implementazione pratica attraverso un'applicazione dimostrativa completa.

Comprendere le sfide del testo RTL (da destra a sinistra) nei file PDF.

Le lingue che si scrivono da destra a sinistra richiedono una gestione speciale nei documenti digitali per diverse ragioni:

  1. Ordine dei caratteri.Il testo RTL scorre da destra a sinistra, al contrario delle lingue LTR.
  2. Testo bidirezionale.I documenti spesso contengono contenuti misti RTL e LTR.
  3. Comportamento del visualizzatore PDF.I lettori PDF necessitano di indicazioni di direzione corrette per visualizzare correttamente il testo.
  4. Complessità Unicode.I caratteri RTL hanno intervalli Unicode specifici che devono essere rilevati ed elaborati.

Gli approcci tradizionali alla generazione di PDF spesso falliscono quando si tratta di testo RTL, con conseguenti sequenze di caratteri invertite, ordine di lettura errato o output completamente illeggibile.

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
Figura 1: Flusso di elaborazione del testo RTL in HotPDF – Illustra l'algoritmo basato su segmenti che elabora testo misto RTL/LTR mantenendo i segmenti RTL nell'ordine originale, mentre inverte internamente i segmenti LTR per una corretta visualizzazione bidirezionale nei documenti PDF.

Presentazione della funzione RtLTextOut di HotPDF.

Il componente HotPDF affronta queste sfide attraverso le sue funzionalità avanzate. RtLTextOut funzione, che implementa algoritmi avanzati di elaborazione bidirezionale del testo. A differenza degli approcci semplici di inversione dei caratteri, RtLTextOut utilizza l'elaborazione basata su segmenti per gestire in modo intelligente contenuti misti da destra a sinistra (RTL) e da sinistra a destra (LTR).

Firme delle funzioni.

Il RtLTextOut la funzione fornisce due versioni con overload per la massima flessibilità:

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

Algoritmo principale: elaborazione basata su segmenti.

Il cuore di RtLTextOut si basa su un algoritmo bidirezionale a segmenti. Invece di applicare una semplice inversione di caratteri, la funzione:

  1. Analizza i tipi di caratteri.: Identifica i caratteri RTL (arabo: U+0600-U+06FF, ebraico: U+0590-U+05FF).
  2. Segmenti di testo.: Raggruppa caratteri consecutivi dello stesso tipo (da destra a sinistra o da sinistra a destra).
  3. Applica l'elaborazione selettiva.:
    • I segmenti RTL mantengono il loro ordine originale.
    • I segmenti LTR vengono invertiti internamente.
  4. Produce un output corretto.Risultato: genera il pattern. Reversed(C)+B+Reversed(A) per i segmenti. 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;

Configurazione automatica della direzione del PDF.

Oltre all'elaborazione del testo, RtLTextOut configura automaticamente il documento PDF per una visualizzazione RTL ottimale:

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;

Questo garantisce che i visualizzatori di PDF aprano il documento con la direzione di lettura corretta, offrendo agli utenti un'esperienza di lettura intuitiva.

Esplorazione dell'applicazione dimostrativa RtLTextOut.

La libreria HotPDF include un'applicazione dimostrativa completa (Demo\Delphi\RtLTextOut\RtLTextOut.dpr) che mostra le RtLTextOut funzionalità della funzione in vari scenari.

Struttura e funzionalità della demo.

L'applicazione dimostrativa mostra:

  • Output di testo arabo di base: rendering semplice di testo RTL.: Rendering semplice di testo RTL.
  • Supporto per il testo in ebraico.Gestione completa dei caratteri ebraici.
  • Contenuti multilingueCombinazioni di testo da destra a sinistra (RTL) e da sinistra a destra (LTR).
  • Documentazione tecnica.Note sull'implementazione e buone pratiche.

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.

Punti salienti della demo.

Elaborazione del testo arabo.: La demo mostra come RtLTextOut gestisce frasi arabe complesse con un corretto flusso e spaziatura dei caratteri.

Supporto per l'ebraico: Dimostra il rendering del testo ebraico con la corretta orientamento da destra a sinistra.

Contenuti multilingue: Mostra come la funzione elabora in modo intelligente il testo contenente elementi sia RTL che LTR.

Configurazione del font: Illustra la corretta selezione dei font Unicode (Arial Unicode MSper il supporto dei caratteri RTL.

Dettagli sull'implementazione tecnica.

Rilevamento dei caratteri Unicode.

La funzione utilizza un rilevamento robusto degli intervalli Unicode:

  • Arabo.: U+0600 a U+06FF (1536-1791 decimale).
  • Ebraico.: U+0590 a U+05FF (1424-1535 decimale).

Gestione della memoria.

La gestione efficiente degli array garantisce prestazioni ottimali:

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;

Supporto per testo verticale.

La funzione include una gestione speciale per i font verticali:

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 practice per il testo RTL nei PDF.

Selezione dei font.

Scegliere font compatibili con Unicode che supportino le tue lingue RTL di destinazione:

  • Arial Unicode MS.Supporto completo per Unicode.
  • Times New Roman.Adatto per contenuti misti.
  • Tahoma.Ottimo supporto per l'arabo.

Codifica del testo.

Assicurarsi che la codifica Unicode sia corretta nel testo sorgente:

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;

Compatibilità con i visualizzatori PDF.

L'impostazione automatica della direzione garantisce la compatibilità tra i diversi visualizzatori di PDF:

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

Considerazioni sulle prestazioni

L'algoritmo basato su segmenti offre eccellenti caratteristiche di prestazioni:

  1. Complessità temporale lineareTempo di elaborazione O(n).
  2. Minimo sovraccarico di memoria.Gestione efficiente degli array.
  3. Elaborazione in un'unica passata.Non sono richieste iterazioni multiple.
  4. Rilevamento dei caratteri ottimizzato.Controlli rapidi degli intervalli Unicode.

Applicazioni nel mondo reale.

Localizzazione di documenti.

Il RtLTextOut Questa funzione consente la localizzazione senza interruzioni di documenti per i mercati RTL:

  • Documenti legali in arabo.
  • Manuali tecnici in ebraico.
  • Moduli e contratti multilingue.
  • Materiale didattico.

Business internazionale.

Le aziende che operano nei mercati di lingua RTL possono utilizzare questa funzionalità per:

  • Generazione di fatture.
  • Creazione di report.
  • Stampa di certificati.
  • Materiale di marketing.

Risoluzione dei problemi comuni.

Problemi di codifica dei caratteri.

Problema.: Caratteri illeggibili o mancanti.
Soluzione.: Assicurarsi di utilizzare la corretta codifica Unicode e la selezione del font.

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

Problemi di direzione

Problema.: Il testo appare nella direzione errata.
Soluzione.: Verificare che RtLTextOut sia utilizzato al posto del normale. TextOut

Problemi di contenuto misto.

Problema.: Ordinamento errato nel testo misto da destra a sinistra (RTL) e da sinistra a destra (LTR).
Soluzione.: L'algoritmo basato su segmenti gestisce automaticamente questo problema.

Miglioramenti futuri e roadmap.

Il team di sviluppo di HotPDF continua a migliorare il supporto per RTL.

  1. Supporto linguistico esteso.Lingue RTL aggiuntive.
  2. Gestione avanzata di script complessi.Funzionalità avanzate di tipografia.
  3. Ottimizzazioni delle prestazioni.Ulteriori miglioramenti della velocità.
  4. Debugging migliorato.Strumenti diagnostici migliori.

Considerazioni finali.

Il RtLTextOut La funzione in HotPDF rappresenta un notevole progresso nella tecnologia di generazione di PDF per le lingue RTL. Il suo sofisticato algoritmo di elaborazione basato su segmenti, combinato con la configurazione automatica del PDF, offre agli sviluppatori un potente strumento per creare documenti PDF veramente internazionali.

L'applicazione demo completa funge sia da risorsa didattica che da guida pratica all'implementazione, dimostrando le migliori pratiche per la gestione di testo RTL in scenari reali. Che siate impegnati nello sviluppo di applicazioni per mercati di lingua araba, nella creazione di documentazione in ebraico o nella realizzazione di sistemi multilingue, RtLTextOut questa funzione fornisce la solida base necessaria per la generazione di file PDF di qualità professionale.

Comprendendo e implementando queste tecniche, gli sviluppatori possono creare documenti PDF che soddisfano adeguatamente le esigenze di un pubblico globale, superando le barriere linguistiche e garantendo che i contenuti siano accessibili e leggibili indipendentemente dal sistema di scrittura utilizzato.

Per maggiori informazioni su HotPDF e le sue funzionalità avanzate, visitare la documentazione ufficiale o esplorare le applicazioni demo complete incluse nel componente.