CaseLeaf

Handbook / The `reveal` command

The reveal command

A document is far larger than what you can see on its pages, and you suspect something is in there that was hidden rather than removed.

Puts back a picture that was written at no opacity, one that is in the file but invisible. It exists because that is a real way documents hide things, whether deliberately or through a conversion that went wrong, and because a picture you cannot see is a picture nobody checked. Reach for it when a document looks emptier than its size suggests.

How you run it

caseleaf reveal report.pdf --to reviewed.pdf

What each part means

In full, every part it will take:

caseleaf reveal <file> --to <file>
part what it is for
<file> The PDF to work on, as a path, such as report.pdf beside you, or the full path to it. It is read and not written.
--to Where to write the result, as a path. The shape above shows which format this command writes. This command needs it, and writes only there: the document you named is left exactly as it was.

What comes back

Asked of a short sample document, it answers as below. The sample has eight sheets, a highlight and a note left by a reviewer, a web link, a small table, two pictures and one form field already filled in.

{
  "note" : "no picture in this document is drawn at no opacity",
  "states" : 0,
  "was" : 90875
}

The same thing from AppleScript

Everything above can be asked for from a script instead. There is one AppleScript command, perform: on names the document, and options takes the rest exactly as you would type it.

tell application "CaseLeaf"
    perform "reveal" on "/path/to/report.pdf" ¬
        options "--to reviewed.pdf"
end tell

All the commands · Asking from a script · Contents