Adding a Picture

You can add a picture, in a number of ways, to illustrate a diagram or modify a component icon. You can also update an existing picture.

Supported picture formats are .bmp, .jpg, .jpeg, .png, .rgb, .tif, .tiff, and .svg.

Note: SVG images are internally converted into bitmap images before displayed since the Modelica language does not support vector images. Because of this rasterization, pixels are visible when zooming in on these images.

Pictures can be added from the file system, from Modelica external resources, or from resource tables. For more about external resource handling see Managing External Resources, for more about resource tables see xxx.

Note: The commands Update, Apply, and Export are not available for pictures.

This task shows you how to:

See Also
About Modelica Components
Drawing Primitives

Add a Picture from the File System, Without Adding It as a Resource

You can use a picture from the file system, without adding it as a resource.

  1. From the Diagram section of the action bar, click Picture .
    The Drawing dialog box appears and a cross appears under your pointer.
  2. Click the needed position in the diagram and move your pointer to define the convenient size.

  3. Click the diagram when the size is correct.
    The Select Resources dialog box appears.
  4. In the Select Resources dialog box, click Select a resource in the file system.
    The Select File dialog box appears.
  5. In the Select Resource dialog box, do the following:
    1. Optional: Browse and select the picture to be added to the diagram.

      You can select from all image files or select from a specific image type.

      The path to the selected picture appears in the lower part of the dialog box.
    2. Click Open.
    • The selected picture is added in the diagram.
    • The path of the added picture appears in the Modelica Graphics Properties dialog box, in the Picture Properties section, if that dialog box is displayed.
    Note: You can control the size of the picture by dragging any handle around the picture.

Add a Picture Already Available as a Resource

You can use a picture already available as a resource.

  1. Follow the steps from Step 1 to Step 3 as described in the first task above.
  2. In the Select Resources dialog box, click Select a resource in the Modelica resources of a library.
    The Select Resource dialog box appears.
  3. In the Select Resource dialog box, do the following:
    1. Optional: Browse the tree and select the picture to be added to the diagram.
      The path to the selected picture appears in the lower part of the dialog box.
    2. Optional: To embed the picture in the Modelica text, select the Embed picture option.

      By default, this option depends on the previous selection.

    3. Click OK.
    • The selected picture is added in the diagram.
    • The path of the added picture appears in the Modelica Graphics Properties dialog box, in the Picture Properties section, if that dialog box is displayed.
    • The picture is embedded in the Modelica text, if the Embed picture option was selected.
    Note: You can control the size of the picture by dragging any handle around the picture.

Add a Picture Not Yet Available as a Resource, and Adding It as a Resource

You can use a picture that is not yet available as a resource. By doing that, you also import it as a resource.

  1. Follow the steps from Step 1 to Step 3 as described in the first task above.
  2. In the Select Resources dialog box, click Select a resource in the Modelica resources of a library.
    The Select Resource dialog box appears.
  3. In the Select Resource dialog box, do the following:
    1. Optional: Browse the tree and select the folder where the picture should be imported as a resource.

      By default, the library of the activated class is selected.

      Tip: You can add a new folder in the browsed location by clicking Add Folder.

      The path to the selected folder appears in the lower part of the dialog box.
    2. Click Import Resources.
      The Import Resources dialog box appears.
    3. Browse for the picture you want to import and click Open to validate your selection.
      • The picture appears as a resource in the tree in the dialog box.
      • The path to the resource appears in the lower part of the dialog box.
    4. Optional: To embed the picture in the Modelica text, select the Embed picture option.

      By default, this option is not selected.

    5. Click OK.
    • The selected picture is added in the diagram.
    • The path of the added picture appears in the Modelica Graphics Properties dialog box, in the Picture Properties section, if that dialog box is displayed.
    • The picture file is imported as an external resource.
    • The picture is embedded in the Modelica text, if the Embed picture option was selected.
    Note: You can control the size of the picture by dragging any handle around the picture.

Add a Picture Using a Resource Table

You can use a picture from a resource table.

For handling of resource tables, see Creating and Using Resource Tables.

  1. Follow the steps from Step 1 to Step 3 as described in the first task above.
  2. In the Select Resources dialog box, click Select a resource contained in a Document in the resource table.
    The Select Resource dialog box appears.
  3. In the Select Resource dialog box, click the line of the resource you want to use, and then click OK.
    • The selected picture is added in the diagram.
    • The path of the added picture appears in the Modelica Graphics Properties dialog box, in the Picture Properties section, if that dialog box is displayed.
    Note: You can control the size of the picture by dragging any handle around the picture.

Update an Existing Picture

You can update an existing picture, for example, change it to another picture. You can also use the dialog to change other picture attributes, including changing if the picture is embedded in Modelica text or not.

In this scenario you change the picture to another one, already available as a resource.

Before you begin: You must display the Modelica Graphics Properties dialog box, if not already displayed.
  • If the dialog box is minimized in the right part of the screen, click Modelica Graphics Propperties to expand it.
  • If it is not present at all, do the following:
    • Display the App Options panel, if not already displayed. To access the App Options panel, from the Tools section of the action bar, select App Options .
    • In the panel, click Modelica Graphics Propperties
  1. Select the picture in the diagram layer or the icon layer.

    If the resource corresponding to the picture is renamed, the picture changes into the picture icon .

    The Picture Properties section of the Modelica Graphics Properties dialog box opens.
    Tip: You can see the path to the corresponding resource in the second line of this section.
  2. In the Modelica Graphics Properties dialog box, click Update Picture.
    The Select Resources dialog box appears.
  3. Select what resources to use. You can select an image from the file system, from Modelica resources, or from a resource table.

    In this scenario, select Modelica Resources.

    Note: Updating an image is very similar to adding an image, so for use of other resource types, see the corresponding sections above about adding images.

    The Select Resource dialog box appears.
  4. In the tree in this dialog box, browse for the resource.
    The path to the selected picture appears in the lower part of the dialog box.
  5. Click OK.
    The picture is updated.
    Tip: You can also change the picture to a picture not yet available as a resource, by using Import Resources in the Select Resource dialog box.