Skip to main content

Notice: this Wiki will be going read only early in 2024 and edits will no longer be possible. Please see: https://gitlab.eclipse.org/eclipsefdn/helpdesk/-/wikis/Wiki-shutdown-plan for the plan.

Jump to: navigation, search

Papyrus/Papyrus Developer Guide/Papyrus diagram generation

< Papyrus‎ | Papyrus Developer Guide
Revision as of 11:53, 15 April 2011 by Vincent.lorenzo.cea.fr (Talk | contribs) (Label Role (Coming soon))

Papyrus editor add some new features to GMF, and needs specific generation. Here is a little guide explaining how to deal with the Papyrus generation stuff.

How to generate a diagram for Papyrus

The generation has to be run in a runtime application.

Setup your runtime application

It is strongly recommended to setup your runtime application before running a generation in order to avoid Java Heap Space error.

In the Run configuration menu, you can

  • Add specific vm arguments (-Dosgi.requiredJavaVersion=1.5 -XX:MaxPermSize=256M -Xms40m -Xmx512m -XX:PermSize=64M):

Capture-Run Configurations.gif

  • Use the arguments define in a *.ini file (for instance the eclipse.ini of your Eclipse)

Capture-Run Configurations Configuration.gif

Import the required project

You will need to import from your workspace the following project into your runtime application (do not copy them) :

  • org.eclipse.papyrus.codegen
  • org.eclipse.papyrus.def
  • the plugin of the diagram you will generate (like org.eclipse.papyrus.diagram.clazz)

Update the GMFGen

In your GMFGen, you have to update two properties to take into account the specific Papyrus templates. In the node GenEditor of your gmfgen files, you have to setup the following properties :
Dynamic Templates to true
Template Directory to /org.eclipse.papyrus.def/dynamic-templates3.5/codegen

Run the generation

To run the transformation, rigth click on your gmfgen file and select the menu Generate Papyrus Diagram.

How to add your own template to the custom Papyrus generator

To add a new template to the mechanism of generation, you have to :

  1. Add your template xpt to the plugin org.eclipse.papyrus.def under a subfolder of "dynamic-templates3.5/codegen/xpt"
  2. In the plugin org.eclipse.papyrus.codegen, edit the class org.eclipse.papyrus.codegen.PapyrusCodegenEmitters by adding a get method for your template :
public TextEmitter getyourTemplateNameEmitter() {
return newXpandEmitter("xpt::yourTemplatePath::yourTemplateName::yourStartingDefine"); //$NON-NLS-1$
}

where
yourTemplateName is the name of your template
yourTemplatePath is the path to access to your template from the folder xpt. Subfolder has to be separated by ::
yourStartingDefine the define that will start the generation

  1. Edit the class org.eclipse.papyrus.codegen.PapyrusGenerator
  2. Add a method generateXXXPage() :
private void generateDiagramPreferencePage() throws InterruptedException, UnexpectedBehaviourException {
doGenerateJavaClass(emitters.getyourTemplateNameEmitter(), PackageName,
ClassName, Input);
}

where
getyourTemplateNameEmitter() : is the new TextEmitter defined before
PackageName : is the name of the package the class will be contained in. It has to match with the one specified in the template.
ClassName : is the name of the class. It has to match with the one defined in the template.
Input : is the input element. It has to match with the type defined with FOR in your first xpt define.

  1. Call this method in the method customRun().


You just now have to run your transformation as explained before in this page. Be careful to refresh your projects in your runtime application if you generate in this mode.

Papyrus Extension Root Node Description

TODO


Compartment Visibility Preference (Coming Soon)

Description : This extension allows to define the default visibility for the compartments. The compartments not referenced by this node are visible by default.

Fields for this node:

  • Comment : a comment
  • Visible By Default : true or false, allows to define the visibility preference for the compartments

Compartment Title Visibility Preference (Coming Soon)

Description : This extension allows to define the default visibility for the titles of compartments. The titles not referenced by this node are visible by default.

Fields for this node:

  • Comment : a comment
  • Visible By Default : true or false, allows to define the visibility preference for the compartments titles

Label Role (Coming soon)

Description : This extension is used to define the role of the labels (Connection Labels and External Node Labels). The informations provided by this node are used in two ways :

  • Define which label should be hidden after the element creation (Preference Page)
  • Provide the role of the label in the Manage Labels dialog.

Fields for this node:

  • Comment : a comment
  • External Node Label : the list of the external node labels which have the specified role
  • Icon Path Role : an icon to illustrate the role of the label
  • Link Labels : the list of the link labels which have the specified role
  • Role : the role of the referenced labels
  • Visible By Default : true or false, allows to define the preference for the labels

The LabelEditPart referenced by the Label Role Node implements the interface ILabelRoleProvider.


Warning : if you have a node representation and a link representation for the same element (for example, AssociationNodeEditPart and AssociationEditPart),

when you define the Metamodel Type or the Specialization Type of the element, you can't specify the same "Display Name" for each EditPart.

This "Display Name" is used to generate the Preferences Pages. So, before you had one Preference Page by Element (I think) and after you get 2 Preferences Pages :

  • After :
    • AssociationNodePreferencePage
    • AssociationLinkPreferencePage
    • (you should destroy AssociationPreferencePage)


If you don't use this node :

  • you can't manage the display of the labels in the preferences pages and all labels are visible by default.
  • the dialog to manage the labels works (if you have the correct EditPolicy), but it doesn't display the role.

Examples of usage:

  • Labels Preferences for Association

Label Preferences for Association

  • Labels Manager

LabelManager

How to overwrite existing GMF template

TODO

Back to the top