Compare revisions

Overlay two revisions of a sheet to see what was added, removed and moved.

Compare revisions lines up two versions of a sheet and shows what changed: removed linework in red, added in green, unchanged in gray. It's in beta.

Starting a comparison

The usual review is the new revision, open in Vellum, against an earlier set. So Compare opens with the sheet on screen as the Revised side, and Base waiting for you to choose the earlier revision.

  1. 1
    Open it

    Open Share in the toolbar, choose Export and document tools, then Compare revisions… under Document. Or press ⌘K to open feature search and choose Compare revisions.

  2. 2
    Choose the base

    Click Choose a document… next to Base and pick a document from Other projects, or Open a PDF from this device…. To compare two pages of this document, choose This document.

  3. 3
    Check the pages

    Each side has a page picker. Swap base and revised (the arrows button) switches the two sides round.

Sheet pairs

When the two sides are different documents, Vellum pairs their sheets by sheet number, read from each page's label or its bookmark title, so C1 is compared with C1. Case, spaces and punctuation don't matter. Pages without a number pair in order, and two sets that share no numbers pair by position.

  • The sheet bar steps through the pairs with its arrows, or pick a pair from its list. Sheets only one set has are listed as New in revised or Not in revised.
  • Changing the base page brings its pair along on the revised side.

Vellum renders both sheets and aligns them automatically on the text they share, such as the title block and notes, so a sheet that was shifted, rotated slightly or plotted at a different size still lines up.

Overlay and side by side

  • Overlay draws both sheets on top of each other: Removed in red, Added in green, Unchanged in gray.
  • Side by side shows the base and the aligned revision next to each other. While Locked is on, the two views pan and zoom together; turn it off to move them independently.
  • Use zoom in, zoom out and Fit sheet to move around. Your view is kept when you switch between the two.

The change list

Changes lists each changed area and counts them as moved, changed, removed and added. Click an item to zoom to it. Something that moved is shown once as "moved from" and once as "moved to", numbered so you can match the pair. A change that would cover more than about a quarter of the sheet is split into smaller areas, so the list points at the edits.

Revcloud all changes

Revcloud all changes, at the bottom of the change list, draws a revision cloud around every listed change on the revised sheet. Changes close together share a cloud. All the clouds are one undo step.

  • When it's done the list says, for example, Added 7 clouds to C1. Show on sheet closes Compare and selects the clouds on the drawing.
  • Clouds only go into the open drawing, so the revised side must be this document. If this document is the base, the note offers Swap sides.

Alignment

The alignment chip in the header says how well the sheets line up (Aligned: good, fair or poor, or Not aligned). Click it to see the offset, rotation, scale and how much of the linework lines up.

  1. 1
    Align manually

    If the automatic alignment is off, or the sheets are scanned and share no text, click the chip and choose Align with 2 points.

  2. 2
    Pick the first point

    Tap a sharp point on the base sheet (a grid intersection or a corner; zoom in first), then the same point on the revised sheet.

  3. 3
    Pick the second point

    Tap a second point far from the first on the base sheet, then the same point on the revised sheet.

A manual alignment is remembered on this device for that pair of sheets, and nothing is written to the document. Choose Auto-align to go back to the automatic alignment.

Note

Compare looks at the sheets as drawn, so it finds what looks different. Apart from the clouds you add with Revcloud all changes, it doesn't change either document.