<IMAGE>

<< Click to Display Table of Contents >>

Navigation:  Common vpxPrint tags > Images >

<IMAGE>

     

Inserts a picture at the current point. Additional tags: <ROTATE> and <TRANSPARENT>

 

Syntax 1:

         <IMAGE [ (left,top,right,bottom) ] filename >  

(Left,top,right,bottom) syntax is intended to extract an area from the image file. The four coordinates define an area from the source image.

 

Examples:

         <IMAGEC:\TEMP\4GL.bmp>

         <IMAGE(0,0,100,200)c:\temp\4gl.bmp>                copy the rectangle 0,0 to 100,200 of the input image.

 

 

 

 

Image stretching: rescale the image inside the page.

 

Syntax 2:

         <IMAGE[ (left,top,right,bottom) ] #bookmark [,STRETCH]=filename>  

 

This syntax defines the rectangle where the image will be drawn.

The image will be expanded to fill the rectangle defined by the bookmark and the current point (see the note below).

 

Example :

         <IMAGE#3=C:/TEMP/4GL.jpg>  

 

Tuto_Image_Demo_0

 

Syntax 3:

vpxPrint accepts PDF files as input. Additional parameters can be specified.

vpxPrint calls tool and creates a temporary JPG image with the zoom factor and the quality specified. By default, zoom=100 and quality=100.

It then inserts the image within the frame defined by the bookmark and the current cursor.

if the PDF (only) contains spaces, PDFtoJPG does not process files. For PDF files, replace any space in the file name by #.

 

Parameters:

1.The image is drawn within the rectangle defined by the bookmark and the current cursor.

2.filename: name of the input image or PDF file.

3./ and \ are allowed in the file path

4.PDF only: page=nnn or First or Last : specify here the page that you want to insert. Default=1.

5.PDF only: zoom=nnn : % value of the zoom from 10 to 100 (default=100). This value has no effect on the visual image (except for quality). It's used to limit the size of the temporary file generated by PDFtoJPG.

6.PDF only: quality=nnn : % value of the JPG quality.

7.STRETCH option stretches the image over the entire defined area, the proportions of the image are lost. (10.31)

 

Examples:

         <IMAGE#3=C:/TEMP/4GL.PDF>

                 inserts the first page of the PDF file

         <IMAGE#3=C:/TEMP/4GL.PDF,page=3>  

                 inserts the third page of the PDF file

         <IMAGE#3=C:/TEMP/4GL.PDF,page=Last>  

                 inserts the last page of the PDF file

 

 

Notes:

the image proportions are always retained by vpxPrint. As a result, the image size can be smaller than expected to fit within the area.

the zoom value should be adjusted to get the best performance.
A good way of determining the right value is to try different values with PDFtoJPG directly from command line. You will see the image size and the time needed to create the image.

inserting a PDF page from vpxPrint is a time-consuming process. If multiple pages have to be inserted in a report, consider to run PDFtoJPG to create image files before calling vpxPrint. You can then create all the pages in a single run and insert them in the report.

The <ROTATE> tag allows to rotate the image

The <TRANSPARENT> tag inserts a transparent image

 

 

Supported formats :

vpxPrint supports the formats: *.bmp, *.jpg, *.wmf, *.emf, *.ico, gif, png or pdf

tif images can be also inserted if they contains only one page. Quality of drawing for TIF files is usually not very accurate.

PDF files

 

         

<IMAGE#bookmark [ ,STRETCH ]=filename

 [,page=pageNumber  | First | Last ]

 [,zoom=nnn]

 [,quality=nnn]

 >  

Image1

 

 

Starting with the 10.26d, the <IMAGE> tag can be combined with <CENTER> and <RIGHT> tags to horizontally align the image within the image frame:

 

centerImage

 

Tuto_Image

Tuto_Transparent

 

 

 

Tuto_Image_Demo_00

Tuto_Image_Demo2