TODO
====

Bugs To Fix
-----------

Problem:  running out of bugs to fix.


Features To Enhance
-------------------

Feature:  script interface should include level to radius fading.
Feature:  script interface should include view validity testing.
Feature:  script interface should include more complete input handling.
Feature:  'transition.lua' should work without 'dt' depending on 'z'.
Feature:  large tiled texture might be more efficient when drawing.


Other Known Issues
------------------

Problem:  script errors terminate 'mandulia' abruptly.
Cause:    lack of error checking in 'Interface.hs'.
Solution: don't write buggy scripts.

Problem:  real-time operation lags Julia rendering at rapid movements.
Cause:    Your system is too SLOW to play this!
Solution: get a faster computer.

Problem:  recording enabled leads to higher quality.
Cause:    main thread blocks on image output, Julia renderer threads don't.
Solution: use another worker thread for image output (but HQ recs are nice).

Problem:  scripts printing to 'stdout' corrupts recordings.
Cause:    recordings go to 'stdout', which expects nothing but recordings.
Solution: somehow redirect all Lua 'stdout' to 'stderr'.

Problem:  script's 'render()' doesn't get called when the window is hidden.
Cause:    that's exactly the way GLUT is supposed to behave.
Solution: switch to a less smelly UI library to wrap OpenGL.  SDL?

Problem:  'extra/' in git repository contains unrelated code.
Cause:    ppmtoy4m was a video encoding bottleneck, needed speeding up.
Solution: move that code to a different repository.

Problem:  very occasional glibc realloc() crashes.
Cause:    possibly an nVidia driver issue?
Solution: unknown. seems sporadic and random.
Cause:    possibly a Lua stack overflow?
Solution: fixed in eb8a82052c7f50a64bd23d19278757a649f23f9c