File: utils.lua

package info (click to toggle)
minetest-mod-meshport 0.2.3-1
  • links: PTS
  • area: main
  • in suites: sid, trixie
  • size: 776 kB
  • sloc: python: 40; makefile: 2
file content (395 lines) | stat: -rw-r--r-- 10,051 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
--[[
	Copyright (C) 2021 random-geek (https://github.com/random-geek)

	This file is part of Meshport.

	Meshport is free software: you can redistribute it and/or modify it under
	the terms of the GNU Lesser General Public License as published by the Free
	Software Foundation, either version 3 of the License, or (at your option)
	any later version.

	Meshport is distributed in the hope that it will be useful, but WITHOUT ANY
	WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
	FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for
	more details.

	You should have received a copy of the GNU Lesser General Public License
	along with Meshport. If not, see <https://www.gnu.org/licenses/>.
]]

local S = meshport.S

meshport.NEIGHBOR_DIRS = {
	-- face neighbors
	vector.new( 0, 1, 0), -- 1
	vector.new( 0,-1, 0),
	vector.new( 1, 0, 0),
	vector.new(-1, 0, 0),
	vector.new( 0, 0, 1),
	vector.new( 0, 0,-1),

	-- edge neighbors
	vector.new(-1, 1, 0), -- 7
	vector.new( 1, 1, 0),
	vector.new( 0, 1, 1),
	vector.new( 0, 1,-1),
	vector.new(-1, 0, 1),
	vector.new( 1, 0, 1),
	vector.new(-1, 0,-1),
	vector.new( 1, 0,-1),
	vector.new(-1,-1, 0),
	vector.new( 1,-1, 0),
	vector.new( 0,-1, 1),
	vector.new( 0,-1,-1),
}

local FACEDIR_TO_TILE_INDICES = {
	[0] =
	{1, 2, 3, 4, 5, 6},
	{1, 2, 5, 6, 4, 3},
	{1, 2, 4, 3, 6, 5},
	{1, 2, 6, 5, 3, 4},
	{6, 5, 3, 4, 1, 2},
	{3, 4, 5, 6, 1, 2},
	{5, 6, 4, 3, 1, 2},
	{4, 3, 6, 5, 1, 2},
	{5, 6, 3, 4, 2, 1},
	{4, 3, 5, 6, 2, 1},
	{6, 5, 4, 3, 2, 1},
	{3, 4, 6, 5, 2, 1},
	{4, 3, 1, 2, 5, 6},
	{6, 5, 1, 2, 4, 3},
	{3, 4, 1, 2, 6, 5},
	{5, 6, 1, 2, 3, 4},
	{3, 4, 2, 1, 5, 6},
	{5, 6, 2, 1, 4, 3},
	{4, 3, 2, 1, 6, 5},
	{6, 5, 2, 1, 3, 4},
	{2, 1, 4, 3, 5, 6},
	{2, 1, 6, 5, 4, 3},
	{2, 1, 3, 4, 6, 5},
	{2, 1, 5, 6, 3, 4},
}

local FACEDIR_TO_TILE_ROTATIONS = {
	[0] =
	{0, 0, 0, 0, 0, 0},
	{1, 3, 0, 0, 0, 0},
	{2, 2, 0, 0, 0, 0},
	{3, 1, 0, 0, 0, 0},
	{0, 2, 1, 3, 2, 0},
	{0, 2, 1, 3, 3, 3},
	{0, 2, 1, 3, 0, 2},
	{0, 2, 1, 3, 1, 1},
	{2, 0, 3, 1, 2, 0},
	{2, 0, 3, 1, 1, 1},
	{2, 0, 3, 1, 0, 2},
	{2, 0, 3, 1, 3, 3},
	{1, 1, 1, 1, 3, 1},
	{1, 1, 2, 0, 3, 1},
	{1, 1, 3, 3, 3, 1},
	{1, 1, 0, 2, 3, 1},
	{3, 3, 3, 3, 1, 3},
	{3, 3, 2, 0, 1, 3},
	{3, 3, 1, 1, 1, 3},
	{3, 3, 0, 2, 1, 3},
	{2, 2, 2, 2, 2, 2},
	{1, 3, 2, 2, 2, 2},
	{0, 0, 2, 2, 2, 2},
	{3, 1, 2, 2, 2, 2},
}

local WALLMOUNTED_TO_FACEDIR = {[0] = 20, 0, 17, 15, 8, 6}

local DRAWTYPE_ALIASES = {
	allfaces_optional = "allfaces",
	glasslike_framed_optional = "glasslike",
}


function meshport.log(name, level, s)
	local message

	if level == "info" then
		message = minetest.colorize("#00EF00", s)
	elseif level == "warning" then
		message = minetest.colorize("#EFEF00", S("Warning: @1", s))
	elseif level == "error" then
		message = minetest.colorize("#EF0000", S("Error: @1", s))
	end

	minetest.chat_send_player(name, "[meshport] " .. message)
end


function meshport.rotate_vector_by_facedir(vec, facedir)
	local v = vector.new(vec)
	local rotY = facedir % 4
	local rotSide = (facedir - rotY) / 4

	-- Rotate the vector. Values of 0 for either `rotY` or `rotSide` do not change the vector.
	if rotY == 1 then
		v.x, v.z = v.z, -v.x -- 90 degrees clockwise
	elseif rotY == 2 then
		v.x, v.z = -v.x, -v.z -- 180 degrees clockwise
	elseif rotY == 3 then
		v.x, v.z = -v.z, v.x -- 270 degrees clockwise
	end

	if rotSide == 1 then
		v.y, v.z = -v.z, v.y -- Facing Z+
	elseif rotSide == 2 then
		v.y, v.z = v.z, -v.y -- Facing Z-
	elseif rotSide == 3 then
		v.x, v.y = v.y, -v.x -- Facing X+
	elseif rotSide == 4 then
		v.x, v.y = -v.y, v.x -- Facing X-
	elseif rotSide == 5 then
		v.x, v.y = -v.x, -v.y -- Facing Y-
	end

	return v
end


function meshport.translate_texture_coordinates(texCoords, offset)
	if offset.x == 0 and offset.y == 0 then
		return texCoords
	end

	local newTexCoords = {}

	for _, tc in ipairs(texCoords) do
		table.insert(newTexCoords, {x = tc.x + offset.x, y = tc.y + offset.y})
	end

	return newTexCoords
end


function meshport.rotate_texture_coordinates_rad(texCoords, rad)
	if rad == 0 then
		return texCoords
	end

	local sinRad = math.sin(rad)
	local cosRad = math.cos(rad)
	local newTexCoords = {}

	for _, texCoord in ipairs(texCoords) do
		-- Coordinates are rotated around (0.5, 0.5).
		local x = texCoord.x - 0.5
		local y = texCoord.y - 0.5
		table.insert(newTexCoords, {
			x = x * cosRad - y * sinRad + 0.5,
			y = x * sinRad + y * cosRad + 0.5
		})
	end

	return newTexCoords
end


local function rotate_texture_coordinates(texCoords, rot)
	if rot == 0 then
		return
	end

	for i, tc in ipairs(texCoords) do
		local x, y

		-- Rotate the vector. Values of components range from 0 to 1, so adding 1 when inverting is necessary.
		if rot == 1 then
			x, y = 1 - tc.y, tc.x -- 90 degrees counterclockwise
		elseif rot == 2 then
			x, y = 1 - tc.x, 1 - tc.y -- 180 degrees counterclockwise
		elseif rot == 3 then
			x, y = tc.y, 1 - tc.x -- 270 degrees counterclockwise
		end

		texCoords[i] = {x = x, y = y}
	end
end


local function scale_global_texture_coordinates(texCoords, pos, sideIdx, scale)
	-- Get the offset of the tile relative to the lower left corner of the texture.
	local texPos = {}

	if sideIdx == 1 then
		texPos.x = pos.x % 16 % scale
		texPos.y = pos.z % 16 % scale
	elseif sideIdx == 2 then
		texPos.x = pos.x % 16 % scale
		texPos.y = scale - pos.z % 16 % scale - 1
	elseif sideIdx == 3 then
		texPos.x = pos.z % 16 % scale
		texPos.y = pos.y % 16 % scale
	elseif sideIdx == 4 then
		texPos.x = scale - pos.z % 16 % scale - 1
		texPos.y = pos.y % 16 % scale
	elseif sideIdx == 5 then
		texPos.x = scale - pos.x % 16 % scale - 1
		texPos.y = pos.y % 16 % scale
	elseif sideIdx == 6 then
		texPos.x = pos.x % 16 % scale
		texPos.y = pos.y % 16 % scale
	end

	-- Scale and move the texture coordinates.
	for i, texCoord in ipairs(texCoords) do
		texCoords[i] = {
			x = (texCoord.x + texPos.x) / scale,
			y = (texCoord.y + texPos.y) / scale,
		}
	end
end


-- WARNING: This function mutates tables!
-- Please follow the table rules used by Faces.
function meshport.prepare_cuboid_face(face, tiles, pos, facedir, sideIdx)
	-- If the tile index has not been set manually, assign a tile to the face based on the facedir value.
	face.tile_idx = face.tile_idx or FACEDIR_TO_TILE_INDICES[facedir][sideIdx]
	local tile = meshport.get_tile(tiles, face.tile_idx)

	if tile.align_style == "world" or tile.align_style == "user" then
		-- For scaled, world-aligned tiles, scale and reposition the texture coordinates as needed.
		if tile.scale and tile.scale ~= 1 then
			scale_global_texture_coordinates(face.tex_coords, pos, sideIdx, tile.scale)
		end
	else
		-- If the tile isn't world-aligned, rotate it according to the facedir.
		rotate_texture_coordinates(face.tex_coords, FACEDIR_TO_TILE_ROTATIONS[facedir][sideIdx])
	end

	return face
end


function meshport.get_content_id_or_nil(nodeName)
	if minetest.registered_nodes[nodeName] then
		return minetest.get_content_id(nodeName)
	end
end


function meshport.get_def_from_id(contentId)
	return minetest.registered_nodes[minetest.get_name_from_content_id(contentId)] or {}
end


function meshport.get_aliased_drawtype(drawtype)
	return DRAWTYPE_ALIASES[drawtype or ""] or drawtype
end


function meshport.get_facedir(type, param2)
	if type == "facedir" or type == "colorfacedir" then
		-- For colorfacedir, only the first 5 bits are needed.
		return param2 % 32
	elseif type == "wallmounted" or type == "colorwallmounted" then
		-- For colorwallmounted, only the first 3 bits are needed. If the wallmounted direction is invalid, return 0.
		return WALLMOUNTED_TO_FACEDIR[param2 % 8] or 0
	else
		return 0
	end
end


function meshport.get_degrotate(type, param2)
	if type == "degrotate" then
		return 1.5 * (param2 % 240)
	elseif type == "colordegrotate" then
		return 15 * ((param2 % 32) % 24)
	else
		return 0
	end
end


function meshport.get_node_neighbors(array, area, idx)
	-- Get the node's absolute position from the flat array index.
	local pos = area:position(idx)
	local neighbors = {}

	-- Get the content/param2 value for each neighboring node.
	for i = 1, 6 do
		neighbors[i] = array[area:indexp(vector.add(pos, meshport.NEIGHBOR_DIRS[i]))]
	end

	return neighbors
end


function meshport.get_tile(tiles, n)
	if type(tiles) == "table" and #tiles > 0 then
		return tiles[n] or tiles[#tiles]
	else
		return "unknown"
	end
end


local function get_png_dimensions(path)
	-- Luckily, reading the dimensions of a PNG file is a trivial task
	local file = io.open(path, "rb")
	if not file then
		return
	end
	file:seek("set", 1)
	if file:read(3) ~= "PNG" then -- Verify it's a PNG file
		return
	end
	file:seek("set", 16)

	local function read_u32(b)
		return (b:byte(1) * 0x1000000 +
				b:byte(2) * 0x10000 +
				b:byte(3) * 0x100 +
				b:byte(4))
	end

	local w = read_u32(file:read(4))
	local h = read_u32(file:read(4))
	file:close()

	return w, h
end


-- In case of failure, this should return nil, nil
function meshport.get_texture_dimensions(textureName)
	local dims = meshport.texture_dimension_cache[textureName]
	if dims then
		return dims[1], dims[2]
	end

	local path = meshport.texture_paths[textureName]
	if path then
		local w, h = get_png_dimensions(path)
		meshport.texture_dimension_cache[path] = {w, h} -- Will be an empty table if the file isn't found.
		return w, h
	end
end


function meshport.get_asset_paths(assetFolderName, extension)
	local modAssetPath
	local assets = {}

	-- Iterate through each enabled mod.
	for _, modName in ipairs(minetest.get_modnames()) do
		modAssetPath = minetest.get_modpath(modName) .. "/" .. assetFolderName

		-- Iterate through all the files in the requested folder of the mod.
		for _, fileName in ipairs(minetest.get_dir_list(modAssetPath, false)) do
			-- Add files to the table. If an extension is specified, only add files with that extension.
			if not extension or string.lower(string.sub(fileName, -string.len(extension))) == extension then
				assets[fileName] = modAssetPath .. "/" .. fileName
			end
		end
	end

	return assets
end