Adds missing data

addons/cyclops_level_builder/snapping/snap_to_grid_util.gd

@@ -0,0 +1,92 @@
+# MIT License
+#
+# Copyright (c) 2023 Mark McKay
+# https://github.com/blackears/cyclopsLevelBuilder
+#
+# Permission is hereby granted, free of charge, to any person obtaining a copy
+# of this software and associated documentation files (the "Software"), to deal
+# in the Software without restriction, including without limitation the rights
+# to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+# copies of the Software, and to permit persons to whom the Software is
+# furnished to do so, subject to the following conditions:
+#
+# The above copyright notice and this permission notice shall be included in all
+# copies or substantial portions of the Software.
+#
+# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+# AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+# OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+# SOFTWARE.
+
+@tool
+extends Resource
+class_name SnapToGridUtil
+
+#const feet_per_meter:float = 3.28084
+
+@export var unit_size:float = 1
+
+@export var use_subdivisions:bool = false
+@export var grid_subdivisions:int = 10
+
+@export var power_of_two_scale:int = 0 #Scaling 2^n
+
+#local transform matrix for grid
+@export var grid_transform:Transform3D = Transform3D.IDENTITY:
+	get:
+		return grid_transform
+	set(value):
+		grid_transform = value
+		grid_transform_inv = grid_transform.affine_inverse()
+		
+var grid_transform_inv:Transform3D = Transform3D.IDENTITY
+
+func load_from_cache(cache:Dictionary):
+	unit_size = cache.get("unit_size", 1)
+	use_subdivisions = cache.get("use_subdivisions", false)
+	grid_subdivisions = cache.get("grid_subdivisions", 10)
+	power_of_two_scale = cache.get("power_of_two_scale", 0)
+	#print("load grid_transform before")
+	grid_transform = SerialUtil.load_cache_transform_3d(cache.get("grid_transform", ""), Transform3D.IDENTITY)
+	#print("load grid_transform after ")
+	
+	if is_zero_approx(grid_transform.basis.determinant()):
+		#print("replace")
+		grid_transform = Transform3D.IDENTITY
+	#grid_transform = cache.get("grid_transform", Transform3D.IDENTITY)
+	
+func save_to_cache():
+	#print("save SnapToGridUtil")
+	return {
+		"unit_size": unit_size,
+		"use_subdivisions": use_subdivisions,
+		"grid_subdivisions": grid_subdivisions,
+		"power_of_two_scale": power_of_two_scale,
+		"grid_transform": SerialUtil.save_cache_transform_3d(grid_transform),
+	}
+
+#Point is in world space
+func snap_point(point:Vector3)->Vector3:
+	
+	var p_local:Vector3 = grid_transform_inv * point
+	
+	#print("unit_size %s  pow 2 %s" % [unit_size, pow(2, power_of_two_scale)])
+	var scale:Vector3 = Vector3.ONE * unit_size * pow(2, power_of_two_scale)
+	if use_subdivisions:
+		scale /= float(grid_subdivisions)
+	
+	p_local = floor(p_local / scale + Vector3(.5, .5, .5)) * scale
+	
+	var target_point:Vector3 = grid_transform * p_local
+	
+	#print("point %s  target_point %s  scale %s" % [point, target_point, scale])
+	return target_point
+
+func _to_string():
+	return "unit_size %s  use_subdiv %s  subdiv %s  pot %s  xform %s" \
+		% [unit_size, use_subdivisions, grid_subdivisions, power_of_two_scale, grid_transform]
+
+