Download lightbox as a PowerPoint file

This article describes how to configure your Asset Bank so that users can download the images in their lightbox as a PowerPoint presentation file (either PPT or PPTX).

If the functionality is enabled in your Asset Bank you will see a checkbox 'can download as ppt/pptx' when adding or editing a Usage Type. If this checkbox is checked then when users select this Usage Type on the 'Download Lightbox' page they will see a checkbox 'Download as PowerPoint Presentation', which will be checked by default.

If this checkbox is checked when they click the 'Download now' button, Asset Bank will create a PPT or PPTX file and insert any images in the lightbox into this file, one per slide. The pixel sizes of the images added to the presentation will be determined by the sizes you configure for the Usage Format. In general, the larger these sizes the higher res the images will be in the presentation (as the image object on the slide will be resized so that it fits the slide).

Asset bank will also insert any PPT or PPTX files into the template, although it can only insert PPT files into PPT templates, and PPTX files into PPTX templates. Please note that any images in the inserted files will not be resized when inserted.

If you have not uploaded any 'PowerPoint templates' to your Asset Bank then a basic PPT file will be used.

To add 'PowerPoint templates', follow these steps:

  • Create a category, for example called 'PowerPoint templates'. If you don't want this to be shown on the home page you can set its 'is browsable' attribute to false.
  • Edit the application settings file and set the value of the ppt-template-category-id to the ID of the category you just added.
  • Add PPT or PPTX files to Asset Bank in the usual way, and put them in the 'PowerPoint' category you just created. All PPT or PPTX files in this category will then be available for users to select when downloading their lightbox as a PowerPoint presentation. Note that POT and POTX files are not supported (any POT or POTX files in this category will be ignored).

If the template file selected by a user is PPT, then the images will simply be placed on a new slide (each) which is copied from the last slide in the template. If the template contains more than one slide then the first slides are just left at the top of the presentation (this is so your templates can contain, for example, introductory text).

If the template is PPTX then you should add one or more slides containing 'shapes' to determine how the images are positioned on the slides. Note that each slide should contain only one of the positioning shapes - this generally means the templates should contain at least two slides - one containing a shape to use for 'landscape' images and one containing a shape to use for 'portrait' images. You should also consider having a third slide for 'square'.

The following logic is used when deciding which slide from the template to use for a particular image, and how to position the image:

  • AB starts at the beginning of the slides in the template and examines slide one by one. The largest shape on each slide is located.
  • The slide that contains the shape that has the closed aspect ratio to the aspect ratio of the image is copied and added to the end of the new PPTX being created for download.
  • The image is placed on that new slide in the position and size of the shape that was located. Note that the 'shape' from the template will still be present underneath the image.
  • By default the image will be positioned so that it fits within the shape and the aspect ratio of the original image will be maintained. You can instead get Asset Bank to crop the images so they fit within the shape exactly by changing the following setting: pptx-template-crop-images=true. Note that this setting will apply to all templates, i.e. it is global for your Asset Bank.

Note: PPT files cannot be merged in a PPTX template and vice versa.

Was this article helpful?

Yes No

Thanks for your feedback!