Using the Magnifying Glass

LEADTOOLS provides a "magnifying glass" that can be attached to a window handle. This magnifying glass provides a means of "zooming in" on the image loaded into the window to which it is attached.

Use the "Magnifying Glass" if you want to:

• Work with the magnifying glass after passing a callback function to the L_StartMagGlass function; the optional callback is used to handle the WM_LBUTTONDOWN, WM_LBUTTONUP and WM_MOUSEMOVE messages received by the window to which the Magnifying Glass is attached.

• Set the contrast, gamma and intensity for the zoomed area.

In the Document and Medical toolkits, LEADTOOLS also provides a "Zoom View" that can be attached to a window handle. For more information about the Zoom View, refer to Using the Zoom View. Use the "Zoom View" if you want to:

• Display one or more zoomed views for a single displayed image.

• Display an annotation in addition to the zoomed view.

• Display callout lines.

To attach the magnifying glass to a window, call L_StartMagGlass or L_StartMagGlass. To determine whether a window has a magnifying glass attached to it, call the L_WindowHasMagGlass function. As the magnifying glass is moved over an image, the zoomed - in view is also displayed.

One of three scenarios can be followed when working with magnifying glass:

The following can be set using the L_StartMagGlass function:

• size of the magnifying glass

• shape of the magnifying glass

• magnifying glass border (color, thickness, appearance)

• magnification level

• size of the rectangle used to display the zoomed image

• paint characteristics

• section of the pixel on which to center the zoomed image

• color masks

To update the Magnifying Glass procedure with a new destination rectangle, call L_UpdateMagGlassRect. This should be done anytime the image's destination rectangle is modified, for example, when scrolling or zooming.

To update the Magnifying Glass procedure with new display flags, call L_UpdateMagGlassPaintFlags.

The L_StartMagGlass function lets you set all of the previously listed properties as well as the following:

• flags that indicate which colors in the bitmap to display and which to mask

• flags that enable or disablethe manual updating of the magnifying glass

• an optional callback to handle the WM_LBUTTONDOWN, WM_LBUTTONUP and WM_MOUSEMOVE messages received by the window to which the Magnifying Glass is attached.

If a callback function is passed to L_StartMagGlass, information about the non-updated parts of the bitmap can be obtained from the callback function. Low-level functions like L_GetPixelColor can then be used to get color information for the non-updated parts of the bitmap. This new color information can then be passed to L_UpdateMagGlass to update the Magnifying Glass zoomed image. This callback function receives information when the left mouse button is pressed or released and when the mouse is moved while the left mouse button is pressed.

If a callback function is passed to L_StartMagGlass, L_UpdateMagGlass must be called in order to paint the zoomed image in the Magnifying Glass display area.

LEADTOOLS provides two defined shapes for the Magnifying Glass: Rectangle and Ellipse. The L_UpdateMagGlassShape function lets you update the shape of the magnifying glass to one of the previously listed shapes, or to a custom shape.

L_SetMagGlassPaintOptions gives the user the ability to set the contrast, gamma and intensity for the zoomed area.

after L_StartMagGlass has been called and the Magnifying Glass paints itself to the DC, but before the Magnifying Glass is displayed on the screen, the user can change what is in the DC, through a user-defined callback function of the MAGGLASSOWNERDRAWCALLBACK prototype. In order to use this callback function, the callback function must be set by calling L_SetMagGlassOwnerDrawCallback. This feature lets you render magnified annotations, which may be overlaid on the currently displayed image, or just simply override what is currently in the Magnifying Glass display area.

To discontinue using the MAGGLASSOWNERDRAWCALLBACK to render the Magnifying Glass, call L_SetMagGlassOwnerDrawCallback a second time, with the pfnCallback parameter set to NULL.

When the magnifying glass is no longer needed, call L_StopMagGlass to stop the magnifying glass procedure and to detach it from the window handle.