L_SaveBitmapWithLayers

#include "l_bitmap.h"

L_LTFIL_API L_INT L_SaveBitmapWithLayers(pszFile, pBitmap, nFormat, nBitsPerPixel, nQFactor, hLayers, pLayerInfo, nLayers, pSaveOptions)

L_TCHAR* pszFile;	output file name
pBITMAPHANDLE pBitmap;	pointer to the bitmap handle
L_INT nFormat;	output file format
L_INT nBitsPerPixel;	resulting file's pixel depth
L_INT nQFactor;	quality factor
HBITMAPLIST hLayers;	handle to a list of bitmaps
pLAYERINFO pLayerInfo;	pointer to a structure
L_INT nLayers;	number of layers in pLayerInfo
pSAVEFILEOPTION pSaveOptions;	pointer to optional extended save options

Saves an image contained in a bitmap to a file, along with the specified layers.

Parameter	Description
pszFile	Character string containing the output file name.
pBitmap	Pointer to the bitmap handle referencing the bitmap that holds the image data.
nFormat	Output file format. Currently, only PSD (FILE_PSD) files support layers.
nBitsPerPixel	Resulting file's pixel depth. For color images this can be 24 or 32. For grayscale images this can be 8.
nQFactor	Reserved for future use. Pass 0.
hLayers	Handle to the bitmap list that contains the layers to save in the output file. The layers should have the same bits per pixel as the file. Every bitmap in the list will be saved as a layer. The first bitmap in the list will be interpreted as the first layer. The bitmaps in the bitmap list must have the same bits per pixel as specified in nBitsPerPixel.
pLayerInfo	Pointer to an optional array of LAYERINFO structures. If this is NULL, then each layer will start at (0, 0) and will have the same size as the image. If this is not NULL, then the layer information for each layer in hLayers will be stored here. The number of LAYERINFO structures is given in nLayers.
nLayers	The number of LAYERINFO structures in the pLayerInfo array. This value should be the same as the number of bitmaps in the hLayers bitmap list. This parameter is used only if pLayerInfo is not NULL.
pSaveOptions	Pointer to optional extended save options. Pass NULL to use the default save options.

Returns

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

Comments

Currently, only the PSD format supports layers.

This function supports signed data images, but only DICOM and TIFF formats support signed data. This function will return an error code if you attempt to save a signed image to a format other than DICOM or TIFF.

If the bitmap has a region, the region stored in the bitmap will be saved, if the image is saved as one of the TIFF file formats.

Required DLLs and Libraries

LTFIL
File format DLLs

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

Platforms

Win32, x64, Linux.

Example

This example saves a bitmap and 3 layers

#define MAKE_IMAGE_PATH(pFileName) TEXT("C:\\Users\\Public\\Documents\\LEADTOOLS Images\\")pFileName 
L_INT SaveBitmapWithLayersExample(L_VOID) 
{ 
   L_INT nRet; 
   BITMAPHANDLE Bitmap; 
   HBITMAPLIST hLayers; 
   L_INT nLayers = 3; 
   L_INT i; 
   LAYERINFO layerInfo[3]; 
   memset(layerInfo, 0, sizeof(layerInfo)); 
   for (i=0; i<3; i++) 
   { 
      ZeroMemory(&layerInfo[i], sizeof(LAYERINFO)); 
      layerInfo[i].uStructSize = sizeof(LAYERINFO); 
      layerInfo[i].nLayerLeft = 0; 
      layerInfo[i].nLayerTop = 0; 
      layerInfo[i].uOpacity = 255; 
      layerInfo[i].uClipping =0; 
      memcpy(layerInfo[i].szBlendModeKey, "norm", 4); 
      layerInfo[i].pMaskBitmap = NULL; 
   } 
   nRet = L_CreateBitmapList(&hLayers); 
   if(nRet != SUCCESS) 
      return nRet; 
   /* load the bitmap for the first layer */ 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("layer0.bmp")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if(nRet != SUCCESS) 
   { 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   nRet = L_InsertBitmapListItem(hLayers,(L_UINT)-1, &Bitmap); 
   if(nRet != SUCCESS) 
   { 
      L_FreeBitmap (&Bitmap); 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   /* load the bitmap for the second layer */ 
   /* Note that I do not free the bitmap I just loaded because I inserted it in the list */ 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("layer1.bmp")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if(nRet != SUCCESS) 
   { 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   nRet = L_InsertBitmapListItem(hLayers, (L_UINT)-1, &Bitmap); 
   if(nRet != SUCCESS) 
   { 
      L_FreeBitmap (&Bitmap); 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   /* load the bitmap for the third layer */ 
   /* Note that I do not free the bitmap I just loaded because I inserted it in the list */ 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("layer2.bmp")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if(nRet != SUCCESS) 
   { 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   nRet = L_InsertBitmapListItem(hLayers, (L_UINT)-1, &Bitmap); 
   if(nRet != SUCCESS) 
   { 
      L_FreeBitmap (&Bitmap); 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   /* Load the bitmap that is made up of all the layers */ 
   memset(&Bitmap, 0, sizeof(Bitmap)); 
   nRet = L_LoadBitmap (MAKE_IMAGE_PATH(TEXT("ULAY1.BMP")), &Bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL); 
   if(nRet != SUCCESS) 
   { 
      L_DestroyBitmapList(hLayers); 
      return nRet; 
   } 
   /* Save this bitmap and all the layers */ 
   nRet = L_SaveBitmapWithLayers(MAKE_IMAGE_PATH(TEXT("Out_image.psd")), &Bitmap, FILE_PSD, 0, 0, hLayers, layerInfo, nLayers, NULL); 
   /* Free the bitmap */ 
   if(Bitmap.Flags.Allocated) 
      L_FreeBitmap (&Bitmap); 
   /* Free the layers bitmap list and all the bitmaps contained in it */ 
   L_DestroyBitmapList(hLayers); 
   return nRet; 
}

Help Version 19.0.2017.10.27

Products | Support | Contact Us | Copyright Notices
© 1991-2017 LEAD Technologies, Inc. All Rights Reserved.

LEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

LEADTOOLS Raster Imaging Features

Redistributables/Files To Be Included With Your Application

Functions:	L_LoadLayer, L_SaveBitmap, L_SaveFile, L_SaveFileOffset, L_SaveFile, L_FileConvert, L_SetComment, L_DlgSave, L_SaveFileMemory
Topics:	Raster Image Functions: Saving Files
	Loading and Saving Images