Tabled of Contents |
---|
WordWriter allows you to insert jpg, gif, bmp, and png images in merge fields. You can insert images repeat block and main document merge fields. There are two ways to insert an image into a merge field:
To insert an image in a merge field using a placeholder:
If you are using a database as a data source, the column that corresponds to the merge field containing the image must be of type BLOB ("Image" in SQL Server). If the data source is an array of objects, the value that corresponds to the merge field containing the image should be a simple byte array.
To specify how WordWriter should scale the image:
Relative\ to original\ picture size |
Lock aspect ratio |
Meaning |
---|---|---|
false |
false |
The image will maintain its natural size and aspect ratio. |
true |
false |
The image will be scaled to fit into the placeholder image but keep its natural aspect ratio. |
false |
true |
The image will be scaled to fit into the placeholder image but keep its natural aspect ratio. The image will not be enlarged if it is smaller than the placeholder image. |
true |
true |
The image will be scaled to fit into the placeholder image and its aspect ratio. |
To insert an image in a merge field the "image" modifier:
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. |
If you are using a database as a data source, the column that corresponds to the merge field containing the image must be of type BLOB ("Image" in SQL Server). If the data source is an array of objects, the value that corresponds to the merge field containing the image should be a simple byte array.