We are happy to provide release 2014/05 of the KIELER Pragmatics Project! It is a framework for enhanced user interaction in graphical modeling that builds on the Eclipse platform. This document describes how to install the release and highlights the most exciting new features.
As a bonus, we are co-releasing our KLighD-based KIELER Ptolemy Browser. As a further bonus, the next few days will see the first release of our KIELER KLayJS libraries that bring our very own KLay Layered layout algorithm to the world of JavaScript.
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! |
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", but may also be compatible with other versions of Eclipse.
See the KIELER Tools and Libraries page to download the KIELER Ptolemy Browser and the KIELER Web Service.
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. Release notes of older releases can be found at our Release Notes page.
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.
This is a summary of the API changes introduced with version 2014/05:
Renamed LayoutDataService to LayoutMetaDataService and renamed ILayoutData to ILayoutMetaData in order to avoid confusion with the KLayoutData meta model and the respective interface.
ILayoutConfig: renamed API method enrich() to getContextValue(..), renamed getValue(..) to getOptionValue(..), renamed setValue(..) to setOptionValue(..), renamed clearValues() to clearOptionValues(..) – see Configuring Automatic Layout for more details.
IDiagramLayoutManager does not inherit from IAdapterFactory anymore; adapter values are now accessed with layoutManager.getDiagramConfig().getContextValue(..)
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).
Here's a few highlights of what's new in version 2014/05:
Made categorization of the Layout View more understandable.
Added a creation method for VolatileLayoutConfig that makes the far too complicated STATIC_CONFIG of layout managers unnecessary.
LayoutOptions.PORT_SPACING
and LayoutOptions.ADDITIONAL_PORT_SPACING
.Properties.MERGE_HIERARCHICAL_PORTS
):One of the core features of KIELER Pragmatics is the KIELER Infrastructure for Meta-Layout (KIML). It provides the glue between diagram editors and layout algorithms. If you have installed layout support for GMF editors, you may want to try the following:
If you have a Ptolemy installation, try the following:
.moml
file somewhere.Download and start our Ptolemy Model Browser.
Starting with Mac OS X Mountain Lion, trying to start the Ptolemy Model Browser may give you the following error message: The problem is not that our application file is damaged in any way. Much rather, we have not invested the money to obtain a proper developer certificate with which this error would not be generated. The solution is to open your system preferences and navigate to the Security & Privacy settings. Therein, make sure to set Allow apps downloaded from to Anywhere: Start the Ptolemy Browser again. This will result in the following warning: Simple click "Open" and you're good to go at last. |
We're working hard to make the graphical modeling user experience as convenient as possible. However, bugs can still remain in the code and some things might not be as you would expect them. Please don't hesitate to send in bug reports or give other comments like feature requests.
Send bug reports to kieler@…, please. For news or general questions subscribe to the rt-kieler mailing list.