L_IgnoreFilters

#include "l_bitmap.h"

L_INT EXT_FUNCTION L_IgnoreFilters(pszFilters)

L_TCHAR L_FAR * 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). This is useful for instance if you never load AVI files and you want to ignore the AVI filter since this filter on its own loads all the DLLs required for Video for Windows (there are about 10 of them).

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.

Required DLLs and Libraries

LTFIL

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

Windows 95 / 98 / Me, Windows 2000 / XP, Windows CE.

See Also

Functions:

L_PreLoadFilters, 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_IgnoreFilters
(TEXT("CMP"));