File: pymailgui-products/unzipped/docetc/ICONS/_README.txt

Icons for use in windows, desktop shortcuts, launcher, and documentation.

*Do not delete this folder*: the documentation and launcher use some of its files.
 
Icon usage hints:

Windows window-border icons
    Windows users: copy any "mb*.ico" to the top-level "PyMailGui-PP4E" folder to use
    it as an alternative window-border icon.  The PP4E GUI tools imported and used by 
    PyMailGUI pick up a local-dir Windows icon automatically if present (else the GUI 
    tools folder's blue "PY" icon from the book is used by default).  

    PyEdit always uses its own icons located in its own folder, whether run standalone
    or imported for PyMailGUI popups (see PyMailGui-PP4E/PP4E/Gui/TextEditor/icons).

Linux app-bar (dock) icons
    Linux users: you can similarly copy a GIF file to the top-level "PyMailGui-PP4E" 
    to be used as the Linux app-bar icon (else the window tools' default "PY" is used).  
    In Pythons using Tk 8.6+ (such as Python 3.4+ on Windows), a PNG file can serve 
    the same role (Pythons using older Tks require a Pillow install for non-GIF images).

Windows desktop shortcut icons
    The "mb*.ico" files, or similar creations of your own, can also be used as desktop 
    shortcut icons on Windows (and possibly elsewhere).  On Windows, drag or copy the 
    launcher script to a desktop shortcut, and set its icon to one of the "*.ico" files
    here via right-click/Properties.  To fetch tools for making icons from your own 
    images, see http://learning-python.com/iconify.html.  

Max OS X desktop alias icons
    On Mac OS X, you can similarly make an alias for launchers and drag them to the 
    desktop for quick access.  Mac supports setting icons from any image file, by 
    copy-and-paste'ing the image's content into the icon at upper left in Get Info, 
    but this may require disabling new security guards temporarily in recent OS X 
    versions (via 'csrutil disable' in a Cmd+R recovery mode session).  Though 
    complex, you can assign icons this way to desktop aliases, and more.  

Mac OS X other icons
    You may assign icons manually to desktop aliases and other items as descibed 
    above, but there is no other icon support in PyMailGui or PyEdit.  This seems to 
    be at odds with source-code distributions (and may require an app package bundle),
    but is a TBD.  Per-window icons are not a standard paradigm on Macs.

Linux other icons
    Like the Mac, per-window icons are not a standard paradigm on Linux (they seem
    to be largely a Windows model).  Other automatic icon contexts on Linux for 
    Python/Tk scripts remain TBDs.



[Home page] Books Code Blog Python Author Train Find ©M.Lutz