Skip to main content

Interface: EnvTexture

Defines an environment texture for scene backgrounds and reflections.

The EnvTexture interface describes a 360° environment map that surrounds the scene, providing both a visual background and reflection source for materials. Environment textures significantly impact the visual context and lighting quality, especially for reflective materials like metals, glass, or polished surfaces.

High-quality environment textures create realistic lighting contexts that enhance product presentation and material rendering.

Example​

// Setting up an environment texture for a studio scene
scene.environmentTexture = {
  id: "studio-environment",
  label: "Modern Studio",
  filePath: "environments/studio_small.env",
};

// Adjusting environment intensity and rotation
scene.intensity = 0.8;  // Slightly dimmer than default
scene.rotation = Math.PI/2;  // Rotate 90 degrees

Properties​

filePath​

filePath: string

Relative path to the texture file.

This is the primary identifier used to locate and load the texture.

id​

id: string

Unique identifier for this environment texture.

label​

label: string

Display name for this environment texture.

This human-readable label appears in environment selection interfaces.