phoenix_title wx.lib.agw.advancedsplash

AdvancedSplash tries to reproduce the behavior of SplashScreen, with some enhancements.

Description

AdvancedSplash tries to reproduce the behavior of SplashScreen, but with some enhancements (in my opinion).

AdvancedSplash starts its construction from a simple frame. Then, depending on the options passed to it, it sets the frame shape accordingly to the image passed as input. AdvancedSplash behaves somewhat like SplashScreen, and almost all the methods available in SplashScreen are available also in this module.

Usage

Sample usage:

import wx
import wx.lib.agw.advancedsplash as AS

app = wx.App(0)

frame = wx.Frame(None, -1, "AdvancedSplash Test")

imagePath = "my_splash_image.png"
bitmap = wx.Bitmap(imagePath, wx.BITMAP_TYPE_PNG)
shadow = wx.WHITE

splash = AS.AdvancedSplash(frame, bitmap=bitmap, timeout=5000,
                           agwStyle=AS.AS_TIMEOUT |
                           AS.AS_CENTER_ON_PARENT |
                           AS.AS_SHADOW_BITMAP,
                           shadowcolour=shadow)

app.MainLoop()

None of the options are strictly required (a part of the bitmap parameter). If you use the defaults you get a very simple AdvancedSplash.

Methods and Settings

AdvancedSplash is customizable, and in particular you can set:

  • Whether you want to mask a colour or not in your input bitmap;

  • Where to center the splash screen (on screen, on parent or nowhere);

  • Whether it is a “timeout” splashscreen or not;

  • The time after which AdvancedSplash is destroyed (if it is a timeout splashscreen);

  • The (optional) text you wish to display;

  • The font, colour and position of the displayed text (optional).

Window Styles

This class supports the following window styles:

Window Styles

Hex Value

Description

AS_TIMEOUT

0x1

AdvancedSplash will be destroyed after timeout milliseconds.

AS_NOTIMEOUT

0x2

AdvancedSplash can be destroyed by clicking on it, pressing a key or by explicitly call the Close() method.

AS_CENTER_ON_SCREEN

0x4

AdvancedSplash will be centered on screen.

AS_CENTER_ON_PARENT

0x8

AdvancedSplash will be centered on parent.

AS_NO_CENTER

0x10

AdvancedSplash will not be centered.

AS_SHADOW_BITMAP

0x20

If the bitmap you pass as input has no transparency, you can choose one colour that will be masked in your bitmap. the final shape of AdvancedSplash will be defined only by non-transparent (non-masked) pixels.

Events Processing

No custom events are available for this class.

License And Version

AdvancedSplash control is distributed under the wxPython license.

Latest revision: Andrea Gavana @ 19 Dec 2012, 21.00 GMT

Version 0.5

class_summary Classes Summary

AdvancedSplash

AdvancedSplash tries to reproduce the behavior of SplashScreen, with