LEADTOOLS Raster Imaging C DLL Help > Function References > L_IgnoreFilters |
#include "l_bitmap.h"
L_LTFIL_API L_INT L_IgnoreFilters(pszFilters)
L_TCHAR* pszFilters; |
/* character string containing filters */ |
Specifies which file filters LEADTOOLS should NEVER load, even if present.
Parameter |
Description |
pszFilters |
Character string containing which filters should be ignored and therefore not loaded. pszFilters has the same format as in L_PreLoadFilters . |
Returns
SUCCESS |
The function was successful. |
< 1 |
An error occurred. Refer to Return Codes. |
Comments
Use this function if you never want to load a particular file filter(s).
The files specified in L_PreLoadFilters take priority over the files specified in L_IgnoreFilters. This means that if the filter is present in pszFilters for both methods, then the filter will be loaded and will not be ignored.
In case the current ignored filters list should be changed, call the L_GetIgnoreFilters function before calling this function.
Required DLLs and Libraries
For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application. |
Platforms
Win32, x64, Linux.
See Also
Functions: |
L_PreLoadFilters, L_GetIgnoreFilters, L_GetPreLoadFilters, L_SetFilterInfo |
Topics: |
Raster Image Functions: Input/Output File Filters, Files To Be Included With Your Application |
Example
This example tells LEADTOOLS not to load the CMP filter. Ignore CMP filter, never load CMP or JPEG files
L_INT IgnoreFiltersExample(L_VOID) { L_INT nRet; nRet = L_IgnoreFilters(TEXT("CMP")); if(nRet != SUCCESS) return nRet; return SUCCESS; }