Graphics and 3-D Visualization, MATLAB Version 7.5 (R2007b)

New features and changes introduced in this version are:

Datatips Are Now Saved to FIG-Files

When you save a figure, all datatips existing in it are saved along with other annotations. When you open the FIG-file, the datatips are displayed and can be manipulated or deleted in the same ways they could in the original figure.

Compatibility Considerations

If you open a FIG-file containing datatips while using a previous MATLAB version (V7.4 or earlier), no error results, but the datatips do not display.

New Options for Displaying Groups of Lines in Legends

You can now customize how legends for figures display groups of lines, such as contours. Previously, legends displayed groups of lines such as contourgroups with a glyph that represented the entire group; now users have the flexibility to designate a single legend entry, a legend entry for each child of the group, or no legend entries for the group.

By default, a legend entry for an hggroup now consists of the DisplayName of its first child and a glyph representing it (previously, no glyph appeared, only the DisplayName). This is what you now see after clicking the legend tool icon in the figure's toolbar. However, you can set the new Annotation property of hggroups to control how the group is represented in a legend. For details and examples of its use in customizing legends, see Controlling Legends in the Graphics documentation.

Drawnow Update Option Now Updates Uicontrols Only

The drawnow command can now selectively update the display of UI components. The update option enables you to update only uicontrol objects without allowing callbacks to execute or processing other events in the queue.

Annotation Textboxes Can Automatically Resize to Fit their Contents

In previous releases, textboxes had fixed sizes that users needed to adjust to fit the size of their contents. Now, if you create a textbox annotation using a GUI or the annotation function, it can grow or shrink to just fit the text you type into it. This behavior is controlled by the Annotation Textbox object's FitBoxToText property, which can be 'on' or 'off'. When you create a textbox with the Annotation toolbar (using the tool), this property is set to 'on' if you create a textbox without dragging; however, if you drag to make the new textbox have a certain size, the property is initially 'off'. When you create a textbox with the annotation function, for example,

htb = annotation('textbox')

without specifying a position and size, the textbox is created with FitBoxToText set to 'on'. If you specify a position vector in the command, for example,

htb = annotation('textbox', [.1 .8 .4 .1])

the textbox is created with FitBoxToText set to 'off'.

Similarly, if you resize a textbox in plot edit mode or change the width or height of its position property directly, its FitBoxToText property is set to 'off'. You can toggle this property with set, with the Property Inspector, or more conveniently, via the object's context menu, as the illustration below shows.

If you edit a textbox that has FitBoxToText set to 'on', the textbox resizes to accommodate the number of characters and lines in the text as you type. You can reposition the textbox without changing the FitBoxToText property, but as soon as you resize it, the property becomes (or remains) 'off'.

Property Inspector Now Has Context-Sensitive Help

When you use the Property Inspector (the inspect command), you can now ask for a description of any property it shows. The descriptions come from the property reference page for the type of object being inspected (e.g., axes, lineseries, annotations, uicontrols, etc.). To get a description of a property, right-click its name in the left-hand column of the Property Inspector and select What's This? from the context menu that appears. A mini-help window opens to show the property's description from the object's property reference page. If you need an overview of all properties pertaining to particular kinds of objects and how these objects relate, scroll through the entries in the mini-help window or open the Handle Graphics Property Browser from the Help Browser.

The "v6" Option for Creating Plot Objects is Obsolete

Prior to MATLAB Version 7, handles returned by high-level plotting functions referenced graphic primitives, such as lines and patches. In Version 7, MATLAB began bundling the primitives into "series" objects, for example, lineseries, barseries, and contourgroups. At that time, the v6 option was added to plotting functions to enable users of MATLAB Version 7.x to create FIG-files that previous versions can open. The v6 option is now obsolete. It will be removed in a future MATLAB release. The following functions include the option in their syntax and now warn when it is used:

Compatibility Considerations

Specifying the v6 flag to any plotting function now results in a warning that the option is being removed, but the option still functions. To generate a FIG-file for a plot created with the v6 option, you still need to use the -v6 option to the hgsave command in order to save it in a form that a previous version of MATLAB can read. Figures containing annotations (such as textboxes, arrows, ovals, and rectangles) that are saved this way open in previous versions, but the annotations do not display because different objects are used to contain them in Version 7 than before. That is, the annotation objects have never been backward compatible.

  


 © 1984-2008- The MathWorks, Inc.    -   Site Help   -   Patents   -   Trademarks   -   Privacy Policy   -   Preventing Piracy   -   RSS