| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |
Arguments: &key filename data title
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
.
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.
| Allegro CL version 8.2 Unrevised from 8.1 to 8.2. 8.1 version |