* foregroundImage property added

* fixed documentaion nits

* test for fallback to background image on foreground image failover

* golden test