realize-palette

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). stream should be a cg-stream.

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*) (see screen and *system*).

Copyright (c) 1998-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page was not revised from the 8.1 page.
Created 2010.1.21.