LogoLogo
Tutorial VideosScripting DocumentationLegalHome
Breakroom
Breakroom
  • Welcome to Breakroom
  • GETTING STARTED
    • Helpful terms
    • UI tour
    • Keyboard shortcuts
    • Customizing your avatar
      • Choosing a starter avatar
      • Editing avatars in the Outfit window
      • Using the Sine Wave Shop
    • Controlling your avatar
    • Controlling your camera
    • Communicating with other users
    • Using the conference system
      • Troubleshooting audio and video issues
    • Using Breakroom for Training
    • Settings
    • Language and accessibility
    • Reporting issues
  • EXPLORING BREAKROOM
    • Region navigation tools
    • Bookmarks and teleport invites
    • Using the Explore window
    • Using the Meetings window
    • Networking with other users
      • People
      • Groups
    • Snapshots
  • BUILDING NEW WORLDS
    • Breakroom Dashboard tour
    • Creating and managing Regions
    • Default Landing and Orientation Regions
    • Region settings
    • Region template descriptions
  • CREATING CUSTOM EXPERIENCES
    • Branding tools
    • UI customization options
    • Filtering the Sine Wave Shop
    • Selecting default avatars
      • Default avatar collections
    • Using the Region Editor
      • Editing and moving objects
      • Editing terrain and sky
      • The Region Editor ADVANCED window
    • Exploring the Breakroom Toolkit
      • Breakroom Video Player
      • Breakroom Web Browser
      • Breakroom Image Viewer
      • Breakroom Info Kiosk
      • Breakroom Teleport Portal
      • Breakroom Web Collab
      • Breakroom Note Board
      • Breakroom Games
      • Breakroom Reactives
      • Breakroom Orientation Quest
      • Breakroom Tour Cameras
      • Conference rooms and booths
      • Add-on seats
      • Breakroom Start Here UI
      • Breakroom Basic Emojis
      • Breakroom 360° Video Player
    • Managing your Media Library
  • OPENING THE DOORS
    • Seats and concurrency
    • Creating and managing user accounts
      • World-level user permissions
      • Region-level user permissions
      • Single sign-on
      • Eventbrite integration
    • World Stream
      • Purchasing and managing World Credits
      • Pre-allocation campaigns
      • World Stream viewer toolbars
      • World Stream keyboard shortcuts
      • Troubleshooting World Stream issues on Chrome
      • Troubleshooting World Stream issues on macOS
    • Desktop viewers
    • Privacy Policies, EULAs, and data collection
    • Analytics
    • Toggling World availability
  • RUNNING YOUR EVENT
    • Understanding the conference system
      • Voice zones, zone types, and conference permissions
      • Voice chat and spatial audio
    • Customizing the conference system components
      • Adding breakout areas
      • Creating custom voice zones
      • Setting up Presenter and Audience zones
      • Designating triage zones
      • Troubleshooting duplicate zone errors
      • The RoomFurniture component
    • Setting up Breakroom for Training courses
    • Moderator tools
      • Broadcast messages
      • Crowd management
      • Audience questions
      • Raised hands
      • Presentation controls
      • Hidden UI toggle
      • Participation
      • Audio streams
  • TIPS FOR SUCCESS
    • Region Editor best practices
    • Onboarding new users
  • ADVANCED TUTORIALS
    • Uploading your own Region
      • Installing Unity and the Breakroom SDK
      • Reducing poly counts on CAD files
      • Uploading a Region from Unity to Breakroom
      • Creating and uploading custom chairs
      • Testing items on the preview server
      • Pushing items to the live server
      • Installing the conference system components
    • Uploading your own virtual objects
    • Uploading your own virtual clothing
    • Creating and copying avatar shapes
    • Installing the Quest System
    • Registration and grid APIs
    • Video streaming
    • Sinespace scripting documentation
  • HELP
    • Where to find support
    • Tutorial video playlists
      • Platform basics
      • Dashboard
      • Moderator tools
      • Breakroom Games
      • Creator Core
      • Breakroom for Training - Students
      • Breakroom for Training - Instructors
      • Breakroom for Training - Dashboard and Backend
    • Account management
    • System requirements
    • Troubleshooting network ports and firewalls
  • RELEASE NOTES
    • Breakroom SDK
    • Breakroom Viewer
    • Breakroom Dashboard
Powered by GitBook

©2008-2024 Sine Wave Entertainment Ltd. All Rights Reserved.

On this page
  • Overview
  • Getting started
  • Moving objects using the Region Editor
  • Movement
  • Rotation
  • Scaling
  • Editing the Transform component
  • Changing an object's position
  • Changing an object's rotation
  • Changing an object's scale
  • Using node mode
  • Using grid mode
  • Local mode vs. global mode
  • Center mode vs. mesh pivot mode
Export as PDF
  1. CREATING CUSTOM EXPERIENCES
  2. Using the Region Editor

Editing and moving objects

Whether you enter precise location data or freestyle it—Breakroom helps you put everything into its proper place. Learn how to manipulate and position virtual objects using the Region Editor.

PreviousUsing the Region EditorNextEditing terrain and sky

Last updated 10 months ago

Overview

Breakroom's is a powerful tool that helps you bring your Metaverse visions alive. On this page, you'll learn how to move, rotate, resize, and position virtual objects in order to customize your Breakroom World.

Getting started

In order to make changes to a virtual object in Breakroom, you'll first need to open the Region Editor and select that object. To do so, follow these steps.

  1. Navigate to the Region that contains the object you want to edit.

Moving objects using the Region Editor

Movement

The movement gizmo is a tool that allows you to manually reposition items in your Region. In the image above, you can see the movement gizmo represented by a set of colorful arrows attached to the picnic table object.

Once the movement gizmo is activated, you can move your chosen object using the steps below.

  1. To move the object along the X, Y, or Z axis, hover your cursor over the appropriate arrow. That arrow will turn yellow.

  2. Click on the arrow and hold down the left mouse button.

  3. With the arrow selected and the left mouse button held down, move your cursor to slide the object back and forth along your chosen axis.

  4. To set the object in place, release the left mouse button.

  5. To move the object along multiple axes simultaneously, click and hold on one of the squares located at the gizmo's root. You can then drag the object to your desired location.

You can also "free move" an object along a plane set at 90° to the current camera angle (as if you were "washing" the camera lens in front of you).

  1. Hold down the Shift key on your keyboard. A single highlighted box will appear at the root of the movement gizmo.

  2. Click on the box and hold down the left mouse button. Continue to hold down the Shift key.

  3. Use your cursor to freely position the object.

  4. To set the object in place, release both the left mouse button and the Shift key.

Rotation

The rotation gizmo allows you to rotate an object around one or more axes. In the image above, you can see the rotation gizmo represented by a set of colorful rails attached to the picnic table object.

Once the rotation gizmo is activated, you can rotate your chosen object using the steps below.

  1. To rotate the object along the X, Y, or Z axis, hover your cursor over the appropriate colored rail. That rail will turn yellow.

  2. Click on the rail and hold down the left mouse button.

  3. With the rail selected and the left mouse button held down, move your cursor to rotate the object.

  4. To freeze the object in your desired position, release the left mouse button.

You can rotate the object on a plane facing your camera by manipulating the outer white rail instead of the colored rails, following the directions above.

Finally, you can "free rotate" an object along all three axes at once by clicking and holding on any part of the object itself, instead of the rails.

Scaling

The scaling gizmo allows you to resize an object along one or more axes. In the image above, you can see the scaling gizmo represented by a set of colorful markers attached to the picnic table object.

Once the scaling gizmo is activated, you can resize your chosen object using the steps below.

  1. To scale the object along the X, Y, or Z axis, hover your cursor over the appropriate axis marker. That marker will turn yellow.

  2. Click on the marker and hold down the left mouse button.

  3. With the marker selected and the left mouse button held down, move your cursor to scale the object.

  4. To finish scaling the object, release the left mouse button.

  5. To scale the object along multiple axes simultaneously, click and hold on one of the triangles located at the gizmo's root. You can then drag the object to your desired proportions.

You can also scale an object along all three axes at once. This will preserve the object's original aspect ratio/proportions, essentially allowing you to "embiggen" or "shrink" the object.

  1. Hold down the Shift key on your keyboard. A single highlighted box will appear at the root of the scaling gizmo.

  2. Click on the box and hold down the left mouse button. Continue to hold down the Shift key.

  3. Use your cursor to freely resize the object.

  4. To finish scaling the object, release both the left mouse button and the Shift key.

Editing the Transform component

In some situations, it may be more efficient to move, rotate, or scale an object by editing its Transform component. By manually editing the values stored in an object's Transform component, you can move an object five meters along the X axis and rotate the same object by a precise number of degrees, all with just a few clicks.

To identify the values stored in an object's Transform component, follow these steps.

  1. Locate the object you want to edit in the Objects window, and click on it. This will open the Inspector window for that object.

  2. You will see three properties (Local Position, Local Euler Angle, and Local Scale). Each property contains three fields corresponding to the object's X, Y, and Z axes.

Changing an object's position

To change the position of an object, enter the updated location values (along the X, Y, or Z axis, or any combination of these). Then click the Save button located in the bottom right corner of the Region Editor.

Changing an object's rotation

To change the rotation of an object, enter the updated rotation values (along the X, Y, or Z axis, or any combination of these). Then click the Save button located in the bottom right corner of the Region Editor.

Changing an object's scale

To change the scale of an object, enter the updated scale values (along the X, Y, or Z axis, or any combination of these). Then click the Save button located in the bottom right corner of the Region Editor.

Using node mode

Using grid mode

In grid mode, movement "snap points" are set one meter apart from each other. Rotation "snap points" are set at 15° intervals.

Local mode vs. global mode

In global mode, object manipulation is accomplished relative to the layout of the Region.

Both local and global mode have their uses. Combine global mode with grid mode to lay out a precise flower garden, or use local mode to randomly sprinkle rose petals along a pathway.

Center mode vs. mesh pivot mode

The difference between these two points can sometimes be subtle, but it's still a useful distinction to keep in mind. The pivot point is where your movement, rotation, and scaling gizmos will appear in the Region Editor, and rotating an object from its center pivot point may lead to different results than rotating that same object from its mesh pivot point.

Open the Region Editor by clicking the Edit Region button in the .

Click on the object you want to edit, or click on that item's name in the .

This will highlight the object on your screen. You can switch your selected object within the Region Editor at any time. For additional information, please review our and our .

To activate the movement gizmo while in the Region Editor, click the Move button located in the , or press the W key on your keyboard.

You can move objects quickly and easily using the . This button will move any currently selected object to your camera's location. It's especially useful for .

To activate the rotation gizmo while in the Region Editor, click the Rotate button located in the , or press the E key on your keyboard.

To activate the scaling gizmo while in the Region Editor, click the Scale button located in the , or press the R key on your keyboard.

Open the Region Editor by clicking the Edit Region button in the .

Make sure the is open by clicking the Objects button located on the bottom right.

Expand the Transform component in the by clicking the > arrow located to the left.

This section is currently under construction. If you have any questions that aren't answered here, please contact our .

You can activate grid mode for every object in your Region by clicking the Grid Mode button in the , or by holding down the Ctrl key while actively manipulating an object. When you're in grid mode, you'll notice that object movement, rotation, and scaling will "snap" along an invisible grid instead of flowing smoothly. This is especially useful when moving items around a scene, allowing you to perform tasks like lining up chairs in neat rows with a minimum of effort.

In the , you can choose to orient your objects using either local mode or global mode. In local mode, objects will be moved, rotated, and scaled relative to their own axes.

In the , you can also toggle between two pivot points for your objects—center pivot and mesh pivot. All objects have a mesh pivot point, which is usually located at the object base (where an object might rest on the floor or on a table) or at a natural pivot point, such as the hinges of a door. Alternatively, an object's center point is normally located close to its center of mass, or the center of the bounding box that surrounds it.

introduction to using the Region Editor
Region Editor best practices
Customer Success Team
Region Editor
changing camera angles in voice zones
Objects window
object editing tray
"Move Object to Camera" button
object editing tray
object editing tray
Objects window
Inspector window
object editing tray
object editing tray
object editing tray
bottom toolbar
bottom toolbar
Pictured: The Region Editor window, with a Breakroom Web Browser object selected. Its Inspector window is shown on the left.
Pictured: An example Inspector window.
Pictured: In local mode, the movement gizmo aligns with the width, length, and height of the object.
Pictured: In global mode, the movement gizmo aligns with the cardinal directions of the region itself.