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.
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 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
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
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
This page describes the options available when editing images in LeiaPlayer.
The Depth slider controls the disparity value of your image. As you move the slider up, you will perceive more depth
Disparity is the difference in image location of the same 3D point when projected under perspective to two different camera views
Perception of depth arises from the “disparity” of a given 3D point in your right and left retinal images
The Focus slider controls the convergence value of your image.
As you move the slider up, more objects in your image will appear to be popping out of the front of the screen
As you move the slider down, more objects in your image will appear to be moving backward behind the screen
The convergence value is the point at which the left and right eye images align, which sets the location of convergence at the screen plane
Objects in front of this point will appear to be in front of the screen and those behind will appear to be behind the screen
The bokeh slider controls the digital blur applied to background pixels that are located behind the convergence plane
If you move the convergence slider to the very top, there are no pixels considered as behind the convergence plane, and thus aren’t part of the background
Thus you won’t see any digital blur applied to those pixels, even if you move the Bokeh slider to the very top
If you feel the need to increase the depth of your image a considerable amount to the point where you start to see visual artifacts in the background, you can add some bokeh, as it will blur the background and help conceal the artifacts.
These are primarily straightforward chroma editors that you will see in any mobile photo editing app
This will increase the brightness of all shadows and highlights in your image
Your photo will look brighter overall as you move the slider up
This will increase the photo’s color intensity
The colors in your photo will look more intense as you move the slider up
Contrast is the range of difference between different tones in a photo
For black and white photos, contrast describes the difference between the darkest and lightest tones
For color photos, contrast applies to how sharply colors stand out from one another
As you move the slider up, bright colors will appear brighter
As you move the slider down, dark colors will appear darker
Adjusting the Hue slider to see shifts in the color values in your images
You can radically alter your photos colors
Smaller, more incremental adjustments can effectively reduce unwanted color casts and correct the photos white balance
Color Pop will remove color from pixels considered as part of the background
This makes the colors of objects in the foreground really standout
This is the only feature in the Color section that makes use of the disparity map
Simple tools for resizing and rotating your image.
Note that if you crop an image down to a smaller size, its disparity and convergence values will increase, which will increase the depth sensation
This is where the artistic flavor gets added
Tap any of the relighting presets, and you will have different lighting configurations added to your image.
These lighting placements use the depth map to get placed into different parts of the image.
After applying a preset and hitting the check button to confirm your changes, you can open the Relighting section again and add another preset. This will let you create custom presets by combining multiple presets together. If you keep adding them, your pictures will start to take on a very different tone.
Apply styles to your images by selecting the preset filters.
As with relighting, you can apply multiple presets to each image to create your own custom styles.
Combine these filters with a bunch of relighting presets to make each image a unique work of art
The Swiss army knife of the Leia ecosystem that lets you playback, edit, and export 3D Lightfield media.
LeiaPlayer is a simple yet powerful app that lets you view, organize, and edit your 3D Lightfield media.
When you launch LeiaPlayer, you’ll find yourself in the Media gallery. The app launches directly to Media so you can easily find the images or videos you've engaged with most recently.
Media shows you all the images and videos found in your Pictures, Movies, and Downloads folders as well as any file you navigate to and open in LeiaPlayer's File Browser. You can easily remove any file from your Media tab by selecting it inside the Media tab and choosing "Remove Selection From Media". You can also easily add any file on your device to the Media tab by finding it in LeiaPlayer's File Browser and selecting "Add Selection to Media".
If you're opening LeiaPlayer for the first time, you’ll notice some preloaded media to give you inspiration on what 3D Lightfield content can look like. Note: Media will automatically add photos and videos found in the top level of your Pictures, Movies, and Downloads folders, but will not automatically add files in nested folders found inside those listed folders.
Tap the Menu Button (a.k.a. Hamburger Menu) in the top left to access the Navigation Menu Drawer. From here, you can jump between different file galleries in LeiaPlayer.
Moving down the drawer menu below Media, you'll see Camera Roll, File Browser, Lume Link, and Settings.
This is the default browsing experience in LeiaPlayer. The Media tab aggregates media on your device in one easy to use place. By default, all the image and video files in your Pictures, Movies, and Downloads folders will appear here. However, other files that you've opened in the LeiaPlayer File Browser will appear in Media automatically too, as well as media you've added using "Add Selection to Media".
The Camera Roll is a folder of all the pictures and videos you've taken using camera apps on the device, including those taken with LeiaCam.
This section shows you the entire file system of your device. The LeiaPlayer File Browser follows the standard file browsing paradigm from Android. The File Browser shows the folders on your device, and these folders contain subfolders within them. When you tap the “Pictures” folder you will see the “Screenshots” subfolder contained within it, alongside any media that's already in the Pictures folder.
We want to preserve this folder structure so that when you move files on or off of Lume Pad from a computer or another app, you can easily understand where they're located.
Lume Link is a feature of the LeiaLink app that allows you to send images from your mobile device to your Lume Pad and have it waiting for you in LeiaPlayer already converted into Lightfield 3D.
To use Lume Link, you must log in using your LeiaLogin account, and link to the LeiaLink app installed on your mobile device.
The Settings tab in LeiaPlayer gives you the ability to turn features on and off and customize your LeiaPlayer experience.
General: This section provides several options for how you'd like to view media in LeiaPlayer. It also gives you options on how you'd like LeiaPlayer to handle certain features that may make modifications to your files.
Video Playback: Options for default video playback behavior.
About: Licenses and legal info.
LeiaPlayer Beta: Sign up for future Beta versions of LeiaPlayer.
There are a variety of ways to add media to your Lume Pad, including downloading files from the internet, or getting a 3D Lightfield photo or video from another Lume Pad user. To add media from a computer to Lume Pad to experience in LeiaPlayer, you can use Android File Transfer on MacOS or simply plug your Lume Pad into a PC to move files from your computer onto Lume Pad. Then, you can find them in LeiaPlayer and view them.
All 2D or 3D content can be viewed in 3D in LeiaPlayer! For 3D content it's self-explanatory, but for 2D images and videos it's a little different. Still, it's as easy as tapping the Leia Lightfield button.
2D Images: Open a 2D image so it's full screen in LeiaPlayer. Tap the Leia logo in the bottom left hand corner on the View Switcher, and a new LIF format version of your image that's in 3D. You will have two files now: the original 2D image and the new 3D LIF image.
2D Videos: Open a 2D video so it's full screen in LeiaPlayer. Tap the Leia logo in the bottom left hand corner on the View Switcher, and after a few seconds of buffering, you will see your video playing back in 3D! Just follow these steps again whenever you want to view your 2D video file in 3D.
The Ellipsis Button is the three vertical dots you usually see in the top right corner of the app. The Ellipsis Menu changes depending on the context of where you are in the app.
The Ellipsis Button opens up View Options if you're in a standard Gallery View. These View Options may be available in other modes too, like in Bulk Selection Mode. These are the options available within the View Options menu:
Lightfield/2D Sorting: Show only Lightfield media files, only 2D media files, or Both.
Media Type Sorting: Show only Images, only Video, or Both.
Sort By Options: Sort by Date Created, Date Modified, Filename, File Size, or Resolution
The Ellipsis Button opens up More Options if you're in the File Browser View. These are the options available within More Options when in the standard File Browser View:
New Folder: Creates a new Folder within the Folder that you're currently in.
Select: This option will switch you into Bulk Selection Mode so you can easily select mutliple files to move or delete.
The Ellipsis Button opens into More Options in Bulk Selection Mode. Here are the options available within More Options when in Bulk Selection Mode:
Add Selection to Media: Adds the selected file to the Media tab.
Rename: You can use this option to change a file's filename (Only when 1 file is selected)
Move: This feature will move the file(s) from one folder to another (more info below)
Select None: Deselects all selected items and exits Bulk Selection Mode
Invert Selection: Deselects all currently selected items and selects all currently unselected items within the folder that you're in.
Select All: This option will select every item in the folder that you're in
Moving files from one location to another is easy. Just follow these instructions:
Long press an image thumbnail to enter Bulk Selection Mode.
Select the files that you would like to move.
Tap the Ellipsis Button (3 vertical dots) in top right corner.
Tap the Move Button in the More Options Menu.
In the Move Menu, navigate to the destination folder you want to move the file(s) to.
Tap the Move Here Button in bottom right corner to confirm the move.
The files will now be located in the destination folder you selected.
The files you selected are not being copyed, they are being moved. They will no longer be found in their original location.
The files you just moved may be hard to find if you moved them to a folder with a lot of items in them. To find the files you just moved, you may have to scroll down to the bottom of the destination folder, as the folder you moved the files to may be sorted based on the files names or the original date the files were created. The files you just moved may also not be grouped together in the destination folder.
Viewing 3D images
If you have 3D files from other sources like SBS or Quad Lightfield images or video, LeiaPlayer will try to detect them automatically. However, sometimes, LeiaPlayer may not automatically detect them as 3D. To manually communicate to LeiaPlayer that the files are 3D, you will need to use the 3D Tagging feature.
Here's how to do this in LeiaPlayer:
Open up the 3D image that's being displayed in 2D
Tap Ellipsis Button (3 vertical dots) icon in top right corner
Tap Add 3D Tag
Follow the instructions and answer questions about the file
The file will now be viewable correctly in 3D
You can do this process to fix a file that's incorrectly identified as 3D or in the wrong format of 3D too by doing the same steps except tapping the "Edit/Remove 3D Tag" button that appears in place of the "Add 3D Tag" button.
When you open an image or video in LeiaPlayer, it will open in Theater Mode. This is the best place to view 3D Lightfield media.
When viewing media, you will notice an option in the bottom left corner to change the view mode.
Lightfield: This icon looks like the Leia logo. View the compatible image or video as a 3D Lightfield with 4 unique views. Lightfield View Mode has the following benefits: a wide viewing angle, comfortable for multiple viewers, objects feel more real and have a "look-around" (parralax) effect.
ST: This icon is named for Stereoscopic 3D View Mode. The icon is only shown when viewing compatible files. View the compatible image or video in traditional stereo 3D with 2 unique views. Stereo 3D has some benefits, including: support for more depth for a single viewer, and no synthesized views. The downsides for Stereo 3D View Mode include a smaller viewing angle, much less comfortable for multiple viewers, no look-around / parallax effect, and increased chance of cross-talk/ghosting. This is the preffered viewing method for content captured on legacy 3D systems.
2D: View the image or video in standard 2D with a single view. 2D is highest resolution with maximum brightness, but of course has no depth or look-around effect/parralax.
Some Apple devices allow you to capture depth maps when shooting images in Portrait Mode and with some other apps. The quality of the depth map depends on the device, the sensors available, and the environment and distance from the subject when the image was taken.
Shoot Portrait Mode Images on your iOS device where the Portrait Mode Indicator (e.g. Natural Light icon) is yellow
Move images with Apple Depth Maps and move them to your Lume Pad (using LeiaLink, email, or other method)
Open it in LeiaPlayer
Tap the Leia Lightfield View Button to convert Apple Depth Map images to a 3D Lightfield LIF
Currently supported iPhone Models
iPhone 13 Series
iPhone 12 Series
iPhone SE (2020 and 2022)
iPhone 11 Series
iPhone XS Max
iPhone XR
iPhone 8 Plus
iPhone 7 Plus
In order to share Leia Image Format (LIF) files to another Lume Pad device and retain the 4V depth metadata, you must be cognizant of the transfer method you use. Many messaging apps and social networks will strip the 3D Lightfield metadata and send only a 2D image to the other user.
If you'd like to send the LIF file directly to another device here are some methods that work:
Supported Messaging Platforms
Discord
ZIP: If you compress or ZIP images before sending them, metadata will be retained in transit
If you want to share your Lightfield images to 2D devices, tap the share button in the gallery screen.
This will allow you to export images as Lightfield Animation in MP4 and GIF format, which are Lightfield-synthesized animations that show the depth of your images by interpolating smoothly between the image's views.
This is the best way to share your Lightfield images on traditional social media platforms.
Loop Video
To loop your video continuously, tap the ellipsis button in the top right corner
Then tap “Loop Video On”
Depth Slider
You will see the Depth Slider on the right-hand side of the screen whenever viewing video content in Lightfield view mode
Move the Depth Slider up and down to increase or decrease the disparity value, which will increase or decrease the sensation of depth
What are the benefits of editing Lightfield Images in LeiaPlayer?
Improve the visual quality of your images
Increase the depth effect of your images
Add artistic flair to your images
To edit images in LeiaPlayer, open an image and tap the pencil and pad icon in the bottom center of the screen. Only some 3D Lightfield images can be edited, including LIF and 3D SBS images.
The LeiaPlayer editor relies on the depth map to estimate the depth at each pixel in the photo, which can be used to identify portions of the image that are far away and belong to the background. Quad Lightfield images don't contain the Lightfield metadata needed to edit them.
Images are saved in the Leia Image Format, and will retain the same number of views as it originally contained.
To learn more about specific tools available when editing Lightfield images, go to the Editing Images page.
This page explains how to convert 2D media into Lightfield 3D media in LeiaPlayer.
2D to 3D Lightfield conversion couldn't be simpler. Simply open your 2D image or video in LeiaPlayer and tap on the Leia Lightfield View Switch in the bottom left hand corner. Voila, your file is now viewable in 3D Lightfield!
For images, a 3D copy of the image will be made in the LIF format, so you'll now have the original untouched 2D file as well as a 3D LIF copy.
For video, the conversion is done in real-time and your 2D video file will remain untouched. You will need to follow the above process each time you return to your video if you'd like to view it in 3D.
If your file is a Portrait Mode image from iOS with an Apple Depth Map, the embedded depth map will be used in the 3D Lightfield conversion.
To learn more about the different filetypes, go to Supported Filetypes in LeiaPlayer.
Lume Link is a feature of LeiaPlayer that allows you send pictures directly from your linked smartphone to your Lume Pad.
The Lume Link tab on the side of LeiaPlayer allows you to connect your smartphone to your Lume Pad. Then, you can easily send pictures to your Lume Pad from your mobile device and they'll appear in 3D Lightfield in LeiaPlayer.
It's easy!
Go to the Lume Link tab in LeiaPlayer
Sign in using LeiaLogin
You'll see a pin number on-screen
Now grab your mobile device.
On your mobile device, go to your device's app store and download LeiaLink
Open LeiaLink and follow the instructions on the screen
Type your LeiaLogin account's email address into the LeiaLink app
Type the pin number on your Lume Pad into the LeiaLink app
Your Lume Pad and mobile device are now linked!
Now you can go to the image gallery on your smartphone, select images, and share them to the LeiaLink app. They will appear in the Lume Link tab in LeiaPlayer on your Lume Pad, except they'll be in beautiful Lightfield 3D!
This page describes how to create beautiful and shareable Lightfield Animations.
You can turn any 3D image file in LeiaPlayer into a Lightfield Animation. This is a an animation that can be shared anywhere that can give others an understanding of the depth in your 3D image.
To create and share a Lightfield Animation, all you have to do is open the 3D Lightfield image that you want to turn into a Lightfield Animation, tap the Share button, and then select either "Video Animation" or "GIF Animation".
Video Animations will be in the MP4 file format and GIF Animations will obviously be in the GIF file format.
Video Animations export in higher quality but GIF Animations may be supported on platforms where sharing a video isn't. In addition, some platforms like Twitter will compress video files but will leave GIFs uncompressed. Also, GIFs play automatically, but videos may require a viewer to click or tap to play the Video Animation. Many times you'll find that there's no option to automatically loop videos on the platform you're using, while GIFs will do so by default.