تبدیل اسلایدهای ارائه به تصاویر در PHP

معرفی

Aspose.Slides for PHP via Java به شما امکان می‌دهد به سادگی اسلایدهای ارائه PowerPoint و OpenDocument را به فرمت‌های تصویری مختلفی مانند BMP، PNG، JPG (JPEG)، GIF و غیره تبدیل کنید.

برای تبدیل یک اسلاید به تصویر، مراحل زیر را دنبال کنید:

تنظیمات تبدیل مورد نظر را تعریف کنید و اسلایدهایی که می‌خواهید صادر کنید را با استفاده از:
- کلاس TiffOptions یا
- کلاس RenderingOptions
تصویر اسلاید را با فراخوانی متد getImage تولید کنید.

در Aspose.Slides for PHP via Java، IImage کلاسیاست که به شما امکان کار با تصاویری را می‌دهد که با داده‌های پیکسل تعریف شده‌اند. می‌توانید از این کلاس برای ذخیره تصاویر در طیف گسترده‌ای از فرمت‌ها (BMP، JPG، PNG و غیره) استفاده کنید.

تبدیل اسلایدها به بیت‌مپ‌ها و ذخیره تصاویر در قالب PNG

شما می‌توانید یک اسلاید را به یک شی بیت‌مپ تبدیل کنید و مستقیماً در برنامه خود استفاده نمایید. به‌علاوه، می‌توانید اسلاید را به بیت‌مپ تبدیل کرده و سپس تصویر را در قالب JPEG یا هر فرمت دلخواه دیگری ذخیره کنید.

این کد نحوه تبدیل اولین اسلاید یک ارائه به شی بیت‌مپ و سپس ذخیره تصویر در قالب PNG را نشان می‌دهد:

$presentation = new Presentation("Presentation.pptx");
try {
    // تبدیل اولین اسلاید در ارائه به یک بیت‌مپ.
    $image = $presentation->getSlides()->get_Item(0)->getImage();
    try {
        // ذخیره تصویر در قالب PNG.
        $image->save("Slide_0.png", ImageFormat::Png);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

تبدیل اسلایدها به تصاویر با اندازه‌های سفارشی

ممکن است نیاز داشته باشید تصویر با اندازه‌ای خاص دریافت کنید. با استفاده از overload متد getImage، می‌توانید اسلاید را به تصویری با ابعاد مشخص (عرض و ارتفاع) تبدیل کنید.

این کد نمونه نحوه انجام این کار را نمایش می‌دهد:

$imageSize = new Java("java.awt.Dimension", 1820, 1040);

$presentation = new Presentation("Presentation.pptx");
try {
    // تبدیل اولین اسلاید در ارائه به یک بیت‌مپ با اندازه مشخص.
    $image = $presentation->getSlides()->get_Item(0)->getImage($imageSize);
    try {
        // ذخیره تصویر در قالب JPEG.
        $image->save("Slide_0.jpg", ImageFormat::Jpeg);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

تبدیل اسلایدها با یادداشت‌ها و نظرات به تصاویر

برخی اسلایدها ممکن است شامل یادداشت‌ها و نظرات باشند.

Aspose.Slides دو کلاس TiffOptions و RenderingOptions را فراهم می‌کند که به شما امکان کنترل رندر کردن اسلایدهای ارائه به تصاویر را می‌دهد. هر دو کلاس شامل متد setSlidesLayoutOptions هستند که به شما اجازه می‌دهد رندر کردن یادداشت‌ها و نظرات بر روی اسلاید هنگام تبدیل به تصویر را تنظیم کنید.

با کلاس NotesCommentsLayoutingOptions می‌توانید موقعیت دلخواهتان برای یادداشت‌ها و نظرات را در تصویر نهایی تعیین کنید.

این کد نحوه تبدیل اسلایدی که شامل یادداشت‌ها و نظرات است را نشان می‌دهد:

$scaleX = 2;
$scaleY = $scaleX;

$presentation = new Presentation("Presentation_with_notes_and_comments.pptx");
try {
    $notesCommentsOptions = new NotesCommentsLayoutingOptions();
    $notesCommentsOptions->setNotesPosition(NotesPositions::BottomTruncated);         // موقعیت یادداشت‌ها را تنظیم کنید.
    $notesCommentsOptions->setCommentsPosition(CommentsPositions::Right);             // موقعیت نظرات را تنظیم کنید.
    $notesCommentsOptions->setCommentsAreaWidth(500);                                 // عرض ناحیه نظرات را تنظیم کنید.
    $notesCommentsOptions->setCommentsAreaColor(java("java.awt.Color")->LIGHT_GRAY);  // رنگ ناحیه نظرات را تنظیم کنید.

    // گزینه‌های رندرینگ را ایجاد کنید.
    $options = new RenderingOptions();
    $options->setSlidesLayoutOptions($notesCommentsOptions);

    // اولین اسلاید ارائه را به تصویر تبدیل کنید.
    $image = $presentation->getSlides()->get_Item(0)->getImage($options, $scaleX, $scaleY);
    try {
        // تصویر را در قالب GIF ذخیره کنید.
        $image->save("Image_with_notes_and_comments_0.gif", ImageFormat::Gif);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

Note

در هر فرآیند تبدیل اسلاید به تصویر، متد setNotesPosition نمی‌تواند مقدار BottomFull را اعمال کند (برای تعیین موقعیت یادداشت‌ها) زیرا متن یک یادداشت ممکن است بیش از حد بزرگ باشد و نتواند در اندازه تصویر مشخص شده جا بگیرد.

تبدیل اسلایدها به تصاویر با استفاده از گزینه‌های TIFF

کلاس TiffOptions کنترل بیشتری بر تصویر TIFF خروجی فراهم می‌کند و به شما امکان مشخص کردن پارامترهایی مانند اندازه، وضوح، پالت رنگ و غیره را می‌دهد.

این کد یک فرآیند تبدیل را نشان می‌دهد که در آن گزینه‌های TIFF برای خروجی تصویر سیاه و سفید با وضوح 300 DPI و اندازه 2160 × 2800 استفاده می‌شود:

// بارگذاری فایل ارائه.
$presentation = new Presentation("sample.pptx");
try {
    // دریافت اولین اسلاید از ارائه.
    $slide = $presentation->getSlides()->get_Item(0);

    // پیکربندی تنظیمات تصویر خروجی TIFF.
    $options = new TiffOptions();
    $options->setImageSize(new Java("java.awt.Dimension", 2160, 2880));  // تنظیم اندازه تصویر.
    $options->setPixelFormat(ImagePixelFormat::Format1bppIndexed);       // تنظیم قالب پیکسل (سیاه و سفید).
    $options->setDpiX(300);                                              // تنظیم وضوح افقی.
    $options->setDpiY(300);                                              // تنظیم وضوح عمودی.
    
    // تبدیل اسلاید به تصویر با گزینه‌های مشخص شده.
    $image = $slide->getImage($options);
    try {
        // ذخیره تصویر در قالب TIFF.
        $image->save("output.tiff", ImageFormat::Tiff);
    } finally {
        $image->dispose();
    }
} finally {
    $presentation->dispose();
}

Note

پشتیبانی از TIFF در نسخه‌های قبل از JDK 9 تضمین نشده است.

تبدیل تمام اسلایدها به تصاویر

Aspose.Slides به شما امکان می‌دهد تمام اسلایدهای یک ارائه را به تصاویر تبدیل کنید و به‌صورت مؤثری تمام ارائه را به مجموعه‌ای از تصاویر تبدیل نمایید.

این کد نمونه نشان می‌دهد که چگونه تمام اسلایدهای یک ارائه را در PHP به تصاویر تبدیل کنید:

$scaleX = 2;
$scaleY = $scaleX;

$presentation = new Presentation("Presentation.pptx");
try {
    // رندر کردن ارائه به تصاویر اسلاید به اسلاید.
    for($i = 0; $i < java_values($presentation->getSlides()->size()) ; $i++) {
        // کنترل اسلایدهای مخفی (اسلایدهای مخفی رندر نمی‌شوند).
        if (java_values($presentation->getSlides()->get_Item($i)->getHidden())) {
            continue;
        }

        // تبدیل اسلاید به تصویر.
        $image = $presentation->getSlides()->get_Item($i)->getImage($scaleX, $scaleY);
        try {
            // ذخیره تصویر در قالب JPEG.
            $image->save("Slide_" . $i . ".jpg", ImageFormat::Jpeg);
        } finally {
            $image->dispose();
        }
    }
} finally {
    $presentation->dispose();
}

سوالات متداول

آیا Aspose.Slides از رندر کردن اسلایدها با انیمیشن‌ها پشتیبانی می‌کند؟

خیر، متد getImage فقط یک تصویر ثابت از اسلاید را ذخیره می‌کند و انیمیشن‌ها را شامل نمی‌شود.

آیا می‌توان اسلایدهای مخفی را به عنوان تصویر صادر کرد؟

بله، اسلایدهای مخفی می‌توانند همانند اسلایدهای عادی پردازش شوند. فقط مطمئن شوید که در حلقه پردازش گنجانده شده‌اند.

آیا می‌توان تصاویر را با سایه‌ها و افکت‌ها ذخیره کرد؟

بله، Aspose.Slides رندر کردن سایه‌ها، شفافیت و سایر افکت‌های گرافیکی را هنگام ذخیره اسلایدها به عنوان تصویر پشتیبانی می‌کند.

حذف اسلایدها از ارائه‌ها در PHP مقایسه اسلایدهای ارائه در PHP