ImageGear for C and C++ on Windows v19.1 - Updated
IG_util_MMX_usage_set
API Reference Guide > Core Component API Reference > Core Component Functions Reference > Utility Functions > IG_util_MMX_usage_set

This function tells ImageGear whether or not to optimize for MMX hardware.

Declaration:

 
Copy Code
AT_ERRCOUNT LACCUAPI IG_util_MMX_usage_set(BOOL bMMXUsage);

Arguments:

Name Type Description
bMMXUsage BOOL Set to TRUE to turn on MMX optimization; FALSE to turn off MMX optimization.

Return Value:

Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.

Supported Raster Image Formats:

This function does not process image pixels.

Sample:

JPEG

The JPEG sample demonstrates loading images with or without MMX support.

Example:

 
Copy Code
AT_ERRCOUNT   nErrcount;
bMMXusage = TRUE;
nErrcount = IG_util_MMX_usage_set(bMMXusage);

Remarks:

Set lpbMMXUsage to TRUE to instruct ImageGear to optimize for MMX technology if the computer contains MMX hardware.

If you set bMMXUsage = TRUE, MMX technology will be used if it is detected. If it is not detected, no error will be generated, and MMX optimization will not be used.

Currently, the JPEG Lossy Compression is the target area for optimization.

See also IG_util_MMX_usage_get() function.