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

Article technique

Fonction RtLTextOut dans le composant HotPDF

· Programmation PDF

Texte de gauche à droite dans la génération de PDF : Présentation de la fonction RtLTextOut de HotPDF.

Introduction aux langues de gauche à droite.

Les langues de gauche à droite (RTL) représentent une part importante des systèmes de communication écrite dans le monde, desservant plus de 400 millions de personnes dans le monde. Ces langues comprennent l'arabe, l'hébreu, le persan (farsi), l'ourdou, le pachtou et plusieurs autres, chacune ayant ses propres caractéristiques et sa signification culturelle.

Contexte historique et culturel.

Les systèmes d'écriture RTL ont des origines anciennes qui remontent à des milliers d'années. L'arabe, par exemple, a évolué à partir de l'écriture nabatéenne et s'est standardisé au début de la période islamique. L'hébreu a une histoire encore plus longue, avec des inscriptions hébraïques anciennes datant du 10ème siècle avant notre ère. Ces systèmes d'écriture se sont développés indépendamment des scripts basés sur le latin et reflètent différentes approches de l'organisation de l'information écrite.

Caractéristiques linguistiques des langues RTL.

Les langues RTL possèdent plusieurs caractéristiques distinctives qui ont un impact sur le traitement numérique du texte :

  • Direction de l'écriture.Le texte s'écrit de droite à gauche, contrairement aux langues européennes.
  • Formes de lettres contextuelles.De nombreux systèmes d'écriture RTL utilisent différentes formes de lettres en fonction de la position (initiale, médiane, finale, isolée).
  • Ligatures et connexions.Les lettres se connectent souvent pour former des mots continus, ce qui nécessite un rendu sophistiqué.
  • Signes diacritiques.Les marques de voyelles et autres signes diacritiques apparaissent au-dessus ou en dessous des caractères de base.
  • Texte bidirectionnel.Les documents RTL contiennent fréquemment des éléments LTR intégrés (chiffres, texte latin, URL).

Défis numériques et normes Unicode.

La représentation numérique des langues RTL présente des défis techniques uniques.

  1. Encodage des caractères.Unicode fournit des points de code standardisés pour les caractères RTL.
    • Arabe : U+0600-U+06FF (bloc arabe).
    • Hébreu : U+0590-U+05FF (bloc hébreu).
    • Supplément arabe : U+0750-U+077F.
    • Arabe étendu-A : U+08A0-U+08FF
  2. Algorithme bidirectionnel: L'algorithme bidirectionnel Unicode (UBA) définit comment le texte mixte RTL/LTR doit être traité.
  3. Exigences de police: Le texte RTL nécessite des polices avec une couverture de glyphes appropriée et des capacités de mise en forme.
  4. Considérations de mise en page: Les interfaces utilisateur et les documents doivent prendre en charge les modèles de lecture de droite à gauche.

Importance pour le marché mondial.

La prise en charge des langues RTL est essentielle pour les entreprises et les organisations opérant sur des marchés diversifiés :

  • Régions arabophones : 22 pays avec plus de 300 millions de locuteurs natifs.: 22 pays avec plus de 300 millions de locuteurs natifs.
  • Marché hébreu : Israël et communautés juives dans le monde.: Israël et communautés juives dans le monde.
  • Persan/Farsi : Iran, Afghanistan et Tadjikistan.: Iran, Afghanistan et Tadjikistan.
  • Ourdou.: Pakistan et certaines régions de l'Inde.
  • Impact économique.: Le PIB combiné des régions de langue RTL dépasse 4 billions de dollars.

Dans le monde globalisé d'aujourd'hui, la création de documents PDF qui prennent correctement en charge plusieurs langues et systèmes d'écriture est devenue de plus en plus importante. Bien que la plupart des bibliothèques de génération de PDF gèrent facilement les langues de gauche à droite (LTR) comme l'anglais, le français et l'allemand, la prise en charge des langues de droite à gauche (RTL) telles que l'arabe et l'hébreu présente des défis uniques. Cet article explore les innovations. RtLTextOut Cette fonction est intégrée au composant HotPDF pour Delphi et son implémentation pratique est démontrée à travers une application de démonstration complète.

Comprendre les défis liés au texte RTL dans les fichiers PDF.

Les langues qui s'écrivent de droite à gauche nécessitent un traitement spécial dans les documents numériques pour plusieurs raisons :

  1. Ordre des caractères.Le texte RTL s'affiche de droite à gauche, contrairement aux langues LTR.
  2. Texte bidirectionnel.Les documents contiennent souvent du contenu mixte RTL et LTR.
  3. Comportement du lecteur PDF.Les lecteurs PDF ont besoin d'indications de direction appropriées pour afficher correctement le texte.
  4. Complexité Unicode.Les caractères RTL ont des plages Unicode spécifiques qui doivent être détectées et traitées.

Les approches traditionnelles de génération de PDF échouent souvent lorsqu'elles traitent du texte RTL, ce qui entraîne des séquences de caractères inversées, un ordre de lecture incorrect ou une sortie complètement illisible.

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
Figure 1 : Flux de traitement du texte RTL dans HotPDF – Illustrant l'algorithme basé sur les segments qui traite le texte mixte RTL/LTR en conservant l'ordre des segments RTL tout en inversant les segments LTR en interne pour un affichage bidirectionnel correct dans les documents PDF.

Présentation de la fonction RtLTextOut de HotPDF.

Le composant HotPDF relève ces défis grâce à sa fonctionnalité sophistiquée. RtLTextOut qui implémente des algorithmes avancés de traitement de texte bidirectionnel. Contrairement aux approches simples de renversement de caractères, RtLTextOut utilise un traitement basé sur les segments pour gérer intelligemment le contenu mixte RTL/LTR.

Signatures des fonctions.

La RtLTextOut La fonction fournit deux versions surchargées pour une flexibilité maximale.

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

Algorithme principal : traitement basé sur les segments.

Le cœur de RtLTextOut réside dans son algorithme bidirectionnel basé sur des segments. Au lieu d'appliquer une inversion de caractères globale, la fonction :

  1. Analyse des types de caractères.: Identifie les caractères RTL (de droite à gauche) (arabe : U+0600-U+06FF, hébreu : U+0590-U+05FF).
  2. Segments Text: Regroupe les caractères consécutifs du même type (LTR ou RTL).
  3. Applique le traitement sélectif.:
    • Les segments RTL conservent leur ordre d'origine.
    • Les segments LTR sont inversés en interne.
  4. Produit une sortie correcte.: Entraîne le motif suivant. Reversed(C)+B+Reversed(A) pour les segments. 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;

Configuration automatique de la direction du PDF.

Au-delà du traitement de texte, RtLTextOut configure automatiquement le document PDF pour une affichage RTL optimale :

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;

Cela garantit que les lecteurs de PDF ouvrent le document avec la direction de lecture correcte, offrant aux utilisateurs une expérience de lecture intuitive.

Exploration de l'application de démonstration RtLTextOut.

La bibliothèque HotPDF inclut une application de démonstration complète (Demo\Delphi\RtLTextOut\RtLTextOut.dpr) qui présente les RtLTextOut fonctionnalités dans divers scénarios.

Structure et fonctionnalités de la démonstration.

L'application de démonstration illustre :

  • Sortie de texte arabe de base.: Rendu de texte RTL simple.
  • Prise en charge du texte hébreu.: Gestion complète des caractères hébreux.
  • : Contenu multilingue.: Combinaisons de texte RTL/LTR.
  • Documentation technique.: Notes d'implémentation et bonnes pratiques.

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.

Points forts de la démo.

Traitement du texte arabe.: La démo montre comment RtLTextOut gère les phrases arabes complexes avec un flux et un espacement corrects des caractères.

: Prise en charge de l'hébreu.: Démontre le rendu de texte en hébreu avec la bonne orientation de gauche à droite.

: Contenu multilingue.: Montre comment la fonction traite intelligemment le texte contenant à la fois des éléments RTL et LTR.

: Configuration de la police.: Illustre la sélection correcte des polices Unicode (Arial Unicode MSpour la prise en charge des caractères RTL.

Détails de l'implémentation technique.

Détection des caractères Unicode.

La fonction utilise une détection robuste des plages Unicode :

  • Arabe.: U+0600 à U+06FF (1536-1791 décimal).
  • Hébreu.: U+0590 à U+05FF (1424-1535 décimal).

Gestion de la mémoire.

La gestion efficace des tableaux garantit des performances optimales.

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;

Prise en charge du texte vertical.

La fonction inclut une gestion spéciale pour les polices verticales.

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

Bonnes pratiques pour le texte RTL dans les fichiers PDF.

Sélection de la police.

Choisissez des polices compatibles avec Unicode qui prennent en charge vos langues RTL cibles.

  • Arial Unicode MS.Prise en charge complète de Unicode.
  • Times New Roman.Idéal pour le contenu mixte.
  • Tahoma.Excellente prise en charge de l'arabe.

Encodage du texte.

Assurez-vous d'utiliser un encodage Unicode correct dans votre texte source.

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é avec les lecteurs PDF.

Le réglage automatique de la direction garantit la compatibilité avec les différents lecteurs PDF :

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

Considérations de performance

L'algorithme basé sur les segments offre d'excellentes performances :

  1. Complexité temporelle linéaire: Temps de traitement O(n).
  2. : Faible surcharge mémoire.: Gestion efficace des tableaux.
  3. : Traitement en une seule passe.: Aucune itération multiple requise.
  4. : Détection de caractères optimisée.: Vérifications rapides des plages Unicode.

: Applications concrètes.

Traduction et adaptation de documents.

La RtLTextOut Cette fonctionnalité permet une traduction et adaptation transparente de documents pour les marchés RTL :

  • Documents juridiques en arabe.
  • Manuels techniques en hébreu.
  • Formulaires et contrats multilingues.
  • Matériel pédagogique.

Commerce international.

Les entreprises opérant sur les marchés linguistiques RTL peuvent utiliser cette fonctionnalité pour :

  • Génération de factures.
  • Création de rapports.
  • Impression de certificats.
  • Matériel de marketing.

Dépannage des problèmes courants.

Problèmes d'encodage de caractères.

Problème.: Caractères illisibles ou manquants.
Solution.: Assurez-vous d'utiliser le bon encodage Unicode et la bonne sélection de police.

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

Problèmes de direction

Problème.: Le texte apparaît dans la direction incorrecte.
Solution.: Vérifiez que RtLTextOut est utilisé au lieu de la version standard. TextOut

Problèmes de contenu mixte.

Problème.: Ordre incorrect dans le texte RTL/LTR.
Solution.: L'algorithme basé sur les segments gère cela automatiquement.

Améliorations futures et feuille de route.

L'équipe de développement de HotPDF continue d'améliorer la prise en charge de RTL.

  1. Prise en charge étendue des langues.: Langues RTL supplémentaires.
  2. : Gestion avancée des scripts complexes.: Fonctionnalités de typographie avancées.
  3. : Optimisations des performances.: Améliorations supplémentaires de la vitesse.
  4. : Débogage amélioré.: Outils de diagnostic améliorés.

: Dernières réflexions.

La RtLTextOut La fonction intégrée dans HotPDF représente une avancée significative dans la technologie de génération de PDF pour les langues RTL. Son algorithme de traitement sophistiqué, basé sur des segments, combiné à une configuration PDF automatique, offre aux développeurs un outil puissant pour créer des documents PDF véritablement internationaux.

L'application de démonstration complète sert à la fois de ressource d'apprentissage et de guide d'implémentation pratique, illustrant les meilleures pratiques pour la gestion du texte RTL dans des scénarios réels. Que vous développiez des applications pour les marchés arabophones, que vous créiez de la documentation en hébreu ou que vous construisiez des systèmes multilingues, RtLTextOut Cette fonction fournit la base solide nécessaire pour la génération de fichiers PDF de qualité professionnelle.

En comprenant et en mettant en œuvre ces techniques, les développeurs peuvent créer des documents PDF qui répondent correctement aux besoins des publics internationaux, en éliminant les barrières linguistiques et en garantissant que le contenu est accessible et lisible, quel que soit le système d'écriture utilisé.

Pour plus d'informations sur HotPDF et ses fonctionnalités avancées, consultez la documentation officielle ou explorez les applications de démonstration complètes incluses avec le composant.