L_TemperatureBitmap - Raster Imaging C API Help


#include "l_bitmap.h"

L_LTIMGCLR_API L_INT L_TemperatureBitmap(pBitmap, nFactor, uFlags)


pointer to the bitmap handle

L_INT nFactor;

Temperature value

L_UINT32 uFlags;


Adds temprature to an image.

Parameter Description
pBitmap Pointer to the bitmap handle that references the bitmap on which to apply the effect.
nFactor Value of temprature to be used, in the range of -100 and 100.
uFlags Reserved for future use. Must be 0.


SUCCESS The function was successful.
< 1 An error occurred. Refer to Return Codes.


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.

Required DLLs and Libraries

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


Win32, x64.

See Also

Functions: L_MosaicBitmap, L_PosterizeBitmap, L_RemoveRedeyeBitmap, L_GlassEffectBitmap
Topics: Raster Image Functions: Filtering Images
Raster Image Functions: Artistic Effects
Applying Artistic Effects
Raster Image Functions: Correcting Colors


This example loads a bitmap and applies temperature bitmap filter.

L_INT TemperatureBitmapExample(L_VOID) 
    L_INT nRet; 
    BITMAPHANDLE LeadBitmap;   /* Bitmap handle to hold the loaded image. */ 
    /* Load the bitmap, keeping the bits per pixel of the file */ 
    nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("cannon.jpg")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
    if(nRet != SUCCESS) 
        return nRet ; 
    /* Apply temperature bitmap filter */ 
    nRet = L_TemperatureBitmap(&LeadBitmap, 100, 0) ; 
    if(nRet !=SUCCESS) 
        //free bitmap 
        return nRet ; 
    nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &LeadBitmap, FILE_BMP, 24, 0, NULL) ; 
    //free bitmap 
    return nRet ; 

Help Version 20.0.2018.7.30
Products | Support | Contact Us | Copyright Notices
© 1991-2018 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help