ImageGear gives you complete control over how your application displays files on different Windows platforms. This topic provides an overview of the following:

Image Display Using ImGearPage Class

Once the ImGearPage class object is obtained (either by itself, or as part of an ImGearDocument class), the most common thing to do with it is to display it on the computer screen. Usually, an application will only display a given image on the computer screen once. However, there are many situations when an application will need to display the same image more than once (e.g., to allow the end user to apply some alternate display settings, the application needs to show "before" and "after" images at the same time). The various control options used to determine the appearance on the screen are all bundled together in a single object called ImGearPageDisplay. Each ImGearPageDisplay class is associated with one (and only one) ImGearPage class, but a given ImGearPage class can have any number (0, 1, or more) of ImGearPageDisplay class instances associated with it.

All that is necessary is to create an ImGearPageDisplay class instance attached to the page, set up display style optionally, and call its Draw method member during paint event handling.

See the section Image Display Using ImGearPage for more information.

Please use ImGearPresentationPageDisplay class instead of ImGearPageDisplay class when working with WPF environment.

Viewing in Windows Forms

The ImageGear.Windows.Forms namespace provides common GUI functionality that can simplify development of Windows Forms based applications. This functionality is implemented in a separate assembly (ImageGear.Windows.Forms assembly), using only public ImageGear API, with source code provided to enable modifications.

See the section Viewing in Windows Forms for more information.

Viewing with Windows Presentation Foundation (WPF)

ImageGear.WPF namespace provides UI controls for use with the Windows Presentation Foundation (WPF) framework.

See the section Viewing with WPF for more information.

More Information about Viewing

There are many configuration options and attributes that can be used to define how images should be displayed. The following list details some of the settings that can be controlled:

• Contrast and Brightness adjustments
• Transparency
• Gamma correction
• Image Rotation (Orientation)
• The display area where the image is to be drawn (this area is called the Device Rectangle)
• The portion of the image to display (this array of pixels within the DIB bitmap is called the Image Rectangle)
• The Alignment of the displayed image in the display area
• The fill pattern and color to use for the background, any area of the Device Rectangle not displaying a portion of the image
• The Image Layout, Fit to width/height/window
• Precision scrolling
• Aspect ratio
• Anti-aliasing display for 1-bit (Black & White) images using preserve black, preserve white and scale to gray modes
• Color Anti-aliasing for non 1-bit (Black & White) images
• Using LUTs (look-up tables) to cause the colors in an image's color palette to be translated to other colors you select (i.e., you can display an 8-bit grayscale image in any 256 colors you choose)  

All of the above display attributes affect the display only. They do not alter either the image bitmap or the color palette in the DIB. In addition, any time your image is being displayed, you can center, zoom, or scroll it from within your application.