A very simple tkinter prompt window with an animated gradient background.
Installation:
pip install gradientmessagebox
Several Presets that require basic configuration:
from gradientmessagebox import ColorConfig, PresetLoadingMessage, PresetImageBgMessage, PresetChoiceWindow, PresetChoiceEntryWindow, PresetMultiTextChoice, PresetCopyTextWindow, PresetUserPasswordWindowPresetLoadingMessage:
'''Basic loading indicator that can create a custom Loading message, plays a simple text animation.'''
loading = PresetLoadingMessage('LOADING')
loading.Play()
time.sleep(10)
loading.Close()PresetIageBackgroundImage:
'''Basic text pop up.'''
loading = PresetImageBgMessage('SPLASH')
loading.Show()
time.sleep(10)
loading.Close()PresetChoiceWindow:
'''
Basic choice window with an accept and a reject button.
returns the text of the clicked button
'''
loading = PresetChoiceWindow()
loading.Ask('Cool?', 'Yup', 'Nope')PresetChoiceEntryWindow:
'''
Basic choice window with a text entry, an accept button, and a reject button.
returns the text of the entry, or reject button
'''
prompt = PresetChoiceEntryWindow()
propt.Ask('Why so Cool?', 'Enter', 'Nope')Â
PresetChoiceMultilineEntryWindow:
'''
Basic choice window with a multi line text entry, and an accept and a reject button.
returns the text of the entry, or reject button
'''
prompt = PresetChoiceMultilineEntryWindow()
propt.Ask('Coolness details:', 'Enter', 'Nope')Â
All window objects text and color attributes can be configured, here are some examples:
popup = PresetChoiceWindow()
'''After creating various attributes can be configured
Here we lighten the foreground, and darken the background
By Default, foreground is the text color, and background is the widget surface color.'''
popup.fg_luminance(0.65)
popup.bg_luminance(0.35)
'''If you want to invert the foreground and background colors:'''
config.invert()
'''On instantiation a midground color is created, based on the
the color that is halfway between the foreground and background.
To swap the midground for the foreground or background:'''
popup.swap_mg_for_fg()
##or
popup.swap_mg_for_bg()
'''Here we reduce the saturation of the gradient used on the pop up background
We could also lighten or darken it with config.gradient_luminance'''
popup.gradient_saturation(0.5)
'''Set the text to a custom color with'''
popup.custom_txt_color('red')#use web color codesÂ
Pop ups can also be configured with a config object, for more customization:
from gradientmessagebox import ColorConfig, ChoiceWindow, MultiTextChoice, CopyText, UserPasswordWindow
'''Create the color configuration for the dialog:'''
config = ColorConfig(width=450, height=300, color1="#00ffff", color2="#ffa500", alpha=1.0, saturation=1.0, direct='+x', hasframe=True)Color colors can be manipulated per element:
'''Here we lighten the foreground, and darken the background
By Default, foreground is the text color, and background is the widget surface color.'''
config.fg_luminance(0.65)
config.bg_luminance(0.35)
'''If you want to invert the foreground and background colors:'''
config.invert()
'''On instantiation a midground color is created, based on the
the color that is halfway between the foreground and background.
To swap the midground for the foreground or background:'''
config.swap_mg_for_fg()
##or
config.swap_mg_for_bg()
'''Here we reduce the saturation of the gradient used on the pop up background
We could also lighten or darken it with config.gradient_luminance'''
config.gradient_saturation(0.5)
'''This call will add an image to the pop up background on
top of the gradient. If logo is set, a logo for the window
is applied. If useImgSize is True, the pop up size is based on
the image size passed.'''
config.imagery(path='./test-bg.png', icon_path='./logo.png', useImgSize=False)
animation can be applied to the gradient background of the pop up:
'''Speed is in ms, so lower is faster
Stretch, lengthens the gradient, generally makes it look
better if it's a little longer in length.'''
config.animation(speed=10, stretch=2)Example1 ~ Choice Window:
'''Create the window:'''
choice = ChoiceWindow(config)
'''Create a simple pop up, with option to add a text entry field,
Without the field, the popup returns the text of the button pressed
With an entry field, the accept button returns the text from the entry field.'''
answer = choice.Ask(msg='What's up?', b_accept='Chillin', b_decline='Nah', entry=False, horizontal=True)
print(answer.response)
'''Returns: "Chillin"'''There are currently 4 window types:
ChoiceWindow, MultiTextChoice, CopyText, UserPasswordWindow
Each Window has an Ask('your prompt') method which will pop the window.
