Lite update box versus lite draw box

LiTE's basic graphics enclosure is a so called. All primitive widgets such as,   up to even a   really have a   that is mapped to a sub-surface of the main surface.

There are two APIs to update this sub-surface, or  after the contents have changed,   and.

will set a dirty flag for the specific box (note that even the  is underneath a  ), and during the event loop this flag is checked for each time the event loop goes through an iteration. If there are any dirty boxes that needs to be redrawn, then this will happen here.

will call the drawing functions directly, without the need to wait for the event loop to process a dirty flag. This operation is used to show results on the screen immediately, for example if you have a time critical update.

Depending on the need and performance, sometimes  is too expensive, sometimes   is too asynchronous. But in most cases it makes sense using  to merge multiple updates in the queue and do just one single update where different updates overlap.