lua simulation api functions for drawing with tools / deco