Tab Picture

The picture tab provides various options to customize the rendering of images. The supported picture formats are:

GIF
JPG, JPEG
PNG
BMP
WMF, EMF

The following options are available:

Crop

The cropping enables you to cut off parts of the image you don't want to be printed. Therefore you can specify the size of the parts you want to cut off. E.g. setting the top cropping to 1 inch will cut off 1 inch from the top border into the original image.

Note: If you set cropping measurements, which will crop off more than the size of original image no image will be printed.

Scaling Option

The combo box scaling option allows you to set the basic scaling behavior of you picture element. The following option are available:

Fit to Frame	The image will be scaled to the size of the picture element. The element properties can grow and can shrink will have no affect when this option has been set.
Use Scale Factor	The image will be scaled using the given scaling factors for width and height. These factor can be set in the 'Scale Width' and 'Scale Height' fields below.
Fit Width	The image will be scaled to the width of the picture element. The height will keep the aspect ratio if the 'Keep Aspect Ratio' checkbox is checked otherwise it will be calculated using the height scaling factor.
Fit Height	The image will be scaled to the width of the picture element The width will keep the aspect ratio if the 'Keep Aspect Ratio' checkbox is checked otherwise it will be calculated using the width scaling factor.

Scale Width/ Scale Height

These percentage values refer to the original size of the image. When you set 'scale width' to 100 % the image will be displayed with its original width. If this image doesn't fit in its element frame the overhanging parts will be cropped off. Which parts these are depends on the image alignment properties. The 'Scale Width' or 'Scale Height' property will only take affect if 'Scaling Option' is set to 'Use Scale Factor' or to 'Fit Width' or 'Fit Height' with 'Keep Aspect Ratio' set to false.

Keep Aspect Ratio

If this option is activated the image will keep it original aspect ratio, which means the width and height will be scaled by the same factor.

Size Width / Size Height

Changing the 'Size Width' / 'Size Height' will cause an resize of the report element. This may have influence to the image of this picture element.

Can Grow / Can Shrink

Enable these option if you want to resize your picture element dynamically to the size of its image. By selecting only 'Can Grow' the resize operation is restricted to enlarge the element and vice versa. These options can be set by property formula and will only take affect if 'Scale Option' is not set to 'Fit to Frame'.

Setting the Can Shrink option may invalidate the Alignment option (see next).

Alignment

You can set the image alignment using the horizontal and vertical alignment property. This may be needful if the image doesn't fit in it's element frame. If the image is larger than it's element frame the alignment will decide which part of the image is visible.

The property formula can be used to set the alignment dynamically or depending on database field or parameter field value. In the property formula you can use alignment constants.

Using the Alignment option together with the Can Shrink option may invalidate your alignment and reset it to 'Left' 'Upper' if your image is smaller than the frame.

Dynamic Image Location

You can set a formula for this property returning a dynamic path to an image which will replace the original image. The path provided in the formula should be relative to the location of the report. You can use one of the following formats:

relative path to the location of the report
- Sample: "./myimage.png"
absolute file path
- Sample: "/opt/var/images/myimage.png"
URL
- Sample: http://myserver.com/images/myimage.png

Image Key

This key can be used to identify equal images, which normally would be stored more than once in formats like PDF or PostScript. To save memory you can set the same key for images you know are equal. This will cause the image to be cached and reused for each image with the same key late on.

Size Info

These fields are readonly and displays the estimates image size in the report document. This may differ from the Size Width / Size Height information since they both are rounded on the Twips level wheras the Size Info is not.