Workshop is a multi-participant tool that brings people together to get things done. It allows teams to collaboratively ideate, prototype and solve problems whether they are in the same physical location or participating remotely. Import 2D and 3D files into work Sessions, or use Annotation tools to co-create with others. Workshop also showcases Magic Leap 2’s ability to represent geospatial data with a Map Mode that features live flight data layered over dimensional terrain.
Magic Leap 2 Setup
Put On The Magic Leap 2
Put the Magic Leap 2 headset on. The compute pack can be clipped to your pocket or worn using the shoulder strap.
Power On The Magic Leap 2
Power on the compute pack by long-pressing the Power Button until the indicator lights turn on. Power on the Controller by long-pressing the Home Button.
A Home Menu will display when the Magic Leap 2 powers on. Use the Controller Ray to interact with the menu. Your Controller will cast a Ray to show where it is pointed.
Select Featured Apps
Scroll through the Home Menu to locate Featured Apps.Point your Ray at Featured Apps and press the Trigger to select it. A web browser will appear displaying featured applications for the Magic Leap 2.
Locate and select Workshop from the list of featured applications. Selecting Workshop will download and install the application. When Workshop is finished downloading, it will appear as an item in the Home Menu.
Locate Workshop in the Home Menu. Select Workshop to launch the application.
The Magic Leap 2 Controller is used to navigate Workshop. The following actions are mapped to the Controller:
- Target - Point at with Ray
- Select - Press the Trigger while Targeting
- Grab Object - Press the Trigger while Targeting Object
- Annotate - Press the Trigger when Annotation Tool is active
- Pick up/drop Annotation Tool - Press the Bumper
- Open Object Menu - Target an Object and press the Bumper
- Duplicate - Target an Object, hold the Bumper and drag the Object
- Delete - Target an Object and double press the Bumper
- Menu button
- Open/close Personal Menu
- Open Magic Leap 2 Home Menu
- Zoom Map - Swipe left/right on the Touchpad while Targeting the Map
- Position Annotation Cursor - Swipe up/down on the Touchpad to extend/retract the Annotation Cursor
- Rotate Objects - Select an Object and swipe left/right on the Touchpad.
- Move Objects - Select an Object and press up/down on the Touchpad.
- Scale Objects - Select an Object and press left/right on the Touchpad.
Workshop supports individual and group Sessions. Groups can be located together in the same physical space or groups can be remote with Participants joining from different locations.
Start or Join
To begin the Workshop experience, you can start a new Session or join a Session.
Start a new Session if you are an individual Participant.
To host a Session for a group, you must start a new Session. The person who starts a Session is automatically assigned to be the Session Host.
To join a Session, you must be invited by the Session Host. The Host will supply you with a Session Code.
Starting a New Session
Starting a New Session
Select New from the start panel to begin a new Session.
Provide Your Name
You are required to provide your name in order to create a new Session. Your name will be displayed to other Participants if you host a group Session.
The Canvas will be the focal point of your Workshop Session. Position the Canvas in an area that is easy to access and reach. The Canvas can be positioned on a horizontal surface such as a table or positioned in open space.
Press the Trigger on the Controller to place the Canvas.
The Canvas can be scaled up or down in size using the corner cubes. The Canvas can be rotated using the spheres. The Canvas can be picked up and moved by pointing your Ray anywhere on the grid and then pressing and holding the Trigger while moving the Canvas. When you are satisfied with the size and position of the Canvas, confirm its placement by selecting the check button.
Hosting a Group Session
You will see a notification prompting you to invite Participants when you enter a new Session. You can dismiss this notification and continue to use Workshop as an individual Participant. If you would like to invite other Magic Leap 2 Participants to join you, provide them with the Session Code. If you dismiss the invite prompt, you can still access the Session Code at any time by opening your Personal Menu and then selecting Session.
Hosting a Remote Group
If all of the Participants are in a different physical location than you, then there’s no further action you need to take. Have fun exploring Workshop while you wait for them to join!
Hosting a Group Located Together
If any of the Participants are in the same physical location as you, then you will need to synchronize your location. Please refer to Synchronize Location for details.
Joining a Session
Invitation from Host
In order to join a Session, you need to be given a Session Code from the Host.
Select Join from the start panel.
Provide Your Name
You are required to provide the name in order to join a Session. Your name will be displayed to other Participants in the Session.
Enter the Session code from the Host.
Joining Remotely, Place Session
If you are not located with other Session Participants, then you will need to position the Session within your space.
Place the Session in an area that is easy to access and reach. You can rotate the Session using the spheres. You’ll be able to see a preview of where other Participants are positioned so that you can comfortably spread out.
Confirm the position of the Session by selecting the check button.
Joining In a Shared Location, Synchronize Location
If you are located with the Host or with other Session Participants, then you will need to synchronize your location. Please refer to Synchronize Location for details.
When a group is in the same physical location, they must synchronize their shared location. Synchronizing your location allows everyone in the group to see the Session content appear in the same place.
Use a laptop or desktop to open the Workshop Marker url: marker.workshop.magicleap.cloud
Print the marker at 100% scale. Only one marker is required per group.
Position the marker in a location that is visible to everyone in the group. Try placing the marker as close to the Canvas as possible. When the marker has been positioned, do not move the marker. The marker must remain in the same position after each Participant scans it.
To scan the marker, look directly at the marker with your Magic Leap 2. When the marker has been scanned, a digital outline appears around the marker. Confirm that the digital outline is correctly aligned with the physical marker. Select the Check Button to confirm the alignment. If it is not aligned, then press the bumper on your Controller to re-scan the marker.
Participants who are together in the same location, see their names and statuses digitally displayed above their heads.
Participants Appear as Avatars Participants who are located remotely appear in the Session as digital avatars. The remote Participant’s name and status is displayed above their avatar. Avatars use the Magic Leap 2’s sensors and cameras to recreate gaze, eye tracking, expressions and gestures.
The Host is always assigned Blue. All other Participants are assigned a random color when they join the Session. Your color appears around your status.
The Canvas is the focal point of the Session. In a Workshop Session, all Participants are invited to gather around the Canvas to collaborate.
Workshop has two experience modes: Map Mode and Blank Mode.
Workshop begins in Map Mode, where an interactive, 3D Terrain Map appears over the Canvas. In Map Mode, Participants can examine Live Flight Data and explore the entire world in 3D.
Blank Mode invites Participants to fill the Canvas with their own creations. Participants can explore sample files or upload their own 3D objects, 2D files, and videos.
The Workshop Menu is docked to the Canvas. The menu is communal and is accessible to all Participants. The Menu allows Participants to change experience modes. The menu options displayed are dependent on the experience mode. In Map Mode, Participants have access to Location and Layers. In Blank Mode, Participants have access to Files and Magnetism.
Participants can switch experience modes by opening the main menu button anchored on the left side of the Workshop menu. Selecting an experience mode from the mode list immediately changes the mode for all Participants
Clearing the Canvas
To delete all annotations and objects for the current experience mode, you can select Clear Canvas from the main menu.
Clearing annotations is dependent on which mode you are in. Clearing from one mode (Map or Blank) will clear all annotations from only that mode.
Moving the Menu
The Workshop menu can be re-positioned. To move the menu, hover over the Menu with your Ray and select the Move Bar located below the center of the Menu. With the Trigger pressed, move the Controller to reposition the menu.
There are Menu Rails located along each side of the Canvas. You can reposition the Menu horizontally along the rails by grabbing the Menu’s Move Button and sliding it to the left or right.
Undocking the Menu
The menu can be undocked from the Menu Rail and placed in a world-relative position.
To undock the menu, grab and hold the Menu Move Button, and then pull the menu off of the Menu Rails. When the menu has detached from the Menu Rail, it becomes world-relative. The Menu can be positioned anywhere in the Session space. The Menu can be placed back on the Menu Rail at any time during the Session.
About Map Mode
Map Mode is an innovative geospatial tool designed for multiple Participants. In its current iteration, Map Mode provides real-time, global air traffic data. This feature showcases how live information can be brought to life spatially to be explored in a more relevant and contextual way.
Workshop Menu in Map Mode
In Map Mode the following options are made available in the Workshop Menu:
Location allows you to quickly navigate to a specific location, rotate the direction of the Terrain Map, and access the Globe.
The Location Label displays the name of the map location when you have searched and selected a location from the saved locations List or selected a location from the Globe.
You can search by location to change the map position.
The saved location list is a curated set of destinations that showcase frequent air traffic activity and a variety of terrains.
You can rotate the direction of the Terrain Map by 90 degree increments corresponding with the cardinal directions (North, South, East, and West).
Activates a 3D Globe that allows you to jump to new locations. See Globe for details.
The Globe invites you to explore the world and quickly travel to saved or new locations. Selecting a Saved Location Pin or placing the Travel Pin closes the Globe and instantly transports the Terrain Map to that location. Participants can also close the Globe to return to Terrain Map by selecting the Globe button from the Location menu.
Spinning the Globe
Participants can spin the Globe by grabbing and dragging it. It can be rotated in any direction, inviting you to see the Globe from new perspectives. If a Participant is moving the Globe, other Participants are not able to grab the Globe until that Participant releases it.
Current Location Pin
The Terrain Map’s current location is represented with a Blue pin.
Saved Location Pins
Locations featured in the Saved Locations list are displayed on the Globe with translucent pins.
The Travel Pin is located above the Globe. Participants can grab the Travel Pin and place it anywhere on the Globe to travel to that location.
The Layers menu allows you to control which layers are visible on the Terrain Map. Layers also allows you to set the visual style of the map.
You can set the visual style of the map to Satellite or Dark. The visual style impacts the Terrain Map and the Globe.
You can turn flight data on or off by selecting Flight Data button. When flight data is on, Participants are able to see live flights visualized through 3D aircraft layered over the Terrain Map. When flight data is off, all aircraft are hidden from the Terrain Map.
Navigating the Map
You can go anywhere in the world on the Terrain Map. You can pan and zoom the map or you can travel to specific destinations using the Location Menu.
Grab & Drag to Pan
You can pan the map by targeting the terrain with the Ray, pressing and holding Trigger, and dragging the terrain. If a Participant is actively panning the map, other Participants are not able to manipulate the map.
Use Touchpad to Zoom
You can adjust the zoom level of the map by targeting the terrain with the Ray and pressing left or right on the Touchpad. If a Participant is actively zooming the map, other Participants are not able to manipulate the map.
Live flight data from ADS-B Exchange is visualized in real-time through 3D aircrafts layered over the Terrain Map. *Flight data is restricted to a 200 mile radius. Flight data can be turned on or off through the Layers menu.
Targeting an aircraft with your Ray reveals flight summary information
Selecting a Flight
Selecting an aircraft reveals the Flight Detail Panel and the aircraft’s flight path. When you select an aircraft, the selected state is visible to all Participants in the Session. The aircraft remains in a selected state until the Flight Detail Panel is closed or until another aircraft is selected.
The Flight Detail Panel displays the following data:
- Departure and Destination (if available)
- Flight Number or Call Number
- Aircraft type
There are 8 unique aircraft types, each represented by a color-coded 3D model:
- Commercial Jetliner
- Private Jet
- Turbo Prop
- Multi-engine Prop
- Private Airplane
- Military Transport
- Military Jet
When data becomes spatial, new insights are revealed. Review live data, Present your ideas in 3D, or Prototype and iterate together.
Workshop Menu in Blank Mode
In Blank Mode the following options are made available in the Workshop Menu:
The Files menu invites Participants to upload their own files into their Workshop Session. Magic Leap sample files are also provided for reference.
Selecting Upload Files begins the file upload sequence. See File Upload for more details.
By default all files are displayed. Participants are able to navigate by selecting a folder from the files menu or by selecting a folder from the navigation drop-down. Back and forward arrows also allow Participants to navigate between folders.
Edit and Delete Files
Edit allows Participants to select one or more files. Selected files can be deleted. Deleting a file will permanently remove it from the Session including any open instances of that file.
Grid View and List View
The View button allows you to switch between the grid view and the list view.
Hovering over a file exposes the file’s More (...) button. Selecting More reveals file options such as delete or open.
Grab and Drag to Open A file can be opened by grabbing it from the folder and dragging it into the Session. The file will appear where you have placed it.
Open with More (...)
A file can be opened by hovering over the file, selecting the More button, and then selecting Open. The file will open centered on the Canvas.
Larger files may take a moment to load when opening. A loading animation will display where the file is being opened. Participants may experience different loading times.
You are encouraged to upload your own unique files to their Session. Uploading files requires access to a laptop or desktop computer during the Workshop Session.
Select Upload from Files Menu
Select the Upload button from the Files menu to begin the upload process.
Open the Workshop File Manager on a Laptop or Desktop Computer
On a laptop or desktop computer open a web browser (Chrome is recommended for the best experience). Go to workshop.magicleap.cloud. The landing page will display a QR code.
On your Magic Leap 2, select the Next button to advance to the QR code scanner. Look directly at the QR code on your computer with the Magic Leap 2. If you have difficulty scanning the QR code, try getting closer to your computer screen or turning the brightness of your computer screen down. A confirmation message will display when the QR code has been successfully scanned.
Workshop File Manager
When authentication is complete, the Workshop File Manager will display your name and the Session Code. The file manager displays all files that have been uploaded to your Session including files that have been uploaded by other Participants. Magic Leap sample files are not displayed in the Workshop File Manager.
Drag and Drop to Upload
Drag and drop files from your computer into the Workshop File Manager to upload. While multiple files can be uploaded simultaneously, folders are not able to be uploaded.
Upload by Browsing Files
Select the Upload Files button or Upload to access your computer’s file manage, then select the file(s) from your file manager to upload.
Files that are uploaded or in the process of uploading are listed in the File Manager. The file name, type, Participant the file was uploaded by, file size, and file status are displayed.
You can cancel the upload of a file by hovering over the upload status and then selecting cancel.
Files can be deleted by hovering over the file status and selecting delete. Deleting a file will permanently remove it from the Session and from the File Manager. Participants are only able to delete files they have uploaded.
If an error occurs during uploading, the file status will be updated to display an exclamation icon and an error message.
If a Participant attempts to upload a file that is not supported, an alert will display the reason why the file was rejected.
Log Out of File Manager
You can log out of the File Manager by selecting your name in the upper left corner and then selecting log out. Closing the web browser (or tab) will also automatically log you out of the File Manager. If the Host ends the Workshop Session or if you leave the Workshop Session, you will automatically be logged out of the File Manager.
Compatible File Types
- Portable Document Format (PDF)
- Images (JPG, JPEG, PNG)
- 3D Models (GLB, GLTF)
- Video (MP4, TS, MKV, 3GP, WEBM)
Maximum File Size
- PDFs: Up to 50MB
- Images: Up to 15MB
- 3D Models: Up to 50MB
- Video: Up to 100MB
Files loaded into an Assist Session will be temporarily stored in RAM and loaded as active elements are needed. At the end of an Assist Session the uploaded files will be cleared from the ML2 headset’s local storage.
Preparing 3D Models
3D Models loaded into an Assist Session require some preparation to ensure proper performance. Models should limit the total number of polygons that the Object is composed from. There is an upper limit of 1 million polygons for 3D models of any file type. Loading high detail models will cause performance to slow and responsiveness to suffer as the upper limit is approached. If a high detail model must be loaded, reduce the number of other models being displayed on the canvas. If complex scenes need to be displayed ensure they are populated with low detail models. Recommendations: Use as few materials as possible (5 or fewer) Reduce texture resolutions where possible (2K resolution or lower) Reduce total number of Tris where possible (150k maximum) Avoid 3D model scenes featuring too many elements. Load individual 3D models or reduce the total scene complexity to meet the above limits
Images are automatically resized to fit within a 2048 x 2048 pixel display size within Assist. Files exceeding this size will be converted and compressed to fit within that size limit while preserving their aspect ratio. Images exceeding 6000 x 6000 pixels will not be accepted. If your images exceed this size limit you will need to manually resize them to be smaller than 6000 x 6000 pixels.
Recommendations: Keep image size below 6000 x 6000 pixels maximum Images are compressed upon upload, if compression may be an issue consider using a lossless image file type like PNG over JPG or JPEG
Magnetism is a property of the Canvas in Blank Mode that allows objects to be magnetically attached to the Canvas when in close proximity. Selecting Magnetism from the Workshop Menu turns Canvas Magnetism on or off. Magnetism only impacts objects that are actively being moved. Stationary objects are not effected by Canvas Magnetism.
On When Magnetism is on, objects that are being moved will snap to the surface of the Canvas if they are within magnetic range. When an object is within magnetic range, the dots on the surface of the Canvas will rise up towards the object. Releasing an object when it is within magnetic range will snap it to the surface of the Canvas.
When Magnetism is off, objects that are being moved will not be attracted to the surface of the Canvas. This allows object positions to be fine tuned.
Objects In Workshop the following are considered Objects: 2D Images 3D Objects Videos PDFs
All objects have an Object Menu. When a you target an Object, brackets and the Object Menu button appear. The Object Menu button (and any connected UI modules, ex: Play button for video) are only visible to the Participant targeting the object.
To move an object, target it, press the Trigger, and move the Controller while holding the Trigger. Release the Trigger to place the object.
To scale an object, target the object, press and hold the Trigger, and press left on the Touchpad to scale the object down or right on the Touchpad to scale it up.
To rotate an object, select the object, and swipe left or right on the Touchpad while holding the Trigger.
Direct Object Manipulation
The Object Cursor appears when the Controller is in close proximity to an Object. The Object Cursor gives you the ability to move and rotate digital objects as if they were physical objects. Objects can be directly manipulated by placing your Controller on, or in close proximity to, the digital object. When your Controller is close to the object, the Ray is replaced with the Object Cursor. Press and hold the Trigger to grab the object. While holding the Trigger you can move or rotate the object free-form, as if you were holding it in your hand. Release the Trigger to place the object.
The Object Menu is positioned below objects and provides additional contextual options specific to each object type. By default, the following options are universally available for all object types: Duplicate Lock Actual Scale Delete
Selecting Duplicate creates an identical copy of the object. The duplicate appears next to the original object.
Objects can be locked or unlocked. By default objects are unlocked. When an object is locked, it cannot be moved. Locked objects have a lock symbol appear next to the Object Menu.
Selecting Actual Scale transforms the object to its true size. The object's true size is not always the same as its spawn size.
Selecting Delete permanently removes that object from the Session. Deleting an open object from the Object Menu does not remove the object from Files or from the File Manager.
Some files such as videos and PDFs have Object Controls that appear next to the Object Menu button. Object Controls are revealed when Targeting an object.
Object Controls for videos include a Play/Pause button, Mute/Unmute button, and a Progress Bar. The Progress Bar can be scrubbed to jump to a specific moment in the video.
Object Controls for PDFs include Previous and Next. The current page and total number of pages in the PDF are displayed.
The Controller has incorporated various shortcuts to optimize your productivity.
Press Bumper while Targeting an object to open the Object Menu.
Press and hold the Bumper while dragging an object to Quick Duplicate.
Double tap the Bumper while Targeting an object to Quick Delete.
Personal Menu In the Session, everyone has access to their own Personal Menu. The Personal Menu can be opened and closed by pressing the Menu button on the Controller.
Your Personal Menu provides access to the following:
Personal Menu - Active
Your Personal Menu is only visible to you when it is active. No one else is able to see or control your Personal Menu. When your Personal Menu is active, the Workshop menu, objects, and annotations are temporarily hidden from your view. Avatars and the Canvas remain visible.
The Overview consists of slides that summarize the Workshop experience. The Overview is highly recommended for first time Participants.
About contains the app version and copyright information. You can access the software license agreement, supplemental terms, and open source software notice.
Logs display technical and performance information. Logs are intended for developer use.
Quit Workshop will close the Workshop application and return you to the Magic Leap Home screen.
Session contains detailed information about your current Session.
Session Code and Time Elapsed
The Session code is displayed along with the total elapsed time of the Session. The Session Code can be given to Participants that you would like to invite to the Session.
If you are in the same location as other Session Participants, then your location status will display as Synchronized. If you are remote and not located in the same space as other Participants, then your location status will display as Solo.
A list of all Participants including the Host are displayed.
The Host has the ability to remove Participants from the Session or mute Participants. Participants cannot mute other Participants or remove other Participants from the Session.
Participants who have synchronized their locations are connected in the list with a line.
If the Host would like to synchronize their location with joining Participants, the Host can begin the process by selecting Synchronize Location. See Synchronize Location for more details.
Solo Participants who indicated they were remote during the Session entry process will be prompted to exit the Session and rejoin in order to synchronize their location.
If your headset tracking is lost and the placement of your Session has shifted, you can re-calibrate by selecting Re-calibrate Location.
If your location status is Solo, then you will be prompted to Place your Session to re-calibrate your location.
If your location status is Synchronized, then you will be prompted to Scan the Marker to re-calibrate your location.
With annotation tools, you can create annotations in the Session.
The following annotation tools are available:
- Thin Draw
- Thick Pin
- Color Palette
Selecting an Annotation Tool
Selecting an annotation tool automatically closes your Personal Menu and replaces your Ray with the Annotation Cursor.
You can select a color for your annotations using the Color Palette. The color you select is automatically applied to all of your annotation tools.
Mute and Exit
Mute or unmute your microphone by selecting Mute/Unmute in your Personal Menu.
Exit the Session by selecting Exit in your Personal Menu. Exiting a Session will return you to the Start panel.
You can use annotation tools to annotate in a Session. Annotation tools can be accessed by opening the Personal Menu and selecting Annotate.
The following annotation tools are available:
- Draw Thin
- Draw Thick
- Color Palette
Annotations can be placed in the environment, on the Blank Canvas, or on the Terrain Map.
Using Annotation Tools
When an annotation tool is active, the Ray is replaced with the Annotation Cursor. A label is mapped to the Touchpad of the Controller displaying the name of the active tool (ex: Draw, Pin, Arrow, Eraser).
You can “drop” an active tool at any time by pressing Bumper. You can also “drop” an active tool by opening the Personal Menu and selecting the tool a second time.
Swipe to Customize Cursor Position
The position of the Annotation Cursor can be adjusted. Swipe up on the Touchpad to move the cursor farther away from the Controller. Swipe down on the Touchpad to move the cursor closer to the Controller. Adjusting the position can help extend your reach.
The Bumper acts as a shortcut to access annotation tools. Press the Bumper to pick up or drop the most recently used annotation tool.
When your Ray is visible, pressing the Bumper will pick up the most recently used annotation tool. When you have an annotation tool active and see the annotation cursor, pressing the Bumper will drop the annotation tool taking you back to the Ray.
If an annotation tool has not been used yet in the Session, pressing Bumper will pick up the draw (thin) tool.
The Color Palette allows you to select a color for your annotations. The selected color is displayed at the center of the color pallet wheel and is applied to all annotation tools.
To view all the annotation color options, select the color palette. Selecting a new color applies the color selection to all annotation tools.
Drawing tools can be used to create free-form lines in space. There are two Drawing tools available: thick and thin.
When a Drawing tool is active, the Annotation Cursor appears floating in front of your Controller.
Place the Cursor where you would like to start drawing. Then press and hold the Trigger while moving the Controller to draw. Releasing the Trigger completes the drawing.
A Pin is a physical marker with a label.
When the Pin tool is active, the Annotation Cursor appears floating in front of your Controller. Place the Cursor where you would like the Pin tip to point. Then press and release the Trigger to place the pin. Hover over the Pin and select the form field to add a label.
The label is a helpful communication feature that is unique to pins.
An Arrow contains a point and a tail.
When the Arrow tool is active, the Annotation Cursor appears floating in front of your Controller. Place the Cursor where you would like the Arrow tip to point. When you press the Trigger, the Arrow appears with the point originating at the Cursor. While holding the Trigger, the Participant can move the Controller to change the Arrow’s length and direction. Releasing the Trigger places the Arrow.
The Eraser can be used to delete individual annotations.
When the Eraser tool is active, the Annotation Cursor appears floating in front of your Controller. Target individual Pins, Drawings, or Arrows by hovering over the annotation. When the annotation is targeted, the Cursor turns red. Press and release the Trigger to erase the targeted annotation.
Alternatively you can double tap the Bumper while targeting an object to erase it.
Delete All Annotations
Delete All (trash icon) removes all annotations from the Session.
Selecting the Delete All button displays a confirmation message dialogue box. Annotations will not be deleted until confirmed through the dialogue box.
Annotating on the Map
When an Annotation Tool is active, you can target the Terrain Map. The Annotation Cursor will be projected onto the surface of the Terrain Map.
Terrain Map annotations remain fixed to the geolocation where they were placed when panning and zooming the map.
Drawings and Arrows scale with the Terrain Map. Pins remain the same size regardless of the map’s zoom level.
Annotating on the Canvas
In Blank Canvas mode, Participants can annotate in space or on the blank Canvas.
When an Annotation Tool is active, the Participant can target the Canvas and the Annotation Cursor will be projected onto the surface of the Canvas.