summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorDS <vorunbekannt75@web.de>2019-12-08 18:59:30 +0100
committersfan5 <sfan5@live.de>2019-12-08 18:59:30 +0100
commit8f73ec6c6c18ea5676261064399a650911333da5 (patch)
treee225b3ffcb8984364d543d23dda349a3989d55f5 /doc
parentd3255f92d7ed5758de5db735eda7796ef7b5e017 (diff)
downloadminetest-8f73ec6c6c18ea5676261064399a650911333da5.tar.gz
minetest-8f73ec6c6c18ea5676261064399a650911333da5.tar.bz2
minetest-8f73ec6c6c18ea5676261064399a650911333da5.zip
Formspec: make bgcolor element less confusing and allow setting fullscreen color (#8996)
Diffstat (limited to 'doc')
-rw-r--r--doc/lua_api.txt18
1 files changed, 13 insertions, 5 deletions
diff --git a/doc/lua_api.txt b/doc/lua_api.txt
index f3e21bbc5..7ba3ad77d 100644
--- a/doc/lua_api.txt
+++ b/doc/lua_api.txt
@@ -2104,11 +2104,19 @@ Elements
* Show an inventory image of registered item/node
-### `bgcolor[<color>;<fullscreen>]`
-
-* Sets background color of formspec as `ColorString`
-* If `true`, a fullscreen background is drawn and the color is ignored
- (does not affect the size of the formspec)
+### `bgcolor[<bgcolor>;<fullscreen>;<fbgcolor>]`
+
+* Sets background color of formspec.
+* `bgcolor` and `fbgcolor` (optional) are `ColorString`s, they define the color
+ of the non-fullscreen and the fullscreen background.
+* `fullscreen` (optional) can be one of the following:
+ * `false`: Only the non-fullscreen background color is drawn. (default)
+ * `true`: Only the fullscreen background color is drawn.
+ * `both`: The non-fullscreen and the fullscreen background color are drawn.
+ * `neither`: No background color is drawn.
+* Note: Leave a parameter empty to not modify the value.
+* Note: `fbgcolor`, leaving parameters empty and values for `fullscreen` that
+ are not bools are only available since formspec version 3.
### `background[<X>,<Y>;<W>,<H>;<texture name>]`