wip
This commit is contained in:
@@ -0,0 +1,275 @@
|
||||
-- Import ------------------------------------------------------------------------------------------
|
||||
|
||||
local math = _G["math"]
|
||||
local VoxelArea = _G["VoxelArea"]
|
||||
|
||||
|
||||
-- Region Class ------------------------------------------------------------------------------------
|
||||
|
||||
local Region = {
|
||||
--[[ Defines the names of the known metadata tables. ]]--
|
||||
META = {
|
||||
--[[ The highest solid block in a certain x,z location. ]]--
|
||||
ALTITUDE = "altitude",
|
||||
|
||||
--[[ The id of the biome at each x,z location. ]]--
|
||||
BIOME = "biome",
|
||||
|
||||
--[[ A list of {weight:int, terrain_type:int} tuples for each x,z location. ]]--
|
||||
TERRAIN_BLEND = "terrain_blend",
|
||||
|
||||
--[[ The heaviest weighted terrain type from the `TERRAIN_BLEND` list. ]]--
|
||||
TERRAIN_TYPE = "terrain_type",
|
||||
}
|
||||
}
|
||||
|
||||
--[[
|
||||
Create a new Region object to manage the generation of a part of the map.
|
||||
|
||||
Returns:
|
||||
an empty Region ready to be filled
|
||||
]]--
|
||||
function Region:new()
|
||||
local result = {
|
||||
_emerged_area = nil,
|
||||
_emerged_data = {},
|
||||
_fill_min = nil,
|
||||
_fill_max = nil,
|
||||
_meta = {},
|
||||
_voxels = nil,
|
||||
}
|
||||
setmetatable(result, { __index = Region })
|
||||
return result
|
||||
end
|
||||
|
||||
--[[
|
||||
Return the content_id of the node at the indicated coordinate.
|
||||
|
||||
Args:
|
||||
x:int - the x-axis position
|
||||
y:int - the y-axis position
|
||||
z:int - the z-axis position
|
||||
|
||||
Returns:
|
||||
an int giving the content_id of the node at that location
|
||||
]]--
|
||||
function Region:get_content_id(x, y, z)
|
||||
return self._emerged_data[self._emerged_area:index(x, y, z)]
|
||||
end
|
||||
|
||||
--[[
|
||||
Alter the content_id of the node at the indicated coordinate.
|
||||
|
||||
Args:
|
||||
x:int - the x-axis position
|
||||
y:int - the y-axis position
|
||||
z:int - the z-axis position
|
||||
content_id:int - the new content_id for the given location
|
||||
]]--
|
||||
function Region:set_content_id(x, y, z, content_id)
|
||||
self._emerged_data[self._emerged_area:index(x, y, z)] = content_id
|
||||
end
|
||||
|
||||
--[[
|
||||
Iterate over every voxel within a specified area.
|
||||
|
||||
For each voxel, inside the described cuboid, call the `doOperation` function which should have
|
||||
the following signature:
|
||||
|
||||
function doOperation(x:int, y:int, z:int) -> None
|
||||
|
||||
The called function can then inspect and manipulate the content ids and meta data in the region
|
||||
using the various methods on this class.
|
||||
|
||||
Args:
|
||||
x_min:int - the lowest x coordinate in the desired cuboid
|
||||
x_max:int - the highest x coordinate in the desired cuboid
|
||||
y_min:int - the lowest y coordinate in the desired cuboid
|
||||
y_max:int - the highest y coordinate in the desired cuboid
|
||||
z_min:int - the lowest z coordinate in the desired cuboid
|
||||
z_max:int - the highest z coordinate in the desired cuboid
|
||||
doOperation:function(x:int,y:int,z:int) - the callback to be invoked for each voxel
|
||||
]]--
|
||||
function Region:iterate(x_min, x_max, y_min, y_max, z_min, z_max, doOperation)
|
||||
x_min = math.floor(math.max(x_min, self._fill_min.x))
|
||||
x_max = math.floor(math.min(x_max, self._fill_max.x))
|
||||
y_min = math.floor(math.max(y_min, self._fill_min.y))
|
||||
y_max = math.floor(math.min(y_max, self._fill_max.y))
|
||||
z_min = math.floor(math.max(z_min, self._fill_min.z))
|
||||
z_max = math.floor(math.min(z_max, self._fill_max.z))
|
||||
|
||||
for z = z_min, z_max do
|
||||
for y = y_min, y_max do
|
||||
for x = x_min, x_max do
|
||||
doOperation(x, y, z)
|
||||
end
|
||||
end
|
||||
end
|
||||
end
|
||||
|
||||
--[[
|
||||
Iterates over all voxels at or below a certain altitude.
|
||||
|
||||
Works identically to the `Region:iterate` function, except that the x & z ranges are the full
|
||||
area being filled by this region, and the y range is capped at the given altitude.
|
||||
|
||||
Args:
|
||||
y_max:int - the maximum y value to include
|
||||
doOperation:function(x:int,y:int,z:int) - the callback to be invoked for each voxel
|
||||
]]--
|
||||
function Region:iterate_below(y_max, doOperation)
|
||||
self:iterate(
|
||||
self._fill_min.x, self._fill_max.x,
|
||||
self._fill_min.y, y_max,
|
||||
self._fill_min.z, self._fill_max.z,
|
||||
doOperation
|
||||
)
|
||||
end
|
||||
|
||||
--[[
|
||||
Iterates over all the x,z columns in the fill region.
|
||||
|
||||
Works identically to the `Region:iterate` function, except that the x & z ranges are the full
|
||||
area being filled by this region, and the y-axis coordinate is omitted.
|
||||
|
||||
Args:
|
||||
doOperation:function(x:int,z:int) - the callback to be invoked for each voxel
|
||||
]]--
|
||||
function Region:iterate_columns(doOperation)
|
||||
self:iterate(
|
||||
self._fill_min.x, self._fill_max.x,
|
||||
0, 0,
|
||||
self._fill_min.z, self._fill_max.z,
|
||||
function(x, y, z) doOperation(x, z) end
|
||||
)
|
||||
end
|
||||
|
||||
--[[
|
||||
Iterates over all voxels being filled in this region.
|
||||
|
||||
Works identically to the `Region:iterate` function, except that the x, y, and z ranges are the
|
||||
full area being filled by this region.
|
||||
|
||||
Args:
|
||||
doOperation:function(nt,int,int) - the callback to be invoked for each voxel
|
||||
]]--
|
||||
function Region:iterate_fill(doOperation)
|
||||
self:iterate(
|
||||
self._fill_min.x, self._fill_max.x,
|
||||
self._fill_min.y, self._fill_max.y,
|
||||
self._fill_min.z, self._fill_max.z,
|
||||
doOperation
|
||||
)
|
||||
end
|
||||
|
||||
--[[
|
||||
Iterates over all voxels at a specific altitude.
|
||||
|
||||
Works identically to the `Region:iterate` function, except that the x & z ranges are the full
|
||||
area being filled by this region, and y is limited to exactly the given altitude.
|
||||
|
||||
Args:
|
||||
y:int - the y value to use
|
||||
doOperation:function(int,int,int) - the callback to be invoked for each voxel
|
||||
]]--
|
||||
function Region:iterate_plane(y, doOperation)
|
||||
if y < self._fill_min.y then return end
|
||||
if y > self._fill_max.y then return end
|
||||
|
||||
self:iterate(
|
||||
self._fill_min.x, self._fill_max.x,
|
||||
y, y,
|
||||
self._fill_min.z, self._fill_max.z,
|
||||
doOperation
|
||||
)
|
||||
end
|
||||
|
||||
--[[
|
||||
Get the named metadata at the indicated coordinate.
|
||||
|
||||
The canonical use for this method is to find the previously-calculated altitude of the base
|
||||
terrain at a certain location (e.g., `get_meta(Region.META.ALTITUDE, 292, 998)`). However, any
|
||||
meta name can be used, and any data stored. This data is let until overwritten, so each mapgen
|
||||
cycle should be careful to recompute any metadata it requires before running algorithms which
|
||||
depend upon it.
|
||||
|
||||
Args:
|
||||
name:string - the name of the metadata table to access
|
||||
x:int - the x coordinate of the desired data
|
||||
z:int - the z coordinate of the desired data
|
||||
|
||||
Returns:
|
||||
the value previously stored for that location or `nil` if there isn't any
|
||||
]]--
|
||||
function Region:get_meta(name, x, z)
|
||||
local meta_data = self._meta[name]
|
||||
if not meta_data then return nil end
|
||||
return meta_data[self._emerged_area:index(x, 0, z)]
|
||||
end
|
||||
|
||||
--[[
|
||||
Change the metadata at the indicated coordinate.
|
||||
|
||||
This will automatically fill in any necessary pieces to ensure that the operation succeeds
|
||||
(e.g., creating a missing metadata table), so it is highly advised to use the provided
|
||||
`Region.META` constants to avoid accidentally creating new tables through misspellings.
|
||||
|
||||
Args:
|
||||
name:string - the name of the metadata table to access
|
||||
x:int - the x coordinate of the desired data
|
||||
z:int - the z coordinate of the desired data
|
||||
value:any - the value to be stored
|
||||
]]--
|
||||
function Region:set_meta(name, x, z, value)
|
||||
local meta_data = self._meta[name]
|
||||
if not meta_data then
|
||||
meta_data = {}
|
||||
self._meta[name] = meta_data
|
||||
end
|
||||
|
||||
meta_data[self._emerged_area:index(x, 0, z)] = value
|
||||
end
|
||||
|
||||
--[[
|
||||
Reads raw voxel data from a voxel manipulator.
|
||||
|
||||
Args:
|
||||
voxels:VoxelManip - the voxel manipulator containing the data
|
||||
fill_min:vector - the smaller corner of the cuboid to be filled
|
||||
fill_max:vector - the larger corner of the cuboid to be filled
|
||||
]]--
|
||||
function Region:read_voxels(voxels, fill_min, fill_max)
|
||||
self:save_voxels()
|
||||
|
||||
self._voxels = voxels
|
||||
self._fill_min = fill_min
|
||||
self._fill_max = fill_max
|
||||
|
||||
local min_emerged, max_emerged = voxels:get_emerged_area()
|
||||
self._emerged_area = VoxelArea(min_emerged, max_emerged)
|
||||
self._voxels:get_data(self._emerged_data)
|
||||
end
|
||||
|
||||
--[[
|
||||
Writes raw voxel data back into the source voxel manipulator.
|
||||
|
||||
If no voxel data has been read (or none has been read since the last save), then this function
|
||||
returns immediately.
|
||||
]]--
|
||||
function Region:save_voxels()
|
||||
if not self._voxels then return end
|
||||
|
||||
self._voxels:set_data(self._emerged_data)
|
||||
self._voxels:calc_lighting()
|
||||
self._voxels:update_liquids()
|
||||
|
||||
self._emerged_area = nil
|
||||
self._fill_max = nil
|
||||
self._fill_min = nil
|
||||
self._voxels = nil
|
||||
end
|
||||
|
||||
|
||||
-- Export ------------------------------------------------------------------------------------------
|
||||
|
||||
return Region
|
||||
Reference in New Issue
Block a user