Distorts the bitmap with two perpendicular waves at the specified angle and with the specified wave type.
#include "l_bitmap.h"
L_LTIMGSFX_API L_INT L_WaveBitmap(pBitmap, uAmplitude, uWaveLen, nAngle, uHorzFact, uVertFact, crFill, uFlags)
Pointer to the bitmap handle that references the bitmap on which to apply the effect.
Waves magnitude. The values range from 1 to the length of the image's diagonal.
Value that represents the wave length, if DIS_PER is set in the uFlags
parameter. Possible values range from 1 - 100 and give the wavelength as a percentage of the bitmap dimensions. If DIS_FRQ is set in uFlags, this value is the number of repeated waves.
Waves rotation angle in hundredths of degrees. The valid range is from -18000 to 18000 (The value in degrees is nAngle divided by 100).
Size of the horizontal wave, given as a percentage. The valid range is from 0 to 100.
Size of the vertical wave, given as a percentage. The valid range is from 0 to 100.
The COLORREF value that specifies the fill color for any exposed areas. You can specify a COLORREF value, such as the return value of the Windows RGB macro, or you can use the PALETTEINDEX macro to specify a palette color.
Flags that indicate how to handle exposed areas, the type of information in the uWaveLen parameter and the wave type. You can use a bitwise OR ( | ) to specify one flag from each group.
Value | Meaning |
---|---|
FILL_CLR | [0x0000] Fill any exposed areas with crFill . |
FILL_RPT | [0x0001] Stretch the image edges to fill the exposed area. |
FILL_NOCHG | [0x0002] Leave the exposed area as is, without changing it. |
uWaveLen
parameter:Value | Meaning |
---|---|
DIS_PER | [0x0000] The value in uWaveLen is a wavelength given as a percent of the bitmap dimensions. If this value is used, the valid range of uWaveLen is from 0 to 100. |
DIS_FRQ | [0x0010] The value in uWaveLen is the frequency, or the number of times the wave repeats. |
Value | Meaning |
---|---|
WV_SIN | [0x0000] The wave is a sinusoidal wave. |
WV_COS | [0x0100] The wave is a sinusoidal wave shifted by 90 degrees. |
WV_SQUARE | [0x0200] The wave is a square wave. |
WV_TRIANG | [0x0300] The wave is a triangular wave. |
Value | Meaning |
---|---|
SUCCESS | The function was successful. |
< 1 | An error occurred. Refer to Return Codes. |
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.
The function applies two perpendicular waves. The uHorzFact
and uVertFact
parameters control the size of these waves.
If the bitmap has a region, the effect will be applied on the region only.
This function supports 12- and 16-bit grayscale and 48- and 64-bit color images. Support for 12- and 16-bit grayscale and 48- and 64-bit color images is available in the Document and Medical Imaging toolkits.
To update a status bar or detect a user interrupt during execution of this function, refer to L_SetStatusCallback.
This function does not support 32-bit grayscale images. It returns the error code ERROR_GRAY32_UNSUPPORTED if a 32-bit grayscale image is passed to this function.
Wave Function - Before
Wave Function - After
View additional platform support for this Wave function.
Win32, x64.
L_INT WaveBitmapExample(L_VOID)
{
L_INT nRet;
BITMAPHANDLE LeadBitmap; /* Bitmap handle for the image */
/* Load a bitmap at its own bits per pixel */
nRet = L_LoadBitmap(MAKE_IMAGE_PATH(TEXT("sample5.cmp")), &LeadBitmap, sizeof(BITMAPHANDLE), 0, ORDER_BGR, NULL, NULL);
if (nRet != SUCCESS)
return nRet;
/* apply sinusoidal waves on the image*/
nRet = L_WaveBitmap(&LeadBitmap, 20, 25, 0, 100, 100, 0, FILL_RPT | DIS_PER | WV_SIN);
if (nRet != SUCCESS)
return nRet;
nRet = L_SaveBitmap(MAKE_IMAGE_PATH(TEXT("Result.BMP")), &LeadBitmap, FILE_BMP, 24, 0, NULL);
if (nRet != SUCCESS)
return nRet;
//free bitmap
if (LeadBitmap.Flags.Allocated)
L_FreeBitmap(&LeadBitmap);
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