Minetest-WorldEditAdditions/worldeditadditions/lib/sculpt/brushes/__gaussian.lua

local wea = worldeditadditions
local wea_c = worldeditadditions_core
local Vector3 = wea_c.Vector3

---
-- @module worldeditadditions.sculpt.brushes

--- Returns a smooth gaussian brush.
-- @name make_gaussian
-- @internal
-- @param	size	Vector3		The target size of the brush. Note that the actual size of the brush will be different, as the gaussian function has some limitations.
-- @param	sigma=2	number		The 'smoothness' of the brush. Higher values are more smooth.
return function(size, sigma)
	size = math.min(size.x, size.y)
	if size % 2 == 0 then size = size - 1 end -- Gaussian runs on odd numbers
	if size < 1 then
		return false, "Error: Invalid brush size (brushes must be at least 1 node in size)."
	end
	
	local success, gaussian = wea.conv.kernel_gaussian(size, sigma)
	
	-- Normalise values to fill the range 0 - 1
	-- By default, wea.conv.kernel_gaussian values add up to 1 in total
	local max = wea_c.max(gaussian)
	for i=0,size*size-1 do
		gaussian[i] = gaussian[i] / max
	end
	
	return success, gaussian, Vector3.new(size, size, 0)
end