displays a dynamic version of image, supporting panning, zooming, etc.


displays a dynamic version of the image stored in file.


displays a dynamic version of the image stored in url.

Details and Options

  • DynamicImage creates a viewer with controls for zooming, panning, and scrolling, useful for examining details of large images.
  • DynamicImage works with Image objects, as well as any supported image file format.
  • In DynamicImage[file], file can be specified as a string or as a File object.
  • DynamicImage[file] tries to read only necessary parts of file when working with TIFF, JPEG, and PNG.
  • In DynamicImage[url], url can be specified as a string or as a URL object.
  • DynamicImage has the same options as Pane, with the following additions and changes:
  • AppearanceElements Automaticcontrols to show on the dynamic image
    AspectRatio Automaticcontrols the aspect ratio of the dynamic image
    Epilog{}graphics primitives to render on the image
    ImageSize Automaticdisplayed size of the image
    SaveDefinitionsFalsesave entire image in the dynamic expression
    ZoomCenter Automaticposition of the center of the displayed image
    ZoomFactor Automaticratio between displayed and original pixel size
  • Available elements for AppearanceElements are:
  • "Pan"panning using mouse drag
    "ResizeArea"resize area to the bottom right
    "Scrollbars"scrollbars with additional zoom knobs at the ends
    "Thumbnail"small preview of the entire image
    "ZoomButtons"buttons to zoom in and out
    "Zoom"zooming using and vertical mouse drag
  • Groups of appearance elements can be selected using one of the following:
  • Allall appearance elements
    Automaticautomatically selected appearance elements
    Noneno appearance elements
  • Use Setting on the output of DynamicImage to access the displayed subimage.


open allclose all

Basic Examples  (2)

Dynamically view an image:

Dynamically view a large out-of-core file:

Options  (6)

AppearanceElements  (1)

By default, an automatic set of appearance elements is displayed:

Specify appearance elements:

Show all available appearance elements:

AspectRatio  (2)

By default, an automatic aspect ratio is used:

Specify a fixed aspect ratio:

Changing the size of the viewer with a fixed aspect ratio will preserve the aspect ratio:

ImageSize  (1)

By default, an automatic size is used:

Specify the initial size:

ZoomCenter  (1)

By default, the image is center aligned with the dynamic image viewer:

Specify the alignment:

Use an explicit coordinate as the zoom center:

ZoomFactor  (1)

By default, the larger dimension of the image fits into the display size:

Specify the zoom factor:

Use ZoomFactor->1 to get the original image size:

Magnify the image using zoom factors greater than 1:

Interactive Examples  (1)

Draw interactive graphics primitives on top of an image:

Wolfram Research (2016), DynamicImage, Wolfram Language function, https://reference.wolfram.com/language/ref/DynamicImage.html (updated 2017).


Wolfram Research (2016), DynamicImage, Wolfram Language function, https://reference.wolfram.com/language/ref/DynamicImage.html (updated 2017).


Wolfram Language. 2016. "DynamicImage." Wolfram Language & System Documentation Center. Wolfram Research. Last Modified 2017. https://reference.wolfram.com/language/ref/DynamicImage.html.


Wolfram Language. (2016). DynamicImage. Wolfram Language & System Documentation Center. Retrieved from https://reference.wolfram.com/language/ref/DynamicImage.html


@misc{reference.wolfram_2022_dynamicimage, author="Wolfram Research", title="{DynamicImage}", year="2017", howpublished="\url{https://reference.wolfram.com/language/ref/DynamicImage.html}", note=[Accessed: 28-March-2023 ]}


@online{reference.wolfram_2022_dynamicimage, organization={Wolfram Research}, title={DynamicImage}, year={2017}, url={https://reference.wolfram.com/language/ref/DynamicImage.html}, note=[Accessed: 28-March-2023 ]}