Add VoxelArea() constructor (#12886)

diff --git a/builtin/game/voxelarea.lua b/builtin/game/voxelarea.lua
index 62f07d928f9021eb9717c015d62ec43b4ce20d29..a9195213bdbd3ea74a8b7e385027d2a3de7831e8 100644 (file)
--- a/builtin/game/voxelarea.lua
+++ b/builtin/game/voxelarea.lua
@@ -8,7 +8,10 @@ VoxelArea = {
        zstride = 0,
 }
 
-function VoxelArea:new(o)
+local class_metatable = {}
+setmetatable(VoxelArea, class_metatable)
+
+local function new(self, o)
        o = o or {}
        setmetatable(o, self)
        self.__index = self
@@ -20,6 +23,12 @@ function VoxelArea:new(o)
        return o
 end
 
+function class_metatable:__call(MinEdge, MaxEdge)
+       return new(self, {MinEdge = MinEdge, MaxEdge = MaxEdge})
+end
+
+VoxelArea.new = new
+
 function VoxelArea:getExtent()
        local MaxEdge, MinEdge = self.MaxEdge, self.MinEdge
        return vector_new(

diff --git a/doc/lua_api.txt b/doc/lua_api.txt
index 4e3d1230cc942ded812208d6427891ee043fc379..fd4e2d3e5af94f27658440a575de36a38d8d435a 100644 (file)
--- a/doc/lua_api.txt
+++ b/doc/lua_api.txt
@@ -4485,7 +4485,8 @@ Methods
 -----------
 
 A helper class for voxel areas.
-It can be created via `VoxelArea:new({MinEdge = pmin, MaxEdge = pmax})`.
+It can be created via `VoxelArea(pmin, pmax)` or
+`VoxelArea:new({MinEdge = pmin, MaxEdge = pmax})`.
 The coordinates are *inclusive*, like most other things in Minetest.
 
 ### Methods
@@ -4533,7 +4534,7 @@ the axes in a voxel area:
 
 If, for example:
 
-    local area = VoxelArea:new({MinEdge = emin, MaxEdge = emax})
+    local area = VoxelArea(emin, emax)
 
 The values of `ystride` and `zstride` can be obtained using `area.ystride` and
 `area.zstride`.