Arguments: stream &optional invalidate-p update-colors-p
The function maps the current palette of stream into the hardware palette, so that the window's colors are in active use. This may be useful after another window (or another application) has mapped its colormap, possibly displacing from the single hardware palette the palette that was established for stream via (setf palette).
When a top-level Allegro CL window is brought in front of other
top-level windows (as when Alt-Tab is used), then the palette of that
top-level window is realized automatically. Thus, calling
realize-palette is not necessary unless you use multiple palettes
under a single top-level window or some palette assigned to a
lower-level window is not also assigned to its top-level
parent. Recall that a top-level window is one whose parent is (screen
*system*).
Note: incompatible change in release 6.0: in releases prior
to 6.0, when a frame-with-single-child instance
was passed to this operator, the operator was actually applied to the
child (the result of applying frame-child to the
frame-with-single-child instance). In release 6.0, this redirection no
longer occurs. If you intend this operator to apply to the
frame-child, pass that to this operator rather than the parent. This
is a non-backward-compatible-change. See the release notes for more
information.
Common Graphics and IDE documentation is described in About Common Graphics and IDE documentation in cgide.htm.
The documentation is described in introduction.htm and the index is in index.htm.
Copyright (c) 1998-2000, Franz Inc. Berkeley, CA., USA. All rights reserved.
Created 2000.10.5.