#include "BIFILTER.H"
HANDLE CALLBACK FilterMultiply( HDIB hDIB,
int iFactor,
int iShowProgress,
HWND hParent)
Description
This function multiplies each pixel by iFactor/10. The filter can be used to make an image lighter or darker on a linear scale.
Examples
The original 160 x 170 pixel image and the multiplied one by iFactor = 12.
Parameters
|
HDIB |
hDIB |
Handle of the DIB to filter. |
|
int |
iFactor |
The value used by the multiplication. iFactor cannot be less than zero. |
|
int |
iShowProgress |
This parameter specifies the displaying of the progressbar and the preview dialog. Available values: DISPLAY_NONE (0) - The progressbar and the preview dialog will not display before filtering. DISPLAY_PROGRESS (1) -The progressbar will display during filtering procedure. DISPLAY_DIALOG (2) - The preview dialog will display before filtering. This dialog shows the part of the image before and after filtering. DISPLAY_BOTH (3) - The progressbar and the preview dialog will display. IMPORTANT: The preview dialog will only display, if there is BiDlgs.dll installed. |
|
HWND |
hParent |
Handler of the parent window. |
Return values
The handle of the new filtered DIB or NULL if an error occurred.
Programming notes
The function will not free the input DIB.
Requirements
Header : Declared in BIFilter.h; include BIFilter.h.
Library : Use BIFilter.lib.
DLLs : BIFilter.dll , BIDlgs32.dl.