ImageGear for C and C++ on Linux - Updated
IG_dspl_layout_get
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Display Functions > IG_dspl_layout_get

This function returns the current values of layout parameters.

Declaration:

 
Copy Code
AT_ERRCOUNT  ACCUAPI  IG_dspl_layout_get( 
        [IN] HIGEAR hIGear, 
        [IN] DWORD dwGrpID,
        [OUT] LPAT_RECTANGLE lpImageRect,
        [OUT] LPAT_RECTANGLE lpDeviceRect,
        [OUT] LPAT_RECTANGLE lpClipRect,
        [OUT] LPAT_MODE lpnFitMode,
        [OUT] LPAT_MODE lpnAlignMode,
        [OUT] LPAT_MODE lpnAspectMode,
        [OUT] LPDOUBLE lpdAspectValue
);

Arguments:

Name Type Description
hIGear HIGEAR Image handle from which to search the option group.
dwGrpID DWORD Identifier of group which to get layout options.
lpImageRect LPAT_RECTANGLE Pointer to the rectangle in which to copy the value of ImageRect option. If NULL then it is ignored. If ImageRect is not set then an empty rectangle is returned.
lpDeviceRect LPAT_RECTANGLE Pointer to the rectangle in which to copy DeviceRect. If NULL, then the parameter is ignored. If an empty rectangle is returned then it is not set and it will be calculated every time from the destination device.
lpClipRect LPAT_RECTANGLE Pointer to the rectangle in which to copy ClipRect. If NULL, then the parameter is ignored. If an empty rectangle returned then it is not set and it will be calculated every time from the destination device.
lpnFitMode LPAT_MODE Assigns the current FitMode. If NULL then the parameter is ignored.
lpnAlignMode LPAT_MODE Assigns the current AlignMode. If NULL then the parameter is ignored.
lpnAspectMode LPAT_MODE Assigns the current AspectMode. If NULL then the parameter is ignored.
lpdAspectValue LPDOUBLE Assigns the current AspectValue. If NULL then the parameter is ignored.

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++.

Example:

 
Copy Code
HIGEAR           hIGear;     /* HIGEAR handle of image  */
DWORD           nGrpID;      /* display group identifier */
AT_RECTANGLE             ImageRect;    /* Image rectangle  */
AT_RECTANGLE            DeviceRect;    /* Device rectangle  */
AT_RECTANGLE             ClipRect;      /* Clip rectangle  */
AT_MODE     nFitMode;               /* Fit mode  */
AT_MODE     nAlignMode;            /* Align mode  */
AT_MODE     nAspectMode;           /* Aspect mode  */
DOUBLE      dAspectValue;    /* Aspect value  */
 ...
/* get all layout parameters */
IG_dspl_layout_get( hIGear, nGrpID, &ImageRect, &DeviceRect, &ClipRect, &nFitMode,
&nAlignMode, &nAspectMode, &dAspectValue );
 ...
/* get only device rectangle and fit mode */
IG_dspl_layout_get( hIGear, nGrpID, NULL, &DeviceRect, NULL, &nFitMode, NULL, NULL, NULL
);
 ...

Remarks:

If a parameter is a rectangle then all empty rectangle is returned if it is not set. For a list of possible values see function IG_dspl_layout_set().