ImageGear for C and C++ on Windows v21.0 - Updated
API Reference Guide / Core Component API Reference / Core Component Functions Reference / Display Functions / IG_dspl_zoom_set
In This Topic
    IG_dspl_zoom_set
    In This Topic

    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
    );
     ...