LBitmap::PicturizeList
#include "ltwrappr.h"
virtual L_INT L_PicturizeList(uxDim, uyDim, uLightnessFact, pBitmapList)
L_UINT uxDim; |
/* thumbnail width */ |
L_UINT uyDim; |
/* thumbnail height */ |
L_UINT uLightnessFact; |
/* lightness factor */ |
LBitmapList * pBitmapList; |
/* pointer to an LBitmapList object */ |
Picturizes the class object's bitmap using thumbnail images created from the specified bitmap list.
Parameter |
Description |
uxDim |
Width of the thumbnail bitmap. |
uyDim |
Height of the thumbnail bitmap. |
uLightnessFact |
Value that represents how much to lighten the thumbnail bitmap. Valid values are between 0 and 1000. This value is divided internally by 1000. Values between 0 and 499 darken the image. Values between 500 and 1000 lighten the image. |
pBitmapList |
Handle to the list of bitmaps used to create the thumbnail images which are in turn used to picturize the specified image. |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
The class object's bitmap, or selected region, is broken down into rectangles of size uxDim x uyDim. For each rectangle, the image in the list that best approximates that rectangle is inserted in the original image. The thumbnail image may be corrected, to approximate a rectangle.
The uLightnessFact parameter can be used to change the lightness of the big image by changing the lightness of each rectangle.
This function supports 12 and 16-bit grayscale and 48 and 64-bit color images. Support for 12 and 16-bit grayscale and 48 and 64-bit color images is available only in the Document/Medical toolkits.
This function does not support signed data images. It returns the error code ERROR_SIGNED_DATA_NOT_SUPPORTED if a signed data image is passed to this function.
This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.
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. |
See Also
Functions: |
LBitmap::BricksTexture, LBitmap::Canvas, LBitmap::DisplaceMap, LBitmap::Fragment, LBitmap::Vignette, LBitmap::Picturize LBitmap::PicturizeSingle, Class Members |
Topics: |
|
|
|
|
Example
L_INT LBitmap__PicturizeListExample(LBitmap & Bitmap, L_TCHAR * szFile, LBitmapList & BitmapList) { L_INT nRet; nRet =Bitmap.Load(szFile); if(nRet !=SUCCESS) return nRet; nRet =Bitmap.PicturizeList(20, 15, 200, &BitmapList); if(nRet !=SUCCESS) return nRet; return SUCCESS; }