| GraySetInt1Handler | Function (Macro)

gray.h

void GraySetInt1Handler (INT_HANDLER handler);

Sets the interrupt handler executed by the grayscale algorithm.

GraySetInt1Handler sets the interrupt handler which is called internally by the grayscale support to handler. Using this function, you can redirect this interrupt even in grayscale mode.
The interrupt handler called by the grayscale routines looks something like this (pseudo-code):

    DEFINE_INT_HANDLER (GrayInt1Handler)
    {
      SwitchPlanes ();
      ExecuteHandler (OldInt1);
    }

where OldInt1 is the previous AUTO_INT_1 handler. GraySetInt1Handler sets the value of OldInt1 to handler. Note that this is just a C-style declaration of the AUTO_INT_1 handler for grayscale; the actual one is implemented in assembly.
Note: Always reset the handler to the previous value (returned by GrayGetInt1Handler) before turning off grayscale, otherwise it will be installed as a permanent interrupt handler.

Deprecated alias: SetGrayInt1Handler

See also: GrayGetInt1Handler, intr.h