Common properties for TRpImage

Component Reference

Properties for TRpImage

Summary

Name

Internal Name

Type

Description

Draw Style

DrawStyle

TRpImageDrawStyle

Value	Meaning
Crop	Draws the image using the Resolution property to determine size, then cut the part of the image outside the component size
Stretch	Draws the image no using the Resolution property but adapting to the size of the component size
Full	Draws the image using the Resolution property to determine size, then ignores component size, you can use this property with parent section autoexpand property to draw different image sizes optimizing page space
Tile	Draws the image repeating it until the component size is filled, this is used to obtain for example beautiful backgrounds from small sized bitmaps

Expression

WideString

The image can be embedded (Image property) or obtained through this expression property, the expression is evaluated, if the expression result is a binary database field will try to read the image from there, see below the image formats supported. If the field is a string field or the result of evaluation is a string the engine will try to load the image as a file reference.

Image

Stream

TStream

Embedded image, stored with the report structure containing a image stream. When embedding large images you should set preferred save format in page setup to binary/gzip to enhance performance.

Resolution (dpi)

dpires

Integer

Resolution of the image in pixels per inch unit, the size of the bitmap and the resolution will determine the final size depending on the Draw Style property

Additional details about the implementation

Because Report Manager driver architecture, the image formats supported depends on the output driver used, the server applications use the PDF driver.

Supported Image file formats

Image type	Designer/Windows (legacy CLX/Qt)	Designer/Linux (legacy CLX/Qt)	Windows GDI	HTML	PDF
	TCLXReport (legacy)	TCLXReport (legacy)	TVCLReport		TPDFReport
Windows Bitmap, regular	Yes	Yes	Yes	Yes	Yes
Windows Bitmap, RLE	Yes	Yes	Yes	No	No
Windows Bitmap, Monochrome	Yes	Yes	Yes	Yes	Yes
JPeg Image (any method)	Yes	Yes	Yes	Yes	Yes
PNG Image	Yes	Yes	No	No	No
XPM Images	Yes	Yes	No	No	No
Gif Image	No	No	No	No	No

Notes:

The image files supported by the Report Servers (TCP and Web) are the same as the TPDFReport.
The text output driver does not support any image or drawing
The TVCLReport and TCLXReport (legacy) components can extend graphic file formats by calling from Delphi/Builder source code (or the older Kylix) the RegisterGraphicFileFormat function, this will allow loading of different file image formats like GIF or PNG

Developer info

Internal component name	TRpImage
Parent class	TRpCommonPosComponent
Unit name	rpdrawitem.pas