=head1	NAME

Tk::mySplashScreen - annother Perl/Tk implementation of a splash screen


=head1	TO DO

=over
	
=item	write test scripts

=back


=head1	SYNOPSIS


use Tk;
require Tk::mySplashScreen;

my $Splash = Tk::mySplashScreen->new(
	
	-image	=> "/path/to/image.gif",
	
	-text	=> "this is a splash screen"

);

$Splash->configure(-text => "new message");

$Splash->configure(-image => $newTKimageObject);

$Splash->configure(-image => "path/to/new/file.gif");

$Splash->configure(-anchor => 'n|s|e|w');

$Splash->configure(-hide => 1);		#hide it

$Splash->configure(-hide => 0);		#unhide it (if already hidden)	

$myContentFrame = $Splash->AltContent();

$Splash->destroy();



=head1	new	(Constructor)

=head2	Notes

The new method creates a new toplevel window and puts an image and 
a message in it. Note that there is no parent widget.


=head2	Options

=over

=item	-text

this is the message text you wish to display in the splash screen

=item	-image

this is alternately, the path to a file containing a supported image type, or a reference to a
pre-existing Tk::Image object. In either case the image is displayed in the splash screen window.


=back



=head1	hide

=head2	Notes

this will hide (undraw) the splash screen, but not destroy the object.



=head1	unhide

head2	Notes

this will unhide a hidden splash screen. Obviously, this dosen't do much unless the 
window has already been hidden.


=head1	AltContent

=head2	Notes

this allows you to add custom content on the splash screen between the image and the message
display. This is handy if, for instance, you want to ask for a username and password before 
showing your main program or whatever. This works by returning a frame reference. You can pack
whatever you want into the frame. When you're done, just destroy the frame reference.

=head2	Example


$frame = $Splash->AltContent();

$frame->label(-text => "enter your password")->pack();

$frame->entry(
	-width => 20, 
	-show => '*', 
	-variable => \$pass
)->pack();

..etc


=head1	Author

Andrew N. Hicox	<andrew@hicox.com>

