DevIL Documentation Home | Previous | Next

ilHint

The ilHint function specifies implementation-specific hints.


ILvoid ilHint(
  ILenum Target,
  ILenum Mode
);

Parameters

Target
An enum indicating what behaviour of the library is to be controlled. The following values are accepted:

IL_MEM_SPEED_HINT
Controls the memory used vs. speed tradeoff.
IL_COMPRESSION_HINT
Controls whether compression is used when saving images.

Mode
The desired behaviour. The following values are accepted:

IL_FASTEST
Makes the target use a faster but more memory-intensive algorithm.
IL_LESS_MEM
Makes the target use less memory but a potentially slower algorithm.
IL_USE_COMPRESSION
Specifies that OpenIL should use compression when saving, if possible.
IL_NO_COMPRESSION
Specifies that OpenIL should never use compression when saving.
IL_DONT_CARE
The client does not have a preference.

Remarks

ilHint lets the user control aspects of OpenIL's behaviour, in order to optimize either speed, memory, compression or quality, depending wholly on what the user desires.

Error Codes

IL_INVALID_ENUM - Either Target or Mode was an invalid enum.

See Also

ilLoadImage