kill-splash-screen-when-ready

Arguments: project

Returns whether the standalone application that is generated from the specified project will close the application's splash screen as soon as the standalone application has finished starting up. The setf of this function may be called to set this option for a project. The default value is t.

When this option is true, the user may begin using the app as soon as possible, rather than waiting until the splash screen goes away after an arbitrary amount of time. (See the descriptions of the +b and +Bt arguments in Command line arguments in startup.htm. Those arguments control the initial display of a splash screen. The screen is shown for a certain amount of time. kill-splash-screen-when-ready allows you to kill the splash screen sooner if desired.) If, on the other hand, the app comes up very quickly and you want the user to have more time to view the splash screen, then you may want to turn this option off.

When a standalone application that was generated from a project starts up, the function do-default-restart (which is normally the on-restart function of a project) calls the project's on-initialization function, and then calls kill-splash-screen if (kill-splash-screen-when-ready (app *system*)) returns true. (The project no longer exists in the standalone app, and so the value is cached on the "app" object.)

This option requires the cg.os-window Common Graphics module, which will be included automatically when needed by the Find Required CG Modules button on the Project Manager dialog's Include tab.

Copyright (c) 1998-2006, Franz Inc. Oakland, CA., USA. All rights reserved.
Documentation for Allegro CL version 7.0. This page is new in the 7.0 release.
Created 2005.9.20.