15. Creating Reports in OpenROAD : How You Can Design Report Documents : How You Can Use Shapes & Images Fields : Create Image Fields
 
Share this page                  
Create Image Fields
Image fields include images in GIF, BMP, or RAST format.
Note:  To include a PostScript image, you must use a conversion tool to convert the image to a supported format.
To create an image field
1. Click Insert, Shapes & Images, Image.
2. Click in the work area and drag the cursor to draw a field (rectangular area).
The ImageField Properties dialog appears.
In the ImageField Properties dialog, Image Trim is selected by default. Image Trim refers to a static image (comparable to text trim). Image Field refers to a dynamic image, which is selected at runtime based on the query.
For instructions to create each type of image, see the appropriate procedure, following.
To create an image trim field
1. Click the File folder button to the right of the Image File field.
The Current Selection dialog appears.
2. Select a file that includes an OpenROAD compatible image.
This file name is used when the report is printed.
3. Click Open.
You are returned to the ImageField Properties dialog, and your selection is added to the Image File Entry field.
4. Click Show Bitmap to preview the static image.
5. In the DB Storage edit control, click the arrow to the right of the option field (just below the Image Name field) and select one of the following options:
Insert into Catalog
Do Not Insert into Catalog
Select from Catalog
If you choose Select from Catalog and then click the file folder to the right of the Image Name entry field, the Reporter Images dialog appears.
6. To select an image from the catalog, click All Images in Database, or click one of the three options under Images Referenced In (the default):
Current document
All documents by current user
All documents by all users
The content of the list of images in the database depends on criteria as defined by other options.
7. Click Select Image.
You are returned to the ImageField Properties dialog.
Note:  In the Options edit control of the ImageField Properties dialog, you can define how the image will be displayed in the field.
8. Click the down arrow in the Behavior field to access a drop-down box.
9. Select one of the following display choices:
Scale Image Width & Height to Field
Scale Image Width to Field
Scale Image Height to Field
Clip Image to Field
Image Unchanged
10. Click Show Bitmap to preview the static image, which is displayed in the ImageField Properties dialog.
11. If desired, click Open API Code to view the code in the Open API Code Editor/Browser for Field.
12. Click OK to import the selected image and return to the report document.
To create a dynamic image field
1. Click Image Field in the ImageField Properties dialog.
The Reporter DataField List dialog appears.
Note:  This dialog lists all existing table columns. If there are no columns listed, the Reporter DataField Properties dialog appears automatically, allowing you to choose an appropriate table.
2. Select the desired table column from the Columns/Expressions list. (See Note at the end of this section.)
Alternatively, to create a new entry, click N (New).
The Reporter DataField Properties dialog appears:
a. Select a table from the Tables list field.
b. Click the folder button to the right of the Alias Name field.
The Reporter Variables dialog appears.
c. Double-click the appropriate variable in the Select a DataField list field.
The variable is added to the Columns list field and the Selected Column entry field in the Reporter DataField Properties dialog; the DbHandle toggle is checked by default.
d. In the Alias Name field, type the name of the image you are creating.
e. Click OK.
The Reporter DataField List dialog reappears, displaying the new entry.
3. Click Create Field.
You are returned to the Reporter DataField Properties dialog.
4. Click OK.
The dynamic image field indicated by “Image” is added to the report document. The actual image is not visible until you run the report.
The placement and sizing of a dynamic image field you create can be tested using a sample graphic. To create a sample image in the report document, click the Image field using the secondary mouse button to access the ImageField Properties dialog. Then follow the instructions in Image Trim, beginning with Step 3.
Note:  If the selected column is not a DbHandle, a pop-up message prompts you to click N (New) to select an appropriate entry, or click Edit to mark an existing name as a DbHandle. (DbHandle is the term OpenROAD uses for a link into a bitmap stored in the database.)
In either case, the DataField Properties dialog appears:
a. Select an appropriate column name (if you clicked New).
b. Click the DbHandle edit control.
c. Click OK to return to the Reporter DataField List dialog.
d. Click Create Field.