This is machine translation

Translated by Microsoft
Mouseover text to see original. Click the button below to return to the English verison of the page.

Note: This page has been translated by MathWorks. Please click here
To view all translated materals including this page, select Japan from the country navigator on the bottom of this page.


Insert image from external file into report


This component inserts an image from an external file into the report. It can have the Chapter/Subsection or Paragraph component as its parent. If the Paragraph component is its parent, you must select the Insert as inline image check box.


  • File name: Specifies the image file name. You can enter this name manually, or use the Browse button (...) to find the image file.

    The image must be in a format that your viewer can read. An error like the following appears if you specify the name of an image file that does not exist:

      No file name.  Could not create graphic.

    This field supports %<VariableName> notation. For more information about this notation, see %<VariableName> Notation on the Text component reference page.

  • Copy to local report files directory: Saves a copy of the image to a local report files folder.

Display Options

  • Scaling: Controls size of the image, as displayed in a browser. Making an image larger using this option does not affect the storage size of the image, but the quality of the displayed image may decrease as you increase or decrease the size of the displayed image.

    Generally, to achieve the best and most predictable display results, use the default setting of Use image size.

    • Use image size: Causes the image to appear the same size in the report as on screen (default).

    • Fixed size: Specifies the number and type of units.

    • Zoom: Specifies the percentage, maximum size, and units of measure.

  • Size: Specifies the size of the snapshot in the format w h (width, height). This field is active only if you choose Fixed size from the Scaling list.

  • Max size: Specifies the maximum size of the snapshot in the format w h (width, height). This field is active only if you choose Zoom from the Scaling list;

  • Units: Specifies units for the size of the snapshot. This field is active only if you choose Zoom or Fixed size in the Image size selection list.

  • Alignment: Only reports in PDF or RTF formats support this format property. Options are:

    • Auto

    • Right

    • Left

    • Center

  • Title: Specifies text to appear above the snapshot.

  • Caption: Specifies text to appear under the snapshot.

  • Full page image (PDF only): In PDF reports, scales images to fit the full page, minimizes page margins, and maximizes the size of the image by using either a portrait or landscape orientation.


The image that you specify in the Image file name field appears in this pane. You cannot preview Adobe® PostScript® images, or images with formats that the imread function does not support, such as gif.

Clicking an image causes it to display in full size.

Insert Anything into Report?

Yes. Image.



Was this topic helpful?