Working with 2D Elements

Adding media elements such as images, videos, audio, and PDFs enhances the visual appeal and interactivity of your Verses. These elements serve as decorative assets, informational displays, or interactive portals, contributing to a more immersive experience for users in the Metaverse.

Adding Images to Your Scene

You can integrate images into your scene using two primary projection methods:

• 2D Projection: Displays images as flat elements within the scene.

• 360-Degree Equirectangular Projection: Wraps the image spherically, ideal for skyboxes or immersive backgrounds.

How to Upload Images

1. Open the "Assets" tab in XR Creator Studio.
2. Click "Add" and upload an image or GIF file from your computer.
3. Drag & drop the image into the viewport.
4. Configure the projection type in the Properties Panel.

Image Properties

Property	Description
Image URL	Defines the source URL of the image. You can use it to upload/change an image or provide an external link.
Controls	Toggles interaction controls for the image, such as zoom or other display options.
Billboard	Forces the image to always face the user, making it useful for UI elements or signs.
Link Href	Allows the image to act as a hyperlink, directing users to external URLs, Metaverse rooms, or other Verses.
Open as Iframe	Enables the image to open as an iframe instead of redirecting users to another page.
Use 2D View	Displays the image in a 2D viewing interface, allowing zoom and pan functionalities.
Hide Link Href Button	Removes the interactive "Jump" button for linked images, making transitions seamless.
Is 360 Portal	Converts the image into a 360-degree immersive portal when enabled.
Transparency Mode	Adjusts the transparency settings (e.g., opaque, transparent).
Projection	Controls how the image is projected: flat (standard 2D) or equirectangular (360-degree wraparound).

Attribution Properties

If the image is an artwork or licensed content, you can provide attribution details.

Property	Description
Title	Sets the name of the image or artwork.
Author	Displays the creator's name for proper attribution.
URL	Provides a link to the original source or additional details.

Using an Image as a Portal

You can use images or videos as portals to link to external rooms, scenes, or websites. This feature is perfect for creating transitions between Verses or providing direct access to web-based content.

to Set Up a Media Portal

1. Upload an image or video to your project.
2. Position it in the viewport where users can interact with it.
3. In the Properties Panel, find the "Link Href" field.
   
4. Input the URL for the target Metaverse room, scene, or external link.
5. Publish your project.
6. Once published, hovering over the image will display a "Jump" option.

🔹 Pro Tip: You can hide the "Jump" button by enabling the "Hide Link Href Button" option in the Properties Panel, providing a seamless transition effect.

Adding Videos to Your Scene

Videos can be uploaded and used as permanent media players in your Verses. XR Creator supports both static video files and live streaming content.

How to Upload and Configure Videos

1. Open the "Assets" tab and upload a video file or link to a streaming source.
2. Set the playback options in the Properties Panel, including:
   • Auto Play: Start video automatically upon scene entry.
   • Loop: Enable continuous playback, ideal for background videos.
   • Enable Video by Proximity: Start playing when users approach within a defined radius.

Video as a Portal:

• Add a video element, then set the "Link Href" to make the video function as a portal, similar to images.

Additional Video Properties

Property	Description
Billboard	Ensures the video always faces the user, ideal for UI elements or signage.
Invisible Background	Transforms a chroma color (e.g., blue/green screen) into transparency.
Start Video Inside Scene	Delays video playback until users enter the main room, avoiding pre-play in the lobby.
Use 2D View	Allows videos to open in a 2D interface with zoom and pan capabilities.
Projection	Choose between flat projection or 360-degree equirectangular projection.
Override Audio Settings	Customize audio behavior, including spatial audio effects.
Enable Proximity	Makes the video start when users approach within a specific range.

Transparency for Videos

You can integrate transparent videos into Metaverse scenes, unlocking a new level of realism.

How to Enable Video Transparency

1. Use a video with a chroma background (blue/green screen).

2. Import the video into XR Creator Studio.

3. In the Properties Panel, activate "Invisible Background".

4. Publish the project—the background will be removed, creating a seamless transparent effect.

Audio

Audio enhances ambiance, provides narration, or triggers sound effects in Verses.
You can upload .mp3 files or link to external audio sources.

How to Add Audio

1. Add an audio element via the Assets Panel.
2. Upload an audio file or input an audio stream URL.
3. Configure audio playback settings:
   • Auto Play: Start audio automatically upon scene entry.
   • Loop: Enable continuous audio playback.

Other Audio Properties

Property	Description
Controls	Show or hide audio controls (e.g., play, pause, volume).
Don't Play Audio Twice	Prevent audio from repeating if the scene is reloaded (24-hour reset).
Start Audio Only Inside Scene	Ensures audio starts only within the main room, avoiding lobby playback.
Override Audio Settings	Use PannerNode audio for spatial sound effects.
Enable Proximity	Makes audio start when users approach within a defined radius.

PDFs

PDFs can be displayed as interactive 3D elements, allowing users to view documents within the Metaverse.

How to Upload PDFs

1. Upload a PDF file or link via a URL in the Assets Panel.
2. Position the PDF in the scene as a 3D element.
3. Use the "Use 2D View" option to enable easy navigation of PDF content.

🔹 Pro Tip: The 2D View is particularly useful for long documents, enabling scrolling and zooming.

Enabling 2D View

To enhance your viewing experience, you can select the "Use 2D View" option in the Properties Panel.
This allows you to view PDFs as 2D elements in the Metaverse, making it easier to scroll and read content comfortably.

By mastering 2D elements, you can create engaging and interactive experiences in XR Creator Studio, bringing your Metaverse visions to life! 🚀