Supported Filetypes in LeiaPlayer

This page explains which filetypes can be played back and edited in LeiaPlayer.

All of the following filetypes are supported in LeiaPlayer. It's organized by whether the filetype is 3D Lightfield or 2D, and then further divided by whether it's an image or video. All 3D formats are automatically detected as 3D, either through the file's metadata or through an automatic computer vision algorithm for unlabelled 3D files.

3D Lightfield Image Formats

  • Leia Image Format (LIF)

    • Leia Image Format images (abbreviated as LIF) are JPG images with image metadata that may contain depth, bokeh data, and one or more images known as "views"

    • These images can be shared anywhere to any device and will automatically show as a high-resolution 2D image on all standard computing devices like laptops or phones. However, they will automatically be displayed as 3D Lightfield images on Lume Pad and other Leia devices

    • They are optimized for Lightfield View Mode by default. You can view them in stereo 3D view mode (if the LIF file has 2 views) by using the ST button in LeiaPlayer

    • This is the default image format in the Leia ecosystem, and offers the most flexibility long-term. When you edit an SBS image in LeiaPlayer, it will automatically save as LIF

  • 3D SBS Images

    • Two Side-By-Side images

      • Left image on the left, right image on the right

    • File formats supported: JPG, PNG, WEBP, HEIC

  • Quad Lightfield Images

    • Four images shot in a horizontal line aligned in quadrants in the following order:

      • Top Left Quadrant: Outer left image

      • Top Right Quadrant: Inner left image

      • Bottom Left Quadrant: Inner right image

      • Bottom Right Quadrant: Outer right image

    • File formats supported: JPG, PNG, WEBP, HEIC

    • Quad Lightfield images will not be interpolated in any way, they will always be displayed exactly as-is in Lightfield View Mode

    • Quad Lightfield should generally only be used by creators who understand the ins and outs of Leia Lightfield displays and know how to push the capabilities of the Lume Pad to its limits

  • Apple Portrait Mode Images

    • When a user takes a Portrait Mode image on an iOS device using the iOS Camera app, it may include an embedded depth map making it a true 3D file. If LeiaPlayer finds a depth map in a photo from iPhone, you can convert the file to LIF by simply tapping the Lightfield View Mode button

    • Tip: You can tell if a depth map will be captured when taking a photo in Portrait Mode on the iOS Camera app if the icon that says "NATURAL LIGHT" on-screen turns yellow. If it's grey, no depth will be captured

    • Tip: Newer iOS devices and especially iOS devices with LiDar take the highest-quality depth maps. Older devices may not be able to capture depth maps or will take poor quality depth images

  • Legacy 3D Images

    • Support for MPO and JPS filetypes

      • Support for two images embedded in an MPO or JPS image (files with 1 or 3+ images may not be supported)

      • They look like standard 2D images on many non-3D devices

      • MPO is most commonly captured on Fujifilm FinePix Real 3D cameras, Nintendo 3DS and 2DS devices, and other 3D cameras from that era

      • JPS is most commonly captured using Nvidia 3D Vision tools, such as in-game screen captures, and from other 3D software for PC

Automatic Detection of SBS and Quad Lightfield Images:

In the case that the automatic file detection feature didn't correctly identify your your SBS or Quad Lightfield image and shows it in 2D, you can force LeiaPlayer to treat image files as SBS or Quad by using the Manual 3D Tagging feature inside the app or by doing the following:

  • SBS: Append "_2x1" to the end of the filename before the file extension

  • Half-width SBS: Append "_half_2x1" to the end of the filename before the file extension

  • Quad Lightfield: Append "_2x2" to the end of the filename before the file extension

3D Lightfield Video Formats

  • 3D SBS Videos

    • Two Side-By-Side videos

      • Left image on the left, right image on the right

    • File formats supported: MP4, MKV, WEBM, H4V

    • SBS videos will open in Lightfield View Mode and be automatically interpolated to 4 views when viewed in LeiaPlayer on Lume Pad. You can use the ST button to view in the original stereo format with 2 views.

  • Quad Lightfield Videos

    • Four images shot in a horizontal line aligned in quadrants in the following order:

      • Top Left Quadrant: Far left image

      • Top Right Quadrant: Middle left image

      • Bottom Left Quadrant: Middle right image

      • Bottom Right Quadrant: Far right image

    • File formats supported: MP4, MKV, WEBM, H4V

    • Quad Lightfield images will not be interpolated in any way, they will be displayed exactly as-is in Lightfield View Mode

    • Quad Lightfield should generally only be used by creators who understand the ins and outs of Leia displays and know how to push the capabilities of the Lume Pad to it's limits

Automatic Detection of SBS and Quad Lightfield Videos:

In the case that the automatic file detection feature didn't correctly identify your your SBS or Quad Lightfield video and shows it in 2D, you can force LeiaPlayer to treat video files as SBS or Quad by using the Manual 3D Tagging feature inside the app or by doing the following:

  • SBS: Append "_2x1" to the end of the filename before the file extension

  • Half-width SBS: Append "_half_2x1" to the end of the filename before the file extension

  • Quad Lightfield: Append "_2x2" to the end of the filename before the file extension

2D Image Formats

These standard 2D image formats are supported in LeiaPlayer. You can also automatically convert any of them into 3D by tapping the Lightfield View Mode button in the view switcher in the bottom left of the UI. This will create a LIF copy of the image.

  • JPG

  • PNG

  • WEBP

  • HEIC

2D Video Formats

These standard 2D video formats are supported in LeiaPlayer. You can also automatically convert any of them into 3D by tapping the Lightfield View Mode button in the view switcher in the bottom left of the UI. This is real-time conversion and will not alter the file or make a 3D copy.

  • MP4

  • MKV

  • WEBM

Last updated

Copyright © 2023 Leia Inc. All Rights Reserved