Package com.luciad.maps.effects

Class EnvironmentMap

java.lang.Object
com.luciad.maps.effects.EnvironmentMap
All Implemented Interfaces:
AutoCloseable
public final class EnvironmentMap extends Object implements AutoCloseable
An image of the environment surrounding a 3D scene, captured in all directions, together with its orientation and brightness.

An environment map can be used by EnvironmentMapEffect as a skybox and/or as a reflection map. See that class for what each role does.

Create one with EnvironmentMap#newEquirectangularBuilder for a single equirectangular (2:1) image, or with EnvironmentMap#newCubeMapBuilder for six-square, equally sized face images.

HDR imagery is supported and recommended for reflection maps: supply images with a floating point pixel format (PixelFormat#Rgb32 or PixelFormat#Rgba32).

An environment map is an opaque value: once built, it cannot be inspected or modified.

Since:
2026.1

  • Method Details

    • finalize

      protected void finalize()
      Overrides:
      finalize in class Object

    • close

      public void close()
      Specified by:
      close in interface AutoCloseable

    • newEquirectangularBuilder

      @NotNull public static EnvironmentMap.EquirectangularBuilder newEquirectangularBuilder()
      Creates a new builder for an environment map from a single equirectangular (2:1) image.
      Returns:
      a new builder.

    • newCubeMapBuilder

      @NotNull public static EnvironmentMap.CubeMapBuilder newCubeMapBuilder()
      Creates a new builder for an environment map from six cubemap faces.
      Returns:
      a new builder.