This documentation is for the old version. Go to the latest Graphics Mill docs

BitmapViewer.ImageLoadMode Property

Gets/sets a value that specifies how the image is loaded to a browser.

Namespace: Aurigma.GraphicsMill.AjaxControls
Assembly: Aurigma.GraphicsMill.AjaxControls (in Aurigma.GraphicsMill.AjaxControls.dll)


Visual Basic
<BrowsableAttribute(True)> _
Public Property ImageLoadMode As ImageLoadMode
public ImageLoadMode ImageLoadMode { get; set; }

Property Value

The ImageLoadMode enumeration member that specifies how the image is loaded to a browser.


The following load modes are available:

  • Entire Whole original image is loaded including all invisible parts. Note if the PreviewImageEnabled property is true, the image is loaded in the similar manner as a progressive JPEG loading.
  • AdaptiveTile First of all, the control loads image fragment actually visible in the client area. Then, if an user scrolls the image it loads necessary parts of an original image which are visible but not loaded yet.
  • RegularTile In this mode the original image is divided into square tiles. The tile size equals to TileSize property value. The control loads square fragments of the original image for corresponding tiles which are visible but not loaded yet.

If you are not going to change or modify the displayed image frequently you should use the Entire mode. In this case you increase an image load time and get a completely loaded image which can be scrolled without additional delays. If AdaptiveTile or RegularTile mode is used you will get the image inside the control significantly faster than in the Entire mode. But when you scroll the image you will need to wait untill the necessary fragment is loaded. AdaptiveTile mode allows to optimize a traffic by loading only actually visible parts of the displayed image. But it requires more server resources comparing to RegularTile mode.

See Also