RenderPageToMetafileStream

Rendering and printing

Description

פונקציה זו זמינה רק בגרסת Delphi; היא מרנדרת דף מהמסמך שנבחר לתוך TStream כ-Windows metafile (פלט וקטורי), תוך שמירה על הטקסט ותוכן הווקטור של הדף במקום רסטריזציה שלו פיקסלים

הפורמט הנבחר שולט בגרסת ה-metafile: פורמט mfEMF משתמש בנתיב enhanced-metafile הקלאסי של GDI (תאימות רחבה לצרכנים), הפורמטים mfEMFPlus ו-mfEMFDual משתמשים בנתיב ההקלטה של GDI+ (נאמנות טובה יותר לשקיפות והחלקת קצוות - anti-aliasing), ו-mfWMF מייצר את הפורמט המיושן של 16-bit

הפורמט mfEMFDual רושם הן פקודות GDI והן פקודות GDI+ באותו קובץ כך שצרכנים ישנים התומכים ב-GDI בלבד עדיין יוכלו לקרוא אותו במחיר של גודל קובץ גדול יותר; העדף את mfEMFPlus כאשר ידוע כי הצרכן תומך ב-GDI+ (Office, Illustrator, צופים מודרניים)

באופן פנימי, זוהי עטיפת נוחות מעל RenderPageToStream הממפה את ה-Format לערך Options של מספר שלם, כך שה-DPI עדיין מוכפל ב-RenderScale לכל מופע שהוגדר באמצעות SetRenderScale

Syntax

Delphi

Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;

Parameters

DPIה-DPI שבו יש להשתמש בעת רינדור הדף; שולט בממדי מסגרת ה-metafile; תוכן וקטורי עצמו אינו תלוי ב-DPI
Pageמספר הדף לרינדור
FormatmfEMF = קובץ EMF קלאסי של GDI; mfEMFPlus = קובץ EMF+ של GDI+ בלבד; mfEMFDual = קובץ EMF+ Dual של GDI+ (רשומות GDI + GDI+, גדול יותר אך תואם באופן נרחב); mfWMF = קובץ WMF מיושן של 16-bit
Targetהזרם שבו יש למקם את בייטי ה-metafile המרונדרים

Return values

0לא ניתן היה לרנדר את הדף
1הדף רונדר כהלכה ובייטי ה-metafile נכתבו לזרם