iPrintImage (Function) In french: iImprimeImage Sends the image to print to the print buffer. The print is not started (only iEndPrinting can be used to start the print). The print mode of the image depends on the parameters passed to iPrintImage. Versions 20 and laterRemark: This function must not be used to print the background image of a report. To define the background image of a report, use ..BackgroundImage. ..BackgroundImagePrinted is used to specify whether the image must be printed with the report. New in version 20Remark: This function must not be used to print the background image of a report. To define the background image of a report, use ..BackgroundImage. ..BackgroundImagePrinted is used to specify whether the image must be printed with the report. Remark: This function must not be used to print the background image of a report. To define the background image of a report, use ..BackgroundImage. ..BackgroundImagePrinted is used to specify whether the image must be printed with the report.
// Prints Flower.JPG at line 20mm, column 50 mm without stretching or reducing iPrintImage("Flower.JPG", 20, 50) iEndPrinting()
Syntax
Printing an image in a specific area Hide the details
iPrintImage(<Image name> , <X1> , <Y1> , <X2> , <Y2> [, <Scale>])
<Image name>: Character string or Image variable - Name of file containing the image to print. The format of this file must be one of the recognized image formats.
- Name of Image Memo item.
Versions 17 and later Name of an Image variable. New in version 17 Name of an Image variable.  Name of an Image variable.
<X1>: Real Horizontal coordinate of top left corner of image position (in millimeters). Value included between 0 and the page width (returned by iPageWidth). <Y1>: Real Vertical coordinate of top left corner of image position (in millimeters). Value included between 0 and the page height (returned by iPageHeight). <X2>: Real Horizontal coordinate of bottom right corner of border where the image must be printed (in millimeters). Value included between 0 and the page width (returned by iPageWidth). <Y2>: Real Vertical coordinate of bottom right corner of border where the image must be printed (in millimeters). Value included between 0 and the page height (returned by iPageHeight). <Scale>: Integer or integer constant (optional) Configures the scale of zoom performed on the image. | | iHomotheticDisplay | The image is displayed in <X1> <Y1> without being distorted. It occupies either the entire height defined by <X1> and <X2>, or the entire width defined by <Y1> and <Y2>.
| iHomoCenteredDisplay | The image is stretched or reduced to occupy the defined space in an optimal way without being distorted. If is centered in the area defined by <X1>, <Y1>, <X2> and <Y2>.
| iNormalDisplay (Default value) | The image is displayed in the entire rectangle defined by <X1>, <Y1>, <X2> and <Y2>. The image can be distorted.
|
Printing an image at a specific position Hide the details
iPrintImage(<Image name> , <X1> , <Y1> [, <Scale>])
Printing an image section Hide the details
iPrintImage(<File name> , <X1> , <Y1> , <X2> , <Y2> , <X3> , <Y3> , <X4> , <Y4> [, <Scale>])
<File name>: Character string - Name of file containing the image to print. The format of this file must be one of the recognized image formats.
- Name of Image Memo item.
Versions 17 and later Name of an Image variable. New in version 17 Name of an Image variable.  Name of an Image variable.
<X1>: Real Horizontal coordinate of top left corner of image position (in millimeters). Value included between 0 and the page width (returned by iPageWidth). <Y1>: Real Vertical coordinate of top left corner of image position (in millimeters). Value included between 0 and the page height (returned by iPageHeight). <X2>: Real Horizontal coordinate of bottom right corner of border where the image must be printed (in millimeters). Value included between 0 and the page width (returned by iPageWidth). <Y2>: Real Vertical coordinate of bottom right corner of border where the image must be printed (in millimeters). Value included between 0 and the page height (returned by iPageHeight). <X3>: Real Horizontal coordinate (x-coordinate) of the top left corner of the image part to print (in millimeters). <Y3>: Real Vertical coordinate (y-coordinate) of the top left corner of the image part to print (in millimeters). <X4>: Real Horizontal coordinate (x-coordinate) of the bottom right corner of the image part to print (in millimeters). <Y4>: Real Vertical coordinate (y-coordinate) of the bottom right corner of the image part to print (in millimeters). <Scale>: Integer or integer constant (optional) Configures the scale of zoom performed on the image. | | iHomotheticDisplay | The image section is displayed in <X1> <Y1> without being distorted. It occupies either the entire height defined by <X1> and <X2>, or the entire width defined by <Y1> and <Y2>. The image is proportionally enlarged if necessary. | iHomoCenteredDisplay | The image section is stretched or reduced to occupy the specific area without being distorted. It occupies:- the entire height defined by <X1> and <X2>: the image is centered horizontally.
- the entire width defined by <Y1> and <Y2>: the image is centered vertically.
The image is proportionally enlarged if necessary. | iNormalDisplay (Default value) | The image section (defined by <X3>, <Y3>, <X4> and <Y4>) is displayed in the entire rectangle defined by <X1>, <Y1>, <X2> and <Y2>. The image can be distorted. |
Remarks Various - The origin (0,0) is located in the top left corner of the sheet. It takes the physical margins of printer into account.
- If the image doesn't fit in the defined zone and if centering was requested (<Scale> = 999), then the centering option is abandoned.
This page is also available for…
|
|
|