ImageGear for C and C++ on Windows v19.6 - Updated
IG_dspl_zoom_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Display Functions > IG_dspl_zoom_set

This function sets the new zoom values.

Declaration:

 
Copy Code
AT_ERRCOUNT   ACCUAPI  IG_dspl_zoom_set(
        [IN] HIGEAR hIGear,
        [IN] DWORD dwGrpID,
        [IN] AT_MODE nZoomMode,
        [IN] DOUBLE dHZoom,
        [IN] DOUBLE dVZoom
);

Arguments:

Name Type Description
hIGear HIGEAR Image handle to where set zoom options.
dwGrpID DWORD Identifier of group in which to set zoom options.
nZoomlMode AT_MODE New value of ZoomMode to set. Possible value is combination from one of the horizontal zoom flags:
  • IG_DSPL_ZOOM_H_NOT_FIXED
  • IG_DSPL_ZOOM_H_FIXED
and one of the vertical flags:
  • IG_DSPL_ZOOM_V_NOT_FIXED
  • IG_DSPL_ZOOM_V_FIXED
dHZoom DOUBLE New value of ZoomValueH to set. Any positive number is accepted. Value 1.0 means that the image is zoomed by 100% or displayed in its actual size.
dVZoom DOUBLE New value of ZoomValueV to set. Any positive number is accepted. Value 1.0 means that the image is zoomed by 100% or displayed in its actual size.

Return Value:

Returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Display, MFC, FILTERS, ASCII, PAN, ART, Vector

Example:

 
Copy Code
HIGEAR            hIGear;        /* HIGEAR handle of image    */ 
DWORD           nGrpID;        /* display group identifier  */
 ...
/* set aspect ratio as not fixed and zoom image by 150% and 200% for horizontal and
vertical directions respectively  */
IG_dspl_layout_set( hIGear, nGrpID, IG_ASPECT_MODE, NULL, NULL, NULL, 0, 0,
IG_DSPL_ASPECT_NOT_FIXED, 0.0 ); 
IG_dspl_zoom_set( hIGear, nGrpID, IG_DSPL_ZOOM_H_FIXED| IG_DSPL_ZOOM_V_FIXED, 1.5, 2.0 );
 ...
/* the same as before but only for horizontal direction; vertical direction is zoomed
according to current fit method and device rectangle */
IG_dspl_zoom_set( hIGear, nGrpID, IG_DSPL_ZOOM_H_FIXED| IG_DSPL_ZOOM_V_NOT_FIXED, 1.5, 2.0
);
 ...