RenderPagesToFilesParallel
Rendering and printing
Description
يرندر كل صفحة من StartPage إلى EndPage لملف PDF المصدر إلى ملف صورة واحد لكل صفحة، باستخدام تجمع من عمال TTask المتوازيين؛ ينشئ كل عامل مثيلاً خاصاً به من TPDFlib على نفس الملف (علماً بأن TPDFlib ليس آمناً برمجياً للخيوط المتعددة)، ويقوم باستدعاء CoInitializes للخيط الخاص به لضمان أمان شقة GDI+، ويرندر الصفحات التي يتم أخذها من عداد ذري مشترك حتى ينفد النطاق
يتناسب هذا خطيًا تقريبًا مع نوى CPU لمخرجات البيانات النقطية المقيدة بـ CPU (مثل BMP/PNG/TIFF)؛ ويتحكم MaxWorkers في عرض التجمع؛ مرر 0 أو قيمة سالبة للمستوى التلقائي (الحد الأدنى لعدد الصفحات وعدد CPU)؛ ميزة خاصة بنظام Windows فقط: CoInitialize و GDI+ هما بدائيات نظام Windows
Syntax
Delphi
Function TPDFlib.RenderPagesToFilesParallel(Const FileName, Password: WideString; DPI: Double; StartPage, EndPage, Options: Integer; Const OutputPattern: WideString; MaxWorkers: Integer): Integer;Parameters
| FileName, Password | مسار مستند PDF المصدر وكلمة المرور الخاصة به (فارغ إذا كان غير مشفر) |
|---|---|
| DPI | Render resolution |
| StartPage, EndPage | نطاق الصفحات الشامل المستند إلى 1 |
| Options | التنسيق (مثل RenderPageToFile: 0=BMP 1=JPEG 5=PNG ...) |
| OutputPattern | مسار الإخراج؛ يتم استبدال '%p' برقم الصفحة، وإلا يتم إلحاق الرقم |
| MaxWorkers | عرض التجمع (0 = تلقائي، بحد أقصى عدد الصفحات وعدد المعالجات CPU) |
Return values
| >= 0 | عدد الصفحات التي تم تقديمها بنجاح (فشل الصفحة الواحدة معزول وليس خطيرًا) |
|---|