---
title: "BitmapViewer..::.ImageLoadMode Property "
canonical: https://www.graphicsmill.com/docs/gmwc/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_ImageLoadMode.htm
archived: true
applies_to:
  - product: "Graphics Mill Web Controls"
---

**You’re viewing documentation for an outdated product.** Graphics Mill Web Controls is no longer part of Graphics Mill. For current design editing and rendering tools, see [Design Atoms .NET](https://customerscanvas.com/docs/on-premises/design-atoms-cs/), [Design Atoms JS](https://customerscanvas.com/docs/on-premises/design-atoms-js/), and [Design Editor](https://customerscanvas.com/docs/on-premises/design-editor/).

# BitmapViewer.ImageLoadMode Property 

**Applies to:** Graphics Mill Web Controls · **Archived documentation**
 
Gets/sets a value that specifies how the image is loaded to a browser.
 
**Namespace:** [Aurigma.GraphicsMill.AjaxControls](https://www.graphicsmill.com/docs/gmwc/N_Aurigma_GraphicsMill_AjaxControls.htm.md)
 **Assembly:** Aurigma.GraphicsMill.AjaxControls (in Aurigma.GraphicsMill.AjaxControls.dll)
 
## Syntax
  
```csharp
public ImageLoadMode ImageLoadMode { get; set; }
```
 
### Property Value
The [ImageLoadMode](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) enumeration member that specifies how the image is loaded to a browser.
 
## Remarks
  
The following load modes are available:
 
- **[Entire](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** Whole original image is loaded including all invisible parts. Note if the [PreviewImageEnabled](https://www.graphicsmill.com/docs/gmwc/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_PreviewImageEnabled.htm.md) property is **true**, the image is loaded in the similar manner as a progressive JPEG loading.
- **[AdaptiveTile](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** 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](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md)** In this mode the original image is divided into square tiles. The tile size equals to [TileSize](https://www.graphicsmill.com/docs/gmwc/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_TileSize.htm.md) 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](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) 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](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) or [RegularTile](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode is used you will get the image inside the control significantly faster than in the [Entire](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode. But when you scroll the image you will need to wait untill the necessary fragment is loaded. [AdaptiveTile](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) 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](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_ImageLoadMode.htm.md) mode.
   
## See Also

### Reference

- [BitmapViewer Class](https://www.graphicsmill.com/docs/gmwc/T_Aurigma_GraphicsMill_AjaxControls_BitmapViewer.htm.md)
- [Aurigma.GraphicsMill.AjaxControls Namespace](https://www.graphicsmill.com/docs/gmwc/N_Aurigma_GraphicsMill_AjaxControls.htm.md)
- [BitmapViewer..TileSize](https://www.graphicsmill.com/docs/gmwc/P_Aurigma_GraphicsMill_AjaxControls_BitmapViewer_TileSize.htm.md)