Skip to content

Merge Frames

Jerry Hogsett edited this page Jun 30, 2023 · 2 revisions

Merge Frames - Merge a previously split set of of PNG frames

Uses

  • Recombine groups after a large processing run
  • Remerge files split for transport
  • Undo a previous split

How It Works

  1. Set Split Groups Base Path to a path on this server to the directory containing the previously split sub-directories
  2. Set PNG Files Path to a path on this server to store the merged files
    • Tip: this can be the same path as Split Groups Base Path
  3. Leave Number of Split Groups set to -1 for auto-detection of the number of groups
    • Set a specific value to require precisely that many group sub-directories to be present
  4. Choose Split Type
    • Precise merges all files found in the sub-directories
    • Resynthesis merges the files found in the sub-directories, taking into account the extra frames aded for Resynthesize Video
    • Inflation merges the files found in the sub-directories, taking into account the extra frames aded for Video Inflation
  5. Choose Files Action
    • Combine merges the files post-processing, taking into account the Split Type
    • Revert merges the files prior to processing, taking itno account the Split Type
    • Tip: Use Revert to Undo a previous unprocessed split
  6. Click Split Frames
    • Progress can be tracked in the console

Split Type Details

  • Precise
    • Files Action is Combine:
      • Merges all files found in the group directories
      • If the group names are unchanged since the original split:
        • The files will be renamed and merged, assuming they have been processed by a feature likke Upscale Frames that may change filenames but not file counts
      • If the group names are not frame indexes (renamed):
        • The files will be merged as-is without renaming, assuming they may have been processed by hand, for example, deleting unwanted frames or groups
    • Files Action is Revert:
      • Merges all files found in the group directories
      • Files retain their original filenames
      • Files within groups must match the original group count
  • Resynthesize
    • Files Action is Combine:
      • Merges the resynthesized set of files found in the group directories
      • Renumbers the files according to their original frame index
    • Files Action is Revert:
      • Merges the non-resynthesized files found in the group directories
        • Excess files added for Resynthesize Video are skipped
      • Renumbers the files according to their original frame index
  • Inflation
    • Files Action is Combine:
      • Merges the inflated set of files found in the group directories
        • The Video Inflation rate is detected from the file count
        • The files are renumbered taking into account the inflation rate
        • Shared keyframes added for Video Inflation are skipped
    • Files Action is Revert:
      • Merges the non-inflated set of files found in the group directories
        • Shared keyframes added for Video Inflation are skipped
      • Renumbers the files according to their original frame index

Important

  1. The Split Type must match the type used to split the files originally
    • Note: an error message will be shown in the console if the wrong split type is detected
  2. Ensure the only directories files present in the Split Groups Base Path are the ones to be merged
  3. Files are taken in Python sorted() order
Clone this wiki locally