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