Presentation Background

Solid colors, gradient colors, and pictures are often used as background images for slides. You can set the background either for a normal slide (single slide) or master slide (several slides at once)

Set Solid Color as Background for Normal Slide

Aspose.Slides allows you to set a solid color as the background for a specific slide in a presentation (even if that presentation contains a master slide). The background change affects only the selected slide.

1. Create an instance of the Presentation class.
2. Set the BackgroundType enum for the slide to OwnBackground.
3. Set the FillType enum for the slide background to Solid.
4. Use the SolidFillColor property exposed by FillFormat to specify a solid color for the background.
5. Save the modified presentation.

This JavaScript code shows you how to set a solid color (blue) as the background for a normal slide:

// Creates an instance of the Presentation class
var pres = new aspose.slides.Presentation("MasterBG.pptx");
try {
    // Sets the background color for the first ISlide to Blue
    pres.getSlides().get_Item(0).getBackground().setType(aspose.slides.BackgroundType.OwnBackground);
    pres.getSlides().get_Item(0).getBackground().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    pres.getSlides().get_Item(0).getBackground().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "BLUE"));
    // Writes the presentation to disk
    pres.save("ContentBG.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Set Solid Color as Background for Master Slide

Aspose.Slides allows you to set a solid color as the background for the master slide in a presentation. The master slide acts as a template that contains and controls formatting settings for all slides. Therefore, when you select a solid color as the background for the master slide, that new background will be used for all slides.

1. Create an instance of the Presentation class.
2. Set the BackgroundType enum for the master slide (Masters) to OwnBackground.
3. Set the FillType enum for the master slide background to Solid.
4. Use the SolidFillColor property exposed by FillFormat to specify a solid color for the background.
5. Save the modified presentation.

This JavaScript code shows you how to set a solid color (forest green) as the background for a master slide in a presentation:

// Creates an instance of the Presentation class
var pres = new aspose.slides.Presentation();
try {
    // Sets the background color for the Master ISlide to Forest Green
    pres.getMasters().get_Item(0).getBackground().setType(aspose.slides.BackgroundType.OwnBackground);
    pres.getMasters().get_Item(0).getBackground().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Solid));
    pres.getMasters().get_Item(0).getBackground().getFillFormat().getSolidFillColor().setColor(java.getStaticFieldValue("java.awt.Color", "GREEN"));
    // Writes the presentation to disk
    pres.save("MasterBG.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Set Gradient Color as Background for Slide

A gradient is a graphical effect based on a gradual change in color. Gradient colors, when used as backgrounds for slides, make presentations looks artistic and professional. Aspose.Slides allows you to set a gradient color as the background for slides in presentations.

1. Create an instance of the Presentation class.
2. Set the BackgroundType enum for the slide to OwnBackground.
3. Set the FillType enum for the master slide background to Gradient.
4. Use the GradientFormat property exposed by FillFormat to specify your preferred gradient setting.
5. Save the modified presentation.

This JavaScript code shows you how to set a gradient color as the background for a slide:

// Creates an instance of the Presentation class
var pres = new aspose.slides.Presentation("MasterBG.pptx");
try {
    // Apply Gradient effect to the Background
    pres.getSlides().get_Item(0).getBackground().setType(aspose.slides.BackgroundType.OwnBackground);
    pres.getSlides().get_Item(0).getBackground().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Gradient));
    pres.getSlides().get_Item(0).getBackground().getFillFormat().getGradientFormat().setTileFlip(aspose.slides.TileFlip.FlipBoth);
    // Writes the presentation to disk
    pres.save("ContentBG_Grad.pptx", aspose.slides.SaveFormat.Pptx);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Set Image as Background for Slide

Besides solid colors and gradient colors, Aspose.Slides also allows you to set images as the background for slides in presentations.

1. Create an instance of the Presentation class.
2. Set the BackgroundType enum for the slide to OwnBackground.
3. Set the FillType enum for the master slide background to Picture.
4. Load the image you want to use as the slide background.
5. Add the image to the presentation’s image collection.
6. Use the PictureFillFormat property exposed by FillFormat to set the image as the background.
7. Save the modified presentation.

This JavaScript code shows you how to set an image as the background for a slide:

// Creates an instance of the Presentation class
var pres = new aspose.slides.Presentation();
try {
    // Sets conditions for background image
    pres.getSlides().get_Item(0).getBackground().setType(aspose.slides.BackgroundType.OwnBackground);
    pres.getSlides().get_Item(0).getBackground().getFillFormat().setFillType(java.newByte(aspose.slides.FillType.Picture));
    pres.getSlides().get_Item(0).getBackground().getFillFormat().getPictureFillFormat().setPictureFillMode(aspose.slides.PictureFillMode.Stretch);
    // Loads the image
    var imgx;
    var image = aspose.slides.Images.fromFile("Desert.jpg");
    try {
        imgx = pres.getImages().addImage(image);
    } finally {
        if (image != null) {
            image.dispose();
        }
    }
    // Adds image to presentation's images collection
    pres.getSlides().get_Item(0).getBackground().getFillFormat().getPictureFillFormat().getPicture().setImage(imgx);
    // Writes the presentation to disk
    pres.save("ContentBG_Img.pptx", aspose.slides.SaveFormat.Pptx);
} catch (e) {console.log(e);
} finally {
    if (pres != null) {
        pres.dispose();
    }
}

Change Transparency of Background Image

You may want to adjust the transparency of a slide’s background image to make the contents of the slide stand out. This JavaScript code shows you how to change the transparency for a slide background image:

var transparencyValue = 30;// for example
// Gets a collection of picture transform operations
var imageTransform = slide.getBackground().getFillFormat().getPictureFillFormat().getPicture().getImageTransform();
// Finds a transparency effect with fixed percentage.
var transparencyOperation = null;
for (let i = 0; i < imageTransform.size(); i++) {
    let operation = imageTransform.get_Item(i);
    if (java.instanceOf(operation, "com.aspose.slides.AlphaModulateFixed")) {
        transparencyOperation = operation;
        break;
    }
}
// Sets the new transparency value.
if (transparencyOperation == null) {
    imageTransform.addAlphaModulateFixedEffect(100 - transparencyValue);
} else {
    transparencyOperation.setAmount(100 - transparencyValue);
}

Get Value of Slide Background

Aspose.Slides provides the BackgroundEffectiveData class to allow you to get the effective values of slide backgrounds. This class contains information on the effective FillFormat and effective EffectFormat.

Using the Background property from the BaseSlide class, you can get the effective value for a slide background.

This JavaScript code shows you how to get a slide’s effective background value:

// Creates an instance of the Presentation class
var pres = new aspose.slides.Presentation("SamplePresentation.pptx");
try {
    var effBackground = pres.getSlides().get_Item(0).getBackground().getEffective();
    if (effBackground.getFillFormat().getFillType() == aspose.slides.FillType.Solid) {
        console.log("Fill color: " + effBackground.getFillFormat().getSolidFillColor());
    } else {
        console.log("Fill type: " + effBackground.getFillFormat().getFillType());
    }
} finally {
    if (pres != null) {
        pres.dispose();
    }
}