
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