Available with Magic Leap OS 1.3.0-dev2 onwards, the Model Viewer provides Magic Leap 2 users with an on-device viewer for 3D models.
Supported Filetypes
The following 3D file formats are supported:
- .obj, .fbx, .glb/.gltf
Recommended total file size is 200 MB. Larger files may decrease performance and battery life. Turning battery saver on may help reduce power usage in these situations.
Transferring 3D Files to your Magic Leap 2
To transfer supported 3D files to the Magic Leap 2 follow these steps:
From the Hub
- Connect your device to The Magic Leap Hub
- Open “Device Bridge”
- Navigate to “Files”
- Navigate to the file path in the image below
- Drag your files to the folder OR right click and select “upload files”
Don’t have any 3D files, but want to try out the app? Download the Magic Leap 2 device models from our Developer Portal and extract the .zip file.
Via the Browser
Visit the website with the file for the model you wish to view. Download a supported 3D filetype from the Magic Leap browser.
Selecting a Model
Open the "Model Viewer" app from the App Launcher and click on “Open New Model” button to find the asset you just loaded. Note: You may need to look down to see the "Open New Model" prompt.
Inspecting a Model
The Menu
After you choose an object from the file manager, the model loads into your space with a menu that has 3 buttons:
- Reset transforms: resets the transform if you resize and/or rotate the object, while keeping the object in the same position.
- Actual size: scales the object to its original 1:1.
- Delete: immediately removes the object from the scene without asking for confirmation.
In situations where the object is too large, or when the 3 buttons cannot be easily found, the bumper on controller (while targeting an object) can be used to bring up the menu buttons specific to that object, up close and center in the FOV.
When two objects are open, if you press the bumper to open the 3 button menu for one object, you can then point to another object and, using the bumper, close the 3 button menu of the previous object.
Moving, Scaling, and Rotating Models using Hand Gestures
- Hover on the object, by pointing with your hand in a pinch position.
- Grab it via a pinch.
- You can grab the object and place the object anywhere in space
- You can rotate it by aiming and grabbing the vertical and horizontal edges of the bounding box, then rotating to the degree and direction desired
- You can scale it by aiming and grabbing the corners of the bounding box and then increase/decrease the size of the object as desired.
- You can also use two hands for scaling and rotating.
- If the object is in the near field, you can reach your hand into the object, and pinch and grab to directly manipulate any of the corners and edges.
Moving, Scaling, and Rotating Models using the Controller
- Hover on the object, by pointing with the controller.
- Grab it through a controller trigger.
- You can grab the object and place the object anywhere in space
- You can rotate it by aiming and grabbing the vertical and horizontal edges of the bounding box, then rotating to the degree and direction desired
- You can scale it by aiming and grabbing the corners of the bounding box and then increase/decrease the size of the object as desired.
Placing an Object on a Surface
- Grab the 3D object and approach any horizontal surface
- See the horizontal surface get highlighted and a ring the size of the object appear on the surface
- Release the trigger or the pinch and watch the object snap onto the surface