Annotations

Possible Uses for Annotations

Use annotations to make information about the model visible from within the block diagram. Examples of the kinds of information you can include in an annotation include:

  • Descriptions of the model design, to help model developers and reviewers

  • An image or equation relating to the model

  • Links to background information related to the model

  • Documentation about how to use the model

  • Requirements information, to help validate the model

  • Design review and workflow notes

What Are Annotations?

Annotations are visual elements that you can include in a model to document the model or to enable interacting with the model via a link or callback.

For example, this model includes an annotation that provides background information about the model and how to interact with the model.

Three Types of Annotations

You can create three types of annotations:

  • Text and images

  • TeX formatted (for equations)

  • Image-only

You create an text and image annotation as plain text. Then you can apply formatting to the annotation. As soon as you apply formatting, the annotation becomes a rich text annotation.

You can include images and text in the same annotation, but you cannot resize or move the image in that annotation. Alternatively, you can add an image-only annotation, which contains an image without any text. You can resize an image-only annotation.

Annotation Layout and Contents

You can specify the layout for an annotation, including"

  • Borders

  • Text alignment and wordwrap

  • Text color and background color

  • Margins between the text and the borders of the annotation

You can include the following kinds of content in an annotation:

  • Formatted text

  • Lists

  • Tables

  • Images

  • Hyperlinks

You have several options for formatting text and adding content, including:

  • Type text or copy and paste text from a Microsoft® Word or an HTML document.

  • Format text for a whole paragraph or for specific text in a paragraph, including selecting fonts, styles, and size.

  • Apply formatting from one piece of annotation text to text in another part of the same annotation. See Copy Formatting.

  • Create a new table or copy a table (or part of a table) from an HTML page or a Microsoft Word document and paste it into the annotation.

    Edit the table using common Microsoft Word editing features. You can interactively resize table columns and rows.

  • Add images by either copying and pasting an image or by inserting an image from an image file.

      Note:   If you copy text from an HTML page, formatting may be lost when you paste the information into an annotation.

  • Copy a link from a Microsoft Word or an HTML document or specify the URL and link text.

Copy Formatting

You can apply formatting from one piece of annotation text to text in another part of the same annotation.

  1. Click in the annotation text whose format you want to use.

  2. In the annotation edit bar, click the Format Painter button ( .

  3. In the same annotation, select the text to apply the format to.

  4. Release the mouse button.

Interactive Annotations

You can make an annotation interactive, so that clicking the annotation performs an action, such as opening a document. The information in an annotation is not dynamic, but you can include links to dynamic information.

Related Examples

Was this topic helpful?