set-splash-bitmap

Function

Package: system

Arguments: &key filename data title

Windows only.

Sets the splash bitmap to be stored in subsequent dumplisp images and then displayed when those images are started.

The value of the title keyword argument should be a string. If unsupplied, "Allegro starting" (the string used by Allegro CL) is used. The title does not appear in the window displaying the splash bitmap but in tools such as the icon bar.

Exactly one of the keywords filename and data should be supplied. If filename is supplied -- the value should be a namestring or pathname -- then it is the name of a file that contains a device independent bitmap. Such a file typically has the extension .bmp or .dib and the contents must begin with the two characters "BM". When set-splash-bitmap is called, it reads the contents of that file into the Lisp heap, thus the bitmap file needn't exist later when the dumplisp is done or the image is restarted. It need only exist when this function is called.

If the data keyword is given, then its value must be an one-dimensional simple-array of type (unsigned-byte 8). The contents of the array is the bitmap, beginning with the bitmapinfo header. This is different than a bitmap stored on the disk (and read when the filename keyword is given) which begins with a 14 byte bitmap file header.

The user-defined splash bitmap used when an image starts will be saved by subsequent calls to dumplisp, except when the +B command line option is used for the image doing the dumplisp.

The documentation is described in introduction.htm and the index is in index.htm.

Created 2000.10.5.