تحويل PNG إلى PDF باستخدام C# .NET - تحويل الصور بسهولة إلى PDF

يخدم تنسيق (PNG) (رسومات الشبكة المحمولة) وPDF(تنسيق المستندات المحمولة) أغراضًا مميزة في العالم الرقمي. يُستخدم تنسيق PNG على نطاق واسع للصور عالية الجودة نظرًا لضغطه الخالي من الفقد ودعمه للشفافية، مما يجعله مثاليًا لتصميم الويب وإنشاء الرسوم والمحتوى المرئي التفصيلي. من ناحية أخرى، يعد تنسيق PDF تنسيقًا عالميًا لمشاركة المستندات والأرشفة، مما يضمن اتساق التخطيط عبر الأجهزة. يعد تحويل تنسيق PNG إلى PDF عملية مفيدة لإنشاء التجميعات وإنشاء التقارير الاحترافية

• واجهة برمجة تطبيقات تحويل الصور
• تحويل PNG إلى PDF
  • تحميل PNG من التخزين السحابي
  • تحميل PNG من محرك الأقراص المحلي
• تحويل PNG إلى PDF عبر الإنترنت باستخدام أوامر cURL

واجهة برمجة تطبيقات تحويل الصور

Aspose.Imaging Cloud هي واجهة برمجة التطبيقات REST المخصصة التي طورناها لتسهيل بحث عملائنا عن إمكانيات معالجة الصور والتلاعب بها في السحابة. يمكنك إجراء عمليات مثل تغيير حجم الصورة، والقص، والتدوير، والتدرج، والانعكاس، والبحث، والتصدير إلى تنسيقات الملفات المدعومة الأخرى. الآن، وفقًا لهذه المقالة، سنستخدم Aspose.Imaging Cloud SDK for .NET وهي عبارة عن غلاف حول Aspose.Imaging Cloud.

تثبيت

تتوفر مجموعة أدوات تطوير البرامج .NET Cloud للتنزيل عبر NuGet وGitHub. يُرجى تنفيذ الأمر التالي في المحطة الطرفية لتثبيت مجموعة أدوات تطوير البرامج عبر NuGet:

nuget install Aspose.Imaging-Cloud

في حالة احتياجك إلى التثبيت من NuGet Package Manager، يرجى تنفيذ الأمر التالي

PM> Install-Package Aspose.Imaging-Cloud

التثبيت في Visual Studio

هناك نهج آخر وهو التثبيت مباشرة داخل Visual Studio:

1. افتح مستكشف الحلول.
2. قم بتوسيع المشروع ثم انقر بزر الماوس الأيمن فوق مجلد الحزم ضمن الحل الخاص بك.
3. حدد خيار إدارة حزم NuGet…
4. انقر فوق علامة التبويب “استعراض” وابحث عن “Aspose.Imaging-Cloud”.
5. انقر فوق مربع الاختيار بجوار حزمة Aspose.Imaging-Cloud، وحدد الإصدار المناسب في علامة التبويب اليمنى وانقر فوق زر إضافة الحزمة.

اشتراك سحابي

الخطوة التالية هي إنشاء حساب اشتراك مجاني من خلال زيارة لوحة تحكم Aspose.Cloud. إذا كان لديك حساب GitHub أو Google، فما عليك سوى التسجيل. وإلا، فانقر فوق الزر إنشاء حساب جديد وقم بتوفير المعلومات المطلوبة.

تحويل PNG إلى PDF

لتحويل صورة PNG إلى تنسيق PDF، يمكننا استخدام أي من واجهتي برمجة التطبيقات التاليتين لإنجاز هذا المطلب:

• احصل على /imaging/{name}/convert
• نشر/تصوير/تحويل

تتوقع واجهة برمجة التطبيقات GET منك أولاً تحميل صورة إلى Cloud Storage ثم إجراء التحويل. بينما تتطلب واجهة برمجة التطبيقات الثانية منك تمرير الصورة مباشرة في نص الطلب ويتم تخزين الناتج النهائي على Cloud Storage.

تحميل PNG من التخزين السحابي

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

• أولاً، نحتاج إلى إنشاء كائن ImagingApi أثناء تمرير تفاصيل معرف العميل والسر الخاص بالعميل كوسائط.
• ثانيًا، قم بتحميل صورة PNG من محرك الأقراص المحلي ومررها كحجة إلى كائن UploadFileRequest.
• ثالثًا، قم باستدعاء طريقة UploadFile(…) من ImagingApi لتحميل الملف إلى التخزين السحابي (يمكنك تخطي هذه الخطوة إذا كانت الصورة متوفرة بالفعل في التخزين السحابي).
• قم بإنشاء مثيل لفئة ConvertImageRequest التي تأخذ اسم الصورة وتنسيق الإخراج الناتج كحجج. أسماء المجلد والتخزين اختيارية.
• الآن قم باستدعاء طريقة ConvertImage(…) من فئة ImagingApi لبدء عملية التحويل.
• أخيرًا، بما أن الاستجابة تحتوي على صورة متدفقة، فيمكننا حفظها على محرك أقراص محلي باستخدام File.Create كائن (يتم عرض الطريقة أدناه).

// احصل على معرف العميل من https://dashboard.aspose.cloud/
string clientSecret = "caac6e3d4a4724b2feb53f4e460eade3";
string clientID = "4ccf1790-accc-41e9-8d18-a78dbb2ed1aa";
 
// مسار ملف الإدخال PNG
string imageFile = "poodle.png";
 
// تنسيق الملف الناتج
string format = "pdf";
 
// اسم مستند PDF الناتج
string resultantFile = "resultant.pdf";

// تحميل الملف من محرك الأقراص المحلي
using (var file = System.IO.File.OpenRead("/Users/nshahbaz/Desktop/" + imageFile))
{
    var uploadFileRequest = new UploadFileRequest(imageFile, file);

    // تحميل المستند الأصلي إلى التخزين السحابي
    imagingApi.UploadFile(uploadFileRequest);
}

try
{
    // إنشاء طلب صورة
    var request = new ConvertImageRequest(imageFile, format, null, null);
    
    // بدء عملية التحويل
    Stream updatedImage = imagingApi.ConvertImage(request);

    // طباعة رسالة النجاح إذا كان التحويل ناجحًا
    if (request != null && request.Equals("OK"))
    {
        Console.WriteLine("The PNG successfully converted to PDF !");
    }
    
    // استدعاء الطريقة لحفظ الإخراج على محرك النظام
    saveToDisk(updatedImage, "/Users/nshahbaz/Desktop/"+resultantFile);
}
catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}  

// طريقة مخصصة لحفظ كائن Steam كمثال للملف
public static void saveToDisk(Stream responseStream, String resultantFile)
{
    var fileStream = File.Create(resultantFile);
    responseStream.Seek(0, SeekOrigin.Begin);
    responseStream.CopyTo(fileStream);
    fileStream.Close();
}

تحميل PNG من محرك الأقراص المحلي

في القسم التالي، سنستخدم واجهة برمجة التطبيقات CreateConvertedImage لتحويل صورة تم تمريرها مباشرة في نص الطلب.

• الخطوة الأولى هي إنشاء كائن ImagingApi والذي يأخذ تفاصيل معرف العميل والسر الخاص بالعميل كوسائط.
• ثانياً، اقرأ صورة PNG من محرك الأقراص المحلي باستخدام الكائن File.OpenRead.
• ثالثًا، قم بإنشاء كائن ConvertedImageRequest الذي يأخذ ImageStream وتنسيق الإخراج كوسائط.
• ثم قم باستدعاء طريقة CreateConvertedImage(…) من ImagingApi لإجراء عملية التحويل.
• وأخيرًا، قم بحفظ ملف PDF الناتج باستخدام الكائن File.Create.

// احصل على معرف العميل من https://dashboard.aspose.cloud/
string clientSecret = "caac6e3d4a4724b2feb53f4e460eade3";
string clientID = "4ccf1790-accc-41e9-8d18-a78dbb2ed1aa";

// مسار ملف الإدخال PNG
string imageFile = "poodle.png";
 
// تنسيق الملف الناتج
string format = "pdf";
 
// اسم مستند PDF الناتج
string resultantFile = "resultant.pdf";

try
{
    using (var imageStream = System.IO.File.OpenRead("/Users/nshahbaz/Desktop/" + imageFile))
    {
         var request = new CreateConvertedImageRequest(imageStream, format, null, null);
         Stream updatedImage = imagingApi.CreateConvertedImage(request);

         if (request != null && request.Equals("OK"))
         {
             Console.WriteLine("PNG successfully converted to PDF !");
         }

         // حفظ الصورة المحدثة في التخزين المحلي
         using (var fileStream = File.Create("/Users/nshahbaz/Desktop/" + resultantFile))
         {
             updatedImage.Seek(0, SeekOrigin.Begin);
             updatedImage.CopyTo(fileStream);
         }
     }
}
catch (Exception ex)
{
    Console.WriteLine("error:" + ex.Message + "\n" + ex.StackTrace);
}

يمكنك التفكير في تنزيل الملف المدخل poodle.png والملف المحول resultant.pdf لأغراض الاختبار.

تحويل PNG إلى PDF عبر الإنترنت باستخدام أوامر cURL

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

curl -v "https://api.aspose.cloud/connect/token" \
-X POST \
-d "grant_type=client_credentials&client_id=4ccf1790-accc-41e9-8d18-a78dbb2ed1aa&client_secret=caac6e3d4a4724b2feb53f4e460eade3" \
-H "Content-Type: application/x-www-form-urlencoded" \
-H "Accept: application/json"

بمجرد إنشاء رمز الوصول، يرجى تنفيذ الأمر التالي لتحويل صورة PNG المتوفرة في التخزين السحابي إلى تنسيق PDF. ثم يتم تخزين ملف PDF الناتج على محرك أقراص محلي.

curl -X GET "https://api.aspose.cloud/v3.0/imaging/poodle.png/convert?format=pdf" \
-H  "accept: application/json" \
-H  "authorization: Bearer <JWT Token>" \
-o /Users/nshahbaz/Desktop/myResultant.pdf

محول PNG إلى PDF مجاني

من أجل أن تشهد القدرات المذهلة لـ Cloud API لتحويل صور PNG إلى PDF، يمكنك تجربة استخدام تطبيقنا محول PNG إلى Acrobat 3D PDF المجاني عبر الإنترنت.

خاتمة

في هذه المقالة، استكشفنا قدرات Aspose.Imaging Cloud لتحويل تنسيق PNG إلى تنسيق PDF. كما لاحظنا أنه يمكن إجراء التحويل باستخدام .NET Cloud SDK بالإضافة إلى الأمر cURL. كما قدمنا Swagger UI حتى تتمكن من اختبار واجهة برمجة التطبيقات REST مباشرةً داخل المتصفح.

كما يرجى ملاحظة أن Cloud SDK يتم توزيعه بموجب ترخيص MIT ويمكن تنزيل الكود المصدر الكامل الخاص به عبر GitHub. في حالة مواجهة أي مشكلات أو وجود أي استفسارات أثناء استخدام واجهة برمجة التطبيقات، فلا تتردد في الاتصال بنا من خلال منتدى دعم المنتج المجاني.

مقالات ذات صلة

وننصحك أيضًا بزيارة الروابط التالية لمعرفة المزيد عن:

• JPG إلى PNG – تحويل JPG إلى PNG في C#
• استخراج إطار من صورة TIFF متعددة الإطارات باستخدام واجهة برمجة تطبيقات C# REST
• دمج صور JPEG عبر الإنترنت في C#