> For the complete documentation index, see [llms.txt](https://docs.streamavatars.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.streamavatars.com/lua-scripting-api/api-reference-and-tips/global-functions/getbackground.md).

# getBackground

```lua
return function()
    local level = getBackground();
    
    log('the current background level is: ' .. level);
end
```