Class ImageOverlay

java.lang.Object
com.esri.arcgisruntime.mapping.view.ImageOverlay

public final class ImageOverlay extends Object
An overlay that contains a frame with an image to display in the view.

Currently, this feature is supported in a SceneView (3D) only. The overlay can contain exactly one image at any given time. Multiple overlays, however, can be added and rendered at the same time on the SceneView. An ImageOverlay can be used to quickly render frequently changing images. For example, rendering realtime sensor data, such as weather, where each static image represents a single frame from the radar. In this workflow, images are constantly updated via a new ImageFrame each time new data is available. This provides a fast-refreshing workflow where the underlying images are frequently updated as new data comes in.

Since ImageOverlay does not support the rich processing and rendering capabilities of a RasterLayer , you should use Raster and RasterLayer for workflows that require static image rendering, analysis, and persistence.

Image overlays are rendered above all other layers in the scene, draped on the surface, and below any graphics overlays in the scene view.

Since:
100.8.0
See Also:
  • Constructor Details Link icon

    • ImageOverlay Link icon

      public ImageOverlay()
      Creates an ImageOverlay.
      Since:
      100.8.0
    • ImageOverlay Link icon

      public ImageOverlay(ImageFrame imageFrame)
      Creates an ImageOverlay that contains an ImageFrame.
      Parameters:
      imageFrame - the ImageFrame of the ImageOverlay
      Throws:
      IllegalArgumentException - when imageFrame is null
      Since:
      100.8.0
  • Method Details Link icon

    • getImageFrame Link icon

      public ImageFrame getImageFrame()
      Gets the ImageFrame that contains the image.
      Returns:
      the ImageFrame contained in the ImageOverlay or null if none
      Since:
      100.8.0
    • setImageFrame Link icon

      public void setImageFrame(ImageFrame imageFrame)
      Sets the ImageFrame to be used in the ImageOverlay
      Parameters:
      imageFrame - the ImageFrame contained in the ImageOverlay
      Since:
      100.8.0
    • getExtent Link icon

      public Envelope getExtent()
      Gets the extent of the ImageOverlay.

      The spatial reference of the extent matches the extent of the SceneView that contains the image overlay.

      Returns:
      the extent of the ImageOverlay or null if none
      Since:
      100.8.0
    • isVisible Link icon

      public boolean isVisible()
      Gets the visibility of the ImageOverlay.
      Returns:
      the visibility of the ImageOverlay
      Since:
      100.8.0
    • setVisible Link icon

      public void setVisible(boolean isVisible)
      Sets the visibility of the ImageOverlay.
      Parameters:
      isVisible - true if image should be visible
      Since:
      100.8.0
    • getOpacity Link icon

      public float getOpacity()
      Gets the opacity of the ImageOverlay.

      Opacity values range from 0.0 to 1.0, where 0.0 is fully transparent and 1.0 is fully opaque.

      Returns:
      the opacity for the ImageOverlay
      Since:
      100.8.0
    • setOpacity Link icon

      public void setOpacity(float opacity)
      Sets the opacity of the ImageOverlay.

      Opacity values range from 0.0 to 1.0, where 0.0 is fully transparent and 1.0 is fully opaque.

      Parameters:
      opacity - the opacity for the ImageOverlay
      Since:
      100.8.0