Skip to Content
Last modified by Alexander Schulz-Rosengarten on 2023/09/13 12:18
From version 1.1
edited by cds
on 2014/10/01 12:50
Change comment: There is no comment for this version
To version 6.1
edited by chsch
on 2014/10/02 14:03
Change comment: There is no comment for this version

Summary

Details

Page properties
Author
... ... @@ -1,1 +1,1 @@
1 -XWiki.cds
1 +XWiki.chsch
Content
... ... @@ -13,78 +13,63 @@
13 13  
14 14  As a bonus, we are co-releasing our KLighD-based **KIELER Ptolemy Browser**.
15 15  
16 -{{info title="What's with the new version numbering scheme?"}}
17 -Instead of naming this release //KIELER Pragmatics 0.12.0//, we decided to name it //KIELER Pragmatics 2014/05//. This way, people immediately see when this version was released. Also, since the plug-ins and features carry a timestamp, people can immediately see which release a particular plug-in or feature belongs to. All hail to clarity!
18 -{{/info}}
19 19  
20 -
21 21  
22 -
23 -
24 24  {{toc minLevel="2"/}}
25 25  
26 26  == Installation ==
27 27  
28 -KIELER Pragmatics 2014/05 is provided as a set of features, available to be added to your Eclipse installation via an update site. KIELER Pragmatics 2014/05 was tested on [[Eclipse 4.3 "Kepler">>url:http://www.eclipse.org/downloads/||shape="rect"]], but may also be compatible with other versions of Eclipse.
22 +KIELER Pragmatics 2014/10 is provided as a set of features, available to be added to your Eclipse installation via an update site. KIELER Pragmatics 2014/10 was tested on [[Eclipse 4.3 "Kepler">>url:http://www.eclipse.org/downloads/||shape="rect"]], but may also be compatible with other versions of Eclipse.
29 29  
30 -* See the [[KIELER Downloads>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/||shape="rect"]] site for download details.
24 +* See the [[KIELER Downloads>>doc:Downloads]] site for download details.
31 31  * KIELER Pragmatics requires an installed Java Runtime Environment >= version 1.5.
32 32  * The layout components of KIELER can make use of the layout algorithms provided by the [[Graphviz>>url:http://www.graphviz.org/||rel="nofollow" shape="rect" class="external-link"]] library. You may want to install that.
33 33  
34 -See the [[KIELER Tools and Libraries>>url:http://www.informatik.uni-kiel.de/rtsys/kieler/downloads/tools-and-libraries/||shape="rect"]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
28 +Also refer to the [[KIELER Downloads>>doc:Downloads]] page to download the KIELER Ptolemy Browser and the KIELER Web Service.
35 35  
36 36  == Release Notes ==
37 37  
38 -The 2014/05 release of KIELER Pragmatics continues our efforts to redesign our core APIs, KIML and KLighD. **It includes a number of API-breaking changes, so beware of upgrading to this release if you currently do not have time to adapt your code accordingly.** You can find a list of solved tickets for this release at [[our issue tracking system>>url:http://rtsys.informatik.uni-kiel.de/jira/secure/ReleaseNote.jspa?projectId=10400&version=10700||shape="rect"]]. Release notes of older releases can be found at our [[doc:Release Notes]] page.
32 +{{warning}}
33 +Write a summary of the release notes
34 +{{/warning}}
39 39  
36 +
37 +
40 40  If you're wondering where components have gone that were traditionally a part of KIELER, you might not know yet that the KIELER was split into two separate projects, KIELER Pragmatics and KIELER Semantics, which release pretty much independently.
41 41  
42 -=== API Changes in 2014/05 ===
40 +=== API Changes in 2014/10 ===
43 43  
44 -This is a summary of the API changes introduced with version 2014/05:
42 +This is a summary of the API changes introduced with version 2014/10:
45 45  
46 46  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
47 -* (((
48 -[[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]* (((
49 -Renamed LayoutDataService to LayoutMetaDataService and renamed ILayoutData to ILayoutMetaData in order to avoid confusion with the KLayoutData meta model and the respective interface.
50 -)))
51 -* Removed generic type argument from LayoutOptionData.
52 -* (((
53 -ILayoutConfig: renamed API method enrich() to getContextValue(..), renamed getValue(..) to getOptionValue(..), renamed setValue(..) to setOptionValue(..), renamed clearValues() to clearOptionValues(..) – see [[doc:Configuring Automatic Layout]] for more details.
54 -)))
55 -* (((
56 -IDiagramLayoutManager does not inherit from IAdapterFactory anymore; adapter values are now accessed with layoutManager.getDiagramConfig().getContextValue(..)
57 -)))
58 -* (((
59 -Graphiti bridge: moved some methods from KimlGraphitiUtil to GraphitiDiagramLayoutManager in order to allow easier adaptation in subclasses. Furthermore, we now differentiate margins (spacing to visible part of a node) and insets (spacing to nested subgraph).
60 -)))
61 -* Made a design review of the de.cau.cs.kieler.core plugin and improved the API of some core classes and interfaces.
62 -)))
45 +** {{code language="none"}}IPropertyHolder{{/code}}'s {{code language="none"}}setProperty(...) {{/code}}and {{code language="none"}}copyProperties(...){{/code}} now return {{code language="none"}}IPropertyHolder{{/code}} instead of {{code language="none"}}void{{/code}}, implementations are supposed to return {{code language="none"}}this{{/code}} for convenience
46 +** {{code language="none"}}IUpdateStrategy{{/code}} now requires the method {{code language="none"}}requiresDiagramSynthesisReRun(...){{/code}} that allows to tell KLighD's runtime whether a new synthesis run is required for performing a (certain) diagram update
47 +** Introduced {{code language="none"}}IKlighdSelection{{/code}} interface
48 +** Updated {{code language="none"}}layoutDiagram(...){{/code}} methods in {{code language="none"}}LightDiagramServices{{/code}}
49 +* [[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]
63 63  
64 -=== New Features Included in 2014/05 ===
51 +=== New Features Included in 2014/10 ===
65 65  
66 -Here's a few highlights of what's new in version 2014/05:
53 +Here's a few highlights of what's new in version 2014/10:
67 67  
68 68  * [[KIELER Lightweight Diagrams>>doc:Lightweight Diagrams (KLighD)]]
69 -* (((
70 -[[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]* (((
71 -Made categorization of the Layout View more understandable.
72 -)))
73 -* (((
74 -Added a creation method for VolatileLayoutConfig that makes the far too complicated STATIC_CONFIG of layout managers unnecessary.
75 -)))
76 -)))
56 +** Enabled the zoom level-based visibility of diagram elements (nodes, ports, edges, labels) and figure elements (fine grained figure details, texts, ...), see {{code language="none"}}setUpperVisibilityScaleBound{{/code}} & {{code language="none"}}setLowerVisibilityScaleBound {{/code}}methods in DiagramSyntheses
57 +** Enabled output-dependent visibility (main diagram, outline, printout, image export) of figure elements (highlightings, fine grained figure details, texts, ...), see corresponding methods in DiagramSyntheses
58 +** Diagram image export now supports tiled exports enabling the export of huge diagrams, which may be prevented by memory limitations in the past
59 +** Contributed appropriate print support and (customizable) print dialog with preview
60 +** Contributed generic {{code language="none"}}PortRotationModifier{{/code}} (style modifier) that realizes the rotation of port figures in case ports are moved to a different side by the automatic layout computation
61 +* [[KIELER Infrastructure for Meta-Layout>>doc:Infrastructure for Meta Layout (KIML)]]
77 77  * [[KIELER Layout Algorithms>>doc:Layout Algorithms (KLay)]]
78 -** KLay Layered now makes sure that labels of compound node ports placed on the inside of the compound node are not overlapped by nodes inside the compound node.
79 -** KLay Layered now supports controlling the spacing between and around ports through the new layout options {{code language="none"}}LayoutOptions.PORT_SPACING{{/code}} and {{code language="none"}}LayoutOptions.ADDITIONAL_PORT_SPACING{{/code}}.
80 -** KLay Layered now understands LayoutOptions.NO_LAYOUT, which can be set to exclude particular graph elements from automatic layout.
81 -** KLay Layered now understands a new programmatic option for edge thickness.
82 -** When in hierarchical layout mode, KLay Layered now properly places edge labels of cross-hierarchy edges.
83 -** When in hierarchical layout mode, KLay Layered can now compact cross-hierarchy edges as it can compact regular edges ({{code language="none"}}Properties.MERGE_HIERARCHICAL_PORTS{{/code}}):
84 -[[image:attach:merge_hierarchy.png]]
85 85  * [[KGraph Text>>doc:KGraph Text (KGT)]]
86 -** The textual language for defining KGraphs now has a lot more defaults. Node and port labels are automatically extracted from the node's and port's ID. Nodes and ports also have a default size. This makes for shorter diagram descriptions.
87 87  
65 +=== Important Bugs Fixed in 2014/10 ===
66 +
67 +Among others, the following bugs were fixed in version 2014/10:
68 +
69 +* [[KIELER Layout Algorithms>>doc:Layout Algorithms (KLay)]]
70 +** In KLay Layered, the polyline edge router could produce results where edges overlapped nodes.
71 +** In KLay Layered, the polyline edge router could produce weird results when more than one edge leaves a given port.
72 +
88 88  == Quickstart ==
89 89  
90 90  === Diagram Layout ===
Confluence.Code.ConfluencePageClass[0]
Id
... ... @@ -1,1 +1,1 @@
1 -9471861
1 +9471871
URL
... ... @@ -1,1 +1,1 @@
1 -https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471861/KIELER Pragmatics Release 2014/10
1 +https://rtsys.informatik.uni-kiel.de/confluence//wiki/spaces/KIELER/pages/9471871/KIELER Pragmatics Release 2014/10