Some Eclipse Foundation services are deprecated, or will be soon. Please ensure you've read this important communication.
Bug 359219 - Anchor documentation unclear
Summary: Anchor documentation unclear
Status: CLOSED FIXED
Alias: None
Product: Graphiti
Classification: Modeling
Component: Core (show other bugs)
Version: 0.8.0   Edit
Hardware: All All
: P3 enhancement (vote)
Target Milestone: 0.9.0   Edit
Assignee: Project Inbox CLA
QA Contact:
URL:
Whiteboard: Juno M6 Theme_round_offs
Keywords:
Depends on:
Blocks:
 
Reported: 2011-09-28 08:33 EDT by Matthias Gorning CLA
Modified: 2012-06-29 04:20 EDT (History)
4 users (show)

See Also:
matthias.gorning: juno+

Attachments
Add an attachment (proposed patch, testcase, etc.)

Note You need to log in before you can comment on or make changes to this bug.
Description Matthias Gorning CLA 2011-09-28 08:33:33 EDT 
The documentation for FixPointAnchors/BoxRelativeAnchors needs to be improved. 

Currently it is not clear where the connection starts or ends. Is it the center of the anchor's GA or the location of the FixPointAnchor (or in case of a BoxRelativeAnchor the calculated location)?

How can it be achieved that connections starting precisely from the border?
Comment 1 Michael Wenz CLA 2011-10-06 10:43:55 EDT 
Marked as enhancement
Comment 2 Hernan Gonzalez CLA 2011-11-07 10:57:41 EST 
More than that, the general concepts are unclear:

- What defines the "anchor area"? (the are that will act as an anchor when starting a connection)? It seems to be the main GA assigned to the anchor, but I'm not sure.

- What is a "referencedGraphicAlgorihm" ? (seems to determine  the "border" at which the "reference point" lies, but again, I'm not sure)

- How does positioning work? When one assigns a GA to an anchor and sets its position to point (30,40), this coordinates are relative to ... what ? can they be negative ?

See http://www.eclipse.org/forums/index.php/t/254053/
Comment 3 Juergen Pasch CLA 2012-02-23 05:18:10 EST 
I have polished the chapter "Anchors" in the tutorial. There is now an example with a code snippet that a connection "starts precisely from the border". I have also added a "definition" of an anchor and the role of its graphical representation.

The existing code snippets are adjusted according to anchors which are located within a shape. How to render the graphical representation of an anchor which has an location outside of the shape is explained later on in chapter "Selection "Behavior".
Comment 4 Michael Wenz CLA 2012-04-11 10:54:30 EDT 
Bookkeeping: Set target release
Comment 5 Michael Wenz CLA 2012-06-29 04:20:44 EDT 
Part of Graphiti 0.9.0 (Eclipse Juno)