اتجاه الصفحة حسب أبعاد الصورة

في هذا البرنامج التعليمي، سنرشدك خلال عملية تحديد اتجاه الصفحة استنادًا إلى أبعاد الصورة باستخدام Aspose.PDF لـ .NET. سنقوم باستعراض قائمة صور JPG في دليل معين ونقوم تلقائيًا بضبط اتجاه الصفحة بناءً على عرض كل صورة. اتبع الخطوات أدناه لتحقيق ذلك.

المتطلبات الأساسية

قبل البدء، تأكد من استيفاء المتطلبات الأساسية التالية:

• المعرفة الأساسية بلغة البرمجة C#.
• مكتبة Aspose.PDF لـ .NET مثبتة على نظامك.
• بيئة تطوير مثل Visual Studio.

الخطوة 1: تصفح صور JPG

في هذه الخطوة، سوف نقوم باستعراض جميع صور JPG في دليل معين. اتبع الكود أدناه:

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENTS DIRECTORY";

// إنشاء مستند PDF جديد
Aspose.Pdf.Document doc = new Aspose.Pdf.Document();

// استرداد أسماء كافة ملفات JPG في دليل معين
string[] fileEntries = Directory.GetFiles(dataDir, "*.JPG");

تأكد من استبدال"YOUR DOCUMENTS DIRECTORY" مع الدليل الفعلي الذي توجد به صور JPG الخاصة بك.

الخطوة الثانية: إنشاء الصفحة والصورة

بعد تصفح ملفات JPG، سنقوم بإنشاء صفحة وصورة لكل ملف. استخدم الكود التالي:

int counter;
for (counter = 0; counter < fileEntries.Length - 1; counter++)
{
// قم بإنشاء كائن الصفحة
Aspose.Pdf.Page page = doc.Pages.Add();

// إنشاء كائن صورة
Aspose.Pdf.Image image1 = new Aspose.Pdf.Image();
image1.File = fileEntries[counter];

الخطوة 3: التحقق من أبعاد الصورة

الآن دعونا نتحقق من أبعاد كل صورة لتحديد اتجاه الصفحة. استخدم الكود التالي:

// قم بإنشاء كائن BitMap للحصول على معلومات من ملف الصورة
Bitmap myimage = new Bitmap(fileEntries[counter]);

// تحقق مما إذا كان عرض الصورة أكبر من عرض الصفحة أم لا
if (myimage.Width > page.PageInfo.Width)
//

  If the width of the image is greater than the width of the page, set the page orientation to landscape
page.PageInfo.IsLandscape = true;
else
// إذا كان عرض الصورة أقل من عرض الصفحة، فاضبط اتجاه الصفحة على الوضع العمودي
page.PageInfo.IsLandscape = false;

الخطوة 4: إضافة الصورة إلى مستند PDF

بعد التحقق من أبعاد الصورة، سنقوم بإضافة الصورة إلى مجموعة فقرات وثيقة PDF. استخدم الكود التالي:

// أضف الصورة إلى مجموعة الفقرات في مستند PDF
page.Paragraphs.Add(image1);

الخطوة 5: حفظ ملف PDF

بمجرد إضافة جميع الصور إلى مستند PDF، يمكننا الآن حفظ ملف PDF الناتج. هذه هي الخطوة الأخيرة:

// احفظ ملف PDF
doc.Save(dataDir + "SetPageOrientation_out.pdf");

يستبدل"YOUR DOCUMENTS DIRECTORY" مع الدليل المطلوب حيث تريد حفظ ملف PDF الناتج.

مثال على التعليمات البرمجية المصدر لاتجاه الصفحة وفقًا لأبعاد الصورة باستخدام Aspose.PDF لـ .NET

// المسار إلى دليل المستندات.
string dataDir = "YOUR DOCUMENT DIRECTORY";

Aspose.Pdf.Document doc = new Aspose.Pdf.Document();

// استرجع أسماء جميع ملفات JPG في دليل معين
string[] fileEntries = Directory.GetFiles(dataDir, "*.JPG");

int counter;
for (counter = 0; counter < fileEntries.Length - 1; counter++)
{
	// إنشاء كائن الصفحة
	Aspose.Pdf.Page page = doc.Pages.Add();

	// إنشاء كائن الصورة
	Aspose.Pdf.Image image1 = new Aspose.Pdf.Image();
	image1.File = fileEntries[counter];

	// قم بإنشاء كائن BitMap للحصول على معلومات ملف الصورة
	Bitmap myimage = new Bitmap(fileEntries[counter]);
	// تحقق مما إذا كان عرض ملف الصورة أكبر من عرض الصفحة أم لا
	if (myimage.Width > page.PageInfo.Width)
		// إذا كان عرض الصورة أكبر من عرض الصفحة، فاضبط اتجاه الصفحة على أفقي
		page.PageInfo.IsLandscape = true;
	else
		// إذا كان عرض الصورة أقل من عرض الصفحة، فاضبط اتجاه الصفحة على عمودي
		page.PageInfo.IsLandscape = false;
	// إضافة الصورة إلى مجموعة الفقرات من وثيقة PDF
	page.Paragraphs.Add(image1);
}
// احفظ ملف PDF
doc.Save(dataDir + "SetPageOrientation_out.pdf");

خاتمة

في هذا البرنامج التعليمي، قمنا بتغطية العملية خطوة بخطوة لتحديد اتجاه الصفحة استنادًا إلى أبعاد الصورة باستخدام Aspose.PDF لـ .NET. باتباع الإرشادات الموضحة أعلاه، يجب أن تكون الآن قادرًا على إنشاء مستند PDF مع اتجاه الصفحة الصحيح لكل صورة. تكون هذه الميزة مفيدة عندما يكون لديك صور بأحجام مختلفة وتريد تضمينها في مستند PDF.

الأسئلة الشائعة

س: هل يمكنني استخدام تنسيقات صور أخرى بدلاً من JPG لتعيين اتجاه الصفحة بناءً على أبعاد الصورة؟

ج: نعم، يمكنك استخدام تنسيقات صور أخرى مثل PNG أو BMP أو GIF بالإضافة إلى JPG لتعيين اتجاه الصفحة بناءً على أبعاد الصورة. يتم تكرار التعليمات البرمجية المتوفرة عبر جميع ملفات الصور ذات الامتداد “.JPG”، ولكن يمكنك تعديلها لتشمل تنسيقات صور أخرى أيضًا.

س: ماذا يحدث إذا كانت أبعاد الصورة مساوية تمامًا لعرض الصفحة؟

ج: إذا كان عرض الصورة مساويًا تمامًا لعرض الصفحة، فسيتم تعيين اتجاه الصفحة على الوضع العمودي. في التعليمات البرمجية المقدمة، يتم تعيين اتجاه الصفحة إلى الوضع الأفقي فقط إذا كان عرض الصورة أكبر من عرض الصفحة.

س: هل يمكنني تخصيص منطق اتجاه الصفحة بناءً على متطلبات محددة؟

ج: نعم، يمكنك تخصيص منطق اتجاه الصفحة بناءً على متطلبات محددة. على سبيل المثال، يمكنك تعيين قيمة عتبة لتحديد متى يجب تعيين اتجاه الصفحة إلى أفقي أو عمودي. بالإضافة إلى ذلك، يمكنك مراعاة عوامل مثل ارتفاع الصورة أو نسبة العرض إلى الارتفاع لتحديد اتجاه الصفحة.

س: هل يمكنني إضافة محتوى آخر، مثل النص أو الجداول، إلى مستند PDF مع الصور؟

ج: نعم، يمكنك إضافة محتوى آخر، مثل النص أو الجداول، إلى مستند PDF مع الصور. يوفر Aspose.PDF for .NET مجموعة غنية من الميزات لمعالجة مستندات PDF، بما في ذلك إضافة النصوص والصور والجداول والعناصر الأخرى إلى الصفحات.