Cubemap to Equirectangular Converter

Converts cubemap data sets to an equirectuangular projection image

Cubemap:

Equirectangular:

Run

• ./cube2equirect [options]
  • options:
    • -i, --input <DIRECTORY> directory with cubemap image set sequence
    • -o, --output <DIRECTORY> directory to save equirectangular images [Default: 'output/']
    • -h, --h-resolution <NUMBER> horizontal resolution of output images [Default: 3840]
    • -f, --format <IMG_FORMAT> output image format ('jpg', 'png', or 'mp4') [Default: same as input]
    • -r, --framerate <NUMBER> number of images per second (for video output) [Default: 24]
  • cubemap files should be named (JPEG and PNG are both valid):
    • 000000_left.jpg
    • 000000_right.jpg
    • 000000_bottom.jpg
    • 000000_top.jpg
    • 000000_back.jpg
    • 000000_front.jpg
  • if converting a sequence of images, follow above naming convention and increment the leading counter

Install

Ubuntu

• apt install mesa-common-dev
• apt install libegl-dev
• apt install ffmpeg (optional - only needed if converting sequences of images to a video)

Build

• make