DevIL Documentation Home | Previous | Next

ilPushAttrib

The ilPushAttrib function pushes the states indicated by bits onto the state stack.


ILvoid ilPushAttrib(
  ILuint Bits
);

Parameters

Bits
Attribute bits to push. Values accepted are:
IL_ORIGIN_BIT
Preserves the origin state set by ilOriginFunc.
IL_FILE_BIT
Preserves whether OpenIL is allowed to overwrite files when saving (set by ilEnable, ilDisable).
IL_PAL_BIT
Preserves whether OpenIL is supposed to convert palette'd to truecolour images (set by ilEnable, ilDisable).
IL_ALL_ATTRIB_BITS
Preserves all OpenIL states and attributes.

Remarks

ilPushAttrib pushes a new set of modes and attributes onto the state stack, allowing for "a fresh start".

Error Codes

IL_STACK_OVERFLOW - The stack was pushed more times than the current OpenIL implementation allows. Use ilPopAttrib to clear the stack. OpenIL implementations must support a stack depth of at least 32.

See Also

ilPopAttrib