ImageElement

ImageElement representa una imagen 2D en la escena. Soporta comportamiento de billboarding, enlaces clicables, transparencia alfa, modos de proyección y sincronización de red.

src: string

La URL de origen o ruta del archivo de la imagen a mostrar.

Ejemplo:

    const image = new ImageElement();
    image.src = "assets/images/photo.png";
    scene.add(image);

controls: boolean

Habilita o deshabilita los controles de reproducción si el elemento de imagen admite contenido interactivo o animado.

Ejemplo:

    image.controls = true;

billboard: boolean

Cuando es true, la imagen siempre mirará hacia la cámara.

Ejemplo:

    image.billboard = true;

href: string

Hipervínculo opcional asociado con la imagen.

Ejemplo:

    image.href = "https://example.com";

hideHref: boolean

Determina si el hipervínculo (href) debe estar visualmente oculto.

Ejemplo:

    image.hideHref = false;

alphaMode: ImageAlphaMode

Define cómo se maneja la transparencia alfa durante el renderizado (opaque, blend, mask).

• opaque
  Sin transparencia; los píxeles de la imagen son totalmente sólidos, ignorando el canal alfa.

• blend
  Mezcla alfa estándar; los píxeles se renderizan con diferentes niveles de transparencia basados en el alfa.

• mask
  Test de alfa (recorte); los píxeles por debajo de un umbral se descartan (totalmente transparentes), los demás son totalmente opacos.

Ejemplo:

    image.alphaMode = "mask";

projection: string

Especifica el modo de proyección aplicado a la imagen (flat, spherical, equirectangular).

Ejemplo:

    image.projection = "flat";

alphaCutoff: number

Umbral de corte alfa cuando se usa transparencia basada en máscara (0–1).

Ejemplo:

    image.alphaCutoff = 0.5;

networkable: boolean

Indica si el estado y la apariencia del elemento de imagen deben sincronizarse a través de la red.

Ejemplo:

    image.networkable = true;