Page tree
Skip to end of metadata
Go to start of metadata

You are viewing an old version of this page. View the current version.

Compare with Current View Page History

« Previous Version 3 Next »

PowerPointWriter allows you to insert insert file extensions here images in data markers. Images can be inserted using the image modifier.

Using the Image Modifier

The image modifier can be used to insert images into a data marker. If dimensions are not specified, the image will take on the dimensions of the text box. Dimensions are specified in inches.

To insert an image into a data marker using the image modifier:

  1. Create or open a PowerPointTemplate
  2. Add the image modifier in parenthese to the data marker in which you want to insert the image. For example, change %%=Company.Logo to %%=Company.Logo(image)
  3. If desired, set the 'image' modifier's sizing arguments

Using the Image modifier without dimensions

If you do not wish to specify dimensions for the imported image, the image modifier can be used alone or with a scale argument.

If the image modifier is used by itself, for example %%=Company.Logo(image), the image will maintain it's original dimensions.

If the image modifier is used with a scaling argument, %%=Company.Logo(image(1)), the image will be scaled accordingly to fit it's containing text box.
The scaling argument can have the following values:

Value

Meaning

1

The image will always be the width and height specified regardless of its natural size.

2

The image will always be enlarged or shrunk to fit within the bounds specified by width and height but it will keep its natural aspect ratio.

3

The image will be scaled down to within the bounds specified by width and height but it will keep its natural aspect ratio.

Using the Image modifier with dimensions

If you do wish to specify image dimensions, this can be done with or without the scaling argument.

The syntax for specifying an images dimensions without the scaling argument is image(width, height). For example %%=Company.Logo(i,2). All dimensions are in inches.

If you wish to use a scaling argument, this will be the first argument in your modifier. The data marker %%=Company.Logo(image(3,1,2)) would use the third scaling value.

The scaling argument can have the following values:

Value

Meaning

1

The image will always be the width and height specified regardless of its natural size.

2

The image will always be enlarged or shrunk to fit within the bounds specified by width and height but it will keep its natural aspect ratio.

3

The image will be scaled down to within the bounds specified by width and height but it will keep its natural aspect ratio.

Images from databases

If you are using a database as a data source, the column that corresponds to the data marker containing the image must be of the type BLOB("Image" in SQL Server). If the data source is an array of objects, the value that corresponds to the data marker containing the image should be a simple byte array.

Sample code

Inserting an Image from a byte array C#
Inserting an Image from a byte array VB
  • No labels