LeiaViewer

Interact with 3D models displayed as a 3D Lightfield

Getting Started

LeiaViewer is your home for viewing and enhancing 3D models in an immersive Lightfield environment. Precisely tune the depth and appearance of your model and create dynamic backgrounds, for a pleasant viewing and content creation experience. Users can also login to SketchFab to search and view millions of models.

Where To Find It

LeiaViewer comes preinstalled on all Lume Pad devices. All future updates will be delivered via Leia Appstore on Lume Pad devices.

Supported File Types

LeiaViewer supports the following file types:

•FBX

•OBJ

• STL

•GLB

•GLTF

Recommended File Sizes

The file size limitations in LeiaViewer are impacted by the number of triangles, polygons and vertices of each model.

If your model is not loading, it may be too large to open in LeiaViewer. in this case you should try to reduce the facecount to under 100k. You can do this by going into Blender (a free app) and using the decimate tool. You may also want to adjust Image size down to 4K or less in Photoshop. Object orientation and positioning - This was also adjusted in Blender.

Recommend upper limit for facecounts: 100k

Recommend upper limit for file sizes: 50MB

Recommend upper limit for textures? Over 4K definitely won't work

How should users report bugs? what kind of bugs do we want them to report to us?

If there is problem loading SF model, we need the following information:

  1. Name of model and author

  2. Describe problem (crash? error modal? model didn't load? progress bar frozen?)

  3. Describe visual problems (does model look different than model thumbnail image?)

  4. Center of rotation (is the model not centered properly?)

If there is problem loading model on device:

  1. Send us model

  2. Describe problem (crash? error modal? model didn't load? progress bar frozen?)

  3. Center of rotation (is the model not centered properly?)

The file size limitations are impacted by the number of triangles, polygons and vertices of each model.

General recommendations:

  • Keep polygon and vertex count below 1 million

  • There is no exact limitation for opening models in viewer, it depends on the content. Try different LODs and see which works for you.

  • Our rule of thumb is 100k vertices or below, max texture size at 4K

Importing Models

•To import models, tap the + button in the top left corner to open the file browser. Select the model files from whichever directory they are saved to on your device.

•For model types like FBX and OBJ, your textures will need to be siblings of the model file.

Uploading STL instructions

STL doesn't have textures, so its a single model format. Load the model by clicking on it in the file browser.

Uploading OBJ instructions

•OBJ and FBX are the same, but you need to make sure any textures that come with model are in same directory as the model itself

•Sometimes they come with a separate textures folder, you need to move all the textures into the top level directory that contains the OBJ model

•Once all the files are in the right place, just tap the OBJ model in LeiaViewer file browser

Uploading FBX instructions

•OBJ and FBX instructions are the same, but you need to make sure any textures that come with model are in same directory as the model itself

•Sometimes they come with a separate textures folder, you need to move all the textures into the top level directory that contains the OBJ model

Uploading GLB instructions

Copy folder containing GLB to your Lumepad and directory structure is usually already set up properly, so just tap GLB file in LeiaViewer browser.

Opening GLTF instructions

Copy folder containting GLB to your Lume Pad and directory structure is usually already set up properly, so just tap GLB file in LeiaViewer browser.

Animations

Animations are not a separate file, they are apart of models themself.

Animations are usually included in GLB, GLTF, FBX model files already.

They will be shown when you open the model in leaiviewer file browser.

If you want to add animations, add them to your model files.