Splash window tags
Warning
This article describes a deprecated feature as of Panda3D 1.10.0.
The following table lists the custom P3D tokens that you may specify within the <object> element, as described in Advanced object tags. You can use these settings to customize the look of the app’s embedded frame whenever the Panda3D window is not being displayed, e.g. before or after launch.
When deploying an application for the desktop, you can specify these tags with
the -t tag=value
flag to pdeploy.
Token |
Meaning |
---|---|
splash_img |
The URL of an image to display in the plugin space, anytime before Panda starts running (unless a more specific image, below, overrides) |
download_img |
The image to display while the p3d file and its required packages are being downloaded |
unauth_img |
The image to display when the app is unrecognized, and is waiting for the user to click the red “authorize” button |
ready_img |
The image to display when the app is ready to run, and waiting for the user to click the green “play” button |
failed_img |
The image to display when the app cannot launch for some reason (e.g. bad URL) |
launch_img |
The image to display while the app is launching: the time after the user has clicked “play” and before it actually opens its Panda3D window |
active_img |
The image to display while the app is running (but the app has taken its window out of the frame) |
noplugin_img |
This is available only if you use the RunPanda3D.js method of embedding your p3d file. In this case, this specifies the image to display if the plugin is not installed or cannot be run for some reason. |
noplugin_href |
As above, this is available only if you use the RunPanda3D.js method of embedding your p3d file, and it specifies the URL that the user should be taken to if he or she clicks on the embed region when the plugin is not installed. A good choice, for instance, is https://www.panda3d.org/get . |
auth_ready |
The three images that define the normally red “authorize” button |
auth_rollover |
|
auth_click |
|
play_ready |
The three images that define the normally green “play” button |
play_rollover |
|
play_click |
|
fgcolor |
The text color of the text that may appear in the window, default is black. |
bgcolor |
The background color of the window before the app has launched, default is white. |
barcolor |
The fill color of the loading bar that is shown before the app launches |
bar_bgcolor |
The background color of the loading bar. If not set, the bgcolor is used. |
bar_border |
The width of the border around the loading bar, in pixels. Set to 0 to disable the border. |
bar_bottom |
The number of pixels between the bottom of the window and the bottom edge of the loading bar. |
bar_width |
Width of the loading bar, in pixels. Alternatively, you may specify it as a percentage of the window width, eg. ‘60%’ |
bar_height |
Height of the loading bar, in pixels. Alternatively, you may specify it as a percentage of the window height, eg. ‘5%’ |
font_family |
Specify which font to use for the text that may appear in the splash window. Default is ‘Helvetica’. |
font_size |
The font size, in pixels. Default is 12. |
font_style |
Changes the slant of the font. Acceptable values are ‘normal’, ‘oblique’ and ‘italic’. |
font_weight |
This may be set to ‘bold’ in order to make the font bold. Some platforms may support a numeric value between 100 and 900 (in increments of 100), where 100 is lightest, 400 is normal, and 900 is black. |