In the preferences section you can adjust several base settings of ModuleStudio. This chapters explains what these settings do.
Here you can enable automatic save for the editors. You can specify an interval in seconds. This is especially interesting as a save operation triggers validation, too. So if you for example save the model every 30 seconds you can just work and the problems view keeps you updated about possible errors automatically.
The help section allows you to change some context settings about how help information is displayed. For example you can specify that the manual should always be opened in an external web browser instead of the included one.
ModuleStudio base preferences
- Default theme: choose whether you like to have the light or dark theme per default.
- Vendor, Author, Email address, Url: you can input your default values at this place. The wizard for creating a new model project will reuse these values, so you do not have to enter them repeatedly.
- Ignore model warnings during generation: enable this option to avoid that a message box appears if your model contains warnings.
- Override existing files: if you enable this option the generator will not abort if files exist in the selected output directory. Use with caution!
- Use staging updates: if that option is activated the auto update function will include unstable releases. Each time you start ModuleStudio it looks for whether updates are available. Per default it searches only for stable releases. With the staging channel you get also updates from every single build which earlier brings you new features, but also includes the risk of breaking things.
- Ignore updates: enable this option if you do not want ModuleStudio searching for updates.
The following preference pages are mainly intended for advanced users and are usually not required to be changed.
The MostDsl tab is related to the textual editor.
Here you can change styles for the syntax highlighting. For example you could have keywords in red instead of purple. Or you could have strings in bold style using another font.
This shows the available template proposals defined for the textual editor.
You can change them and add new ones if you like.
Inside the input field you can use content assist like in the textual editor, too.
This tab is about the diagram editor. Primarily this section allows you to enable or disable certain features. For example you could hide the status line or deactivate animated zoom.
The illustration above shows the default value of all these preferences.
- Show connector handles: This has no effect for ModuleStudio yet, but is planned for future.
- Show popup bars: Defines whether pop-up bars are used or not.
- Enable animated layout: If checked, then when you launch an automatic layout to arrange elements, the shapes will move smoothly to their final location. This makes the arrangement operation take a little longer, but it is easier to follow where your elements have been moved.
- Enable animated zoom: If checked, when you change the zoom value, ModuleStudio will show intermediate steps to smooth the change.
- Enable anti-aliasing: If checked, the graphics on the diagram will use anti-aliasing. This preference does not take effect on all platforms.
Show status line: This has no effect at the moment.
Auto-size containers during arrange-all action: Container elements which have an explicit size are normally not resized during an Arrange All. This can be problematic if the elements they contain are re-arranged so that the container’s size is not appropriate anymore. When this preference is enabled, the arrange all action will treat all containers as if they are “auto-sized”, and adjust their size to the computed arrangement for their content. After the arrange all action is finished, the containers which had an explicit size before will still have an explicit size (although potentially different); they are only switched to auto-size mode during the arrange all action.
Move unlinked notes during layout: If checked, then the Arrange All will consider all notes on the diagram and arrange them. If unchecked, only the notes which are attached to non-note diagram elements are moved by the layout; the rest (which are considered just comments on the diagram itself), are not touched.
Automatically mark moved elements as pinned: If checked, then as soon as you explicitly move a element (node or container) on the diagram, ModuleStudio will mark it as pinned and consider it should not be moved by the automatic layout. This setting is probably going to be disabled by default (and hidden) in future.
Synchronized mode for new diagrams: If checked, all newly created diagrams will initially be in synchronised mode. You should not disable this to avoid unwanted side effects. This option is probably going to be hidden in future.
Remove/hide note when the annotated element is removed/hidden: If checked, then notes attached to a diagram element will be deleted if the element is deleted, or hidden if the element is hidden.
The Appearance preferences page (see below) gives you two preferences to control whether or not to show the labels on shapes (nodes and containers) and connectors (edges). It also allows you to customise the default font and colours used for some basic diagram elements. Diagram configurations already specify default values for these style attributes, so in practice these preferences are mostly useful for notes.
This page allows changing some edge-related options.
- Show link between edge and its labels on selection: if enabled this shows links between an edge and its labels if one of these is selected. Read more at the corresponding section.
- Enable user specific line style: this allows you to change the edge style. By default ModuleStudio uses rectilinear edges. The following screenshot shows an example using the oblique style instead.