In This Topic ▼

l_CombineBitmapWarp

#include "l_bitmap.h"

l_LTKRN_APIl_INTl_CombineBitmapWarp(pBitmapDst, ptDstArray, pBitmapSrc, ptSrc, nSrcWidth, nSrcHeight, uFlags)

Combines image data from the source bitmap (the slave) and the destination bitmap (the master), using a perspective warp.

Parameters

pBITMAPHANDLEpBitmapDst

Pointer to the bitmap handle referencing the destination bitmap. This is the master bitmap and is the bitmap that the function updates.

l_POINTptDstArray

An array of POINT structures that contain the four points that define the warp area in the destination bitmap.

pBITMAPHANDLEpBitmapSrc

Pointer to the bitmap handle referencing the source bitmap. This is the slave bitmap, which is combined with the destination bitmap.

POINT structure that contains the point of origin of the source bitmap. This is the upper left corner. This point, along withnSrcWidthandnSrcHeightdefine the area of the source bitmap to be warped.

l_INTnSrcWidth

The width of the area in the source bitmap to be warped to the destination bitmap. This value, along withptSrcand nSrcHeight define the area of the source bitmap to be warped.

l_INTnSrcHeight

The height of the area in the source bitmap to be warped to the destination bitmap. This value, along withptSrcandnSrcWidthdefine the area of the source bitmap to be warped.

l_UINTuFlags

标志显示类型of interpolation to use, if interpolation is used. Possible values are:

Value	Meaning
0	No interpolation
CBW_BILINEAR	Bilinear interpolation. This value is only valid if the bits per pixel of the image is 1-bit, 8-bit grayscale, 12-bit without a lookup table, 16-bit without a lookup table, 24, 32, 48, or 64.

Returns

Value	Meaning
SUCCESS	The function was successful.
< 1	An error occurred. Refer toReturn Codes.

Comments

You can warp the entire source bitmap, or a portion of the source bitmap. To warp a portion of the source bitmap, setptSrc,nSrcWidthandnSrcHeightaccordingly. To warp the entire source bitmap, set the following:

ptSrc.x = 0;ptSrc.y = 0;nSrcWidth = pBitmapSrc.BitmapWidth;nSrcHeight = pBitmapSrc.BitmapHeight;

The warp area in the destination bitmap is specified inptDstArray. The polygon specified in ptDstArray must:

be concave.
fit entirely on the destination bitmap.

If either of these conditions is FALSE, this function will return an error.

The ordering of the points in ptDstArray can affect the resulting warp. For example, if the source bitmap is the following:

$image\WarpEx1.gif$

then ordering the points in ptDstArray as shown below results in the following warp:

$image\WarpEx2.gif$

while ordering the points inptDstArrayas shown below, results in the following warp:

$image\WarpEx3.gif$

Required DLLs and Libraries

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

Platforms

Win32, x64, Linux.

Functions

Topics

Example

l_INT CombineBitmapWarpExample(L_VOID){l_INT nRet;BITMAPHANDLE Master;BITMAPHANDLE Slave;POINT ptSrc = {0,0};POINT aptsDest[4]= {{50,50},{100,75},{100,150},{50,100}};//load images as 24-bit, so we don't have to worry about palettesnRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("master.jpg")), &Master,运算符(BITMAPHANDLE), 24, ORDER_BGR, NULL, NULL);if(nRet != SUCCESS)returnnRet;nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("cannon.jpg")), &Slave,运算符(BITMAPHANDLE), 24, ORDER_BGR, NULL, NULL);if(nRet != SUCCESS)returnnRet;nRet = L_CombineBitmapWarp(&Master,aptsDest,&Slave,ptSrc,Slave.Width, Slave.Height,CBW_BILINEAR);if(nRet != SUCCESS)returnnRet;nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.jpg")), &Master, FILE_JPEG, 0, 2, NULL);if(nRet != SUCCESS)returnnRet;if(Master.Flags.Allocated)l_FreeBitmap(&Master);if(Slave.Flags.Allocated)l_FreeBitmap(&Slave);returnSUCCESS;}

Download our FREE evaluation

Help Version 21.0.2021.7.5

lEADTOOLS Raster Imaging C API Help

Introduction

Version History

Getting Started

费尔es To Be Included With Your Application

Document Writers – Files To Be Included With Your Application

lEADTOOLS Raster Imaging Features

Quick Reference

Tutorials

Function References

Callback Functions

Summary of Features

Appendix