RenderPageToMetafileStream
Rendu et impression
Description
Cette fonction n’est disponible que dans l’édition Delphi. Elle effectue le rendu d’une page du document sélectionné dans un TStream sous forme de métafichier Windows (sortie vectorielle), en préservant le texte et le contenu vectoriel de la page au lieu de les rasteriser en pixels
Le Format choisi commande la variante de métafichier : mfEMF emprunte la voie classique du métafichier amélioré GDI (large compatibilité des consommateurs), mfEMFPlus et mfEMFDual empruntent la voie d’enregistrement GDI+ (meilleure fidélité pour la transparence et l’anticrénelage), et mfWMF produit le format hérité 16 bits
mfEMFDual enregistre à la fois les commandes GDI et GDI+ dans le même fichier, afin que les consommateurs anciens limités à GDI puissent continuer à le lire, au prix d’un fichier plus volumineux. Préférez mfEMFPlus lorsque vous savez que le consommateur dispose de GDI+ (Office, Illustrator, visionneuses modernes)
En interne, il s’agit d’un enveloppeur pratique de RenderPageToStream qui convertit Format en une valeur entière de Options ; les DPI restent donc multipliés par le RenderScale propre à l’instance défini via SetRenderScale
Syntaxe
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;Paramètres
| DPI | DPI à utiliser pour le rendu de la page ; contrôle les dimensions du cadre du métafichier ; le contenu vectoriel lui-même est indépendant des DPI |
|---|---|
| Page | Numéro de la page à rendre |
| Format | mfEMF = EMF GDI classique ; mfEMFPlus = EMF+ Only GDI+ ; mfEMFDual = EMF+ Dual GDI+ (enregistrements GDI + GDI+, plus volumineux mais largement compatible) ; mfWMF = WMF 16 bits hérité |
| Target | Flux dans lequel placer les octets du métafichier rendu |
Valeurs de retour
| 0 | La page n’a pas pu être rendue |
|---|---|
| 1 | La page a été rendue correctement et les octets du métafichier ont été écrits dans le flux |