// USER MANUAL

Formats, Specifications and Troubleshooting

Pearla Revela User Manual · Chapter 30 of 30 · Part VIII. Reference

Sections 30.1 to 30.9 list system requirements, supported formats and storage locations. Sections 30.10 to 30.18 explain warnings and errors and what to do about them. Each table points to the chapter covering the subject.

30.1 System Requirements

Revela needs macOS 26.1 or later on an Apple silicon Mac, and a Pearla account the first time it opens. It needs to be online from time to time to confirm the license, and works offline in between for the period the license agreement states (Chapter 1).

30.2 Files Revela Imports

Revela accepts the following file extensions. Other files are left out.

KindFormatsCovered in
Raw stillsCanon .cr2 and .cr3, Sony .arw, Nikon .nef, Panasonic .rw2, Olympus .orf, Fujifilm .raf, Hasselblad .3fr, DNG .dng, PearlaRAW .prawChapters 3, 12
Movies.mov, .mp4, .m4vChapters 3, 12
Raw videoPearlaRAW .prawv, Apple ProRes RAW (a .mov carrying ProRes RAW or ProRes RAW HQ), Blackmagic RAW .braw, Nikon N-RAW .nevChapters 3, 12

JPEG, HEIC, HEIF, TIFF and PNG images are not imported. An import counts them as files to be skipped; an adoption sets them aside, untouched, in the location’s Unmanaged folder. REDCODE RAW (.r3d) and X-OCN are not accepted. Hidden files and packages inside a chosen folder are skipped.

30.3 Raw Video Formats

The raw clip’s format determines its Develop controls and which settings can be changed.

FormatTabUnavailable or fixed settings
PearlaRAW .prawvThe Develop tab, as for a raw stillLuminance, Color, Sharpness, Detail, Moiré and Lens Correction are grayed
Apple ProRes RAWThe Develop tab, as for a raw stillAs for .prawv
Blackmagic RAWThe Develop tab with the maker’s controlsNoise reduction, sharpness, detail and moiré are not offered; Revela’s own Lens Correction is not offered; the tab shows the fixed settings Generation 5, Blackmagic Design Film, Wide Gamut; the look file embedded in the clip is listed in the Info tab and never applied
Nikon N-RAWThe Develop tab with the maker’s controlsNoise reduction, sharpness, detail and moiré are not offered; Revela’s own Lens Correction is not offered; the color science and gamma are fixed; the embedded look file is never applied

Every raw clip has Highlights, Shadows, Whites, Blacks, Punch, camera output color space and Tone Mapping controls. Raw clips never get a proxy. Chapter 12 covers each tab; Chapter 9 covers playback.

30.4 Export Formats for Stills

Where to find it: the Output tab, File section, on a still’s output or a clip’s Frame output.

FormatColor spaces it can carrySettings
JPEGThe display and print spacesQuality 0 to 100, default 90
HEIFThe display and print spaces, the HDR spaces, every log spaceQuality 0 to 100, default 90; Gain map for sRGB and Display P3
TIFFThe display and print spaces, both linear spaces, every log spaceBit depth 8-bit or 16-bit, default 16-bit
PNGThe display and print spaces, Linear sRGBBit depth 8-bit or 16-bit, default 16-bit

The HDR spaces need HEIF. 8-bit is offered for the SDR display spaces only. Resolution is Source, Long edge or Size, and Long edge never enlarges. Metadata is All, All but location (the default), Copyright only or None. Chapter 24 covers every row; Chapter 25 covers what metadata carries.

30.5 Export Formats for Video

Where to find it: the Output tab, Video and Audio sections, on a clip’s Video output.

RowChoices
FormatMovie: QuickTime, MP4. Image sequence: TIFF, PNG, OpenEXR
CodecApple ProRes 422 Proxy, Apple ProRes 422 LT, Apple ProRes 422, Apple ProRes 422 HQ (default), Apple ProRes 4444, Apple ProRes 4444 XQ, H.264, H.265. MP4 takes H.264 and H.265 only
EncodingH.264: Auto, Main, High. H.265: Auto, Main, Main10, Main 4:2:2 10 (QuickTime only)
Quality, Key framesH.264 and H.265 only: Automatic or Restrict to a rate in Mb/s; Automatic or Every so many frames
HDR10Embed metadata, on a movie in a PQ space
Bit depth (sequences)8-bit or 16-bit (default) for TIFF and PNG; Half float (default) or Float for OpenEXR
Frame rateRead-only, as shot. Revela does not retime
Audio CodecLinear PCM (default), AAC, ALAC (Apple Lossless)
Audio Bit depth16-bit, 24-bit (default), 32-bit, 32-bit float for Linear PCM; 16-bit and 24-bit for ALAC
Sample rate44.1 kHz, 48 kHz (default), 96 kHz. AAC stops at 48 kHz
ChannelsSame as source · stereo (the source’s own layout shown), Mono, Stereo, 5.1

An 8-bit movie holds the display spaces only. HDR, linear and log spaces need H.265 at Main10 or Main 4:2:2 10, or a ProRes codec. Adobe RGB (1998) is never offered on video. An OpenEXR sequence carries no metadata, and a sequence carries no audio. A dimmed choice gives its reason in its tooltip: Needs H.264 or H.265, Needs another encoding, Needs another colour space, QuickTime only, Linear PCM or ALAC only, The clip has fewer than six channels, Linear PCM only for this many channels or Needs mono, stereo or 5.1. Chapter 24 covers the rows.

30.6 Delivery Color Spaces

Where to find it: the Output tab, Colour space.

GroupSpaces
DisplaysRGB, Display P3, Rec.709, Rec.709-A (Apple)
PrintAdobe RGB (1998)
HDRHLG BT.2020, PQ BT.2020 (HDR10), PQ P3
LinearLinear sRGB, Linear BT.2020
Camera log, by brandPearl-Log; Sony S-Log3 / S-Gamut3.Cine, S-Log2 / S-Gamut; Panasonic V-Log / V-Gamut; ARRI LogC3 / AWG3, LogC4 / AWG4; Canon C-Log2 / Cinema Gamut, C-Log3 / Cinema Gamut, C-Log / Cinema Gamut; Nikon N-Log / BT.2020; Fujifilm F-Log2 / F-Log Gamut, F-Log / F-Log Gamut; Blackmagic BMD Film Gen 5 / Wide Gamut; Apple Apple Log / BT.2020, Apple Log 2 / Apple Wide Gamut; DJI D-Log / D-Gamut; Insta360 I-Log / BT.2020; Leica L-Log / BT.2020

A new output is sRGB on a still and Rec.709-A (Apple) on a clip. A space the chosen format or bit depth cannot carry is dimmed; Revela never changes the format for you. The spaces a file can be declared in at import are a separate list (Chapter 12). Chapter 24 covers tone mapping, the film profile and conversion on an output.

30.7 LUTs and Profiles

DirectionFormatsCovered in
Import.cube, .3dl, and a .png holding a Hald identity grid. A LUT with a very large grid or an unusual input range is adjusted to fit; it imports and worksChapter 14
Export LUTA .cube of 17, 33 (default) or 65 points per axis, for pictures in Pearla Wide Gamut. It carries the color work onlyChapter 14
Export Verana ProfileA .pprof carrying the output’s complete look, film profile and Punch included, for VeranaChapter 14

30.8 Exported File Names

WhatNameCovered in
One output of a still, or a Frame<photo>_<output>.<ext>; an unnamed output is OutputChapter 25
One movie<clip>_<output>.mov or .mp4Chapter 25
An image sequenceA folder <clip>_<output>, taking _2, _3 if one exists; frames <folder>_000001.<ext> onward, counted from the in pointChapter 25
A batch<photo>_<output>.<ext>; with One folder per output, <output>/<photo>.<ext>; with Include subfolders, the source’s folder layout under the destinationChapter 25
Two files on one name in one jobThe second takes _2, the third _3, in the same order on every runChapter 25
A LUT<photo>_<output>.cubeChapter 14
A Verana profile<name>.pprof, the name from Profile nameChapter 14
OriginalsThe camera filename, with a manifest.csv beside them; Recreate the original folder layout restores an adopted folder’s old names and foldersChapter 6

30.9 The Catalog and Its Stores

A catalog is a .revela package. It holds folders, edits, ratings, presets and small thumbnails. It does not hold the originals.

Originals live in stores. Revela creates this Mac’s store on first launch and names it after the Mac. Unless you choose another location, it is in the Revela folder in Pictures. It must be on the Mac itself and outside any sync service. Every catalog on the Mac keeps its originals there, each with its own files. The same store keeps each catalog’s large thumbnails and proxies, its LUT files and reference images, and an hourly copy of the catalog file.

A store on a drive is a package Revela makes on that drive, named after the catalog and belonging to that catalog alone. An adopted folder stays where it was, with its files renamed into Revela’s layout and the files Revela does not import kept in its Unmanaged folder. The files inside a store are Revela’s to manage; do not move or rename them.

Where to find it: File → Catalogue Info

The info sheet lists what is in the catalog file, the size of the originals in each store, where the thumbnails, proxies, LUT files and reference images are, and when the last hourly copy was made. Chapter 6 covers stores and locations; Chapter 26 covers repositories, which are folders Revela makes in a place you choose.

30.10 Reading the Troubleshooting Tables

Each row gives the screen message, its meaning, the action to take and the reference chapter. Messages that belong to a single editing tool (chart calibration, subject selection, a heal source over an edge, graph wiring) are explained beside the tool in Chapters 11, 15, 16, 19 and 20, and are not repeated here.

30.11 Launch and License

Screen saysMeaningWhat to doCh.
Revela Is Damaged / Reinstall Revela.The license agreement is missing from the appReinstall Revela1
Licence EndedThe license ended, or Revela’s installation is damagedReinstall Revela, then Check Again1
Get RevelaThe account has no licenseBuy Revela or Start a Trial1
Your MacsThe license is active on its full number of MacsManage Macs, deactivate one on the account page, then Check Again1
Trial Ended, Subscription Ended, Subscription Expired, Trial Used on This MacThe trial or subscription is over, or this Mac has had its trialSubscribe, then Check Again1
Licence RevokedThe license was revokedBuy Revela1
Connect to the InternetRevela has been offline for longer than the license allowsConnect, then Check Again1
Revela Can't Check Your LicenceThis Mac is online, but the license could not be confirmedCheck Again later1
Every window closes at once and a license screen showsThe license ended while Revela ranAnswer the screen. Pending edits were saved, exports paused, nothing was deleted1
That code is wrong or has expired.The sign-in code was refusedType it again, or Resend after 60 seconds1
Revela can't reach Pearla. Check your connection.The service could not be reachedConnect and try again1
Sign-in isn't working right now. Try again shortly.Any other sign-in failureTry again later1
Revela can't keep its store in <service>The folder chosen for this Mac’s store is in a sync serviceChoose Again… and pick a folder on this Mac1
Your Pictures folder is kept in <service>Pictures itself is synced, so the usual place cannot hold the storeChoose a Folder… outside the service1
This Mac's store must be on this MacThe folder chosen is on a drive that can be unpluggedChoose Again…; add the drive as a store later, from Locations1, 6
Revela needs a store for your photosThe store panel was canceledChoose a Folder…, or Quit Revela1

30.12 Opening a Catalog

Screen saysMeaningWhat to doCh.
"<name>" can't be opened from <service>.The catalog is in iCloud Drive, Dropbox, Google Drive or OneDrive, and Revela does not open a catalog from a sync serviceMove it to a folder that is not synced, such as Pictures, and open it there1
“<copy>” is a copy of the catalogue “<catalogue>”This Mac already has the catalog, and Revela opens only one copy of itOpen <catalogue> or Show <catalogue> in Finder1
“<catalogue>” belongs to another MacIts originals are in that Mac’s storeOn that Mac, put its folders in a repository; here, Connect to a Repository…1, 26
Revela knows “<catalogue>” as a file on <volume>The known file is on a drive that is not connectedConnect the drive, or Use This File… if the other file is gone1
“<catalogue>” came from another MacIt arrived here with its storeUse on This Mac; stop using the copy on the other Mac1
A sheet saying the catalog was repaired, with a dateThe catalog’s records were damaged; Revela restored the newest good hourly copy and kept the damaged file inside the catalogRedo any edits, imports and ratings made after that date. The originals are untouched1, 6
"<name>" is Revela's originals storageA store package was double-clickedOpen the catalog the alert names1, 6
A recent catalog dimmed, <drive> (not connected)Its drive is awayConnect the drive1
A recent catalog gone from the listIt was deleted or moved in FinderOpen it with File → Open (⌘O)1

30.13 Importing and Adopting

Screen saysMeaningWhat to doCh.
A beep when an import is startedAnother import is runningWait for it3
<folder> takes no photos nowThe folder is in Recently DeletedRestore the folder, or import into another3, 6
A drag onto the grid or sidebar has no effectNothing in it is a file Revela imports, or the target is References or Recently DeletedSee 30.2; drop on another folder3
Nothing to importNo importable file was foundSee 30.23
1 other file is not a photo or video Revela imports and will be skipped.The file is not in 30.2Nothing; it is left where it is3
Unavailable: files on a memory card or removable drive are always copied., Unavailable: the files are not on the same drive as the catalogue.Move into catalogue cannot be usedUse Copy into catalogue3
Not enough space: this import needs <size> and the catalogue's drive has <size> free.The store chosen is too smallChoose another store in Store originals in, or import fewer files3
Verification failed: the copy's contents did not match the source. The copy was removed.A copy differed from its source and was discardedImport the file again; the source is untouched3
The file changed while it was being imported. It was left where it was.The file was being written while it was readImport it again once it is complete3
N files could not be importedEach file is listed with its reasonReveal in Finder on each3
N source files could not be moved to the TrashThe Trash step failed for some filesNothing was deleted; move them in Finder if you wish3
"<folder>" cannot be adoptedThe folder is not a folder, is a whole drive, your home folder or a system folder, is synced, is inside or contains a catalog or store, is read-only, holds a locked file, or is being importedThe alert’s one reason says what to choose instead3
A folder cannot be adopted while an import is running. (or a move, proxies, a verify)Adoption waits for that workLet it finish3
"<folder>": Revela needs permission for the folder that contains it, to rename it. Choose that folder.Renaming needs access to the parent folderChoose the parent folder and Allow3
Thumbnails and proxies are kept in the catalogue, which has <size> free; about <size> may be needed.The catalog’s drive is short of room for what an adoption makesFree space, or set Keep proxies lower3
Adoption stopped: "<folder>" is back as it was, "<folder>" could not be adopted and is back as it wasThe adoption was stopped or failed and undid itselfRead What went wrong:, then try again3
An adoption of "<folder>" was interruptedRevela quit during an adoption; it was undone on openThe alert says where the folder was put back3

30.14 Stores and Missing Originals

Screen saysMeaningWhat to doCh.
A store row reads offline; thumbnails dim with a gray pill naming the storeThe store’s drive is unpluggedConnect it. Ratings, folders and tags still work meanwhile6
Checking <name>… over the browserThe drive is back and Revela is confirming the originalsWait6
This Mac's store, <name>, can't be found, with Locate…; its row reads not foundThis Mac’s store was moved, renamed or deletedLocate…, then Use This Store. If it was deleted, restore the folder first6
That isn't <name>The package chosen in Locate… is another storeChoose the store the alert names6
<store> can’t be found, with Locate…A store is in the Trash, or a store on a drive was movedPut it back in Finder, or Locate… and Reconnect from the Locations sheet6
MISSING pill; 3 missing in the Locations sheet; a verify ending 2 missingOriginals are not where Revela left them, or have changedShow, put the files back, then Verify Location6
Verifying paused on battery (or in Low Power Mode)A verify waits for powerConnect power6
Items cannot be moved while an import is running. (or while Verify is running.)Moving between stores waitsLet the other work finish6
Nothing to moveEvery item is already in that store, or its original is offline or missingNothing6
<store> does not have enough free space for these originals.The destination store is too smallChoose another store, or move fewer items6
Remove… dimmed: A location can be removed once it holds no originals. Move its items first.The store still holds originalsMove them to another store first6
An item stays in Recently Deleted past its timeIts store is away; nothing is erased from an absent storeConnect the store6
1 original is missing and was skipped, N originals could not be exported, The manifest could not be written:Export Originals copied what it couldFind the missing originals, or read each listed reason6

30.15 Loupe Banners

Screen saysMeaningWhat to doCh.
The file could not be loaded.The picture could not be rendered from the original and its editsRun Catalogue → Verify Catalogue; a missing or changed original is then reported6, 7
MISSING: The original file is not in the catalogue. Nothing can be edited until it is back.The original is not where Revela left itPut it back, then Verify Location; Reveal in Finder shows where it belongs; Download when a sync folder holds it6, 7
MISSING: The original file has changed since it was imported.The file on disk is no longer the one importedPut the imported file back, then Verify Location6, 7
MISSING and PROXY: Reviewing the proxy at <N> px.A proxy stands in for a lost originalAs for MISSING7
OFFLINE: Original is on <location>, which is offline. Connect the drive to edit.The store is away and there is no proxyConnect the drive6, 7
OFFLINE: Original is on <location>, which now belongs to "<catalogue>".The store was moved to another catalogWork on the original in that catalog7
PROXY: Original is on <location>, which is offline. Reviewing at <N> px. Connect the drive to edit fully.The grade can be worked on; Develop, healing, masking and export waitConnect the drive6, 7
Showing the proxy. Limited grading: raw settings, Heal, Mask and export need the original.A sync folder’s original is not on this MacEdit, or Download; the original comes from the repository27
The original is only in a store on <Mac>. To get it here, upload <folder>'s originals from that Mac.No repository holds the originalUpload the folder’s originals on that Mac27
This proxy is being updated: the raw settings were changed on <Mac>. / Grading waits until the new proxy arrives.Another Mac changed the developmentWait27
Showing the thumbnail. This clip has no proxy, so grading needs the original.A raw clip in a sync folder has no proxyDownload27
Showing the thumbnail. Getting the proxy from <repo>…The folder keeps thumbnails only; the proxy is on its wayWait27
<repo> is offline. Connect <volume> to download the original. / Nothing was queued.Download needs the repositoryConnect it and choose Download again27
LUT NOT HEREThe grade uses a tool from a kit this catalog does not haveAdd <kit>; without a button, put the tool in a kit from the Mac that has it27
LUT MISSINGA LUT used by the grade is deleted, moved out of a kit or unreadableImport the LUT again, or change the node’s LUT14, 27
CONFLICT: <Mac> edited this photo at the same time; both versions are kept.Two catalogs edited the photo before syncingResolve… (30.17)27
A band at the foot saying the selected node is outside the active output pathThe loupe cannot show that node’s effectSwitch to <output name>, or Turn off these warnings7, 11
This output isn't active. Double-click the node to make it active.The output selected is not the one shownDouble-click its card7, 11
This output has no connected input.Nothing feeds the outputConnect a wire to it7, 11
A raw clip plays below its frame rateThis Mac cannot play the clip at full speedNothing; the latest frame stays on screen9

30.16 Export Failures

Screen saysMeaningWhat to doCh.
Export… dimmed: Needs the originalThe picture is a proxyConnect the original’s store, or download it6, 25
Heal tracking analysis is incompleteTracking has not finished; unfinished ranges would export with static positionsWait, or Export Anyway23, 25
<n> photos skipped with originals on <store>, not connected, originals not on this Mac, originals missing, edits from a newer Revela or raw format not supportedThe batch sheet leaves those items outConnect, download or restore the originals; update Revela25
<folder> has <size> free / about <size> neededThe destination is too small; Export is offChoose another destination, or free space25
<name> is full / <size> more neededA running job stopped for roomFree space, then Resume25
<name> isn’t connected, <name> can’t be found, Can’t write to <name>The destination drive or folder is gone or lockedLocate…, then Export Here; the job continues where it stopped25
<n> failed; the exports button red with a count; Couldn’t export <file> or Exported <n> of <m> files · <k> failedSome files were not writtenShow opens the Exports sheet with each reason; Retry Failed25
Needs the originalThe original was not availableAs above25
The photo is no longer in the catalogue, The output was removedThe item or output was deleted after the job was madeNothing, or export again25
The original could not be read, The clip could not be readThe file could not be readRun Catalogue → Verify Catalogue6, 25
Its edits can’t be read by this version of Revela, Its raw format isn’t supported by this version of RevelaA newer Revela saved the edits, or this version cannot develop the fileUpdate Revela25
Heal tracking not finished, Mask tracking not finishedA batch movie’s tracking was unfinishedLet tracking finish, then Retry Failed23, 25
The file was not writtenAny other failureRetry Failed25
A toast naming a file that could not be copied by a drag, with its reasonA thumbnail dragged out of the window could not deliver its originalRead the reason; the original is untouched in its store5
An export is still running (or <n> exports are still running) at quitJobs are unfinishedQuit and Resume Later, Keep Exporting or Cancel Export and Quit25
A job resumes after sleep with one file fewer doneThe file in hand at sleep was removedNothing; it is written again25
An export waits before starting the next fileThe Mac is short of memory; each file waits, without a message, until memory frees upWait, or close other apps25
Copyright only dimmed: Add your copyright in Settings ▸ ExportNo copyright or creator to writeFill the Settings window’s Export tab24, 25
Can't export this LUTThe path passes through a mixer, or uses LUTs that can no longer be loadedRemove the mixer from the path, or re-import the named LUTs14, 15
Can't export this profileThe output is HDR or a camera log, a clip’s Camera Output is not Pearla Wide Gamut, or nothing feeds the outputThe sheet names the fix14
LUT imported with an adjustmentThe LUT was adjusted during import and is usableNothing14
'<file>' could not be imported / The file may be corrupt or use an unsupported format.The LUT file could not be readUse a .cube, .3dl or Hald .png14

30.17 Sync Refusals and Conflicts

Screen saysMeaningWhat to doCh.
<repo> is offline / Connect <volume> and try again. Nothing has been changed.A command needs the repository now; it is never queuedConnect the drive or share and repeat26, 27
Can't reach <repo> (amber), can't reach: <reason>The repository should be reachable and is not: moved, renamed or deletedChoose… in the Repositories sheet and pick its folder26
There is already a folder named "<name>" on <place>. Choose another place, or another name.The place holds a folder of that nameChange the name or the place26
This drive is formatted for Mac and Windows. A repository there is not safe for two Macs yet. Use a drive formatted for Mac (APFS).The drive’s format is refusedUse an APFS drive26
"<folder>" isn't a Revela repository, "<folder>" is on a drive formatted for Mac and WindowsThe folder chosen in Connect to a Repository… cannot be usedChoose the repository’s own folder26
"<folder>" was made by a newer version of RevelaThe repository needs a newer RevelaUpdate Revela26
<folder> uses <n> resources that are not in <repo>Its grades use tools that no kit in the repository holdsAdd <n> to <kit> and Sync, or Sync Without Them27
1 LUT used in <folder> is not in <repo>Other catalogs see those photos without the toolShow, then Add to a Kit…27
<folder> syncs on its own. A synced folder can't go inside another one.The drag is refusedKeep the two sync folders apart27
<folder> is still arriving. It takes photos once it has finished syncing.The folder is still arriving from the repositoryWait27
There isn't room in <store>The copy’s originals do not fitFree space; nothing was copied or moved27
<n> photos were not copied to <folder>Part of a copy was skipped, one band per reasonSelect Them27
Delete Now isn't available for all of theseSome originals are held by another catalogSelect the ones whose originals are here; delete the rest in the catalog that holds them27
<n> photos were edited in two catalogues at once; the CONFLICT chipTwo catalogs edited a photo at about the same time; both versions are keptResolve…, then Keep mine, Use <Mac>'s or Save the other as a reference27
<n> sync errors: <latest>Sync has problemsSync Log…, Problems tab; each says whether it retries27
couldn't upload: <reason> in TransfersOne item failedNothing; it tries again at the next check27
Syncing paused on battery (or in Low Power Mode, on a limited network, on a metered network, while importing, while verifying)Sync waitsNothing; it resumes when the condition ends27
<repo> is paused · <n> changes waitingYou paused itResume26
<folder> no longer syncs from this catalogueAnother catalog removed this one from the folderShow, then Stop Syncing, Keep Here…, Remove from This Catalogue… or Later27
<n> deleted in <catalogue> · only originals are hereAnother catalog deleted photos whose only originals are on this MacShow; restore them within 30 days or they are erased27
<n> erased elsewhere · originals here for 7 daysThe 30 days passed while this Mac was awayShow, then Recover or Erase Now27
The repository "<repo>" was deletedAnother catalog deleted the repositoryRestore <repo>, or Download <n> Originals before the end date26

30.18 Tracking Loss

Where to find it: the Tracking section of the Mix tab for a mask component, of the Healing tab for a heal item, and of the Frequency Separation tab for its node, on a clip.

The Status line reports each track. The track’s lane on the scrubber draws a lost run as dashes inside the tracked span, and frames where the track may have drifted in amber.

Screen saysMeaningWhat to doCh.
Waiting for analysisTracking is on and has not runUse the Track buttons23
Stopped <n>%The track was stopped part wayTrack forward again23
Tracking failedRevela could not follow the itemRetry (a mask) or Re-track Item (a heal)23
Static (edited), or Static followed by not trackedAn edit made the track invalid, or it never ranTrack again; undo restores the old track23
· <n> gaps after TrackedParts of the clip are not trackedCorrect those frames, or re-track23
Dashes inside the tracked span of a laneA lost run: the tracker could not find the item thereDrag the item on a frame inside the run to set a keyframe, which bridges it, or Re-track from Here23
Amber spans on a laneThe track may have drifted thereCheck those frames; drag the item on a drifting frame to set a keyframe, or Re-track from Here23
On Loss: Fade or HoldWhat a heal does where it is lost: fade out, or hold its last good positionChoose per item20, 23
No face foundFollow is Face and the anchor frame has no faceChoose Region in Follow21, 23
Face lostThe playhead is on a frame where the face was lostCorrect the frame by dragging, or re-track21, 23
Tracked · <n> strokes to re-measureStrokes changed at the anchor frame have not been brought up to dateTrack forward21, 23

← 29. Settings Directory · Contents