virtual L_INT LBitmapBase::Trim(nCol, nRow, uWidth, uHeight)
virtual L_INT LBitmapBase::Trim(prcTrim)
Crops the class object's bitmap, resulting in a new bitmap that is the size of the specified rectangle. If a region is defined for the bitmap, the region is also cropped if necessary.
The X coordinate of the pixel within the bitmap that is the origin of the rectangle to keep.
The Y coordinate of the pixel within the bitmap that is the origin of the rectangle to keep.
Width of the rectangle to keep (in pixels).
Height of the rectangle to keep (in pixels).
Pointer to a RECT structure that contains information about the rectangle to keep.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
Use this function instead of LBitmapBase::CopyRect when the original bitmap is not needed after cropping.
This function uses bitmap coordinates to specify the area to be copied. Therefore, you must account for the view perspective of the bitmap. For information about bitmap coordinates, refer to Accounting for View Perspective.
Win32, x64.
This is an example for LBitmapBase::Trim(nCol,
nRow, uWidth, uHeight):
L_INT LBitmapBase__TrimExample()
{
L_INT nRet;
LBitmapBase MyBitmap;
MyBitmap.SetFileName(MAKE_IMAGE_PATH(TEXT("image1.cmp")));
nRet =MyBitmap.Load(24);
if(nRet !=SUCCESS)
return nRet;
nRet =MyBitmap.Trim(10,15,100,200);
if(nRet !=SUCCESS)
return nRet;
return SUCCESS;
}
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