The Omni Group Forums

The Omni Group Forums (
-   OmniGraffle General (
-   -   The New Line Behavior in OmniGraffle 5.3: How to enable it, how it works (

Joel 2011-07-19 02:03 PM

The New Line Behavior in OmniGraffle 5.3: How to enable it, how it works
We've introduced new behavior to the way that lines connect to shapes in OmniGraffle 5.3, currently this behavior is off by default to preserve appearance for legacy and iPad documents, but this thread is here to show you how to enable the new line styles and to illustrate why you might want to check it out.

(Those of you who downloaded and installed the release candidate have already been exposed to this new behavior, the release notes have the command line defaults to turn it back on, as well as in this post.)

If you would like to enable the new line behavior works, paste the following in Terminal:

"[B]defaults write com.omnigroup.OmniGrafflePro UseOldBezierPathLayout NO[/B]" (if you are running OmniGraffle Professional, minus the quotes)

"[B]defaults write com.omnigroup.OmniGraffle UseOldBezierPathLayout NO[/B]" (if you are running the Standard version of OmniGraffle, minus the quotes)

"[B]defaults write com.omnigroup.OmniGrafflePro.MacAppStore UseOldBezierPathLayout NO[/B]" (if you are running OmniGraffle Professional purchased in the Mac App Store, minus the quotes)

"[B]defaults write com.omnigroup.OmniGraffle.MacAppStore UseOldBezierPathLayout NO[/B]" (if you are running the Standard version of OmniGraffle purchased in the Mac App Store, minus the quotes)

Of course, if you replace NO with YES you can go back to the old way that lines behave if you don't like the new way.

So, what does it all mean? We'll take it step by step:

[B]Line Endings and their Location[/B]

Typically lines desire to point towards the center of a shape that they're connected to (unless snapping to a nearby magnet), yet the endpoints of a selected line show their termination at the edge of the shape.


The new behavior will show the selected line's endpoints at the center of the shape, yet any arrowheads or line endings will still render at the edge of the shape (unless the line is connected to a magnet inside the shape and the line is in front.


There isn't any functional difference here between the old and the new, however the new behavior makes it distinctly easier to have a Bezier line loop around to connect to the same shape without having to make any midpoints, etc.

Joel 2011-07-19 02:04 PM

The New Line Behavior in OmniGraffle 5.3: How to enable it, how it works, Part 2
[B]The New Curved Line Type[/B]

We've made some significant changes to the way that the Curved line style looks, much more aesthetically for the better It's much easier now to get graceful and attractive curves between shapes with just one midpoint instead of having to fuss about with multiple midpoints.

(Here is an old-style Curved line between two squares with one midpoint.)

(And here is the same line rendered using the new line behavior.)

It's worth pointing out that to get the look and feel of the new curve you'd have to use the Bezier line style or multiple midpoints with the Curved style and it still wouldn't look quite as nice.


Joel 2011-07-19 02:04 PM

The New Line Behavior in OmniGraffle 5.3: How to enable it, how it works, Part 3
[B]The New Orthogonal Control Handle[/B]

Orthogonal lines have traditionally had a control handle at their midpoint for adjusting the 'dogleg' of the line where applicable, however that control would only move in one direction based on the layout.


The new control handle allows movement in both the X and Y directions, and provides for much more power when routing orthogonal lines.

(It's worth pointing out that without any interaction you will still get the traditional 'dogleg' between shapes unless you move the handle far enough away.)

The method winds up being fairly easy to understand; the line must route between both endpoints and through the handle with a minimum humber of segments. This means it's easy to get a line that goes from one side of a shape to the same side of another shape directly above or below without having to add midpoints.


You can also use the new Orthogonal line to get get perfectly horizontal and vertical lines between shapes without resorting to using magnets or faking it with the grid and not actually connecting the shapes.


[B]Going Forward and How to Best Handle Legacy Documents[/B]

As stated at the beginning of the post, this new behavior is off by default. We wanted to ensure that the transition wasn't bumpy for anyone out there as well as maintain appearances for documents going back and forth between the Mac and the iPad. There will be a future release where the new line behavior is the default (there will still be the preference to switch back if desired).

We're aware that many of you use OmniGraffle for more illustrative purposes, where you may not want how a Curved line routes to change at all (it may be a path laid over a map, or just something that's artistic in nature). so we'd like to elicit your feedback as to how we should handle older files. Should we simply flag legacy documents and leave well enough alone? Perhaps converting older Curved line types to Bezier so that they look exactly the same?

We'd love to hear from you on this subject, so please chime in here.

robertjlamb 2011-07-19 10:56 PM

Hi - my copy of 5.3 has the new behaviour as default - a very nice group of improvements for general diagramming.

irononmaiden 2011-07-20 07:16 AM

Thanks for these explanations. I've been trying to use the new orthogonal line controls, but they're so fussy that I don't think they're worth the effort.

The control handle seems to have an absolute position, so it doesn't move with the line when I rearrange things. That leads to lots of rearranging, converting back to straight lines, or just deleting and redrawing all the lines. Frustrating, and is already giving me a deep dread of revisions.

The control handle also seems [B]way[/B] too sensitive. I'm spending far too much time getting the proper angle, which used to be so easy. Then option+command+J to make sure the line isn't a pixel off.

The uses you mention in your post are good ones, but I need them way less often than I need a simple, clean, right angle that moves predictably.

Am I missing something? If so, I'm all ears. I'd love to be able to use these new features as easily as the old ones.

Joel 2011-07-20 10:28 AM

Once you move the control handle for the orthogonal line, we assume you want it to stay put -- If you Command-click the handle, it will snap back to its default "middle" position and move automatically between the shapes it's connecting as you move those shapes around.

Hope that sheds some light on how the handle works.

irononmaiden 2011-07-20 01:44 PM

Thanks, that helps.

john.gersh 2011-07-21 05:36 AM

On handling things after the new curvy lines are the default:

I think there are three principles to consider:

1: A document should look the same when opened as it did when saved, unless there's an informed choice to do otherwise.

2: You should be able to modify a document using current tools and editing methods without surprises.

3: The user may not know what "bezier" means.

This may be difficult to implement, but here's an idea:

On opening an old document with the new line defaults, the user is presented with a dialog explaining the situation and given the choice of turning curvies into beziers or leaving them as (new) curvies. The first choice preserves appearance, the second preserves line type and therefore behavior and modification methods. Before making the choice, the user is given the option of seeing the document in those two states. The "what if?" options inform the choice.

whpalmer4 2011-09-25 08:55 AM

[B]Going Forward and How to Best Handle Legacy Documents[/B]

As stated at the beginning of the post, this new behavior is off by default. We wanted to ensure that the transition wasn't bumpy for anyone out there as well as maintain appearances for documents going back and forth between the Mac and the iPad. There will be a future release where the new line behavior is the default (there will still be the preference to switch back if desired).

So what of the iPad app? Is the plan to provide this functionality there as well?

Joel 2011-09-25 09:58 AM

If you're running OmniGraffle for iPad v1.6 or later, you can enable the new line behavior by tapping this link on your iPad:


To go back to the old line behavior, tap the following link:


(more than likely you should copy/paste those URLs and email them to whatever account you're using on your iPad)

You will have to "force quit" OmniGraffle after enabling the new settings by pressing the Home button twice to bring up the fast app switching tray, then tap-and-hold the OmniGraffle icon until the red "minus" badge shows, then tap that to quit the app.

The new behavior should be showing on the next launch.

For what it's worth, we're considering making the new line behavior a per-line setting with a checkbox in the Connections Inspector, which seems like the more robust thing to do, but that's still in the discussion stage.

mrengy 2012-02-29 06:05 AM

bug with disappearing lines
Seem like some good changes, but there has been a [URL=""]bug in 5.3 with orthogonal lines disappearing[/URL] sporadically and reappearing only after toggling their position. I am wondering if these upgrades had anything to do with it.

Petra43210 2012-03-07 06:27 PM

Swim Lanes
Hi, Could someone confirm if there is swim lanes in any stencils for Omni Pro? thanks, P

Petra43210 2012-03-07 06:29 PM

Sorry I'm a bit slow, can someone explain to me how to paste into the Terminal:
Thanks, P

MatthewS 2012-07-12 02:20 PM

This new line behavior is an immensely powerful addition for OG. This will allow users to create flows that follow the market standard in engineering and CAD. Finally, I'll be able to produce flows that can match the rigid development culture entrenched in the use of Visio.

Great job!

calebg 2012-09-01 12:53 PM

does this functionality still exist? I'm using 5.4.2 on a mac, not purchased through the app store, standard version, and I cannot get the new behavior to work.

I find the old behavior very annoying, this would make omnigraffle almost perfect!

whpalmer4 2012-09-01 03:18 PM

Works here using 5.4.2 on 10.6.8 with the non-AppStore version. Perhaps you had OmniGraffle open when you pasted the necessary line into the Terminal app?

In the Terminal, do:

defaults read com.omnigroup.OmniGraffle

and make sure the line
UseOldBezierPathLayout = NO;[/code]
appears in the output.

calebg 2012-09-02 07:19 AM

I'm using omnigraffle 5.4.2 on OSX 10.7.4

I did have omnigraffle open the first time, but have since tried it without omnigraffle open, and I have also tried reinstalling omnigraffle (deleting both omnigraffle in Applications, as well as all default domains, and all preference files I could find in <Username>/Preferences. The required line is in the defaults. Any other ideas?

whpalmer4 2012-09-02 08:29 PM

1 Attachment(s)
Well, I just booted up 10.7.4 and it worked without a hitch. On the off chance that the issue is you're somehow not getting the configuration string correct, I've attached a small Applescript which will kill OmniGraffle and configure the new option. Make sure you've saved any work in OmniGraffle, because it won't ask if you want to save changed files! After downloading the linked file, double-click on it to unzip, then double-click the resulting "Enable new OG line mode.scpt" file to launch the AppleScript Editor. Click the Run button, then try OmniGraffle again. If it still isn't working at that point, I'd say your best bet is to call up the Omni support ninjas on Tuesday and have them figure it out: 800-315-6664 or +1-206-523-4152.

calebg 2012-09-03 01:37 PM

Thanks for all your help. I tried your script to no avail. Something strange is clearly going on. I'll call support tomorrow and see what they say, then post back here.

Thanks again for your help!

whpalmer4 2012-09-03 02:53 PM

One thing you could try while you wait is creating another user account. If it works there, then you know there's something messed up in your main account, but the installation is fine.

calebg 2012-09-04 10:09 AM

Talked to support and got it fixed.

Navigated to <username>/Library/Preferences, and removed com.omnigroup.OmniGraffle.plist

Then opened Console, searched for omni, and cleared the display.

Then re-ran the terminal command, created a new line, and everything works as expected!

wler711 2012-12-06 04:33 PM

Visio Export Issue
I just switched to the new line behavior. For the most part, I love it. One thing I don't love, though, is that it now seems that exporting to Visio does not make the new arrows appear correctly. With the new behavior, when an arrow is connected to an object (pointing towards it), the end point lies in the center of the object while the arrowhead actually appears at the border. Perfect. But when the diagram is exported to Visio, the arrowhead extends all the way to the center of the object, where the endpoint lies.

One of the main reasons I purchased the Pro version was for the Visio export functionality, as I use it heavily for my work. Unfortunately, this little bug is making my diagrams that contain arrows look pretty awful after they've been exported to Visio. Is there a fix for this? Thanks!

All times are GMT -8. The time now is 12:45 PM.

Powered by vBulletin® Version 3.8.7
Copyright ©2000 - 2022, vBulletin Solutions, Inc.