Minetest-WorldEditAdditions/rotate.js

#!/usr/bin/env node

/**
 * Rotate a given point around an origin point in 3d space.
 * NOTE: This function is not as intuitive as it sounds.
 * A whiteboard and a head for mathematics is recommended before using this
 * function.
 * @source	GitHub Copilot
 * @warning	Not completely tested! Pending a thorough evaluation.
 * @param	{Vector3}	origin	The origin point to rotate around
 * @param	{Vector3}	point	The point to rotate.
 * @param	{Number}	x	Rotate this much around the X axis (yz plane), in radians.
 * @param	{Number}	y	Rotate this much around the Y axis (xz plane), in radians.
 * @param	{Number}	z	Rotate this much around the Z axis (xy plane), in radians.
 * @return	{Vector3}	The rotated point.
 */
function rotate_point_3d(origin, point, x, y, z)
{
	point = [...point];
	point[0] = point[0] - origin[0];
	point[1] = point[1] - origin[1];
	point[2] = point[2] - origin[2];
	
	// rotate around x
	var x1 = point[0];
	var y1 = point[1] * Math.cos(x) - point[2] * Math.sin(x);
	var z1 = point[1] * Math.sin(x) + point[2] * Math.cos(x);

	// rotate around y
	var x2 = x1 * Math.cos(y) + z1 * Math.sin(y);
	var y2 = y1;
	var z2 = -x1 * Math.sin(y) + z1 * Math.cos(y);

	// rotate around z
	var x3 = x2 * Math.cos(z) - y2 * Math.sin(z);
	var y3 = x2 * Math.sin(z) + y2 * Math.cos(z);
	var z3 = z2;
	
	return [x3+origin[0], y3+origin[1], z3+origin[2]];
}

function deg_to_rad(deg)
{
	return deg * Math.PI / 180;
}

function point_to_string(point, decimal_places=3)
{
	return "(x " + point[0].toFixed(decimal_places) + ", y " + point[1].toFixed(decimal_places) + ", z " + point[2].toFixed(decimal_places) + ")";
}

function do_test(origin, point, ...args) {
	const result = rotate_point_3d(origin, point, ...args);
	console.log(`ORIGIN`, point_to_string(origin), `\tPOINT`, point_to_string(point), `\tRESULT`, point_to_string(result));
}

do_test(
	[1, 0, 0],
	[5, 0, 0],
	deg_to_rad(0),		// rotate around x axis = yz plane
	deg_to_rad(0),		// rotate around y axis = xz plane
	deg_to_rad(180)		// rotate around z axis = xy plane
);
do_test(
	[1, 0, 0],
	[0, 1, 0],
	deg_to_rad(0),		// rotate around x axis = yz plane
	deg_to_rad(0),		// rotate around y axis = xz plane
	deg_to_rad(180)		// rotate around z axis = xy plane
);
do_test(
	[10, 100, 0],
	[0, 0, 0],
	deg_to_rad(0),		// rotate around x axis = yz plane
	deg_to_rad(0),		// rotate around y axis = xz plane
	deg_to_rad(180)		// rotate around z axis = xy plane
);