Using the Quick Actions Drawer

In this article:

The Quick Actions drawer contains toggle settings and actions similar to those typically found in the Edit menu of an app. You can change the Object Selection Mode and toggle Snap mode, Torch AR's snap-to-surface feature. You can lock objects to prevent accidental modification by touch gestures. You can also copy, paste, duplicate and delete objects.

To open the Quick Actions drawer, tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.

Screen shot of the Torch interface with the Quick Actions drawer open at the bottom of the screen

Depending on your device and whether you are working in portrait or landscape mode, you may need to scroll horizontally to see all the buttons in the Quick Actions drawer.

The following sections describe the function of each Quick Action button, when the button is available and the scope of its effect.

Changing the Object Selection Mode

Tapping an object in your scene will always select it. Tapping in the scene away from any object will always deselect all selected objects. The Object Selection Mode determines what happens when you have an object selected and then you tap another object.

If the Object Selection Mode is Single-select, and you have one object selected, tapping a second object will deselect the first object and select the second object instead.

If the Object Selection Mode is Multi-select, and you have one (or more) objects selected, tapping an additional object will add that tapped object to the existing set of selected objects so that all of those objects are simultaneously selected.

Changing the Object Selection Mode deselects all objects. The Object Selection Mode toggle is always available from the Quick Actions drawer.

Tip: For all toggle buttons in Torch, the label on a toggle button reflects the mode that will become active if you tap the button, that is, the mode that is not currently active.

To set the Object Selection Mode to Single-select:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Note: If the Object Selection Mode toggle button displays Multi-select, this means that Single-select is already enabled.

  3. Tap Single-select. Now Single-select mode is enabled. The Object Selection Mode toggle button changes to display Multi-select.

To set the Object Selection Mode to Multi-select:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Note: If the Object Selection Mode toggle button displays Single-select, this means that Multi-select is already enabled.

  3. Tap Multi-select. Now Multi-select mode is enabled. The Object Selection Mode toggle button changes to display Single-select.
  4. Note: When you set Single-Select or Multi-Select, your object selection mode is used across all scenes of all your projects until you log out of Torch. Each time you sign in to Torch the Object Selection Mode in Torch is set to Single-Select.

As when you have a single object selected, when you have multiple objects selected you can copy, duplicate, delete, and set object properties on those objects. For any group of selected objects, you can open the Object Properties drawer to see the properties for those objects as a group. If you see Multi in a property field, it means that not all the objects have the same value for that field. You can change that: tap the field and enter a new value to set that field for all the selected objects to the new value. Remember to tap the check mark in the lower right to confirm the changes.

Using Snap Mode

Torch AR's Snap mode makes it quick and easy to set objects onto detected horizontal surfaces in your scene.

To snap an object to a detected surface using Snap mode:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Note: If the Snap toggle button displays Disable Snap, this means that Snap mode is already enabled.

  3. Tap Enable Snap. Snap mode is enabled. The Snap toggle button changes to display Disable Snap.
  4. Tap an object in your scene to select it. The object appears highlighted in blue.
  5. Use the two-finger swipe up/down gesture and begin to move the object vertically. Any nearby detected surfaces will be highlighted with a grid of colored dots. Each surface will have a different color of dots.
  6. If you don't see any dots, begin the process of resetting the World Anchor. Before you set the new anchor, move around your space scanning surfaces until you see a surface highlighted with a grid of colored dots. After you see dots, set the anchor somewhere nearby.
  7. Use single-finger swipe gestures to position the object above the detected surface.
  8. Use the two-finger swipe up/down gesture to move the object slowly towards the detected surface. As the object approaches the surface, the dots of the surface highlight and the bottom of the object snaps—spontaneously moves—directly against the surface.

Most of the time, you will likely snap the bottom of an object to the surface below it, such as when you snap the feet of a chair to the surface of the floor. You can also snap the top of an object to the underside of a surface. Snap mode also works when you have multiple objects selected: The top and bottom of each selected object will snap to each detected surface as you two-finger swipe to move the objects vertically.

The Snap mode toggle button is always available from the Quick Actions drawer.

To disable Snap mode:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Note: If the Snap toggle button displays Enable Snap, this means that Snap mode is already disabled.

  3. Tap Disable Snap. Snap mode is disabled. The Snap toggle button changes to display Enable Snap.

Tip: For all toggle buttons in Torch, the label on a toggle button reflects the mode that will become active if you tap the button, that is, the mode that is not currently active.

Note: When you Enable or Disable Snap, your Snap preference is used across all scenes of all your projects until you log out of Torch. Snap mode is Enabled for you each time you sign in to Torch.

Locking and Unlocking Objects

The Lock/Unlock toggle button is available from the Quick Actions drawer when one or more objects are selected in your scene. You can lock objects to protect the position, rotation and scale properties of those objects from accidental modification by touch gestures. All properties of locked objects can still be modified from the Object Properties drawer and by interaction responses.

Tip: For all toggle buttons in Torch, the label on the toggle button reflects the mode that will become active if you tap the button, that is, the mode that is not currently active.

To lock an object:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Tap the object that you want to lock to select it. The selected object appears highlighted in blue.
  3. Tip: If the Lock/Unlock toggle button displays Unlock, then the object is already locked.

  4. Tap Lock. The objects are now locked, so the Lock/Unlock toggle button changes to display Unlock.

To unlock an object:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Tap the object that you want to unlock to select it. The selected object appears highlighted in blue.
  3. Note: If the Lock/Unlock toggle button displays Lock, then the object is already unlocked.

  4. Tap Unlock. The object is now unlocked, so the Lock/Unlock toggle button changes to display Lock.
  5. Note: Lock is not a security feature. Any contributor that you have shared your project with can unlock and modify objects in your project.

Using Copy, Paste and Duplicate

Copy and paste work just as they do in most apps. When you copy an object, you copy its asset, its properties and its interactions to the clipboard so that you can later paste into any scene of any project.

Caution: If the Torch AR app closes, all objects copied to the clipboard are discarded; you cannot paste them after reopening Torch.

Duplicate is equivalent to copy followed immediately by paste. If you are looking for the cut command, you can get the same effect by copying an object and then then deleting that object (you will still be able to paste).

Tip: If you want to copy all the objects from one scene into a new scene, use the Copy Scene feature. Copy Scene creates a duplicate copy of the current scene, including all objects and their interactions. While objects can be copied from a scene in one project and pasted to a scene in a different project, scene copies can only be created within the same project.

You can copy an object from one scene and paste it into another scene in the same project, or a scene in a different project. If you paste an object into a different project, the asset for that object is saved to that project. This is one method for saving an asset from one project to another project. You can read more about assets in Working with Assets.

The Copy and Duplicate buttons are available from the Quick Actions drawer when one or more objects are selected in the scene. The Paste button is available from the Quick Actions drawer when one or more objects have been copied. If one or more objects are selected when you paste, those objects are deselected, then the pasted objects are created and selected.

Note: To preserve interaction relationships between two objects when copying and pasting them, you must select both objects using Multi-select and copy them together.

Tip: If you duplicate a locked object, or copy and paste it in the same scene, it may appear as though no copy was created. As when copying and pasting or duplicating unlocked objects, the new object is created at exactly the same position as the original object. When a locked object is copied and pasted or duplicated, the new object is also created as locked. To freely manipulate a copy or duplicate of a locked object, unlock the new object.

Deleting Objects

The Delete button is available from the Quick Actions drawer when one or more objects are selected in your scene.

To delete one or more objects:

  1. Tap the Quick Actions icon (three vertical dots) in the context menu on the right side of the screen. The Quick Actions drawer opens at the bottom of the screen.
  2. Tap the object that you want to delete to select it, or if you want to delete multiple objects, enable multi-select and tap the objects to select them. The selected object(s) appear highlighted in blue.
  3. Tap Delete. The object(s) are deleted. The Delete button disappears from the Quick Actions drawer.

Tip: You don’t need to open the Quick Actions drawer to delete objects. To quickly delete objects, select the objects you want to delete, then drag them towards your avatar in the upper right of the screen; a trash can will appear. Keep dragging towards the trash can; when a red circle appears, release to delete the objects. 

Still need help? Contact Us Contact Us