LaTeX vers l'image | Aspose.TeX pour C++

Aspose.TeX pour C++ nous permet également de convertir des fichiers LaTeX vers un certain nombre d’autres formats d’images raster.

Comment convertir LaTeX en PNG

Examinons en détail le code en C++ fournissant le moyen le plus simple de convertir LaTeX au format PNG.

Ainsi, la première chose que nous devons faire (enfin, parfois pas la toute première) est de créer une instance de la classe TeXOptions. La seule méthode statique qui fait cela est ConsoleAppOptions(), alors ne soyons pas intrigués par la signification de son nom. La méthode prend l’ instance get_ObjectLaTeX() de la classe TeXConfig, qui convient parfaitement à la conversion d’un fichier LaTeX. Cette configuration indique au moteur Object TeX de charger le format Object LaTeX et d’être prêt à accepter le fichier LaTeX. Le format Object LaTeX n’est en fait que le format LaTeX, sauf qu’il utilise des primitives spécifiques à Object TeX pour configurer les métriques de la page.

La première des options requises est OutputWorkingDirectory qui définit l’espace, ou la zone, où la sortie TeX sera écrite. Ici sont les détails sur le concept de répertoire de sortie dans Aspose.TeX pour C++. Dans cet exemple, nous utilisons la classe OutputFileSystemDirectory, qui nous permet d’écrire la sortie dans le répertoire ou dossier spécifié.

La deuxième option est une instance de classe SaveOptions qui contrôlera la transformation du modèle objet au format cible. Puisque nous convertissons LaTeX en PNG, c’est l’instance de classe PngSaveOptions, qui nous permet de spécifier la résolution des images de sortie.

Ensuite, nous devons créer une instance de la classe TeXJob. Voulant convertir un fichier LaTeX stocké dans le système de fichiers, nous utilisons cette version du constructeur. Nous devons spécifier le chemin complet du fichier. Sinon, le moteur le recherchera dans le répertoire courant (qui est CurrentDirectory) et ne le trouvera probablement pas. Néanmoins, nous pouvons omettre l’extension si notre fichier possède celle .tex. Le moteur l’ajoutera automatiquement. Le deuxième argument du constructeur est une instance de classe Device. Puisque nous convertissons LaTeX en PNG, il s’agit d’une instance de classe ImageDevice (commune à tous les formats d’image pris en charge). Comme dernier argument, nous passons les options de conversion récemment préparées.

Il ne reste plus qu’à exécuter le travail.

Que l’exécution ait réussi ou non, le premier résultat que nous verrons sera la sortie du terminal. En cas de succès, cela ressemble à ceci :

 1This is ObjectTeX, Version 3.1415926-1.0 (Aspose.TeX 21.8)
 2entering extended mode
 3
 4(<input_directory>\hello-world.ltx
 5LaTeX2e <2011/06/27>
 6(article.cls
 7Document Class: article 2007/10/19 v1.4h Standard LaTeX document class
 8(size10.clo))
 9No file hello-world.aux.
10[1]
11(<output_directory>\hello-world.aux) )
12Output written on hello-world.png (1 page).
13Transcript written on hello-world.log.

Nous retrouverons d’autres “fruits” du travail du moteur dans le dossier que nous avons spécifié comme répertoire de sortie. Il s’agira du fichier de transcription et, le voici !, du ou des fichiers image PNG de sortie principaux.

Une autre façon d’écrire le(s) fichier(s) PNG de sortie principal

Il existe une autre façon d’obtenir des données d’image sous forme de tableau de tableaux d’octets, chaque tableau de la deuxième dimension représente les données d’image d’une page distincte.

 1    // Create conversion options for Object LaTeX format on Object TeX engine extension.
 2    System::SharedPtr<TeXOptions> options = TeXOptions::ConsoleAppOptions(TeXConfig::get_ObjectLaTeX());
 3    // Specify the file system working directory for the output.
 4    options->set_OutputWorkingDirectory(System::MakeObject<OutputFileSystemDirectory>(RunExamples::OutputDirectory));
 5    // Initialize the options for saving in PNG format.
 6    options->set_SaveOptions(System::MakeObject<PngSaveOptions>());
 7    // Run LaTeX to PNG conversion.
 8    System::SharedPtr<ImageDevice> device = System::MakeObject<ImageDevice>();
 9    System::MakeObject<TeXJob>(System::IO::Path::Combine(RunExamples::InputDirectory, u"hello-world.ltx"), device, options)->Run();
10    
11    // Save pages file by file.
12    for (int32_t i = 0; i < device->get_Result()->get_Length(); i++)
13    {
14        {
15            System::SharedPtr<System::IO::Stream> fs = System::IO::File::Open(System::IO::Path::Combine(RunExamples::OutputDirectory, System::String(u"page-") + (i + 1) + u".png"), System::IO::FileMode::Create);
16            // Clearing resources under 'using' statement
17            System::Details::DisposeGuard<1> __dispose_guard_0({ fs});
18            // ------------------------------------------
19            
20            try
21            {
22                fs->Write(device->get_Result()[i], 0, device->get_Result()[i]->get_Length());
23            }
24            catch(...)
25            {
26                __dispose_guard_0.SetCurrentException(std::current_exception());
27            }
28        }
29    }

Le(s) fichier(s) “page-n.png” seront écrits dans n’importe quel chemin que nous spécifions. Contrairement à Sortie PDF, ils dupliqueront les fichiers PNG de sortie écrits dans le répertoire de sortie.

À propos des options de saisie

Dans le cas où notre fichier d’entrée principal nécessite des dépendances, par exemple des packages, qui ne sont pas inclus dans le système LaTeX de base et les packages pris en charge, nous DEVONS définir l’option RequiredInputDirectory de la même manière que nous définissons OutputWorkingDirectory. option et placez les dépendances dans ce répertoire. Les dépendances peuvent être arbitrairement organisées en sous-répertoires. Dans le cas où nous avons nos propres fichiers à inclure tout au long du processus de composition, par exemple des fichiers graphiques externes, nous DEVONS également définir le InputWorkingDirectory en utilisant le chemin d’accès à l’emplacement où ces fichiers sont collectés. Nous pouvons également placer le fichier d’entrée principal quelque part dans le répertoire d’entrée et spécifier le chemin relatif dans la méthode run() (ou ne spécifier aucun chemin si le fichier d’entrée principal est à la racine). Ici sont les détails sur le concept de répertoire d’entrée dans Aspose.TeX pour C++ et les implémentations fournies.

D’autres options de travail TeX sont discutées ici.

Vous pouvez également consulter la conversion gratuite LaTeX vers PNG application Web construite sur la base de l’API Aspose.TeX for .NET. Ici est la page de la version C++.

Ci-dessous, nous discutons de la conversion de LaTeX vers d’autres formats d’image raster pris en charge. Nous n’entrerons pas dans les détails simplement parce qu’il n’y a pas de détails. La seule différence réside dans le type de la propriété SaveOptions dans les options de conversion.

Comment convertir LaTeX en JPEG

1...
2// Initialize the options for saving in JPEG format.
3options->set_SaveOptions(System::MakeObject<JpegSaveOptions>());

Vous pouvez également consulter la conversion gratuite LaTeX vers JPEG application Web construite sur la base de l’API Aspose.TeX for .NET. Ici est la page de la version C++.

Comment convertir LaTeX en TIFF

1...
2// Initialize the options for saving in TIFF format.
3options->set_SaveOptions(System::MakeObject<TiffSaveOptions>());

Vous pouvez également consulter la conversion gratuite LaTeX vers TIFF application Web construite sur la base de l’API Aspose.TeX for .NET. Ici est la page de la version C++.

Comment convertir LaTeX en BMP

1...
2// Initialize the options for saving in BMP format.
3options->set_SaveOptions(System::MakeObject<BmpSaveOptions>());

Vous pouvez également consulter la conversion gratuite LaTeX vers BMP application Web construite sur la base de l’API Aspose.TeX for .NET. Ici est la page de la version C++.

Conversion LaTeX en PDF