Let’s get to work!
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. Workshop allows participants to 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.
What’s New in Workshop 1.3
We’ve added some new features and updates to Workshop 1.3:
- Scenes - When in Blank Mode you can construct, save, and load custom scenes for ongoing collaboration, fun experiences, or anything else you can come up with.
- Magic Leap Spectator - We’ve added the option to connect to Workshop sessions with Magic Leap Spectator; Magic Leap’s new application for viewing AR content from your mobile device.
- Universal Object Manipulation - We’ve revamped our object manipulation tools to make it easier to adjust objects in your sessions.
- Web App - We’ve updated the Workshop Web App with a new layout and added new menu options.
- Workshop Personal Menu - The Personal Menu has been updated to include Scenes, as well as graphical and layout updates for ease of use.
- Pin Tool - We’ve updated how the pin tool works. You can now add and edit a pin label from the Object Menu.
- Upgrade Notification - We’ve added a notice if your Workshop version is out of date, letting you know to upgrade.
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. Your Controller will cast a Ray to show where it is pointed. Use the Ray to interact with the menu.
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 an object
- Annotate - Press the Trigger when an Annotation Tool is active
- Pick up/drop an 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
- Close/Open Personal Menu
- Reset 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.
In the session, everyone has access to their own Personal Menu. The Personal Menu is open by default. The Personal Menu can be closed and reopened by pressing the Menu Button on the Controller.
Your Personal Menu provides access to the following:
- About Workshop
- Files (Blank Mode, Inspiration Mode)
- Pin/Unpin Personal Menu
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.
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.
Permissions for the current session relating to participants, scenes, and other controls for hosts.
The Invitation Code is displayed along with the total elapsed time of the session. The Invitation Code should be given to invited participants.
A list of all participants including the Host is displayed.
The Host has the ability to remove participants from the session or mute participants. Participants cannot mute or remove other participants from the session.
Participants who are synchronized in the same location 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 recalibrate by selecting Recalibrate Location.
If your location status is Solo, then you will be prompted to Place your Session to recalibrate your location.
If your location status is Synchronized, then you will be prompted to Scan the Marker to recalibrate your location.
Log in and sync your session with a computer to manage files. See: Web App.
With Annotation Tools, you can create annotations in the Session. The following Annotation Tools are available:
- Draw, Thin
- Draw, Thick
- Color Palette
When an Annotation Tool is active, your Ray is replaced 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.
Files are accessible in Blank Mode or Inspiration Mode. Files are not accessible in Map Mode.
While each participant is able to independently navigate Files, they are communal to the session. Files uploaded by a participant will be made available to all participants in the session. Files in the Personal Menu are identical to files in the communal Workshop Menu.
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 Workshop Start Panel.
Pin/Unpin Personal Menu
Pin/Unpin Personal Menu
The Personal Menu has a Move Bar that appears directly below the Personal Menu. The Move Bar appears in a minimized state by default. The Move Bar expands when you hover over the Personal Menu or hover over the Move Bar.
The Personal Menu is body-locked and follows you by default. It can be pinned to a world-locked position by selecting the Pin Button on the right side of the Move Bar. The Personal Menu can also be pinned by grabbing the Move Bar and repositioning the Personal Menu. When the Personal Menu is pinned, it does not follow you. The Pin Button is blue when the Personal Menu is pinned.
Reset Personal Menu
The Personal Menu can be reset to its default body-locked position by pressing the Menu Button on the Controller.
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 Host.
To join a session, you must be invited by the Host. The Host will supply you with an Invitation 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 targeting the Canvas 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 Confirm (check) Button.
Hosting A Group Session
When first starting a session as the host, you will be presented with a permissions panel. These permissions cover the importing and saving of Scenes for the participants. By default all permissions are set to enabled, meaning that all members of a session can open scenes into the session for all other participants and save an active scenes to their own ML2 device.
If you do not wish for participants to be able to save active scenes then you can disable that permission. You can also disable saving scenes for yourself. You may wish to disable the ability to save opened scenes if presenting sensitive or proprietary information that you do not with to be freely available. If you do not wish for other participants to be able to open scenes during the session, you can disable that permission.
Once you set the permissions and select Okay, you can proceed to invite participants to join your session.
If you would like to invite other Magic Leap 2 participants to join you, give them the Invitation Code, which you can find in the Session panel under Invite.
You can access the Invitation 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 an Invitation Code from the Host.
Select Join from the Start Panel.
Provide Your Name
You are required to provide your name in order to join a session. Your name will be displayed to other participants in the session.
Enter the Invitation Code from the Host.
Joining Remotely, Place Session
If you are not located with other 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 Confirmation (check) Button.
Joining In a Shared Location, Synchronize Location
If you are located with the Host or with other participants, then you will need to synchronize your location.
Please refer to Synchronize Location for details.
Group Located Together
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 Confirmation (check) Button to confirm the alignment. If it is not aligned, then press the Bumper on your Controller to rescan the Marker.
Participants who are together in the same location, see their names and statuses digitally displayed above their heads.
Remote 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 and in the File Manager.
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 three experience modes: Blank, Map, and Inspiration.
Workshop begins in Blank Mode, where participants are encouraged to fill the Canvas with their own creations. Participants can explore sample files or upload their own 3D objects, 2D files, and videos.
In Map Mode, a 3D terrain Map appears over the Canvas. Participants can examine live flight data and explore a digital twin of the world.
In Inspiration Mode, participants can view examples of what you can do in Workshop such as review the design of an electric motorcycle, create a site plan, or layout an office.
The Workshop Menu is docked to the Canvas. The Workshop Menu is communal and is accessible to all participants.
The Workshop Menu allows participants to change Canvas Modes. The Menu options displayed are dependent on the Canvas Mode. In Map Mode, participants have access to Location and Layers. In Blank Mode, participants have access to Files and Magnetism. In Inspiration Mode, participants have access to inspirational example Scenes.
Participants can switch experience modes by opening the Canvas 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 from the current Canvas Mode, select Clear Canvas from the Canvas Menu.
Clearing the Canvas only impacts the Canvas Mode you are currently in.
Moving the Menu
The Workshop Menu can be repositioned. To move the Workshop Menu, target it 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 Bar and sliding it to the left or right.
Undocking the Menu
The Workshop Menu can be undocked from the Menu Rail and placed in a world-relative position.
To undock the Menu, grab and hold the Menu’s Move Bar, 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 by moving it towards the Menu Rail, where it will snap onto the Menu Rail.
Rotating the Menu
The Workshop Menu can be rotated when it is undocked. While moving the Menu, swipe left or right on the Touchpad to rotate the Menu.
In Blank Mode, participants are encouraged to fill the Canvas with their own creations. Participants can explore sample files or upload their own 3D objects, 2D files, and videos. Use Blank Mode to present your ideas in 3D, review files or co-create.
Workshop Menu in Blank Mode
Workshop Menu in Blank Mode
In Blank Mode the following options are made available in the Workshop Menu:
When working in Blank Mode, you can construct a detailed scene with the objects and files you add to the session. A scene consists of all objects and annotations either on the Canvas or free floating in space. When in Blank Mode, scenes are available from the Personal Menu. From the Personal Menu you can save an active scene, load a saved scene, and manage your saved scenes. Scenes are stored locally on your ML2 and are only accessible to you.
In the Session tab, under the Permissions section, there are options for Scenes that the session host can enable or disable to control who can open and save scenes. If you are the host these permissions must be set and accepted before you can invite other participants. By default the permissions are set to enabled. If you choose to disable these permissions then other participants will not be able to open scenes from their My Scenes list or Save any active scenes opened by you.
In the scenes menu you will see all of your saved scenes under My Scenes, organized by date saved, the More button for scene options, and an Open button. Across the bottom of the menu you will see the currently active scene with its name, the last time you saved that scene (if you have saved the scene), the More button and the save options.
Saving a New Scene
If you have a new scene that you want to save, the active scene name will be New Scene, the date saved will show the scene as Unsaved, and you can Save As to rename the scene and save it to My Scenes. Selecting Save As will bring up the Save Scene As panel where you can enter a new name for the scene with the keyboard. New Scenes require a new name in order to be saved.
The newly saved scene will appear at the top of your My Scenes list. The active scene bar will also update with the new scene name and the last saved time and date. A blue dot will also appear next to the scene in the My Scenes list to indicate which scene is currently open.
Unsaved Changes in a Scene
If you make changes to a saved scene an asterisk will appear next to the scene name in the active scene bar. You can select Save to save these changes to the same scene or Save As to save them as a new scene with a new name. If you close a scene with unsaved changes it will revert to the last saved version.
If you wish to make a copy of a scene, either one of your own scenes or of a scene that another participant loaded (if scene saving is enabled), select Save As from the active scene bar.
Overwriting a Scene
If you want to overwrite a scene with a new configuration, select Save As from the active scene bar and use the same name as a currently saved scene in your My Scenes list. You will receive a notice asking you to confirm you wish to overwrite that scene.
Invalid Name Characters
When saving a scene only certain characters can be used for the name. If an invalid character is entered in the scene name field when saving the field will highlight in red along with the invalid character.
Create a New Scene
To create a new scene select the More button from the active scene bar and then select New Scene. You will receive a Clear Scene warning alerting you that all unsaved changes in the current scene will be lost. Accept the notification and a new, blank scene will be loaded.
Opening a Scene
When you first open the Scenes panel in a session you will receive a notification that other participants will be able to view and save any scene opened (if scene saving has been enabled for the session). To open a scene select Open or More and then Open from your My Scenes list. A Clear Scene warning will notify you that the current scene must be cleared in order to open the selected scene. Any unsaved changes will be lost.
Opening a scene will clear everything on the canvas and spawn that scene for all participants in the session. The opened scene will become the active scene for the session.
When a scene is opened all the files associated with that scene will be available in the File Browser, in the root folder, for all participants.
Rename a Scene
To rename a scene from your My Scenes list, select the More button and then Rename. If you try to rename the scene to the name of another saved scene you will receive the Overwrite notification.
Delete a Scene
To delete a scene from your My Scenes list, select the More button and then Delete. You will receive a notification asking you to confirm that you want to delete the scene. If deleted the scene will be permanently removed from your ML2 and cannot be recovered. Deleting a saved scene will not clear an active scene, and the active scene bar will revert to the New Scene state.
Files displays a File Browser containing Magic Leap sample files and any custom files uploaded by participants.
Participants are able to navigate the File Browser by selecting a folder or by using the navigation drop-down.
Edit and Delete Files
Edit allows participants to select one or more file(s). 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.
Select to Open (Trigger press)
A file can be opened by selecting the file with a single Trigger press. The file will open centered above the File Browser.
Grab and Drag to Open
A file can be opened by grabbing it from the File Browser 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 above the File Browser.
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.
Workshop Web App
Workshop features expanded capabilities and tools with the companion Web Application allowing you to upload custom files or share your screen during a session. A Laptop or Desktop computer is required to use the Workshop Web App. With a laptop or desktop computer sessions can include custom uploaded files to add to scenes.
Connect to the Web App
To connect to the Web App, select Session, select the Web App tab and then select “Connect”.
Open the Workshop Web App 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
The Workshop 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 File Manager.
Drag and Drop to Upload
Drag and drop files from your computer into the Workshop File Manager to upload. Multiple files can be uploaded simultaneously. Folder upload is not supported.
Upload by Browsing Files
Select the Upload Files Button to access your computer’s file manager, then select the file(s) from your computer’s file manager to upload.
Files that are uploaded or in the process of uploading are listed in the File Manager. The file name, type, name of the 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 the File Manager. Participants are only able to delete files they have uploaded.
If an error occurs during file upload, the file status will 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.
Disconnect Web App
To unpair the Web App from your Workshop session, select the Disconnect button from the Web App menu.
After disconnecting the Web App, a confirmation message will display. You can return to the Web App landing page by selecting Connect.
Compatible File Types
- Portable Document Format (PDF)
- Images (JPG, JPEG, PNG)
- 3D Models (GLB, GLTF, FBX, 3DS, OBJ)
- Video (MP4, TS, MKV, 3GP, WEBM)
Maximum File Size
- PDFs: Up to 250MB
- Images: Up to 50MB
- 3D Models: Up to 75MB
- Video: Up to 1GB
Files loaded into a Workshop Session will be temporarily stored in RAM and loaded as active elements are needed. At the end of a Workshop Session the uploaded files will be cleared from the Magic Leap 2’s local storage.
Preparing 3D Models
3D models loaded into a Workshop Session require some preparation to ensure proper performance. Models should limit the total number of polygons that the model 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.
- 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 in Workshop. 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.
- 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
Magic Leap Spectator Compatibility
Workshop is compatible with ML Spectator, an AR streaming application available on mobile devices.
To allow ML Spectator participants to join a Workshop session, enable the ML Spectator App Permissions found in the About Workshop menu, under ML Spectator. You can also set a unique headset ID to allow ML Spectator to more easily find and connect to the session.
For multi-participant sessions or sessions with a high number of spawned objects, ML Spectator may have trouble rendering the AR content. To help facilitate a ML Spectator session in this situation, enable Dedicated Rendering. This will use the Magic Leap 2 device that turns this setting on as a dedicated AR content rendering device only for the connected ML Spectator device. While acting as a dedicated rendering device, the Magic Leap 2 will remain in the Workshop session, however it will not render any visual data from the session aside from the UI in the headset. To turn this setting off, return to the Personal Menu using the Menu Button, then open About Workshop and navigate back to the ML Spectator setting menu and turn off the Dedicated Rendering option.
Magnetism is a property of the Canvas in Blank Mode that allows objects to snap to the Canvas surface.
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.
When Magnetism is on, you can snap an object to the Canvas surface by placing the object on the Canvas. When an object snaps to the surface of the Canvas, the Canvas dots illuminate.
When Magnetism is off, objects that are being moved will not snap to the surface of the Canvas. This allows object positions to be fine tuned.
In Map Mode, participants are able to explore a digital twin of the world. This geospatial data mode allows participants to view live, global air traffic data layered on top of a high-fidelity 3D terrain map.
Workshop Menu in Map Mode
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 Map, and access the Globe.
The Location Label displays the name of the Map location.
Select Search to navigate the Map to a specific location. Selecting a location from Search will orient the Map to that location.
Saved Locations is a curated set of destinations that showcase frequent air traffic activity and a variety of different terrains. Selecting a location from Saved Locations will orient the Map to that location.
Select the Rotate Map Button to change the direction of the Map’s terrain by 90 degree increments corresponding with the cardinal directions (North, South, East, and West).
Select the Globe Button to activate a 3D Globe. The Globe allows you to travel 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 orients the Map to that location. Participants can also close the Globe to return to 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 it is released.
Current Location Pin
The Map’s current location is represented with a blue Current Location Pin.
Saved Location Pins
Saved Locations are displayed on the Globe with translucent Saved Location 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 Map will orient to that new location.
The Layers Menu allows you to control which layers are visible on the Map. Layers also allow 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 Map and the Globe.
You can turn Flight Data on or off by selecting the Flight Data Button.
When Flight Data is on, participants are able to see live flights visualized through 3D aircrafts. When Flight Data is off, all aircrafts are hidden from the Map.
Navigating the Map
You can go anywhere in the world on the Map. Using Location, you can travel to specific destinations. You can also pan and zoom the Map to explore or adjust your view.
Grab & Drag to Pan
You can pan the Map by targeting the Map’s 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 Map’s terrain with the Ray and swiping 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 Map. *Live flight data is restricted to a 200 mile radius.
Flight Data can be turned on or off through Layers.
Targeting an aircraft with your Ray reveals a Flight Summary Panel.
Selecting a Flight
Selecting an aircraft reveals the Flight Detail Panel. 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
In Inspiration Mode, participants are able to view inspirational scenes. A scene is an arrangement of content (files, objects, annotations) that are placed on the Canvas or in the environment.
NOTE: Inspiration Mode scenes are pre-built experiences used to showcase Workshop’s capabilities and foster creative application towards your own use cases. Inspiration Mode scenes cannot be saved like scenes created in Blank Mode. Scenes created in Blank Mode cannot be loaded into Inspiration Mode.
Workshop Menu in Inspiration Mode
Workshop Menu in Inspiration Mode
In Inspiration Mode, the communal Workshop Menu contains the following:
- Scene Name
- Scene List
- Reset Scene
Scenes can be selected via the Scene List. Access the Scene List by selecting the dropdown button next to the Scene Name.
- Product Design
- Site Plan
- Office Layout
Scenes can be reset back to their original state selecting the Reset Button. Modifications to scenes will not persist when navigating between scenes. Leaving a scene automatically resets any modifications that may have been made to that scene.
In Workshop the following are considered objects:
- 2D Images
- 3D Objects
Workshop has an in-depth object control and manipulation system which utilizes various object states and manipulation handles. With the object control system you can move, scale, rotate, and for some objects perform a non-uniform scale.
Objects in Workshop have several states when it comes to interacting with them. These states are: Default, Hover, Select, and Active.
When an object is in the Workshop scene, not targeted nor selected, it is in the default state.
When targeting an object it will enter the Hover State. When in the Hover State an object will display gray corner cubes showing the bounding box for the object and the Object Menu button will appear.
Selecting an object with the Trigger will cause it to enter the Select State. In the Select State you will see the manipulation handles around the object allowing you to Scale, Rotate, and (for primitives) Non-Uniform Scale. The manipulation handles only show on the side of the object you are targeting. You will also see the Object Menu button. The object will remain in the Select state until you either: Select a different object, pull the Trigger with the Ray off of the object, Pull the trigger with the Ray on the object but without selecting any of the menu or manipulator handles, or if the selection times out after 4 seconds.
Manipulating or moving an object will make it enter the Active State. When in the active state other participants cannot interact with the object. While the object is being moved or manipulated the manipulation handles will disappear except for the handle being used which will be highlighted in blue. The Active State persists until the object or handle is released, it will then return to the Select State.
To move an object, target it, press and hold the Trigger, and move the Controller. Release the Trigger to place the object.
To scale an object, target the object and select it to enter the Select State. Once in the Select State use the corner handles of the bounding box to scale the object up or down. Target the corner handles, press and hold the Trigger and move the Controller to scale the object. Release the Trigger to set the scale. Objects can also be scaled by selecting them and sliding up or down on the touchpad.
To rotate an object, select the object to enter the Select State. Once in the Select State use the vertical side handles to rotate the object. Target the handle with the Ray, press and hold the Trigger, and move the Controller to rotate the object. Release the Trigger to set the rotation. Objects can also be rotated by selecting the object and sliding left or right on the touchpad.
For primitive objects you can also perform a non-uniform scale where you can squash and stretch an object along one or more axes. To perform a non-uniform scale target and select a primitive to bring up the Select State. On the bounding box you will see a handle in the center of the bounding box. Select that handle and hold the Trigger then move the Controller to perform an non-uniform scale. Release the Trigger to set the scale.
Annotations can also be manipulated just like objects. Just like with objects, target the annotation to bring them into a Hover State to see if you can manipulate the annotation.
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.
All objects have an Object Menu. The Object Menu can be revealed by hovering over or selecting the Object. You can access the Object Menu that appears when targeting an object by selecting the Object Menu Button. The Object Menu can also be accessed by targeting the object and pressing the Bumper. The Object Menu contains the following options:
- Actual Scale
Additional options may be available for specific object types.
Selecting Duplicate creates an identical copy of the object. The duplicate object 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 instance of the object. Deleting an open object 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 the 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.
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 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 Annotation 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 Button 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 and return your 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 colors, 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. To add a label to the pin, select Edit Text from the Object Controls or from the Object Menu.
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, you can move the Controller to change the arrow’s length and direction. Releasing the Trigger places the arrow.
Annotating on the Map
When an Annotation Tool is active, you can target the Map. The Annotation Cursor will be projected onto the surface of the Map’s terrain. Projected annotations appear on the surface of the Map.
Map annotations remain fixed to the geolocation where they were placed when panning and zooming the Map.
Drawings and arrows scale with the Map. Pins remain the same size regardless of the Map’s zoom level.
Annotating on the Canvas
Annotating on the Canvas
When an Annotation Tool is active, you can target the Canvas and the Annotation Cursor will be projected onto the surface of the Canvas. Projected annotations appear on the surface of the Canvas.