Image Utility

ImageMagick

ImageMagick is a command-line image-processing toolkit used to resize, convert, crop, and normalize image sets before alignment and training.

Stage: UtilityBatch resizingFormat conversionDataset cleanup

What It Does

ImageMagick is useful when your capture set is too large, inconsistent, or in a format a downstream tool dislikes. It gives you repeatable image preparation without opening a GUI editor.

For 3DGS, the most common jobs are resizing very large frames, converting PNG/TIFF/HEIC-style workflows into JPEG or PNG sets, and cleaning filenames or orientations as part of a script.

How To Use It In 3DGS

  • Copy or backup originals before destructive batch operations.
  • Resize extremely large images when alignment or training time becomes unreasonable.
  • Convert images into a consistent format accepted by COLMAP or your trainer.
  • Run a quick visual spot check after processing before starting reconstruction.

Things To Watch

  • Over-compressing JPEGs can harm feature matching and final visual quality.
  • Batch commands can overwrite source images, especially with mogrify.
  • Changing resolution after alignment can break assumptions if camera intrinsics are not handled correctly.

Safe Dataset Prep

  • `magick` is safer for one-off conversions because you name the output explicitly; `mogrify` is powerful but can overwrite a folder in one command.
  • Use `-resize` to create a working copy for alignment tests, not to destroy your source capture.
  • Keep EXIF and orientation behavior in mind: after processing, spot-check image rotation and dimensions before COLMAP.