Converts a 1-, 4-, 8-, 16-, 24-, or 32-bit bitmap to a halftoned bitmap, with a specified pattern rotation. A halftoned bitmap is a 1-bit bitmap that has been dithered for black and white printing or display.
#include "ltwrappr.h"
virtual L_INT LBitmap::HalfTone(uType, nAngle, uDim, hBitmapList, uFlags = 0)
virtual L_INT LBitmap::HalfTone(uType, nAngle, uDim, pBitmapList, uFlags = 0)
Value that indicates the type of halftoning to perform. Possible values are:
Value | Meaning |
---|---|
HT_PRINT | [0x0000] Halftone for printing |
HT_VIEW | [0x0001] Halftone for display |
HT_RECT | [0x0002] Rectangular halftone |
HT_CIRC | [0x0003] Circular halftone |
HT_ELLIPS | [0x0004] Elliptical halftone |
HT_RAND | [0x0005] Random halftone |
HT_LINEAR | [0x0006] Linear halftone |
HT_USERDEF | [0x0007] User-defined halftone |
The angle of rotation, expressed in hundredths of degrees. A value of 0 produces a horizontal halftone pattern. This parameter specifies the number of degrees to change the pattern. Positive values rotate the pattern clockwise; negative values rotate the pattern counterclockwise. This value is ignored if the selected halftone pattern is HT_RECT, HT_CIRC or HT_RAND or HT_USERDEF.
Value that indicates the size of the grain. This value is ignored if the selected halftone pattern is HT_VIEW or HT_PRINT. If the pattern is not HT_VIEW or HT_PRINT, uDim should be >= 1. If this parameter is < 1 this function will return ERROR_INV_PARAMETER (-13).
Handle to the list of bitmaps that will be used in halftoning if the HT_USERDEF option is selected.
Pointer to LBitmapList object that will be used in halftoning if the HT_USERDEF option is selected.
Reserved for future use. Must be 0.
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
For the HT_USERDEF option, the number of bitmaps in the list must be at least equal to (uDim * uDim + 1). Bitmaps with higher indexes correspond to higher intensity values.
This function can process the whole image or a region of the image.
This function does not support 12 and 16-bit grayscale and 48 and 64-bit color images.
To update a status bar or detect a user interrupt during execution of this function, refer to LBase::EnableStatusCallback.
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.
This function supports 32-bit grayscale images.
Halftone Function - Before
Halftone Function - After
View additional platform support for this Halftone function.
Win32, x64.
L_INT LBitmap__HalfToneExample(LBitmap & Bitmap, L_TCHAR * pszFile)
{
L_INT nRet;
nRet =Bitmap.Load(pszFile);
if(nRet !=SUCCESS)
return nRet;
nRet =Bitmap.HalfTone(HT_ELLIPS, 4500, 5, (LBitmapList*)NULL);
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
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.