L_SetMagGlassPaintOptions

#include "l_bitmap.h"

L_LTDIS_API L_INT L_SetMagGlassPaintOptions(hWnd, pMagGlassPaintOptions)

L_HWND hWnd;

/* handle to a window */

pMAGGLASSPAINTOPTIONS pMagGlassPaintOptions;

/* pointer to a structure */

Sets the Magnifying Glass paint options.

Parameter

Description

hWnd

Handle of the window to which the magnifying glass is attached.

pMagGlassPaintOptions

Pointer to a structure that contains the new magnifying glass paint options to set.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

The function is used to set the magnifying glass paint options (Intensity, Contrast and Gamma). Those paint options will be used when the magnifying glass paints the zoomed area, so you will see this area with some extra contrast or intensity.

Required DLLs and Libraries

LTDIS

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

Platforms

Windows 2000 / XP/Vista, Windows CE.

See Also

Functions:

L_StartMagGlass, L_StartMagGlass, L_StopMagGlass, L_CreateZoomView, L_GetZoomViewProps, L_UpdateZoomView, L_DestroyZoomView, L_GetZoomViewsCount, L_WindowHasZoomView, ZOOMVIEWPROPS

Topics:

Using the Magnifying Glass

 

Raster Image Functions: Displaying Images

 

Using the Zoom View

Example

This example starts the Magnifying Glass then calls L_SetMagGlassPaintOptions function to set the Magnifying Glass paint options.

 L_INT SetMagGlassPaintOptionsExample(L_HWND          hWnd,
                                                    pBITMAPHANDLE pBitmap,
                                                    RECT*         prcView) 
{
   L_INT                nRet; 
   L_TCHAR              szMsg[256]=TEXT(""); 
   MAGGLASSPAINTOPTIONS MagGlassPntOptions; 
   MAGGLASSOPTIONS      MagGlassOpt;

   // Starting the Magnifying Glass
   memset(&MagGlassOpt, 0, sizeof(MAGGLASSOPTIONS));
   MagGlassOpt.uStructSize = sizeof (MAGGLASSOPTIONS);
   MagGlassOpt.nWidth      = 100;
   MagGlassOpt.nHeight     = 100;
   MagGlassOpt.nZoom       = 400;
   MagGlassOpt.clrPen      = RGB(255,0,0);
   MagGlassOpt.hMagCursor  = NULL;
   MagGlassOpt.clrBack     = RGB(128,128,128);
   MagGlassOpt.bEllipse    = FALSE;
   MagGlassOpt.nBorderSize = 1;
   MagGlassOpt.b3D         = TRUE;
   MagGlassOpt.uPaintFlags = 0;
   MagGlassOpt.pMask       = NULL;
   MagGlassOpt.uMaskCount  = 0;
   MagGlassOpt.nCrosshair  = CROSSHAIR_FINE;
   MagGlassOpt.bIgnoreRgn  = TRUE;
   MagGlassOpt.bCenter     = TRUE;

   nRet = L_StartMagGlass(hWnd, pBitmap, prcView, &MagGlassOpt, NULL, NULL);
   if (nRet != SUCCESS) 
   {
      wsprintf(szMsg, TEXT("Error Starting the Magnifying Glass, Error: %d"), nRet); 
      MessageBox(hWnd, szMsg, TEXT("Error"), MB_ICONEXCLAMATION | MB_OK); 
      return nRet; 
   }

   // Setting the Magnifying Glass Paint contrast, gamma and intensity
   MagGlassPntOptions.uStructSize   = sizeof(MAGGLASSPAINTOPTIONS);
   MagGlassPntOptions.nContrast     = 100; 
   MagGlassPntOptions.nGamma        = 100; 
   MagGlassPntOptions.nIntensity    = 100; 

   nRet = L_SetMagGlassPaintOptions(hWnd, &MagGlassPntOptions); 
   if (nRet != SUCCESS) 
   {
      wsprintf(szMsg, TEXT("Error Setting the Magnifying Glass painting options, Error: %d"), nRet); 
      MessageBox(hWnd, szMsg, TEXT("Error"), MB_ICONEXCLAMATION | MB_OK); 
      return nRet;
   }
   return SUCCESS;
}