Page History

Introduction

KIELER View Management (KIVi) is a high-level description engine for dynamic visualizations in diagrams (e.g. for graphical modeling). Its main driver is the availability of automatic layout as provided by KIML. It implements user interaction that builds upon automatic layout and therefore unfolds the full potentials of automatic layout. Different use-case examples are:

...

Follow the Javadoc links to see the corresponding package for the triggers, effects and combinations. It also gives a hint, which plug-ins to load in order to get access to the classes in your own plug-in.

Trigger(States)

• SelectionTrigger - Contains the most recent list of selected EObjects and the containing DiagramEditor
• ButtonTrigger- Generic TriggerState for KIVi buttons registered using the ButtonHandler. Buttons can be defined
  • using the standard Command extension point of eclipse and by using the ButtonHandler as the handler, or
  • defining a button programmatically, e.g. in the constructor of a Combination, using the KiviMenuContributionService. See an example Combination in KiviMenuContributionDemoCombination.java
• EffectTrigger - Triggered when a KIVi Effect has been executed
• ModelChangeTrigger - Contains the most recent change to a semantic model
• ModelChangeTrigger.DiagramChangeState - Contains the most recent change to a GMF diagram model
• ModelChangeTrigger.ActiveEditorState - Information about the active editor (not necessarily containing a diagram)
• DiagramTrigger - Information about the active diagram (e.g. in the active editor or view), used instead of ActiveEditorState with convenient access to diagram and semantic model

Synccharts and Papyrus UML StateMachine specific

• StateActivityTrigger - receives the most recent n steps of active states from the KIVi-KIEM data component during simulation of Synccharts or Ptolemy UML StateMachines

Effects

• UndoEffect - Pseudo-Effect used to simplify undoing Effects. The only point of contact as a developer is when merging Effects, the other Effect passed may be an UndoEffect containing the actual Effect
• MenuItemEnableStateEffect - Change the enabled state of a button defined with KVi
• LayoutEffect - Performs automatic layout with various options
• SetOptionsEffect - Sets layout option values for a specific model element
• HighlightEffect - Provides different methods of highlighting an EObject: Change its color, line width, or line style without changing the notation model
• CompartmentCollapseExpandEffect - Collapse or expand a compartment without changing the notation model
• ArrowEffect - Draws an arrow between two EObjects
• AnalysisEffect - Performs graph analysis and shows results in the Analysis view
• FocusContextEffect - Reduce level of detail for context elements, show all details for focus elements (e.g. by collapsing/expanding compartments)
• TransformationEffect - Executes a model to model transformation according to passed information.
• RefreshGMFEditPoliciesEffect - Refreshes the EditPolicies of an GMF editor.
• UnlockEffect - Notify all waiting threads on a given Object. Can be used to synchronize threads with the execution of effects.

Combinations

• LayoutCombination - Performs automatic layout after key combo/layout button is pressed
• RandomLayoutCombination - Perform random layout without changing any layout options.
• KSBasECombination - Used to perform layout, currently emptyexecute a ksbase transformation.
• LayoutAfterCollapseExpandCombination - Performs layout after a compartment was collapsed or expanded
• ShowHierarchyCombination - Paints the diagram like a rainbow depending on the hierarchy levels
• LayoutAnalysisCombination - Performs automatic analysis after layout
• ManualFocusCombination - Do Focus&Context viewing, where the focus are the selected elements in a diagram. Currently supported for Synccharts and KAOM-Diagrams.
• E2STransformationCombination - Performs a Esterel to Synccharts transformation and following a Synccharts optimization.

Synccharts specific

• LayoutAfterModelChangedCombination - Performs layout after the model was changed
• SignalFlowCombination - Displays the Dual Model
• SyncChartsCombination - Highlights/Collapses/Expands states during simulation
• HighlightSelectedTransitionsCombination - Higlights selected transitions (and all children) in Synccharts. Used to better see which transition belongs to which label.