Limitations

---

There are some things that we don't do well, or that just don't work.
These are usually caused by limitations in the underlying tkinter, and may be specific to a particular platform.

General Limitations:

• Animated GIFs - appJar has its own way of animating GIFs, if animated GIFs don't have complete frames, the animation will break.
• Image Backgrounds - setting an image as a background doesn't work well - most widgets don't have their own transparency.
• ttk - appJar was never intended to work with ttk, but due to popular demand, we've tried to build it in, but there are still issues.

Platform Limitations:

appJar has been designed to work the same on the three major platforms: Windows, Mac & Linux.
However, not all features are available on all platforms.

Linux:

• Transparency isn't supported
• app Icons aren't supported
• Audio doesn't work - relies on WinSound

Mac:

• app Icons aren't supported
• Audio doesn't work - relies on WinSound
• Buttons don't support background colours and changing the height
• Tickable OptionBoxes don't work
• Pasting some special characters can crash appJar
• Inertial scrolling can crash appJar

Windows:

• n/a

Third Party Limitations

• MatPlotLib does work with appJar, but can be fiddly. If you want to use 3rd party libraries with MatPlotLib, you should import them after the appJar GUI has been created:

from numpy import sin, pi, arange
import random
from appJar import gui 

with gui() as app:
    x = arange(0.0, 3.0, 0.01)
    y = sin(random.randint(1,10) * pi * x)
    axes = app.addPlot("p1", x, y)
    axes.set_title("Click somewhere on a line.\nRight-click to deselect.")
    axes.legend(['The curve'])
    axes.set_xlabel("X Axes")
    axes.set_ylabel("Y Axes")

    # only import this library once the GUI has been created
    import mplcursors
    mplcursors.cursor(axes)