Skip to content

Supported Projection Type

Jongmoon Yoon edited this page Dec 27, 2018 · 4 revisions

Supported Projection Type

View360 supports all three types.

const PROJECTION_TYPE = {
	EQUIRECTANGULAR: "equirectangular",
	CUBEMAP: "cubemap",
	CUBESTRIP: "cubestrip",
	PANORAMA: "panorama",
	STEREOSCOPIC_EQUI: "stereoequi"
};

Reference: PanoViewer.PROJECTION_TYPE

1. EQUIRECTANGUALR

Shows the projected content in Equirectangular Projection format.

Example - Equirectangular Image

2. CUBEMAP

It is the same as CUBESTRIP in that it shows the projected contents in the Cubic Projection format.

See Customizing Cubemap for more information on Cubemap settings.

When to use?

If you have any of the following, you must use CUBEMAP.

1. If you are using a very large cubemap image

  • Texture size is limited. This is typically limited to 4096 x 4096 per texture, especially for mobile environments.
  • The CUBEMAP type uses canvas to increase its usable size by six times.
  • If you are using a very large cubemap image, use CUBEMAP.
    • CUBESTRIP only supports sizes up to 4096 x 4096 for mobile.
    • If greater than this, use CUBEMAP.

2. If you're using individual images for a cube

  • CUBEMAP is used when 6 images constituting the cube are each individual files.
{
	projectionType: "cubemap",
	image: [ 
		'../static_assets/sample_right.jpg', 
		'../static_assets/sample_left.jpg',
		'../static_assets/sample_top.jpg', 
		'../static_assets/sample_bottom.jpg', 
		'../static_assets/sample_back.jpg',
		'../static_assets/sample_front.jpg' 
	]
}

3. Not a 3x2 layout

  • CUBEMAP is used when the following layout is used to arrange six images constituting a single cube.
    • 1x6, 2x3, 3x2, 6x1

image

Example - Customized Cubemap

3. CUBESTRIP

It is the same as CUBEMAP in that it shows the projected contents in the Cubic Projection format.

See Customizing Cubemap for more information on Cubemap settings.

When to use?

1. If you need faster rendering (for example, when playing video)

  • CUBESTRIP performs faster than CUBEMAP because it renders it without going through CANVAS.

2. Using the YouTube EAC format

  • EAC format is a more efficient format that improves existing Cubic Projection.

Example - Youtube - EAC Format

4. PANORAMA

This type is for displaying panorama pictures taken on smartphone. Make your photos look like 360-degree content using the smartphone's basic photo app. The advantage is that it is much easier to obtain content than Equirectangular or Cubemap content.

Here is an example of a panoramic picture.

image

If the picture has a width / height ratio of 6 or more, it covers the '360 degree range'. If it is smaller than 6, the cover angle decreases proportionally from 360 degrees.

Example - Smartphone Panorama

5. STEREOSCOPIC_EQUI

Equirectangular format for displaying stereoscopic images through special equipment. Image format of two equirectangular images combined vertically. Each image is shot with a slight parallax to the image corresponding to the left eye or right eye.

The following is an example of a stereoscopic Equirectangular type photograph.

image

Example - Stereoscopic Equirectangular

Clone this wiki locally