#include "BIFILTER.H"
HANDLE CALLBACK FilterAverage ( HDIB hDIB,
int N,
int iShowProgress,
HWND hParent)
Description
This function performes an averaging on a pixel’s local environment. The size of the used matrix is adjustable by pararmeter N. Average filter is usually used for small noise removal. This function works for only for 8 and 24 bit per pixel images.
Examples
The original 160 x 170 pixel image and the difference filtered image with N = 3.
Parameters
|
HDIB |
hDIB |
Handle of the DIB to filter. |
|
BYTE |
N |
Size of used matrix, cannot be less then 1. |
|
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.