KreaTvGfx Configuration

There is a special IIP option that can be added to your boot image build configuration for debugging and statistics purposes. The IIP name is kreatv-option-kreatvgfx-variables and it can be configured with these parameters:

• blitterstats: Enables blitter statistics that are shown at regular intervals in the log. It contains information on frequency of blits of different sizes and types.
• updatestats: Enables frame update statistics in the log, i.e. frame updates (flips) per second. This is to track performance when designing advanced animations on the edge of what the hardware can handle but still provide smooth movement.
• pixmap: Enables logging of all pixmap memory allocations and deallocations. Free graphics memory is reported whenever allocating or deallocating a pixmap, and the largest free memory block is reported if an allocation fails.
• thread: Enables detection of accesses to the library from more than one thread at a time. Basically all calls to the library are protected with a mutex and if the mutex is already locked the library logs an error and aborts. This should only be used for debugging purposes.

To control thread-safe mode of KreaTV execution, iip option kreatv-option-env-variables::KREATVGFX_THREAD_MONITOR can be used. It accepts the following values:

• "": default mode of operation - thread debugging is controlled by thread variable, described above
• "MonitorDebug": thread debugging mode enforced - same as if thread variable specified
• "ThreadSafe": thread safe mode, overrides thread variable setting.

Example usage:

kreatv-option-kreatvgfx-variables:blitterstats,updatestats,pixmap
kreatv-option-env-variables::KREATVGFX_THREAD_MONITOR=ThreadSafe