diff options
Diffstat (limited to 'plugins/org.eclipse.etrice.doc/html/etrice-docse18.html')
| -rw-r--r-- | plugins/org.eclipse.etrice.doc/html/etrice-docse18.html | 84 |
1 files changed, 42 insertions, 42 deletions
diff --git a/plugins/org.eclipse.etrice.doc/html/etrice-docse18.html b/plugins/org.eclipse.etrice.doc/html/etrice-docse18.html index 9f132de8b..a369f2ddf 100644 --- a/plugins/org.eclipse.etrice.doc/html/etrice-docse18.html +++ b/plugins/org.eclipse.etrice.doc/html/etrice-docse18.html @@ -10,7 +10,7 @@ <meta name="originator" content="TeX4ht (http://www.cse.ohio-state.edu/~gurari/TeX4ht/)" /> <!-- xhtml,3,next,html --> <meta name="src" content="etrice-doc.tex" /> -<meta name="date" content="2015-08-27 23:56:00" /> +<meta name="date" content="2015-08-28 18:10:00" /> <link rel="stylesheet" type="text/css" href="etrice-doc.css" /> </head><body > @@ -21,11 +21,11 @@ href="etrice-docse17.html#tailetrice-docse17.html" >prev-tail</a>] [<a href="#tailetrice-docse18.html">tail</a>] [<a href="etrice-docch6.html#etrice-docse18.html" >up</a>] </p></div> <h3 class="sectionHead"><span class="titlemark">6.3 </span> <a - id="x26-1470003"></a>Automatic Diagram Layout with KIELER</h3> + id="x26-1430003"></a>Automatic Diagram Layout with KIELER</h3> <a - id="x26-147001r194"></a> + id="x26-143001r193"></a> <h4 class="subsectionHead"><span class="titlemark">6.3.1 </span> <a - id="x26-1480001"></a>Overview</h4> + id="x26-1440001"></a>Overview</h4> <!--l. 5--><p class="noindent" >eTrice provides as a feature the automatic layout of the ROOM diagrams in its graphical editors. This helps in improving the pragmatics of the diagrams and frees the user from the burden of manually lay-outing the diagrams on the canvas. @@ -35,20 +35,20 @@ maintenance time, and improve the analysis of dynamic behavior. </p><!--l. 13--><p class="noindent" >This chapter will answer the following questions </p> <ul class="itemize1"> <li class="itemize"><a -href="#x26-1490002">”How to perform automatic layout in the graphical editors of eTrice?”</a> +href="#x26-1450002">”How to perform automatic layout in the graphical editors of eTrice?”</a> </li> <li class="itemize"><a -href="#x26-1500003">”What are layout options?”</a> +href="#x26-1460003">”What are layout options?”</a> </li> <li class="itemize"><a -href="#x26-1510004">”How to configure the layout options to alter the diagram layout as desired?”</a></li></ul> +href="#x26-1470004">”How to configure the layout options to alter the diagram layout as desired?”</a></li></ul> <!--l. 21--><p class="noindent" >Moreover, some <a -href="#x26-1540005">”special layout options”</a> will also be discussed. +href="#x26-1500005">”special layout options”</a> will also be discussed. <a - id="x26-148001r199"></a> + id="x26-144001r198"></a> </p> <h4 class="subsectionHead"><span class="titlemark">6.3.2 </span> <a - id="x26-1490002"></a>Performing Automatic Layout</h4> + id="x26-1450002"></a>Performing Automatic Layout</h4> <!--l. 26--><p class="noindent" >Automatic layout could be performed in eTrice graphical editors using the command to layout the current diagram. @@ -62,10 +62,10 @@ diagram. class="ec-lmsso-10">Ctrl+R L </span>shortcut.</li></ul> <!--l. 36--><p class="noindent" >Additionally, an entry in the context menu allows to layout only a selected part of the diagram. <a - id="x26-149001r200"></a> + id="x26-145001r199"></a> </p> <h4 class="subsectionHead"><span class="titlemark">6.3.3 </span> <a - id="x26-1500003"></a>Layout Options</h4> + id="x26-1460003"></a>Layout Options</h4> <!--l. 41--><p class="noindent" >A layout option is a customization point for the layout algorithms, with a specific data type and optionally a default value, used to affect how the active layout algorithm computes concrete coordinates for the graph elements. @@ -75,14 +75,14 @@ class="ec-lmsso-10">Show Layout View</span> entry. </p><!--l. 49--><p class="noindent" >On opening the layout view, and selecting any layout option, a description of the layout option is available in the footer of eclipse SDK. This is shown in figure <a -href="#x26-150001r1">6.1<!--tex4ht:ref: fig:layout_options --></a>. +href="#x26-146001r1">6.1<!--tex4ht:ref: fig:layout_options --></a>. </p> <hr class="figure" /><div class="figure" > <a - id="x26-150001r1"></a> + id="x26-146001r1"></a> @@ -91,30 +91,30 @@ src="images/043-LayoutOptionDescription.png" alt="PIC" /> <br /> </p><div class="caption" ><span class="id">Figure 6.1: </span><span -class="content">Layout options</span></div><!--tex4ht:label?: x26-150001r1 --> +class="content">Layout options</span></div><!--tex4ht:label?: x26-146001r1 --> </div><hr class="endfigure" /> <a - id="x26-150002r201"></a> + id="x26-146002r200"></a> <h4 class="subsectionHead"><span class="titlemark">6.3.4 </span> <a - id="x26-1510004"></a>Configuring Layout Options</h4> + id="x26-1470004"></a>Configuring Layout Options</h4> <!--l. 61--><p class="noindent" >The values of the layout options for a particular diagram object (in the visible diagram) can be changed using the Layout View of that diagram object. The initial values are the predefined <span class="ec-lmsso-10">default </span>values. These defaults can be changed using the context menu in Layout View as well as the Layout preference pages provided by eTrice. <a - id="Q1-26-204"></a> + id="Q1-26-203"></a> </p> <h5 class="likesubsubsectionHead"><a - id="x26-1520004"></a>The Layout View</h5> + id="x26-1480004"></a>The Layout View</h5> <hr class="figure" /><div class="figure" > <a - id="x26-152001r2"></a> + id="x26-148001r2"></a> @@ -123,12 +123,12 @@ src="images/043-LayoutView.png" alt="PIC" /> <br /> </p><div class="caption" ><span class="id">Figure 6.2: </span><span -class="content">Layout view</span></div><!--tex4ht:label?: x26-152001r2 --> +class="content">Layout view</span></div><!--tex4ht:label?: x26-148001r2 --> </div><hr class="endfigure" /> <!--l. 75--><p class="noindent" >The Layout view (figure <a -href="#x26-152001r2">6.2<!--tex4ht:ref: fig:layout_view --></a>) allows flexible customization of layout options for the selected objects in the eTrice diagram. +href="#x26-148001r2">6.2<!--tex4ht:ref: fig:layout_view --></a>) allows flexible customization of layout options for the selected objects in the eTrice diagram. If no object is selected, the view shows the options for the top-level container of the diagram. Options are stored persistently in diagram file (<span class="ec-lmsso-10">.structure file / </span>.behavior file) of the eTrice diagram, so that they are still @@ -151,7 +151,7 @@ the content of the layout view is updated to display only those options that are algorithm. </p><!--l. 98--><p class="noindent" >Selecting <span class="ec-lmsso-10">Restore Default Value </span>in the context menu or the view toolbar (figure <a -href="#x26-152002r3">6.3<!--tex4ht:ref: fig:layout_context_menu --></a>) removes any value for the currently +href="#x26-148002r3">6.3<!--tex4ht:ref: fig:layout_context_menu --></a>) removes any value for the currently selected option that is stored in the current model file, thus resetting the option to its default value. The view menu has an entry Remove all Layout Options which resets all options of the current model by removing persistent data in the model file. @@ -161,7 +161,7 @@ file. <a - id="x26-152002r3"></a> + id="x26-148002r3"></a> @@ -170,7 +170,7 @@ src="images/043-ContextMenu.png" alt="PIC" /> <br /> </p><div class="caption" ><span class="id">Figure 6.3: </span><span -class="content">Layout in context menu</span></div><!--tex4ht:label?: x26-152002r3 --> +class="content">Layout in context menu</span></div><!--tex4ht:label?: x26-148002r3 --> </div><hr class="endfigure" /> @@ -200,9 +200,9 @@ the diagram type. </li> <li class="itemize">Default values for layout options can most easily be manipulated based on the eTrice domain model elements.</li></ul> <a - id="Q1-26-208"></a> + id="Q1-26-207"></a> <h5 class="likesubsubsectionHead"><a - id="x26-1530004"></a>Preference Page</h5> + id="x26-1490004"></a>Preference Page</h5> <!--l. 140--><p class="noindent" >The user-defined <span class="ec-lmsso-10">default </span>values for layout options can also be set using the preference pages provided in eTrice. Three preference pages have been provided for this purpose </p> @@ -226,7 +226,7 @@ provided by the KIELER. Relevant entries in the <span class="ec-lmsso-10">KIELER > Layout </span>page are shown in the above preference pages. <a - id="Q1-26-210"></a> + id="Q1-26-209"></a> <span class="ec-lmssbo-10">Layout </span><span class="ec-lmssbx-10">Preference Page </span><br @@ -238,7 +238,7 @@ class="ec-lmsso-10">Set routing style of all edges to oblique </span>is active, automatic layout is performed. Since most layouters compute the routing of edges as part of their algorithm, these styles usually do not yield the expected results. <a - id="Q1-26-211"></a> + id="Q1-26-210"></a> <span @@ -260,7 +260,7 @@ for options that relate to edit parts or domain model elements, and the diagram relate to diagram types. Option is the name of the layout option, and Value is the currently set value of the option. Creating a new entry requires the selection of the type of related element (figure <a -href="#x26-153001r4">6.4<!--tex4ht:ref: fig_layout_preference_page --></a>) and entering its class +href="#x26-149001r4">6.4<!--tex4ht:ref: fig_layout_preference_page --></a>) and entering its class name or identifier. Class names of edit parts can be explored using the information button of the layout view, while the class names for the domain model elements and the diagram type identifiers for the diagram types can be selected with the Browse button. After that, a layout option has to be selected from the list using @@ -272,9 +272,9 @@ button. <a - id="x26-153001r4"></a><a - id="x28-16300047"></a><a - id="x29-16500048"></a> + id="x26-149001r4"></a><a + id="x28-15900047"></a><a + id="x29-16100048"></a> @@ -283,7 +283,7 @@ src="images/043-PreferencePage.png" alt="PIC" /> <br /> <div class="caption" ><span class="id">Figure 6.4: </span><span -class="content">Layout preference page</span></div><!--tex4ht:label?: x26-153001r4 --> +class="content">Layout preference page</span></div><!--tex4ht:label?: x26-149001r4 --> </div><hr class="endfigure" /> @@ -294,16 +294,16 @@ types which could be present in the behavior editor diagrams. Similar thing hold class="ec-lmsso-10">Structure </span>preference page. <a - id="x26-153002r203"></a> + id="x26-149002r202"></a> <h4 class="subsectionHead"><span class="titlemark">6.3.5 </span> <a - id="x26-1540005"></a>Special Layout Options</h4> + id="x26-1500005"></a>Special Layout Options</h4> <!--l. 198--><p class="noindent" >While most layout options are used to affect how the active layout algorithm computes concrete coordinates for the graph elements, there are some layout options that have a special role. <a - id="Q1-26-214"></a> + id="Q1-26-213"></a> </p> <h5 class="likesubsubsectionHead"><a - id="x26-1550005"></a>Layout Algorithm</h5> + id="x26-1510005"></a>Layout Algorithm</h5> <!--l. 203--><p class="noindent" >The option with identifier de.cau.cs.kieler.algorithm specifies which layout algorithm to use for the content of a composite node. The value can be either the identifier of a layout algorithm or the identifier of a layout type. In the latter case the algorithm with highest priority of that type is applied. @@ -316,10 +316,10 @@ class="ec-lmsso-10">KLay Layered </span>algorithm. Though the layout algorithm being used for performing layout can be changed at ones own will, it is recommended to use the defaults. <a - id="Q1-26-216"></a> + id="Q1-26-215"></a> </p> <h5 class="likesubsubsectionHead"><a - id="x26-1560005"></a>Diagram Type</h5> + id="x26-1520005"></a>Diagram Type</h5> <!--l. 215--><p class="noindent" >Diagram types are used to classify graphical diagrams for setting default layout option values for a set of similar diagrams. The diagram type of an element is specified with the layout option <span class="ec-lmtt-10">de.cau.cs.kieler.diagramType</span>. Thus, these help @@ -343,10 +343,10 @@ class="ec-lmsso-10">Structure Diagrams </span>- This type has been assigned to t Only the top-level container and the visible bounding box has been assigned these diagram types in respective editors. <a - id="x26-156001r213"></a> + id="x26-152001r212"></a> </p> <h4 class="subsectionHead"><span class="titlemark">6.3.6 </span> <a - id="x26-1570006"></a>Further References</h4> + id="x26-1530006"></a>Further References</h4> <!--l. 234--><p class="noindent" >Most parts of the above documentation have been taken from the "KIML wiki" (<a href="http://rtsys.informatik.uni-kiel.de/confluence/pages/viewpage.action?pageId=328078" class="url" ><span |