Breakroom Image Viewer

Create opportunities for user interaction by branding your event with engaging signage and imagery. Read on for more information about setting up and using the Breakroom Image Viewer.

Overview

The Breakroom Image Viewer allows you to upload static images—including your company logo, informational signage, and event branding or advertising—and display them almost anywhere in your world. You can also create clickable images that will direct users to a webpage.

In your inventory, you'll see the Breakroom Image Viewer represented by this icon:

For help installing the Breakroom Image Viewer, please see our Region Editor documentation.

Tips for best performance

• The Breakroom Image Viewer will automatically adjust its dimensions to match the aspect ratio of the image displayed on it. As a result, you may find that a finished image panel cuts through the floor of your region, or is otherwise too large or small for its intended purpose. You can use the Region Editor to adjust the position, rotation, and scale of the image viewer as needed.

• To resize an image viewer while maintaining the proper aspect ratio, hold down the Shift key while dragging the scaling gizmo. This will allow you to make the image viewer larger or smaller without distorting the image.

• Images have a 5MB size limit. We recommend that image files used for signage or decorative purposes be no longer than 1024 pixels along one side.

Setting up the Breakroom Image Viewer

When a user with the right permissions clicks on a Breakroom Image Viewer, this menu appears.

The Breakroom Video Player control panel is only accessible to the object Owner and staff with the appropriate permissions. To access it, click on the Breakroom Image Viewer and then click the Open Admin button.

When end users click on a web-enabled image viewer, they will only see the Open URL button. Clicking this button will open the associated URL in an external browser tab.

Adding an image

To display an image using the Breakroom Image Viewer, follow these steps:

1. Locate the Breakroom Image Viewer object you want to edit.

2. Click on the image viewer, and then click the Open Admin button to open the control panel.

   1. To choose an image you've already uploaded to Breakroom, click the Image Library button. This will open the image picker. Click on the image you want to use.

   2. To upload a new image from your computer, or click the Upload New Image button. This will open a standard file picker on your computer. Locate the image you want to use, click on it, and then click the Open button.

3. Your selected image will display in the preview window. Make sure everything looks good, and then click the Save and Close button.

Adding a webpage URL

To link a webpage to your Breakroom Image Viewer, follow these steps:

1. Locate the Breakroom Image Viewer object you want to edit.

2. Click on the image viewer, and then click the Open Admin button to open the control panel.

3. Paste your URL into the Webpage URL field.

4. Click the Save and Close button.

Now when users click on the Breakroom Image Viewer, they will see an Open URL button. Clicking this button will open the associated URL in an external browser tab.

Image viewer options

The image display options in the Breakroom Image Viewer control panel.

The Breakroom Image Viewer control panel also allows you to customize the way images are displayed.

To edit the image display options, follow these steps:

1. Locate the Breakroom Image Viewer object you want to edit.

2. Click on the image viewer, and then click the Open Admin button to open the control panel.

3. Click the ON or OFF button located next to each image display option.

4. Click the Save and Close button.

Control panel component	Function
Post FX	If set to ON, will turn off various graphics settings within the image viewer collider zone that could distort the image or on-screen text.
Pops Out	If set to ON, video player screen will "pop out" to user screen when users enter the image viewer collider zone. The offset and scale of this pop-out screen can be customized by entering values into the associated fields.

Editing the Breakroom Image Viewer collider zone

The transparent green box indicates the size and location of the collider zone. In the Objects window, you can see that the collider zone object is nested within the Breakroom Image Viewer object.

Several image viewer options are triggered when an avatar enters the Breakroom Image Viewer collider zone. The size and position of this collider zone can be customized using the Region Editor.

The instructions provided below presume an advanced working knowledge of Breakroom. Please consult our documentation if you need help installing and positioning virtual objects, or editing the RoomFurniture component.

To edit the Breakroom Image Viewer collider zone, follow these steps:

1. Open the Region Editor by clicking the Edit Region button at the bottom of your screen.

2. Locate the Breakroom Image Viewer object you want to edit. Click on it to highlight it in the Objects window.

3. In the Objects window, click the > arrow to the left of the Breakroom Image Viewer object to expand it. Then click on the Collider component.

4. Using the Region Editor tools or the Transform component, move, rotate, and resize the collider to meet your specifications.

5. When you are satisfied, click the Save button to store your changes.