Skip to content

Latest commit

 

History

History
62 lines (53 loc) · 2.66 KB

README.md

File metadata and controls

62 lines (53 loc) · 2.66 KB

360-converter

Overview

Input one of the following type 360 image and convert it to another one.

Faces Cubemap Equirectangular Stereographic

Prerequisites

This project has been tested on:

  • Ubuntu 18.04
  • G++ 7.5.0
  • Clang 6.0.0

The only thing you need is a C/C++ compiler, no other package do you need to install.

Run example

git clone https://github.com/chinhsuanwu/360-converter.git
cd 360-converter
make
make run

Usage

Just directly include the converter.hpp in folder src.

#include "src/converter.hpp"

For example, the conversion from Face to Cube, Equi and Stereo can be shown as below, other conversions can be deduced:

  • To convert from Face to Equi

    Converter::Equi equi = face.toEqui();
  • To get image

    Converter::Image img = equi.getEqui();
  • For Stereo images, you can assign TOP or DOWN, while the default will be DOWN

    Converter::Image img = cube.toStereo(Converter::TOP).getStereo();
    TOP DOWN

  • To load image

    img.img = stbi_load("assets/equi.png", &w, &h, &bpp, CHANNEL_NUM);
    img.w = w, img.h = h;
  • To write image

    stbi_write_png("out/equi.png", img.w, img.h, CHANNEL_NUM, img.img, img.w*CHANNEL_NUM);

Find out more at example.cpp.

Acknowledgement

This project is using stb library for image I/O in example.cpp, great thanks to their excellent work.