Component reference
Files components

Image component

3min

Description

The Image component allows you to display images within your scene, either on a flat plane or projected onto a 360 sphere. It supports various image formats and provides settings to adjust transparency, projection, and visibility.

Document image



Properties

Property

Description

Image URL

The file path or URL to the image file you wish to display.

Transparency

Determines how the image handles transparency. Options include Opaque, Blend, and Mask. Use Opaque to keep the image's original transparency, choose Blend to create semi-transparency based on the image’s alpha channel, or Mask for hard transparency cut-offs.

Alpha Cutoff

When using Mask, adjusts the threshold for transparency. Pixels with alpha values below this threshold become fully transparent.

Projection

Determines how the image is projected. Options are Flat (on a plane) and Equirectangular 360 (projected onto a sphere for 360-degree images).

Side

Specifies which sides of the image plane are visible. Options include Double (both sides), Front (visible from the front only), and Back (visible from the back only).

Important details

  • 360-degree images: Using Equirectangular 360 projection is useful for immersive backgrounds or skyboxes, creating the illusion of being within the image.
  • Transparency effects: Proper use of the Transparency settings can create advanced effects like cut-out shapes in your images.
  • Maintain performance: Be mindful of image resolutions and file sizes, as large images can impact performance.