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 could be used to programmatically set the value of this property, though typically you would set set it interactively with the Kill the Splash Screen When the App Is Ready check-box on the Build tab of the Project Manager dialog. 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, +Bt, and +Bp arguments in Command line arguments in startup.htm. Those arguments control the initial display of a splash screen. +b and +Bt display the splash screen for three seconds, while +Bp displays it until the user clicks on it. 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-2016, Franz Inc. Oakland, CA., USA. All rights reserved.
This page has had moderate revisions compared to the 8.1 page.
Created 2016.6.21.