({{, (RefLink[DynamicImage, paclet:ref/DynamicImage])[image] 
displays a dynamic version of image, supporting panning, zooming, etc.}, {, (RefLink[DynamicImage, paclet:ref/DynamicImage])[file]
displays a dynamic version of the image stored in file. }, {, (RefLink[DynamicImage, paclet:ref/DynamicImage])[url]
displays a dynamic version of the image stored in url.}})

OpenersNotesSection(Spacer1)Details and Options

(RefLink[DynamicImage, paclet:ref/DynamicImage]) creates a viewer with controls for zooming, panning, and scrolling, useful for examining details of large images.

(RefLink[DynamicImage, paclet:ref/DynamicImage]) works with (RefLink[Image, paclet:ref/Image]) objects, as well as any supported image file format.

In (RefLink[DynamicImage, paclet:ref/DynamicImage])[file], file can be specified as a string or as a (RefLink[File, paclet:ref/File]) object.

(RefLink[DynamicImage, paclet:ref/DynamicImage])[file] tries to read only necessary parts of file when working with TIFF, JPEG, and PNG.

In (RefLink[DynamicImage, paclet:ref/DynamicImage])[url], url can be specified as a string or as a (RefLink[URL, paclet:ref/URL]) object.

(RefLink[DynamicImage, paclet:ref/DynamicImage]) has the same options as (RefLink[Pane, paclet:ref/Pane]), with the following additions and changes:

Available elements for (RefLink[AppearanceElements, paclet:ref/AppearanceElements]) are:

Groups of appearance elements can be selected using one of the following:

Use (RefLink[Setting, paclet:ref/Setting]) on the output of (RefLink[DynamicImage, paclet:ref/DynamicImage]) to access the displayed subimage.

OpenersPrimaryExamplesSection(Spacer1)Examples  (9)

OpenersExampleSection0(Spacer1)Basic Examples  (2)

Dynamically view an image:

img=ExampleData[{"TestImage","Apples"}];
DynamicImage[img]

Dynamically view a large out-of-core file:

filename=ExampleData[{"TestImage","Volubilis"},"FilePath"];
DynamicImage[filename]

OpenersExampleSection1(Spacer1)Options  (6)

OpenersExampleSubsection0(Spacer1)AppearanceElements  (1)

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

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename]

Specify appearance elements:

DynamicImage[filename,AppearanceElements->{"Pan","Zoom","Scrollbars"}]

Show all available appearance elements:

DynamicImage[filename,AppearanceElements->All]

OpenersExampleSubsection1(Spacer1)AspectRatio  (2)

By default, an automatic aspect ratio is used:

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename]

Specify a fixed aspect ratio:

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename,AspectRatio->1]

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

DynamicImage[filename,AspectRatio->1]

OpenersExampleSubsection2(Spacer1)ImageSize  (1)

By default, an automatic size is used:

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename]

Specify the initial size:

DynamicImage[filename,ImageSize->{200,200}]

OpenersExampleSubsection3(Spacer1)ZoomCenter  (1)

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

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename]

Specify the alignment:

DynamicImage[filename,ZoomCenter->{Center,Top}]

Use an explicit coordinate as the zoom center:

DynamicImage[filename,ZoomCenter->{450,750},ZoomFactor->2,Epilog->{Red,AbsolutePointSize[5],Point[{450,750}]}]

OpenersExampleSubsection4(Spacer1)ZoomFactor  (1)

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

filename=ExampleData[{"TestImage","Man"},"FilePath"];

DynamicImage[filename]

Specify the zoom factor:

DynamicImage[filename,ZoomFactor->.5]

Use (RefLink[ZoomFactor, paclet:ref/ZoomFactor])->1 to get the original image size:

DynamicImage[filename,ZoomFactor->1]

Magnify the image using zoom factors greater than 1:

DynamicImage[filename,ZoomFactor->5]

OpenersExampleSection3(Spacer1)Interactive Examples  (1)

Draw interactive graphics primitives on top of an image:

Manipulate[
DynamicImage[
ExampleData[{"TestImage","Airport"}],
ImageSize->{360,222}, 
Epilog->{Orange,Thickness[0.01],Circle[{305,574},Dynamic[r]]}
],
{{r,100},24,512},
FrameMargins-> 0
]

({{DocumentationFooterIconsRelatedFunction.png, ({{See Also}, {(RefLink[Image, paclet:ref/Image])  ▪  (RefLink[Pane, paclet:ref/Pane])  ▪  (RefLink[ClickPane, paclet:ref/ClickPane])  ▪  (RefLink[LocatorPane, paclet:ref/LocatorPane])  ▪  (RefLink[DynamicGeoGraphics, paclet:ref/DynamicGeoGraphics])  ▪  (RefLink[Dynamic, paclet:ref/Dynamic])}})}})

({{DocumentationFooterIconsRelatedGuide.png, ({{Related Guides}, {▪(RefLinkPlain[Image Processing & Analysis, paclet:guide/ImageProcessing])}, {▪(RefLinkPlain[Image Representation, paclet:guide/ImageRepresentation])}, {▪(RefLinkPlain[Image Computation for Microscopy, paclet:guide/ImageComputationForMicroscopy])}})}})