Workbench User Guide : Creating Reports in OpenROAD : How You Can Design Report Documents : How You Can Use Shapes & Images Fields
 
Share this page          
How You Can Use Shapes & Images Fields
You can use shapes and images to enhance the appearance of the report document.
Click the desired icon in the field palette:
Create Line
Create Rectangle
Create Ellipse
Create Image Trim
Alternatively, click Insert, Shapes & Images, then select the desired shape or image field command from the slide-off menu. For more information, see Create, Move, or Resize Shape Fields and Create Image Fields.
Create, Move, or Resize Shape Fields
Shape fields include graphic objects such as lines, rectangles, and ellipses.
To create a line, rectangle, or ellipse
1. Click the appropriate icon in the field palette.
2. Click in the work area and drag the cursor to draw the selected shape.
Note:  A line cannot extend from one report section to another.
To move a line in your report document
1. Click the line to select it.
Selection handles appear at either end of the line.
2. Position the cursor anywhere on the line except on a selection handle and drag the line to a new location.
To resize a line in your report document
1. Click the line to select it.
Selection handles appear at either end of the line.
2. Drag a selection handle at one end of the line to a new position.
To move a rectangle or ellipse
1. Click the shape to select it.
Selection handles appear around the border of the shape.
2. Position the cursor anywhere in the shape except on a selection handle and drag the shape to a new location.
To resize a rectangle or ellipse in your report definition
1. Click the shape to select it.
Selection handles appear around the border of the shape.
2. Drag any selection handle to a new position to resize the shape.
Modify Shape Field Properties
You can modify shape field properties in the appropriate Properties dialog.
To edit shape field properties
1. Right-click the field you want to edit.
The appropriate Properties dialog—Segment Shape, Rectangle Shape, Ellipse Shape—appears.
2. Enter the rotation property, if desired.
Note:  Changes to rotation appear only after the report is run.
3. Click Open API Code to view or edit the code if you want.
The Open API Editor for Field appears.
For more information about core editing procedures, see Edit Open API Code.
4. Click OK to save your work and return to the report document.
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.
Modify an Image Field
You can modify an image field in the ImageField Properties dialog.
To modify an image field
1. Click Tools, Images List.
The ImageField Properties dialog appears.
2. Make the desired modifications.
3. Click OK.