Reference

Exporting to Different Formats

You can create files of several different types from your OmniGraffle diagrams. Select Export from the File menu. When you export, a new file is written to the disk, leaving your original document as it is on the screen. Of course, not all aspects of a diagram can be represented in all file formats.

The available file formats are:

  • BMP bitmap image — A legacy graphics format.

  • EPS vector image — Encapsulated PostScript. This is a common format in professional printing.

  • GIF bitmap image — A legacy graphics format prevalent on the web.

  • HTML Image Map — A hypertext file and a JPEG, PNG, or GIF image. URL actions in the original OmniGraffle document are coded into the image map as links so that the image can be clicked to follow them. (Note that actions on lines aren’t included, but actions on line labels are)

  • JPEG bitmap image — a popular compressed image format. You can lower the image quality to get a smaller file size.

  • OmniGraffle Document (Pro) — an OmniGraffle document. You can make the file read-only (not editable), and you can choose to include linked images in the file so that they show up properly on someone else’s computer.

  • OmniGraffle Stencil, OmniGraffle Template — Resources for OmniGraffle.

  • OmniOutliner 3 — Represent the diagram as a text outline, using the connection lines between shapes to create a hierarchy. This doesn’t work as well for diagrams that don’t have strictly tree-like structures.

  • PDF vector image — Portable Document Format. This is a nice cross-platform format that has good support for both vector components and bitmaps.

  • PNG bitmap image — Portable Network Graphics, a popular format for the Web. This format uses lossless compression to retain the details of an image while decreasing its file size. It supports transparency.

  • Photoshop® image (Pro) — Exports a layered .psd file that can be opened in Adobe Photoshop, or other graphics apps that can interpret a .psd file.

  • SVG vector drawing (Pro) — An open Internet standard that uses XML.

  • TIFF bitmap image — Tagged Image File Format. This format supports transparency.

  • Visio® XML document (Pro) — The XML-based file format for the Microsoft® diagramming application.

Depending on the file format you choose, you have different options. Most offer an Export Area option, with which you can choose how much of the document to export.

  • Current Selection — Only export the objects that are selected right now.

  • All Objects — Export all of the objects on the canvas, but not the empty areas.

  • Region — Specify a precise region of the canvas to export.

  • Current Canvas — Export the entire canvas.

  • Whole Document — Export everything, creating one image file for each canvas.

Depending on the format you choose, you can also choose a scale for exporting smaller or larger than actual size, the resolution, the compression level, and whether to make the background transparent.

Importing from Other Applications

Several different file formats can be understood by OmniGraffle. You can import these files by opening them just as you would open a normal OmniGraffle file.

(Pro) Microsoft® Visio® documents, templates, and stencils (.vsd, .vdx, .vst, .vtx, .vss, .vsx)

  • Documents saved by Microsoft® Visio® diagramming software in its XML-based file format (and now even in its original binary file format! Yeah!) can be read by OmniGraffle Pro. Note that while you can open the binary format, you can’t export to it; you’ll have to save as an OmniGraffle diagram or export to the XML format. Also note that graphics in the Microsoft® Enhanced Metafile (EMF) format can’t be imported.

DOT files (.dot)

Diagram! 2 documents (.diagram2 and .dpalette2)

  • Diagram is a NeXTSTEP/OPENSTEP application similar to OmniGraffle. OmniGraffle can import the objects in a Diagram file, but not attached EPS images, sounds, or links.

OmniOutliner documents (.ooutline and .oo3)

  • When you open an OmniOutliner file, the items of the outline are interpreted as a diagram. A dialog appears; use it to indicate exactly how to interpret the outline:

  • Use the pop-up list to choose a diagram style.

  • (Pro) Use the table to assign objects in the diagram style to columns in the outline. If you want to show multiple columns of information for each item, use a diagram style that has grouped objects. You can also assign a column to the objects’ notes.

  • (Pro) Choose whether to put the outline in a completely new document or in a new canvas on the open document.

(Pro) Xcode projects (.xcode), Project Builder projects (.pbproj), and frameworks (.framework)

  • OmniGraffle uses the Objective-C headers to construct a diagram of the inheritance, protocol, and category relationships.

(Pro) Interface Builder nib files (.nib)

  • OmniGraffle graphs the connections in the nib file for easy visualization.

EOModeler files (.eomodeld)

  • OmniGraffle creates a diagram of the database relationships described by the file.

Folder structures

  • Drag a folder from the Finder and drop it on OmniGraffle’s application icon to map out the folder’s contents as a diagram.

AppleScript Support (Pro)

OmniGraffle has extensive AppleScript support, making it easy for you to automate tasks within or to create entirely new OmniGraffle projects. To find out more about how OmniGraffle’s AppleScript object model and commands, launch AppleScript Editor (/Applications/Utilities, or use Shift-Command-U while in the Finder), choose File ▸ Open Dictionary, and then choose your version of OmniGraffle from the Open Dictionary dialog.

You can store AppleScripts in OmniGraffle’s scripts folder, for easy access from the Scripts menu. You can also attach scripts to individual objects on a canvas, using the Action inspector. When you activate the Browse tool, then click an object with a script attached, the script runs.

If you select some objects and then choose Edit ▸ Copy As ▸ AppleScript from the menu bar, you get the exact lines of AppleScript necessary to create those objects. This is a great way to learn how OmniGraffle’s AppleScript support works, or to add specific objects to your own scripts.

LinkBack

LinkBack is a way of embedding content between applications in such a way that you can always go back and edit the content with the software used to create it originally.

For lots of information about LinkBack, and a list of applications that support it, check the website at www.linkbackproject.org.

To embed OmniGraffle content in another LinkBack application, just copy and paste the content like you would normally. The same goes for embedding other applications’ content in OmniGraffle diagrams.

To embed OmniGraffle content inside a single object in OmniGraffle, select all of the objects on your canvas (Command-A), choose Edit ▸ Copy As ▸ PDF from the menu bar, and then Paste (Command-V). The objects you copied become a single image; double-clicking the object opens a new OmniGraffle window in which you can edit the objects to your heart’s content.

To edit OmniGraffle content embedded in another application:

  • Double-click the OmniGraffle content in the other application’s document; an OmniGraffle window appears containing the content.

  • Edit the content in the OmniGraffle window, just as you normally would.

  • In OmniGraffle, choose File ▸ Save; the content in the other application updates automatically.

  • To edit other LinkBack applications’ content embedded in an OmniGraffle diagram, just double-click it. When you save in the other application, the content in the OmniGraffle diagram updates.

Managing Your Omni Licenses

If you purchased OmniGraffle from us (Thanks!), you received an email from The Omni Group that contained your license info. This included the name you used to register OmniGraffle 6, along with a string of characters that make up the license key. You’ll need these two pieces of information to enter the license in OmniGraffle.

Note
If you purchased OmniGraffle 6 from the Mac App Store (Thanks!), you won’t have to worry about licenses. Your copy of OmniGraffle 6 is automatically licensed to you by Apple. If you ever need to update your copy, or re-install OmniGraffle, you can do that through the Mac App Store.

Adding a New License

To enter your license, follow these steps:

  1. From the menu bar, choose OmniGraffle ▸ Licenses to open the Licenses window.
  2. Click Add License. A sheet slides down from the License window’s titlebar.
  3. Switch to Mail (or some other email client you may be using) and find the email message that contains the license key for OmniGraffle 6.

    Tip
    You can quickly switch between apps on your Mac using OS X’s built-in app switcher: Command-Tab. To keep the app switcher open, hold down the Command key after pressing Tab.

    When you press Command-Tab, the app switcher pops up onscreen as a row of icons for the apps currently running on your Mac. Continue pressing Command-Tab until you find the app you need—in this case, Mail—and then let go of the Command key. You can also use Shift-Command-Tab to go backwards in the list of running apps, or you can use the Left Arrow or Right Arrow keys to go backwards or forwards, respectively.

  4. In the email message, you’ll need to locate the name used for the License Owner, and the License Key. Select the name next to License Owner, and choose Edit ▸ Copy (or use Command-C) to copy the name to the pasteboard.

    Note
    If you can’t copy and paste the information, you’ll have to type it in. Make sure you enter everything exactly as it appears in your license message, including the dashes.

  5. Press Command-Tab to switch from Mail back to OmniGraffle.
  6. In the Owner field, choose Edit ▸ Paste (or press Command-V) to paste the name you used to register OmniGraffle.
  7. Press Command-Tab to switch from OmniGraffle to Mail.
  8. In the email message from us, select the License Key, and choose Edit ▸ Copy (or use Command-C) to copy the name to the pasteboard.
  9. Press Command-Tab to switch from Mail to OmniGraffle.
  10. Click in the License Key field, and choose Edit ▸ Paste (or use Command-V).
  11. The Type drop-down menu is grayed out by default, which limits the license type to Personal for the current user account on your Mac. However, your license key can also be used for another Type, Computer:

    • Personal: This type is for your personal use, and will only be available on this computer when you are logged in as the user who installed OmniGraffle. You can install this license on more than one computer, but only for your personal use. You should not use the software on two different computers at the same time with this kind of license. If a Personal license is available, the application will always use it.

    • Computer: You can configure your Mac to use this type, which permits any other user account on your Mac to use OmniGraffle. See Configuring OmniGraffle to Support the Computer License for details on how to do this.

  12. Click Save.

After clicking Save, the license key is verified, after which you’ll need to restart OmniGraffle to unlock any Pro features, if you’ve purchased OmniGraffle 6 Pro.

Purchasing a License

Let’s say that you downloaded OmniGraffle 6 from our website and put it to good use during the free 14-day trial. You made a bunch of outliney lists and even got started on character profiles for that book you’ve been wanting to write. Now that you’re totally hooked and smitten with OmniGraffle 6 Pro’s features, you’ve decided it’s time to purchase OmniGraffle 6 before your trial runs out.

You could purchase OmniGraffle 6 from the Mac App Store, or you can purchase a license key direct from us right from within OmniGraffle!

To purchase a license:

  1. Open OmniGraffle 6.
  2. From the menu bar, choose OmniGraffle ▸ Licenses to open the Licenses window.
  3. Click Buy Licenses.

After clicking the Buy Licenses button, you will find yourself magically transported (in your preferred web browser) to the Omni Store, where you can purchase a license for OmniGraffle 6. (Naturally, this only works if you have an Internet connection.)

Configuring OmniGraffle to Support the Computer License

If there is more than one user account on your Mac, and you’d like everyone on your Mac to discover the awesomeness that is OmniGraffle, you’ll need to jump through a couple of hoops (thanks to Apple’s mandated app sandboxing for OS X 10.7 and above). To set up a Computer license, follow these steps:

  1. Quit OmniGraffle 6.
  2. Open a new Finder window.
  3. Switch the Finder’s view settings to Column, by choosing View ▸ as Columns (or use Command-3). This will make it easier for you to traverse the folder hierarchy on your Mac.
  4. Choose Go ▸ Computer.
  5. Choose your Mac’s hard drive (if you haven’t renamed it, it should be named Macintosh HD), and then traverse through the following folders:
    • Library

    • Application Support
  6. In the Application Support folder, create a new folder (choose File ▸ New Folder, or use Shift-Command-N) and name it Omni Group. You will need to enter your admin password to create a new folder at this level.
  7. In the Omni Group folder, create a new folder and name it Software Licenses.
  8. Open OmniGraffle 6 again, and then choose OmniGraffle ▸ Licenses.
  9. Click Add License.

When you click Add License, you’ll notice that the Type drop-down menu is no longer grayed out, and the Computer option is available for selection. Now just enter the Owner and License Key information you received from us, click Save, and you should be set.

Removing a License

To remove a license:

  1. Choose OmniGraffle ▸ Licenses.
  2. In the Licenses window, select the license you want to remove.
  3. Click Delete License.
  4. An alert sheet appears, asking you to confirm that you really, really want to delete the license. If you are certain that you want to do this, click Delete. If you’ve changed your mind, click Cancel and then close the Licenses window.

Again, the thing to remember here is that license keys are version-specific; the license key you have for OmniGraffle 5 is not compatible with OmniGraffle 6 (and vice versa).

Note
You can disregard the Licensing section if you've purchased your copy of OmniGraffle (Standard or Pro) from the Mac App Store. Licensing is only an issue if you've purchased your copy of OmniGraffle direct from The Omni Group's website.

Regular Expression Syntax

OmniGraffle’s Find dialog supports the use of some simple regular expressions. A regular expression is a single string that represents a whole set of strings. The following syntax is used:

  • a* — zero or more instances of a (matches the longest string possible)
  • a*? — zero or more instances of a (matches the shortest string possible)
  • a+ — one or more instances of a (matches the longest string possible)
  • a+? — one or more instances of a (matches the shortest string possible)
  • a? — zero or one instance of a
  • ^ — beginning of a line
  • $ — end of a line
  • . — any character
  • [a-z] — all characters between a and z
  • [abc-]a, b, c, or -
  • (abc) — matches abc and stores it as a group. Use the Select or Replace pop-up menu in the Find dialog to select or replace only one of these groups rather than the whole expression.
  • \1 — text of first matched group
  • a|ba or b
  • \n — newline
  • \r — carriage return
  • \t — tab character
  • \d — digit
  • \D — non-digit
  • \w — word character (alphanumeric or underscore)
  • \W — non-word character
  • \s — whitespace
  • \S — non-whitespace
  • \ — escape the next character

Regular expressions are very popular, so you should be able to find plenty of information about them on the internet or in a good library or bookstore. Here are a few examples to get you started:

  • \s*$ — matches whitespace at the end of a line.
  • <.*?> — matches strings that begin with < and end with >, such as XML tags.
  • \S+@\S+ — very liberally matches things that resemble email addresses (anything@anything).
  • (19|20)\d\d-\d\d?-\d\d? — matches dates in the format YYYY-MM-DD, between 1900 and 2099