Image (Report Generator)

Component

Image

Category

Formatting

Description

The Image component inserts an image from an external file into the report. The Image component can have the Chapter/Subsection or Paragraph component as its parent. If the Paragraph component is its parent, then the Insert as inline image check box must be checked.

Attributes

This is the Image attribute page.

Note:
To view a component attribute page in the Setup File Editor, select the component in the setup file outline on the left and click on the Options tab. If the component is not in the setup file outline, you must add it to the outline first. See Chapter 4 for a discussion on how to add a component to the outline.

Image filename:

Enter the image filename in this field or use the browse button (...) to find the file that contains the image.

Make sure that the image is in a format that your viewer can read. Your viewer depends on the report format you selected in the Report Options page in the Setup File Editor. See "Report Format and Stylesheets" in Chapter 2 for a discussion on report format options.

Display Options

Image Title

Choose one of the following title options:

No title: Select this option if you do not want an image title.
Title: Select this option and type in the image title in the corresponding field if you want an image title that is not the same as the image file name.
Title from filename: Select this option if you want the image title to be the same as the image filename.

Insert as inline image

Select this option if you want to insert an inline image in a paragraph. To make this a valid option, the Image component must have the Paragraph component as its parent and text components as its peers.

Example: If the following components are included in a setup file,

    paragraph
        text - "This is an example of an inline image."
        text - "This is an example."
        image - *image.jpg*
        text - "This is an example of an inline image."

and you select the Insert as inline image option, the report would contain the following paragraph:

    This is an example of an inline image. This
    is an example. *image.jpg* This is 
    an example of an inline image.

If you do not select the Insert as inline image option, then the report would contain the following paragraph (notice that the image is not inline):

    This is an example of an inline image. This
    is an example.
    *image.jpg*
    This is an example of an inline image.

Copy image to /rptimages directory

Select this option to copy the image to the /rptimages directory. This option creates a relative link from the report to the copied image in the /rptimages directory. You should use this option:

If you generate your report in SGML format and then want to produce the report in multiple formats
If you intend to move your report from one directory to another

The /rptimages has the same parent directory as the report. You specify this in the Directory: option in the Report Options page in the Setup File Editor. See "Specifying the Directory for the Report File" in Chapter 2 for a discussion of the Directory: option.

Image Preview

The Image Preview frame shows the image that you specify in the Image file name field. You cannot preview postscript images or image with formats that are not supported by the imread function, such as .gif.

If you click on the image in the Image Preview frame, it is displayed in full size on the screen.

Insert anything into report?

Yes. Image.

Filename

cfrimage

[ Previous | Help Desk | Next ]