Eclipse Community Forums: Graphiti » "If the meaning of the X attribute isn't clear, there really should be more of a description...

Home » Modeling » Graphiti » "If the meaning of the X attribute isn't clear, there really should be more of a description...(Help with lack of doc?)

Show: Today's Messages :: Show Polls :: Message Navigator

"If the meaning of the X attribute isn't clear, there really should be more of a description... [message #1709859]

Thu, 01 October 2015 14:14

Rafal Filipiuk

Messages: 14
Registered: September 2015

Junior Member

Hi,

I'm an inexperienced GUI/front-end dev. I've been playing around with the graphics side of things and I noticed that every time I look at the doc for methods offered by, say, gaService or Style, the doc either says Sets the value of the 'X' attribute or Returns the value of the 'X' attribute. If the meaning of the 'X' attribute isn't clear, there really should be more a description here...

A lot of the attributes are self-explanatory; such as height, width, X, Y, font, color, etc. But some are more arcane to me: what is 'Filled', or 'Angle', or 'Proportional', or 'Active'? Those are just off the top of my head but how does everyone know what these mean? Is there a reference manual for every property? I'm guessing that a lot of these properties are common knowledge among front-end devs, but is there anything I can consult instead of being met with a useless comment such as the one in this thread's title?

[Updated on: Thu, 01 October 2015 14:15]

Report message to a moderator

Re: "If the meaning of the X attribute isn't clear, there really should be more of a descriptio [message #1709895 is a reply to message #1709859]

Thu, 01 October 2015 19:16

Marek Jagielski

Messages: 97
Registered: April 2012

Member

As for me, I just test them what they do.

Report message to a moderator

Re: "If the meaning of the X attribute isn't clear, there really should be more of a descriptio [message #1709941 is a reply to message #1709895]

Fri, 02 October 2015 07:34

Michael Wenz

Messages: 1931
Registered: July 2009
Location: Walldorf, Germany

Senior Member

Rafal, Marek,

perfectly right, there should be documentation on the flags (and the rest) of the Graphiti model. There is a rather old bugzilla still open for this: https://bugs.eclipse.org/bugs/show_bug.cgi?id=381178. Unfortunatly nobody has found the time so far to work on it.

Michael

Report message to a moderator

Re: "If the meaning of the X attribute isn't clear, there really should be more of a descriptio [message #1709992 is a reply to message #1709941]

Fri, 02 October 2015 14:12

Rafal Filipiuk

Messages: 14
Registered: September 2015

Junior Member

@Marek Testing is not that straightforward, is it? For example, a pictogramElement such as an Anchor has 'Referenced Graphics Algorithm' as a property. How would I find out what that is for through testing? I'm not an experienced dev, so I'm genuinely curious if there is a way.

Report message to a moderator

Previous Topic:	Positioning IDecorator in different PictogramElement
Next Topic:	translations in babel package/site

Goto Forum:

-=] Back to Top [=-

[ Syndicate this forum (XML) ] [

]

Current Time: Sat Jul 27 14:56:54 GMT 2024

.:: Contact :: Home ::.

Breadcrumbs

Sign up to our Newsletter