The state transition diagram preferences allow you to determine how state transition diagrams are displayed by default (options controlling what is displayed and how). Individual state transition diagrams can then be customized, as desired.
Options set in the Project Preferences dialog establish the defaults for all future diagrams. Any diagrams which are open or diagrams for which the view settings have been saved will not be affected by changes to the project preferences. To change these diagrams, open the individual diagram and change the local options.
Show State Behaviors - determines whether entry, exit, and do (root) functions related to the state are displayed on the state.
 |
If you wish to show state behaviors, ensure that the icon template is set to State Transition Node. This icon template contains specialized logic required to display state behaviors. |
Show Triggering Events - determines whether the triggering events are shown as part of the transition label.
Show Guard Conditions - determines whether the guard conditions are shown as part of the transition label.
Show Effects - determines whether the transition effects are shown as part of the transition label.
Show Frame - controls whether a frame will be shown around the diagram. If a frame is shown, the frame block contents are specified by the General Diagram settings.
User Local Icon Settings - determines whether each individual diagram defaults to use its own independent (local) icon settings or these global settings. If the diagram is marked to use local icon settings, changes to the icon settings in the Project Preferences will not impact that diagram. If the diagram is marked to use global icon settings, diagram icons will update as the user changes the icon settings in the Project Preferences. If you wish to standardize the look of your diagrams across each individual diagram, using global settings will simplify icon management. When a specific diagram has special needs, using local icon settings allows you to customize the diagram-level icon settings.
Color - controls the font, line, and fill color for the diagram background. On the use case diagram, the line color controls the diagram frame. In addition, the line and text colors control the color of the lines that connect icons and their associated labels.
| |
Tips and Tricks When using graphical images on diagrams, it is often best to use a white background. |
The icon settings control the default display of the use cases on the diagram. The graphic pane displays a sample icon based upon the current icon settings. This is useful in evaluating how much space is available to display information on the icon. On a given diagram, individual icons can then be customized, as desired.
Icon Size - controls the default width and height of icons on the diagram. The width and height must each be between 10 and 500 pixels, inclusive.
Icon Spacing - controls the default spacing between icons used by the diagram positioning algorithm. The horizontal and vertical spacing must each be between 5 and 500 pixels, inclusive.
Icon Template - this drop-down allows you to select the desired icon content from the collection of templates defined at the project level. You can display any combination of element information and labels on the icon. Icon templates can be created or customized via the Icon Registry under the Utilities section of the project explorer.
Use Image - toggles the default icon presentation between a geometric frame and a graphic representation. If toggled to display a graphic, CORE will display the image associated with the element with the icon template fields shown below the image. If the element bitmap has not been set, CORE will display the image associated with the element's class.
Bold - toggles bold font on or off for the icon text.
Italic - toggles italics font on or off for the icon text.
Color - provides access to the standard color palette to set the default font, line, and fill color used when drawing icons on this diagram. The order of precedence CORE uses when drawing a specific node on a diagram is as follows. If a color setting is nil/automatic, CORE will continue to move down the list until it identifies the color to be used:
Colors applied directly to the specific node on the specific diagram (set using the toolbar buttons on the diagram)
Colors specified for the element font, line, and fill attribute fields (set on the secondary tab of the element property sheet)
Colors specified for the element class font, line, and fill properties (set on the class property sheet)
Colors specified for the node construct type (set in the General Diagram category of the project preferences)
Node colors specified for the diagram type (set in the Diagram Options)
These settings control the representation of the transition arrows (both incoming and outgoing) and their labels. By default, these elements are not represented (state transition diagrams classically show events, guard conditions, and effects but not the names of the transitions themselves). However, any representation can be used for the arrows as it can for the state icons by selecting the desired template from the drop-down list of icon templates. For example, you can display abbreviations only to de-clutter the diagram, display numbers and names to show more information, or present any combination of element information and labels you desire. The content of the icon template is automatically concatenated into a single label for display.
With the exception of the Use Image option which is not appropriate for arrows, the arrow settings available are identical to the icon settings options.