Workbench User Guide : Creating and Using Basic Fields : Scalar Fields : Image Trim
 
Share this page          
Image Trim
Image trim is a field type that appears as a picture on a form. You specify the starting point for the field and provide the name of the file that contains the picture. OpenROAD Workbench saves the image with the form. You must create and maintain the image outside of Workbench.
For more information about using image trim, see the Programming Guide.
Supported Image Formats
OpenROAD accepts the following image formats:
GIF
XBM (black and white only)
Sun Raster (must be decompressed before being used)
TIFF
BMP
ICO
JPG
PNG
Create an Image Trim
You can create an image trim field to place a graphic on a form.
To create an image trim field
1. Open your frame in the Frame Editor (see Open an Existing Frame).
2. Select the Image Trim icon on the field palette.
3. Position the cursor on the form and then click.
A standard File Selection dialog appears.
4. Locate and select an image file, and click OK.
The image is displayed in the designated area.
5. Drag the image to where you want it on the form.
For complete descriptions of each field property, see Image Trim Properties and Common Field Properties.
Image Trim Properties
All the properties for image trim are described under Common Field Properties, with the exception of the following properties that are specific to the image trim field type:
DisplayPolicy
Specifies how the image will be displayed in the field. Available selections are:
DP_CLIP_IMAGE
Clips the image to fit the field
DP_AUTOSIZE_FIELD
Expands or shrinks the field to fit the image
DP_SCALE_IMAGE_H
Scales the image vertically to fit the field
DP_SCALE_IMAGE_W
Scales the image horizontally to fit the field
DP_SCALE_IMAGE_HW
Scales the image vertically and horizontally to fit the field (may cause distortion)
Default: DP_AUTOSIZE_FIELD
Image
Specifies a file containing the image to be displayed as the image field, if set to Bitmap. When you click this button, a standard File Selection dialog appears. Enter the directory path of the new image you want to use.