display api improvements - to be continued