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 Annotations 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.5

We’ve added some new features and updates to Workshop 1.5:

 

New Features: 

• Localization Options: Workshop now features the ML Spaces for localizing your session with colocated participants.
• Duplication: There are three new shortcuts for duplicating multiple objects, duplicating along an axis, and deleting multiple objects. See: 
• Primitives: Primitive objects are no longer a dedicated object file type in the Files tab. Primitives have been added to the Tools menu and have expanded features.
• Session Entry Flow: The Workshop Session entry flow has been updated and reworked along with the inclusion of ML Spaces for localization.
• Planes Detection: Workshop now allows objects to interact with detected planes in your environment. 
• Expanded Object Controls: Workshops object controls have been expanded to include Snap to Surfaces, Snap to Canvas, Snap to Incremental, and a precision Transform mode option in the Object Menu.
• File Names: Workshop will now display the full file name when you hover over the file in the Files tab. 
• Muted Notification: Participants will now be alerted if they try speaking when muted. 
• Dimming Settings Menu: There is a new settings tab to control the strength of the Segmented Dimming and Global Dimming options for the lenses of your headset located within the Workshop Menu.

 

Updates:

• Communal Menu Removed: Workshop has removed the Communal Menu from the session. Functionality formerly located on the communal menu has been relocated to the Personal Menu as such: 
  • Mode Switching has moved to Session
  • Magnetism has moved to the Tools
  • Inspiration scenes have moved to Scenes (under the Inspiration Scenes tab)
  • Clear Canvas has become Clear Scene and moved to Scenes
• Tools: The Tools panel has been updated, reorganized, and expanded to feature a streamlined workflow and more ease of use along with adding in new options like primitives and the Snap To menu. 
• Screen Sharing: The Screen Share paring flow has been updated. Now when pairing the Workshop Web App is initiated from the Screen Share tab you will be returned there once pairing is completed. Initiating Web App pairing from the File browser or Session menu will return the user to the File Manager within the Web App. 
• Permissions Notification: The Permissions Notification presented when first entering a session as a host has had a graphical update to streamline it. 
• Annotation Tools: Annotations and their behavior have been updated. The Bumper shortcut has been removed, now pressing the Bumper only drops the active tool. Pins, Arrows, STicky Notes, and Text objects now spawn into the session via select or drag and drop from the Tools menu.
• Eraser Behavior: The Eraser can now remove all object types. 

 

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.

Install Workshop

 

Home Menu

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.

 

Install Workshop

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.

 

Note: On a factory reset ML2 device you may receive a notification saying "Web Browser - For your security, your device is not allowed to install unknown apps from this source." Click on Settings, and on the Unknown Apps page, toggle Allow From This Source on. You will then be prompted to install the already downloaded application.

 

 

Launch Workshop

 

Launch Workshop

Locate Workshop in the Home Menu. Select Workshop to launch the application.

Controls

 

Workshop Controls

The Magic Leap 2 Controller is used to navigate Workshop. The following actions are mapped to the Controller: 

 

Ray

• Target - Point at with Ray

 

Trigger

• Select - Press the Trigger while targeting 
• Grab Object - Press the Trigger while targeting an object
• Annotate - Press the Trigger when an Annotation is active

 

Bumper

• Drop an Annotation - Press the Bumper 
• Objects: 
  • 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

• Close/Open Personal Menu
• Reset Personal Menu

 

Home Button

• Open Magic Leap 2 Home Menu

 

Touchpad

• 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. 

 

Personal Menu

 

Personal Menu

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
• Session
• Scenes
• Files (Blank Mode, Inspiration Mode)
• Annotate
• Mute
• Exit
• 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.

About Workshop

 

Overview

The Overview consists of slides that summarize the Workshop experience. The Overview is highly recommended for first time participants. 

 

About 

About contains the app version and copyright information. You can access the software license agreement, supplemental terms, and open source software notice. 

 

Magic Leap Spectator

Options for enabling and managing Magic Leap Spectator are located here. For more information see: Magic Leap Spectator.

 

Settings

Segmented Dimming and Global Dimming settings are located here. You can enable or disable these settings and adjust the strength of the dimming effect. To enable Segmented Dimming, it must be enabled in the OS level settings. 

 

Settings also contains an option to enable the Controller Ray measurement option that will display the distance between the Controller and the targeted virtual content. 

 

Logs

Logs display technical and performance information. Logs are intended for developer use. 

 

Quit Workshop

Quit Workshop will close the Workshop application and return you to the Magic Leap Home Screen. 

Session (Menu)

 

Permissions

Permissions for the current session relating to participants, scenes, and other controls for Hosts. 

 

Experience Mode

Sets the experience mode for the Workshop Session. Choose between either the default Workshop mode to collaborate, meet, ideate, create scenes, and more, or enable Map mode to explore the world with a 3D map and Globe. This option is only available to the session Host. Available modes are Workshop (the default option) and Map mode.

 

Invite

The Invitation Code is displayed along with the total elapsed time of the session. The Invitation Code should be given to invited participants. 

 

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. 

Web App

Log in and sync your session with a computer to manage files. See: Workshop Web App.

Tools 

Tool Icons

With Tools, you can create annotations in the Session. The following Tools are available, submenu options indicated in parenthesis:

• Multi-Select
• Snap To (Surfaces/Canvas/Increments)
• Draw (Thick/Thin)
• Pin
• Arrow
• Text
• Sticky Note
• Primitives (Cube, Cylinder, Pyramid, etc)
• Color Palette (Available colors)
• Eraser

 

Annotation Cursor

When a Tool is active, your Ray is replaced with the Annotation Cursor. Pins, Arrows, Sticky Notes, and Text Objects do not use the Annotation Cursor.

 

Color Palette

You can select a color for your annotations using the Color Palette. The color you select is automatically applied to all of your annotations. 

Files

 

Files

Files are accessible in Workshop 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

Mute or unmute your microphone by selecting Mute/Unmute in your Personal Menu. 

 

Exit

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 Session

Workshop supports individual and group sessions. For group sessions participants can be local or remote. When a session includes remote participants, Workshop uses AruCo Markers or Magic Leap Spaces to synchronize and co-locate virtual content and participants. 

 

Hosting an Individual/Remote Group Session 

After launching Workshop you can select to either create a New session or to Join a session. For an Individual session select New. You will then need to enter your name into the text prompt. This name will be your display name. Next, you will be asked if anyone else will be joining your session. Select No for an individual session. You will then be prompted to Place the Workshop Canvas and then set permissions for the session before the Workshop Session loads. 

 

If you wish to change to a remote (no local participants) group session you can find the invite code in the Session menu under Invite. Send the session code to the participants and have them follow the instructions for joining a remote session. See: Joining a Remote Session. 

 

Hosting a Local/Mixed Group Session

To create a local group session with the participants physically located in the same environment, select New on the start session menu, enter your name, and then select Yes when asked if you are inviting anyone to join you. Next, you will be asked if anyone is located with you, answer Yes for a local group session (this also applies for mixed sessions with remote and local participants). You will then be prompted to print an AruCo Marker to synchronize your space with. Follow the instructions to print and scan the marker. Once finished you will then place the Canvas, set session permissions, and the session will begin. Use the invite code to have other participants join the session.

 

Hosting a Local/Mixed Group Session (Using Magic Leap Spaces)

You can also host a session without using a marker by using ML Spaces. This localization application scans your local environment to create a shareable mesh that allows for others to synchronize automatically. To start, select Yes for the options “Are you inviting anyone to join you” and “Are you located with anyone”. After that select the option to Scan your Space. Workshop and ML Spaces will then check to see if you are already localized into a recognized space. If you are then you will be prompted to share your space, after which you will place the Canvas, set the session permissions, and then the session will begin and you will be shown the invite code. 

 

If your space is not already localized you will be prompted to open ML Spaces in order to scan and localize your current environment. This requires leaving Workshop. After completing the scan, return to Workshop (See: How to localize your ML Spaces) , and you will be prompted to share your space, and continue on from there. If you are still not localized you will be prompted to use a marker to synchronize your session (See: Hosting a Local/Mixed Group Session). 

 

If your space fails to be shared, you can try again or cancel the attempt and go back to the previous step to use a marker instead. 

 

Joining a Remote Session

After launching Workshop, select Join to connect to an established session. You will then enter a display name and click Next. Enter the invitation code given to you by the session host. You will be prompted to confirm if you are located with other participants for this session. For a remote session select No. Finally you will need to place the session within your space. You will see an outline of the Workshop Canvas and the location of other participants already in the session. Place the session in a suitable location within your environment. After placing the session you’ll be admitted to the session. 

 

Joining a Local/Mixed Group Session

If you are located with either the Host or another session participant you will need to synchronize your location with the other participants. Follow the previous instructions for joining a session until you are asked if you are located with other session participants. Select Yes. You will now confirm if you are with the Host of the session or another participant. Select Yes if you are located with the Host, otherwise select No. 

 

If you are located with the host, Workshop will confirm if the Host is using an AruCo Marker or if they are using ML Spaces. If the Host is using an AruCo Marker you will be prompted to scan the AruCo Marker. Click Next, then follow the prompts in your headset to scan the marker and synchronize the space. Click Enter Session when that is completed. If ML Spaces is being used it will automatically synchronize with the Host’s space and you will receive a prompt to enter the session.

 

If you are not located with the host you will be prompted to print and place an AruCo Marker. Go to marker.workshop.magicleap.cloud and follow the instructions to print the marker. Once printed, follow the instructions on the prompt and click Next to scan the marker. If the session does not need placement, you will be prompted to enter the session. If the session needs to be placed either you or the person you are located with needs to place the session. Only one person needs to do this. Whoever is selected should click Place Session for Group, and follow the instructions. Once placed both participants will be prompted to enter the session. 

 

Troubleshooting

 

ML Spaces failed to share space

If the scanned space fails to share, you will be prompted to either try again or cancel the attempt. Try to share the space again at least once. If the space continues to fail to share, attempt to rescan the environment in ML Spaces and try hosting or joining the session again. If it continues to fail, use the AruCo Marker and contact care@magicleap.com for help. 

 

How to localize your ML Spaces

To create a new Space for localization follow these steps: 

 

Step 1: Launch the Spaces application from the Magic Leap main menu. 

 

Step 2: Select New Local Space. Spaces will provide you instructions on how best to map your environment. Keep in mind that some surfaces and materials may make scanning difficult, dark or glossy surfaces and clutter should be avoided. 

 

Step 3: Once scanning is complete, select Finish Scanning and then Yes, Save. You need a saved, local Space for Workshop to access. 

 

To check that everything has been saved and completed successfully, you can check the Local Spaces tab to see if your scan is present. This is also where you can delete your saved Spaces. 

 

If you launched ML Spaces from the Workshop session entry flow, you may now close the Spaces app by clicking the close button on the upper right corner of the menu, or via the notification that pops up after completing the scan. 

 

For more information about ML Spaces see: Magic Leap Spaces Developer Documentation.

 

Do I need to keep the AruCo Marker visible during the whole session?

You only need the marker visible for the initial session synchronization. Once that is finished for all participants you can move it out of the way. However if another local participant wishes to join you will need to place the marker back in the exact same location, facing the same direction to ensure that synchronization is completed correctly. 

 

I don’t have a printer for the AruCo Marker

If you don’t have a printer you can use a tablet or laptop screen instead. Place the screen flat against on the ground or a table (wherever the session will be centered around) and make sure the screen is at full brightness and showing the marker at 100% scale and that the full marker is fully visible. After scanning the marker can be moved out of the way. 

 

Session Avatar

 

Located Together

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.

 

Color

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

 

The Canvas

The Canvas is the focal point of the session. In a Workshop session, all participants are invited to gather around the Canvas to collaborate. 

 

Experience Modes

Workshop has two experience modes: Workshop and Map. 

 

Workshop begins in Workshop 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. 

Scenes

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. 

 

Scene Permissions

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. 

 

Scenes Menu

 

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. 

 

Save As

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. 

 

Scene Files

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.  

 

Inspiration Scenes

Workshop comes with example scenes showing the kind of experiences that can be created using the Scene functionality. At the top of the Scenes menu, next to the My Scenes tab is Inspirational Scenes where you can find 3 examples: Product design, Office Layout, and Site Plan. These scenes function the same as other scenes allowing you to make a copy, rename, etc the default Inspiration Scenes. Copies of Inspiration Scenes can have edits saved to them. Default Inspiration Scenes cannot be altered. 

 

 

Files

 

Files

Files displays a File Browser containing Magic Leap sample files and any custom files uploaded by participants. 

 

Files Navigation

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. 

 

More (...)

Hovering over a file exposes the file’s More (...) Button. Selecting More reveals file options such as delete or open. 

Opening Files

 

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.

 

Loading

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. 

 

Authenticate

On your Magic Leap 2, from within Workshop, Select the Session Tab from the personal menu and navigate to the Web App section, then select Connect.  Once the QR code scanner loads, 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. 

Uploaded Files

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.

 

Cancel Upload

You can cancel the upload of a file by hovering over the upload status and then selecting Cancel. 

 

Delete Files

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. 

 

Upload Errors

If an error occurs during file upload, the file status will display an exclamation icon and an error message.

 

Unsupported Files

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.

File Specifications

 

Compatible File Types

• Portable Document Format (PDF)
• Images (JPG, JPEG, PNG)
• 3D Models (GLB, GLTF, FBX, 3DS, OBJ)
• Video (MP4, 3GP, WEBM)

 

Maximum File Size

• PDFs: Up to 250MB
• Images: Up to 50MB
• 3D Models: Up to 75MB
• Video: Up to 1GB

 

File Storage

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. 

 

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

 

Preparing Images

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. 

 

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

 

Screen Share

Screen Share allows you to share desktop and web based content within the Workshop session as a dedicated screen object. 

 

 

Screen Share

To begin sharing your screen in a Workshop session, select the Screen Share button in the Web App. 

 

If the Web App is not already connected you will be prompted to connect with the Workshop session. Select Screen Share in Workshop to bring up the authentication screen, and scan the QR code that appears to connect. Once connected you will be brought back to the Screen Share tab. 

 

 

Sharing Options Window

After selecting Screen Share, a window will appear presenting the available options to share from. The options for sharing content are: 

 

• Chrome Tab
• Window
• Entire Screen

 

After choosing one of these options, the available sources for that type will be displayed. If you do not see a particular source, try a different sharing option. After selecting the source to share, click “Share” at the bottom of the screen to begin sharing with the Workshop Session. 

 

Sharing a Chrome Tab

Selecting “Chrome Tab” will present the currently open and available tabs. If no Chrome window is open or otherwise available this tab will be empty. Selecting a tab to share will display the content as it appears on your screen, including where the mouse pointer is located. The selected tab will continue to be displayed even if focus in the browser is shifted to another tab. If playing a video with audio or an audio file then you must use the Chrome Tab option as audio will not play in other sharing modes. 

 

Sharing a Window

Selecting “Window” will show all available windows open on the desktop. Sharing a window will show all contents of that window as they are displayed on the desktop when in focus. If focus is shifted to a different window, the shared window will still be displayed in the Workshop Session. This is a good option if you need to shift between multiple tabs in a Chrome browser, and do not want to redo the Screen Share selection process multiple times. 

 

Sharing an Entire Screen

If you need to shift between multiple windows and tabs, select Entire Screen from the Source Selection Window. Selecting Entire Screen will display everything that is open and in focus as it appears on your laptop or desktop screen. 

 

While Sharing Your Screen

While Screen Share is active, the Web App will display the shared content at 70% opacity along with the Screen Share Control Bar. 

 

Screen Share Control Bar

While sharing your screen the Web App will display the Screen Share Control Bar along the bottom edge of the shared content window. Here you can control the audio of the shared content and stop sharing the selected content. 

 

Stop Screen Share

When you are finished sharing your screen. Click on the Stop Sharing button in the Screen Share Control Bar. After ending the screen share you will be returned to the Screen Share landing page. 

 

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. 

 

Dedicated Rendering

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.  

 

Map Mode

 

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
• Layers 

Location

 

Location

Location allows you to quickly navigate to a specific location, rotate the direction of the Map, and access the Globe. 

 

Location Label

The Location Label displays the name of the Map location.

 

Search

Select Search to navigate the Map to a specific location. Selecting a location from Search will orient the Map to that location. 

 

Saved Locations

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. 

 

Rotate Map

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).

 

Globe

Select the Globe Button to activate a 3D Globe. The Globe allows you to travel to new locations. See Globe for details.

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. 

 

Menu Rails

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. 

 

Globe

 

The Globe

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. 

 

Travel Pin

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. 

 

Layers

 

Layers 

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. 

 

Map Styles 

You can set the visual style of the Map to Satellite or Dark. The visual style impacts the Map and the Globe. 

 

Flight Data

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. 

 

Map Navigation

 

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. 

Flight Data

 

Flight Data

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. 

 

Flight Summary

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. 

 

Flight Details

The Flight Detail Panel displays the following data: 

• Departure and Destination (if available)
• Flight Number or Call Number
• Speed
• Altitude
• Aircraft type

Aircrafts

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 
• Helicopter
• Military Transport
• Military Jet  

Objects

 

Objects

In Workshop the following are considered objects: 

• 2D Images
• 3D Objects 
• Videos
• PDFs
• Screen Shares

 Transforming Objects

Workshop has an in-depth object control and transform system which utilizes various object states and control handles. With the object control system you can move, scale, rotate, and for some objects perform a non-uniform scale. 

 

Select States

Objects in Workshop have several states when it comes to interacting with them. These states are: Default, Hover, Select, and Active. 

 

Multi-Select Objects

Workshop allows for users to select multiple objects at once. To use Multi-Select, find the Multi-Select button on your Personal Menu and select it to toggle Multi-Select on or off. When Multi-Select is active your Ray will also change to a dotted line instead of a solid one. 

 

When Multi-Select is active certain controller behaviors are changed. When hovering over objects with the Multi-Select Ray the Object Menu is suppressed. When selecting an object the Object Menu and Control Handles do not appear. When Multi-Select is active, Target and Select objects as usual, but unlike in the default behavior each new object selected will be added to the current selection group. Target and Select an already selected object to deselect it. 

 

Hold the trigger down when Targeting a member of the current selection group to bring all members of the group into the Active state. While holding the Trigger down you can move the Objects as a group by moving your controller around, scale them up or down by pressing on the left or right side of the Touchpad, or rotate them by swiping left or right on the Touchpad. 

 

Objects selected with Multi-Select are networked together and cannot be selected by other participants in the Workshop session until they are released by the current object holder. 

 

Transform Mode

When interacting with large scale objects or objects requiring precise placement, there is a dedicated menu under the Object Menu labeled Transform… . When selecting this option the personal menu and all sub menus are hidden and a transform toolbar is shown instead. In Transform mode you can access controls for the selected object including: 

 

• Selecting the modification type (Position, Scale, Rotation)
• Adjusting the increment amount
• A distance readout showing how far/how much a transform has moved
• Adjustment buttons to incrementally nudge the object along the selected axis

 

The Transform mode applies to translation, rotation, and uniform scaling of an object. The transform toolbar adjusts for each application (Showing centimeters when translating, degrees when rotating, and scale percentage when scaling). Object transform UI will only display control handles related to the selected modification type (Horizontal/Depth/Vertical handles for X/Y/Z axis movement and rotation, and the bounding box handles for scaling), allowing you to adjust each aspect of an object one at a time. When placement is complete, click Done on the toolbar to return to normal Workshop operation. 

 

Transform and Multi-Select Shortcuts

To quickly select multiple objects, point the Ray at empty space and hold the Trigger down. You will feel a short, haptic jolt from the controller and the Ray will turn into a dotted line which is animated with the dots moving towards the Controller. Quick Select is now active. While holding the Trigger, point the Ray at objects to add them to the current selection group. Releasing the trigger returns the Controller to the previous selection behavior (Multi-Select or Default). Selected objects are maintained and can be interacted with as previously described. 

 

With multiple objects selected you can either duplicate them by holding the Bumper, then release the bumper to place them, or delete them by doing a double press on the Bumper. 

 

To quickly exit Multi-Select press the Bumper to drop the Multi-select state.

 

To quickly duplicate a single object along an axis, target the object to bring up the transformation handles, then target the Move/Translation arrow and hold the Bumper and drag. This will create a duplicate object along the selected move axis. Release the Bumper to place the object.

 

Default State

When an object is in the Workshop scene, not targeted nor selected, it is in the default state. 

 

Hover 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. 

 

Select State

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. 

 

Active State

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. 

 

Move Objects

To move an object, target it, press and hold the Trigger, and move the Controller. Release the Trigger to place the object. 

 

Scale Objects

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. 

 

Rotate Objects

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. 

 

Non-Uniform Scale

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

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. 

 

Object Cursor

 

Direct Transform

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 transformed 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.

 

Controller Behavior with Large Objects

For objects designed to be true to size for large objects (Buildings, Sculptures, etc) or over sized and scaled objects the Controller behavior will automatically adjust if the Headset and Controller are within a large object: 

 

• Object Boundaries: If the Headset and Controller are inside of an object’s boundaries then the Direct Object Manipulator cursor will not display. Instead the Controller Ray will be displayed. 
• Object Transform Handles: The object transform handles will not display or be interactive while within the bounds of an object. The object cage will remain visible.
• Nested Objects: If another object is within the bounds of a large object you will be able to target it and interact with the object transform handles, as well as use the direct object manipulator cursor. This is only true as long as the object is visible from within the large object. 
• Out of Bounds Targeting: Targeting objects that are outside of a large object is disabled as long as you are still inside of a large object. 
• Mesh Targeting and Transforming: While inside of a large object you should be able to target and select the object’s mesh. While targeting and selecting the mesh you can use the Controller to move the object and use the Trackpad to scale and rotate the object. 

  

 

Object Menu

 

Object Menu

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: 

• Duplicate
• Lock
• Actual Scale
• Delete

Additional options may be available for specific object types. 

Duplicate

Selecting Duplicate creates an identical copy of the object. The duplicate object appears next to the original object. 

 

Lock

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.

 

Actual Scale

Selecting Actual Scale transforms the object to its true size. The object’s true size is not always the same as its spawn size.

 

Delete

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.

Object Controls

 

Object Controls

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.

 

Video

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.

 

 

PDF

Object Controls for PDFs include Previous and Next. The current page and total number of pages in the PDF are displayed.

 

Animation Controls

3D objects which have baked in animations can be played similarly to a video object. Animation controls allow you to play and pause animations, loop the animation, select the next animation, and select a previous animation. Changing between animations is done by pressing Next or Previous.

 

 

Screen Share Object

When a participant is sharing their screen the broadcast will spawn as its own object in the session. Screen Share objects can be interacted with as an object by moving, scaling, and rotating, as well as duplicated and deleted. Screen Share objects can also be muted. When ending a broadcast it will end for all Screen Share objects and they will be deleted. 

 

Object Shortcuts

 

Shortcuts

The Controller has incorporated various shortcuts to optimize your productivity.

 

Object Menu

Press the Bumper while targeting an object to open the Object Menu.

 

Quick Duplicate

Press and hold the Bumper while dragging an object to Quick Duplicate.

 

Quick Delete

Double tap the Bumper while targeting an object to Quick Delete.

 

Tools

 

Annotate

You can use Annotations to add details and notes in a session. Annotations can be accessed by opening the Personal Menu and selecting Tools.

 

The following Annotations are available: 

• Multi-Select
• Snap To (Surfaces/Canvas/Increments)
• Draw (Thick/Thin)
• Pin
• Arrow
• Text
• Sticky Note
• Primitives (Cube, Cylinder, Pyramid, etc)
• Color Palette (Available colors)
• Eraser

 

Annotations can be placed in the environment, on the Blank Canvas, or on the Map. 

Using Annotations

When an Annotation 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, Eraser).

 

You can drop an active Annotation at any time by pressing Bumper. You can also drop an active Annotation 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.

Annotation Color

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 Annotations. 

 

To view colors, select the Color Palette. Selecting a new color applies the color selection to all Annotations. 

 

Annotation color can be edited via the Object Menu, the Color Pallette, or the Object Controls. 

 

Adjusting the Color of Primitives

Primitive objects can also have their color edited. Target or select the primitive to bring up the Object Menu or Controls and select the desired Color from the Color Palette. Only primitive objects can be colored in this way. Custom objects and 3D models spawned into the session will be colored based on their model data which cannot be edited in session. 

 

Multi-Select

This is the menu location for the Multi-Select tool. See: Multi-Select Objects for more details.

 

Snap To

The Snap To menu contains the various interaction modes for Workshop. The available interaction modes are: Snap To Canvas (Default), Snap To Surface (Default), and Snap to Incremental. 

 

Snap To Canvas allows objects to snap to the Workshop Canvas. Objects brought close to the canvas will show the canvas display a highlighted dot pattern showing that the object, when released, will attach itself to the surface of the canvas. Objects snapped to the canvas can be moved along the surface of the canvas, rotated, and scaled. Objects can be taken off the canvas after snapping to it and left to hover in space as well. 

 

Snap To Surface is the default snapping behavior when launching Workshop. You can toggle Snap to Surfaces from the Snap To menu under the Tools menu. When enabled, objects will snap to planes detected in your environment. Planes are surfaces like the Floor, walls, or other large vertical and horizontal surfaces free from clutter that have been detected by the headset. When bringing an object close to a surface a dot pattern will help visualize if the object will snap to that surface. Detected surfaces are not networked across the Workshop session. 

 

When snapping an object to a surface, the object will rotate back to the default vertical position if its rotation is 45 degrees or less. If the object is snapped to a surface, it can then be rotated via the rotation handles and will retain the rotation. Surfaces are permeable and not hard barriers. Objects can be pushed through a surface.

 

Snap To Incremental is a secondary option that can be toggled on and off along with either of the other two Snap To modes. Incremental Snapping allows transformations to be adjusted by increments. Snap to Increments will adjust transforms done via the object Handles or touchpad to increment +/- a set amount. When transforming an object a readout of the transformation amount will display over the object (except for non-uniform scaling). The snap amount cannot be adjusted and applies only to translation, rotation, and scale transformations.

 

Draw

Drawing Annotations can be used to create free-form lines in space. There are two Drawing Annotations available: Thick and Thin. When you hover over the Draw icon a submenu will appear showing the two options, Target the one you want and select it by pulling the Trigger.

 

When the Drawing Annotation 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.

Pin 

A pin is a physical marker with a label.

 

To place a Pin, with the Tools menu open, hover over the Pin icon and press the Trigger. This will summon a Pin object above the menu. Then Target the Pin, press and drag the Pin to the desired location 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. 

Arrow 

An arrow contains a point and a tail. 

 

To place an Arrow, Target the Arrow icon in the Tools menu. Press and release the Trigger to summon an Arrow, then target the Arrow, press and hold the Trigger, and drag the Arrow to the desired location. Release the Trigger to place the Arrow. Then use the transform handles to adjust its position and the length of the arrow. 

 

Text 

The Text Annotation can be used to create text annotations where you can leave detailed notes and instructions. 

 

To create a Text object Target the Text icon in the Tools menu to summon a Text object. Then drag and drop the Text object into the scene. After spawning the Text object will be in edit mode and you can enter text with the keyboard. 

 

 

After entering text, click Done to finish spawning your text object.  

 

Once the text is set, you can scale the text object up and down as needed using the white object scaling and rotation handles. Text size and wrapping will automatically update depending on the size of the bounding box. 

 

Text objects are double sided, flipping the text to be readable on either side, and can Billboard. You can turn on Billboarding from the Object Menu. 

 

Sticky Note

The Sticky Note Annotation can be used to leave short notes in the Workshop session. 

 

To summon a Sticky Note, Target the Sticky Note icon in the Tools menu and press the Trigger. Then drag and drop the summoned Sticky Note into the scene to place it. Sticky Notes will be in the edit state when they are spawned. 

 

In edit mode the Sticky Note will show the bounding box of the note along with the keyboard. Sticky Note text is always black, 40pt font size, and aligned to the top left of the note. When you are finished adding your text, select Done to finish spawning your Sticky Note. Sticky Notes can exist without text, if you wish to have a blank Sticky Note. To change the size of the Sticky Note, use the scaling and rotation handles like any other object. 

 

Sticky Notes by default are two-sided, with the text flipped on the opposite side to be readable, with their initial orientation facing the participant who created it. You can also turn on Billboarding, just like with text objects. 

 

Billboarding

Both Text and Sticky Note objects can Billboard. When Billboarding the object will rotate to face towards the participants. Each participant in a multi-participant session will see the Billboarding object facing towards them independently.

 

When the Billboarding object is selected it will suspend the behavior and face towards the participant who targeted it. Once released it will resume Billboarding. If the object is rotated, Billboarding will be turned off.  

 

Primitives

Primitives are simple objects representing platonic shapes like Spheres, Cones, Cubes, and others. These can be summoned by hovering over the Primitives icon in the Tools menu, then Targeting the desired object from the submenu and pressing the Trigger. After summoning the primitive, drag and drop it into the scene to spawn it. Primitives can be colored using the object menu and color palette. The spawned color for primitives is based on the current active color.

 

Eraser

The eraser is used to remove object types (Annotations, Primitives, and 3D and 2D files) quickly and repeatedly without using the object menu. Select the eraser from the Annotations Menu, then hover over the target object then pull the Trigger on the Controller. 

Map Annotations

 

Annotating on the Map

When an Annotation 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 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.