Panoramic Media Support

Panoramic Media Support

File Formats

ClassVR supports images in JPEG or PNG file format of any size.

ClassVR supports the MP4 video format with a maximum resolution of 3840 x 2160 and a maximum frame rate of 30 FPS.

Panoramic Videos

ClassVR supports the playback of panoramic videos in a variety of forms. Note that panoramic videos are stored just like normal video files: each frame is a simple rectangle. The video player then arranges the content of each frame to give the panoramic effect, which is known as a projection. It is not always possible to determine the projection for a video file automatically as there are no universally recognised standards, so in some cases the user must tag the file with the correct projection before viewing it on a headset.

Equirectangular Projection

The most common projection is equirectangular. In exactly the same way the sphere of the Earth is represented as a 2D rectangular map, a 360 panoramic view can be flattened into a 2D video frame. Here is an example of a panoramic photo inside a church that has been stored using an equirectangular projection:
Panoramic church interior in equirectangular projection
When a media file is uploaded to the ClassVR cloud it is assumed to be in equirectangular format and the tag is added, shown in the lower right-hand corner of the thumbnail like this:
Thumbnail view in ClassVR cloud
To remove this tag, use the context menu (right-click) and select Remove Equirectangular Tag.

Stereo Equirectangular Projection

Pictures or videos can give the illusion of depth by presenting different images to the left and right eyes. The most common arrangement for these files is to put both images into a single frame such that the image for the left eye is on the top and the image for the right eye is on the bottom as shown in the example below:
Stereo equirectangular panorama example
Although files uploaded to the ClassVR cloud will be automatically tagged as Equirectangular, users must manually tag stereo images as shown here:
Stereo tag example

This tells the image or video viewer in the ClassVR headset to present the media in the correct way.

Equiangular Cubemaps

Another emerging format for video files is the equiangular cubemap (EAC), in which the view is split into six sections that correspond to the six faces of a cube. ClassVR supports a popular version of this format in which the left, front, and right faces of the cube are stored sequentially in the top half of the image and the bottom, rear, and top faces of the cube are stored in the bottom half of the image. There is no approved standard for this format and ongoing support for this format is not guaranteed.

Here is an example of an EAC frame:
EAC video frame
EAC videos that have been uploaded to ClassVR cloud need to be tagged with the Cubemap tag.

EAC videos can also come in a stereo format, where the images for both eyes are stored in a single frame as shown below:
Stereo EAC video frame
Videos like this need both the Cubemap and Stereo tags.

Other Media Types


Playback of traditional flat pictures or videos is now supported. On the ClassVR portal, the first option is "Remove Equirectangular Tag (Flat Image)". Select this and then the image or video will display in the headset in a traditional flat view - without being stretched round the entire screen. When re-tagging, you must drag and drop the content back into the playlist pane and resend the track for the change to take effect.


Once the tag has been removed, the content should then display in a flat view. You can re-tag the content by right clicking and adding in a 180-degree or 360-degree tag to the content. Tagging it with the 360 degree option will stretch the image around the entire display; tagging with the 180 degree option will spread around half of the display. When re-tagging, you must drag and drop the content back into the playlist pane and resend the track for the change to take effect.



    • Related Articles

    • Uploading Your Own 360 Videos

      Uploading Video Content to ClassVR However you create your content, all you need to do is get the pictures or videos onto your computer and drag-and-drop them into ClassCloud on the ClassVR portal. From there, you can send them out to any of the ...
    • Using Ricoh Theta cameras with ClassVR

      The Ricoh Theta range of cameras is very popular. Capturing image and video files is straightforward, and these files work well on ClassVR headsets. Depending on the model, these instructions may differ slightly. This article runs through how to use ...
    • Uploading Your Own 360 Images

      Uploading Content to ClassVR However you create your content, all you need to do is get the pictures or videos onto your computer and drag-and-drop them into ClassCloud on the ClassVR portal. From there, you can send them out to any of the ClassVR ...
    • Translating Subtitles on ClassVR YouTube Videos

      This short guide will explain how to convert the subtitles on our YouTube videos into your own language. First, click on the settings cog at the bottom of the video. Next, select the ‘subtitles’ section of the menu and click ‘Auto-Translate’ Then ...
    • Video Playback Buffering on Laptop/PC

      If your 360 video content is not playing well on your management laptop/pc. On the ClassVR portal click the Deliver tab and unlock devices.   Click the sync button (to switch it off) as shown in the picture below this should improve video playback. ...