#include "ltimgkrn.h"
L_LTIMGKRN_API L_INT L_ImgKrnCropImage(bitmap, rect)
Crops the bitmap, resulting in a bitmap having the size of the specified rectangle.
Pointer to the bitmap handle referencing the bitmap to be cropped.
The rectangular area to which the bitmap will be cropped.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
This function uses bitmap coordinates to specify the area to be cropped. Therefore, you must account for the view perspective of the bitmap.
Note: All functions with the L_ImgKrn prefix modify the underlying properties of the input BITMAPHANDLE, including but not limited to:
To avoid BITMAPHANDLE property fidelity loss, pass a copy of your BITMAPHANDLE to all L_ImgKrn* functions.
Required DLLs and Libraries
Win32, x64, Linux.
This example loads an image and crops it.
L_INT KrnCropImageExample(L_VOID)
{
L_INT ret;
BITMAPHANDLE bitmap; /* Bitmap handle to hold the loaded image. */
L_RECT cropBounds; /* Area to keep. */
/* Load the bitmap */
ret = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("cannon.jpg")), &bitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL);
if (ret != SUCCESS)
return ret;
/* Crop half the image */
cropBounds.left = 0;
cropBounds.top = 0;
cropBounds.right = bitmap.Width / 2;
cropBounds.bottom = bitmap.Height;
ret = L_ImgKrnCropImage(&bitmap, &cropBounds);
if (ret == SUCCESS)
ret = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &bitmap, FILE_BMP, 24, 0, NULL);
L_FreeBitmap(&bitmap);
return ret;
}
Help Collections
Raster .NET | C API | C++ Class Library | HTML5 JavaScript
Document .NET | C API | C++ Class Library | HTML5 JavaScript
Medical .NET | C API | C++ Class Library | HTML5 JavaScript
Medical Web Viewer .NET
Multimedia
Direct Show .NET | C API | Filters
Media Foundation .NET | C API | Transforms
Supported Platforms
.NET, Java, Android, and iOS/macOS Assemblies
Imaging, Medical, and Document
C API/C++ Class Libraries
Imaging, Medical, and Document
HTML5 JavaScript Libraries
Imaging, Medical, and Document
Your email has been sent to support! Someone should be in touch! If your matter is urgent please come back into chat.
Chat Hours:
Monday - Friday, 8:30am to 6pm ET
Thank you for your feedback!
Please fill out the form again to start a new chat.
All agents are currently offline.
Chat Hours:
Monday - Friday
8:30AM - 6PM EST
To contact us please fill out this form and we will contact you via email.