مدیریت پس‌زمینه‌های ارائه در پایتون از طریق جاوا

این صفحه درباره چیست

یاد بگیرید چگونه پس‌زمینه‌های پویا را در فایل‌های PowerPoint و OpenDocument با استفاده از Aspose.Slides برای پایتون از طریق جاوا تنظیم کنید، همراه با نکات کد برای بهبود ارائه‌های شما.

مقدمه

رنگ‌های ثابت، گرادیان‌ها و تصاویر معمولاً برای پس‌زمینهٔ اسلایدها استفاده می‌شوند. می‌توانید پس‌زمینه را برای یک اسلاید معمولی (یک اسلاید تک) یا یک اسلاید مستر (که بر روی چندین اسلاید به‌صورت همزمان اعمال می‌شود) تنظیم کنید.

پس‌زمینه PowerPoint

تنظیم پس‌زمینهٔ رنگ ثابت برای اسلاید معمولی

Aspose.Slides به شما امکان می‌دهد یک رنگ ثابت را به‌عنوان پس‌زمینهٔ یک اسلاید خاص در یک ارائه تنظیم کنید — حتی اگر ارائه از اسلاید مستر استفاده کند. این تغییر فقط بر روی اسلاید انتخاب‌شده اعمال می‌شود.

یک نمونه از کلاس Presentation ایجاد کنید.
ویژگی BackgroundType اسلاید را به OwnBackground تنظیم کنید.
ویژگی FillType پس‌زمینه اسلاید را به Solid تنظیم کنید.
از متد getSolidFillColor در FillFormat برای مشخص کردن رنگ پس‌زمینهٔ ثابت استفاده کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

مثال زیر به زبان پایتون نشان می‌دهد چگونه یک رنگ آبی ثابت را به‌عنوان پس‌زمینهٔ اسلاید معمولی تنظیم کنید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat
from java.awt import Color

# یک نمونه از کلاس Presentation ایجاد کنید.
presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # رنگ پس‌زمینه اسلاید را به آبی تنظیم کنید.
    slide.getBackground().setType(BackgroundType.OwnBackground)
    slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.BLUE)

    # ارائه را روی دیسک ذخیره کنید.
    presentation.save("SolidColorBackground.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تنظیم پس‌زمینهٔ رنگ ثابت برای اسلاید مستر

Aspose.Slides به شما امکان می‌دهد یک رنگ ثابت را به‌عنوان پس‌زمینهٔ اسلاید مستر در یک ارائه تنظیم کنید. اسلاید مستر به‌عنوان الگو عمل می‌کند و قالب‌بندی تمام اسلایدها را کنترل می‌کند، بنابراین وقتی یک رنگ ثابت برای پس‌زمینهٔ اسلاید مستر انتخاب می‌کنید، این رنگ بر تمام اسلایدها اعمال می‌شود.

یک نمونه از کلاس Presentation ایجاد کنید.
ویژگی BackgroundType (از طریق متد getMasters) اسلاید مستر را به OwnBackground تنظیم کنید.
ویژگی FillType پس‌زمینه اسلاید مستر را به Solid تنظیم کنید.
از متد getSolidFillColor برای مشخص کردن رنگ پس‌زمینهٔ ثابت استفاده کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

مثال زیر به زبان پایتون نشان می‌دهد چگونه یک رنگ ثابت (سبز) را به‌عنوان پس‌زمینهٔ اسلاید مستر تنظیم کنید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat
from java.awt import Color

# یک نمونه از کلاس Presentation ایجاد کنید.
presentation = Presentation()
try:
    master_slide = presentation.getMasters().get_Item(0)

    # رنگ پس‌زمینه اسلاید مستر را به سبز تنظیم کنید.
    master_slide.getBackground().setType(BackgroundType.OwnBackground)
    master_slide.getBackground().getFillFormat().setFillType(FillType.Solid)
    master_slide.getBackground().getFillFormat().getSolidFillColor().setColor(Color.GREEN)

    # ارائه را روی دیسک ذخیره کنید.
    presentation.save("MasterSlideBackground.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تنظیم پس‌زمینهٔ گرادیان برای اسلاید

گرادیان یک اثر گرافیکی است که با تغییر تدریجی رنگ ایجاد می‌شود. هنگام استفاده به‌عنوان پس‌زمینهٔ اسلاید، گرادیان‌ها می‌توانند ظاهر ارائه را هنری‌تر و حرفه‌ای‌تر کنند. Aspose.Slides به شما امکان می‌دهد یک رنگ گرادیان را به‌عنوان پس‌زمینهٔ اسلایدها تنظیم کنید.

یک نمونه از کلاس Presentation ایجاد کنید.
ویژگی BackgroundType اسلاید را به OwnBackground تنظیم کنید.
ویژگی FillType پس‌زمینه اسلاید را به Gradient تنظیم کنید.
از متد getGradientFormat در FillFormat برای پیکربندی تنظیمات دلخواه گرادیان استفاده کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

مثال زیر به زبان پایتون نشان می‌دهد چگونه یک رنگ گرادیان را به‌عنوان پس‌زمینهٔ اسلاید تنظیم کنید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Presentation, SaveFormat, TileFlip
from java.awt import Color

# یک نمونه از کلاس Presentation ایجاد کنید.
presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # یک افکت گرادیان را به پس‌زمینه اعمال کنید.
    slide.getBackground().setType(BackgroundType.OwnBackground)
    slide.getBackground().getFillFormat().setFillType(FillType.Gradient)

    gradient_format = slide.getBackground().getFillFormat().getGradientFormat()
    gradient_format.setTileFlip(TileFlip.FlipBoth)

    # رنگ‌های گرادیان را اضافه کنید. بدون نقاط توقف گرادیان، پس‌زمینه به یک رنگ‌پاله پیش‌فرض سیاه‑به‑سفید باز می‌گردد.
    gradient_format.getGradientStops().add(0.0, Color.CYAN)
    gradient_format.getGradientStops().add(1.0, Color.BLUE)

    # ارائه را روی دیسک ذخیره کنید.
    presentation.save("GradientBackground.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

تنظیم تصویر به‌عنوان پس‌زمینهٔ اسلاید

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

یک نمونه از کلاس Presentation ایجاد کنید.
ویژگی BackgroundType اسلاید را به OwnBackground تنظیم کنید.
ویژگی FillType پس‌زمینه اسلاید را به Picture تنظیم کنید.
تصویری که می‌خواهید به‌عنوان پس‌زمینهٔ اسلاید استفاده کنید را بارگذاری کنید.
تصویر را به مجموعهٔ تصاویر ارائه اضافه کنید.
از متد getPictureFillFormat در FillFormat برای اختصاص تصویر به‌عنوان پس‌زمینه استفاده کنید.
ارائهٔ تغییر یافته را ذخیره کنید.

مثال زیر به زبان پایتون نشان می‌دهد چگونه یک تصویر را به‌عنوان پس‌زمینهٔ اسلاید تنظیم کنید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import BackgroundType, FillType, Images, PictureFillMode, Presentation, SaveFormat

# یک نمونه از کلاس Presentation ایجاد کنید.
presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)

    # ویژگی‌های تصویر پس‌زمینه را تنظیم کنید.
    slide.getBackground().setType(BackgroundType.OwnBackground)
    slide.getBackground().getFillFormat().setFillType(FillType.Picture)
    slide.getBackground().getFillFormat().getPictureFillFormat().setPictureFillMode(PictureFillMode.Stretch)

    # تصویر را بارگذاری کنید.
    image = Images.fromFile("Tulips.jpg")
    # تصویر را به مجموعهٔ تصاویر ارائه اضافه کنید.
    presentation_image = presentation.getImages().addImage(image)
    image.dispose()

    slide.getBackground().getFillFormat().getPictureFillFormat().getPicture().setImage(presentation_image)

    # ارائه را روی دیسک ذخیره کنید.
    presentation.save("ImageAsBackground.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

نمونهٔ کد زیر نشان می‌دهد چگونه نوع پرشدگی پس‌زمینه را به یک تصویر کاشی‌شده تنظیم کنید و ویژگی‌های کاشی‌بندی را تغییر دهید:

import jpway
import asposeslides

if not jpway.isJVMStarted():
    jpway.startJVM()

from asposeslides.api import BackgroundType, FillType, Images, PictureFillMode, Presentation, RectangleAlignment, SaveFormat, TileFlip

presentation = Presentation()
try:
    first_slide = presentation.getSlides().get_Item(0)

    background = first_slide.getBackground()

    background.setType(BackgroundType.OwnBackground)
    background.getFillFormat().setFillType(FillType.Picture)

    new_image = Images.fromFile("image.png")
    presentation_image = presentation.getImages().addImage(new_image)
    new_image.dispose()

    # تنظیم تصویر مورد استفاده برای پر شدن پس‌زمینه.
    background_picture_fill_format = background.getFillFormat().getPictureFillFormat()
    background_picture_fill_format.getPicture().setImage(presentation_image)

    # تنظیم حالت پر شدن تصویر به Tile و تنظیم ویژگی‌های کاشی.
    background_picture_fill_format.setPictureFillMode(PictureFillMode.Tile)
    background_picture_fill_format.setTileOffsetX(15.0)
    background_picture_fill_format.setTileOffsetY(15.0)
    background_picture_fill_format.setTileScaleX(46.0)
    background_picture_fill_format.setTileScaleY(87.0)
    background_picture_fill_format.setTileAlignment(RectangleAlignment.Center)
    background_picture_fill_format.setTileFlip(TileFlip.FlipY)

    presentation.save("TileBackground.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

Note

بیشتر بخوانید: Tile Picture as Texture.

تغییر شفافیت تصویر پس‌زمینه

ممکن است بخواهید شفافیت تصویر پس‌زمینهٔ اسلاید را تنظیم کنید تا محتوای اسلاید بیشتر به چشم بیاید. کد پایتون زیر نشان می‌دهد چگونه شفافیت تصویر پس‌زمینهٔ اسلاید را تغییر دهید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import AlphaModulateFixed, Presentation, SaveFormat

transparency_value = 30  # برای مثال.

presentation = Presentation("sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # دریافت مجموعهٔ عملیات تبدیل تصویر.
    image_transform = slide.getBackground().getFillFormat().getPictureFillFormat().getPicture().getImageTransform()

    # پیدا کردن یک اثر شفافیت ثابت‑درصد موجود.
    transparency_operation = None
    for operation in image_transform:
        if isinstance(operation, AlphaModulateFixed):
            transparency_operation = operation
            break

    # تنظیم مقدار شفافیت جدید.
    if transparency_operation is None:
        image_transform.addAlphaModulateFixedEffect(100 - transparency_value)
    else:
        transparency_operation.setAmount(100 - transparency_value)

    presentation.save("output.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()

دریافت مقدار پس‌زمینهٔ اسلاید

Aspose.Slides به شما اجازه می‌دهد مقادیر موثر پس‌زمینهٔ یک اسلاید را با استفاده از متد getEffective در Background دریافت کنید. داده‌های بازگشتی شامل فرمت پرشدگی و اثرات موثر هستند.

با استفاده از متد getBackground در کلاس BaseSlide می‌توانید پس‌زمینهٔ یک اسلاید را دریافت کنید.

مثال زیر به زبان پایتون نشان می‌دهد چگونه مقدار پس‌زمینهٔ موثر یک اسلاید را دریافت کنید:

import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import FillType, Presentation

# یک نمونه از کلاس Presentation ایجاد کنید.
presentation = Presentation("Sample.pptx")
try:
    slide = presentation.getSlides().get_Item(0)

    # پس‌زمینهٔ موثر را دریافت کنید، با در نظر گرفتن مستر، لِی‌اوت و تم.
    effective_background = slide.getBackground().getEffective()

    if effective_background.getFillFormat().getFillType() == FillType.Solid:
        print("Fill color:", effective_background.getFillFormat().getSolidFillColor())
    else:
        print("Fill type:", effective_background.getFillFormat().getFillType())
finally:
    presentation.dispose()

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

آیا می‌توانم پس‌زمینهٔ سفارشی را بازنشانی کنم و پس‌زمینهٔ قالب/چیدمان را بازیابی کنم؟

بله. پرکردن سفارشی اسلاید را حذف کنید؛ پس‌زمینه دوباره از اسلاید layout/master مربوطه (یعنی theme background) ارث‌بری می‌شود.

اگر بعداً قالب ارائه را تغییر دهم، چه اتفاقی برای پس‌زمینه می‌افتد؟

اگر یک اسلاید پرشدگی اختصاصی داشته باشد، بدون تغییر باقی می‌ماند. اگر پس‌زمینه از layout/master ارث‌بری شده باشد، با قالب جدید به‌روزرسانی می‌شود.

مدیریت قلم‌های تم مخصوص اسکریپت در پایتون از طریق جاوا تسلط بر قلم‌های PowerPoint در Python از طریق Java