Skip to content

Latest commit

 

History

History
90 lines (72 loc) · 3.44 KB

README.md

File metadata and controls

90 lines (72 loc) · 3.44 KB

Example for users to understand how to use the library

Different methods have been written for inter conversion between different mappings related to omni directional cameras.

Click here for a detailed API documentation and examples.

1. Equirectangular image to fisheye or pinhole camera image

Possibile areas of application

  • Generate images with different focal length and distortion coefficients.
  • Generate synthetic images for training of various deep learning models.
  • Image augmentation
  • Creating interesting visual effects with 360° videos. Some of the above mentioned applications have been discussed in detail in the application notes sections.

Example of conversion of equirectangular image to fisheye image

2. Fisheye image to equirectangular image

Possible areas of applications

  • Used for stitching and creating a 360° video from two fisheye cameras facing away from eachother.
  • To upload omnidirectional camera videos to youtube which can support the 360° viewer GUI.
  • Used as an interconversion step

Example of conversion of fisheye image to equirectangular image

3. Equirectangular image to cube map image (horizontal or dice format)

Possible areas of applications

  • Useful to create cubemap environment textures, for video games or VR application, from a given equirectangular image.
  • To remove distortions generated due to the fisheye lens.
  • Used in visual SLAM methods where omni directional cameras are used.

Example of conversion of equirectangular image to cubemap image

4. Cubemap image to equirectangular image

Possible areas of applications

  • Create compressed equirectangular form of texture maps which can be later converted to cubemap and used as texture maps.
  • Intermediate step when using omnidirectional cameras.
  • Convert cubemap based images into a format that can be uploaded to a 360° image/video viewer.

Example of conversion of cubemap to equirectangular image

5. Convert equirectangular image to perspective image with desired field of view and viewing angles

Possible areas of applications

  • Creating different perspective views in a 360° video/image.
  • Object detection in 360° videos with existing pre-trained models.
  • Creating a GUI to view 360° videos and images.
  • Surveillance robots using omni directional cameras.

Example of conversion of equirectangular image to perspective image

6. Convert cubemap image to perspective image with desired field of view and viewing angles

Possible areas of applications

  • Create different perspective views in a 360° video/image.
  • Creating a GUI to view 360° videos and images.
  • Simulate and analyse a texture map in a video game.

Example of conversion of cubemap image to perspective image