From 574d9dc6b1edc7c46f76a0e141a72edf0faa2637 Mon Sep 17 00:00:00 2001 From: Arthur Moore Date: Sat, 9 Mar 2024 23:35:04 -0500 Subject: [PATCH] Move helper functions / modules to their own file These are not explicitly tied to Gridfinity. --- generic-helpers.scad | 170 ++++++++++++++++++++++++++++++++ gridfinity-rebuilt-utility.scad | 169 +------------------------------ 2 files changed, 171 insertions(+), 168 deletions(-) create mode 100644 generic-helpers.scad diff --git a/generic-helpers.scad b/generic-helpers.scad new file mode 100644 index 0000000..b40c9d8 --- /dev/null +++ b/generic-helpers.scad @@ -0,0 +1,170 @@ +/** + * @file generic-helpers.scad + * @brief Generic Helper Functions. Not gridfinity specific. + */ + +function clp(x,a,b) = min(max(x,a),b); + +module rounded_rectangle(length, width, height, rad) { + linear_extrude(height) + offset(rad) + offset(-rad) + square([length,width], center = true); +} + +module rounded_square(length, height, rad) { + rounded_rectangle(length, length, height, rad); +} + +module copy_mirror(vec=[0,1,0]) { + children(); + if (vec != [0,0,0]) + mirror(vec) + children(); +} + +module pattern_linear(x = 1, y = 1, sx = 0, sy = 0) { + yy = sy <= 0 ? sx : sy; + translate([-(x-1)*sx/2,-(y-1)*yy/2,0]) + for (i = [1:ceil(x)]) + for (j = [1:ceil(y)]) + translate([(i-1)*sx,(j-1)*yy,0]) + children(); +} + +module pattern_circular(n=2) { + for (i = [1:n]) + rotate(i*360/n) + children(); +} + +/** + * @brief Unity (no change) affine transformation matrix. + * @details For use with multmatrix transforms. + */ +unity_matrix = [ + [1, 0, 0, 0], + [0, 1, 0, 0], + [0, 0, 1, 0], + [0, 0, 0, 1] +]; + +/** + * @brief Get the magnitude of a 2d or 3d vector + * @param vector A 2d or 3d vectorm + * @returns Magnitude of the vector. + */ + function vector_magnitude(vector) = + sqrt(vector.x^2 + vector.y^2 + (len(vector) == 3 ? vector.z^2 : 0)); + +/** + * @brief Convert a 2d or 3d vector into a unit vector + * @returns The unit vector. Where total magnitude is 1. + */ +function vector_as_unit(vector) = vector / vector_magnitude(vector); + +/** + * @brief Convert a 2d vector into an angle. + * @details Just a wrapper around atan2. + * @param A 2d vectorm + * @returns Angle of the vector. + */ +function atanv(vector) = atan2(vector.y, vector.x); + +/** + * @brief Affine transformation matrix for 2d rotation on the X,Y plane. + * @param angle The angle to rotate things by + * @returns an Affine transformation matrix for use with `multmatrix()` + */ +function affine_rotation(angle) = [ + [cos(angle), 0, sin(angle), 0], + [0, 1, 0, 0], + [-sin(angle), 0, cos(angle), 0], + [0, 0, 0, 1] +]; + + +/** + * @brief Affine transformation matrix for 2d translation on the X,Y plane. + * @param vector 2d Vector to translate by. + * @returns an Affine transformation matrix for use with `multmatrix()` + */ +function affine_translation(vector) = [ + [1, 0, 0, vector.y], + [0, 1, 0, 0], + [0, 0, 1, vector.x], + [0, 0, 0, 1] +]; + +/** + * @brief Create a rectangle with rounded corners by sweeping a 2d object along a path. + * Centered on origin. + */ +module sweep_rounded(width=10, length=10) { + half_width = width/2; + half_length = length/2; + path_points = [ + [-half_width, half_length], //Start + [half_width, half_length], // Over + [half_width, -half_length], //Down + [-half_width, -half_length], // Back over + [-half_width, half_length] // Up to start + ]; + path_vectors = [ + path_points[1] - path_points[0], + path_points[2] - path_points[1], + path_points[3] - path_points[2], + path_points[4] - path_points[3], + ]; + // These contain the translations, but not the rotations + // OpenSCAD requires this hacky for loop to get accumulate to work! + first_translation = affine_translation(path_points[0]); + affine_translations = concat([first_translation], [ + for (i = 0, a = first_translation; + i < len(path_vectors); + a=a * affine_translation(path_vectors[i]), i=i+1) + a * affine_translation(path_vectors[i]) + ]); + + // Affine matrix to rotate around X axis + rot_x = 90; + x_matrix = [ + [1, 0, 0, 0], + [0, cos(rot_x), -sin(rot_x), 0], + [0, sin(rot_x), cos(rot_x), 0], + [0, 0, 0, 1] + ]; + + // Affine matrix to rotate around Z axis + z_rot = 90; + z_matrix = [ + [cos(z_rot), -sin(z_rot), 0, 0], + [sin(z_rot), cos(z_rot), 0, 0], + [0, 0, 1, 0], + [0, 0, 0, 1] + ]; + + // Bring extrusion to the xy plane + affine_matrix = z_matrix * x_matrix; + + walls = [ + for (i = [0 : len(path_vectors) - 1]) + affine_matrix * affine_translations[i] + * affine_rotation(atanv(path_vectors[i])) + ]; + + union() + { + for (i = [0 : len(walls) - 1]){ + multmatrix(walls[i]) + linear_extrude(vector_magnitude(path_vectors[i])) + children(); + + // Rounded Corners + multmatrix(walls[i] + *x_matrix*x_matrix*x_matrix *z_matrix*z_matrix*z_matrix*z_matrix) + rotate_extrude(angle = 90, convexity = 4) + children(); + } + } +} diff --git a/gridfinity-rebuilt-utility.scad b/gridfinity-rebuilt-utility.scad index 333dbda..3fa930f 100644 --- a/gridfinity-rebuilt-utility.scad +++ b/gridfinity-rebuilt-utility.scad @@ -5,6 +5,7 @@ */ include +use // ===== User Modules ===== // @@ -621,171 +622,3 @@ module profile_cutter_tab(h, tab, ang) { polygon([[0,h],[tab,h],[0,h-tab*tan(ang)]]); } - -// ==== Utilities ===== - -function clp(x,a,b) = min(max(x,a),b); - -module rounded_rectangle(length, width, height, rad) { - linear_extrude(height) - offset(rad) - offset(-rad) - square([length,width], center = true); -} - -module rounded_square(length, height, rad) { - rounded_rectangle(length, length, height, rad); -} - -module copy_mirror(vec=[0,1,0]) { - children(); - if (vec != [0,0,0]) - mirror(vec) - children(); -} - -module pattern_linear(x = 1, y = 1, sx = 0, sy = 0) { - yy = sy <= 0 ? sx : sy; - translate([-(x-1)*sx/2,-(y-1)*yy/2,0]) - for (i = [1:ceil(x)]) - for (j = [1:ceil(y)]) - translate([(i-1)*sx,(j-1)*yy,0]) - children(); -} - -module pattern_circular(n=2) { - for (i = [1:n]) - rotate(i*360/n) - children(); -} - -/** - * @brief Unity (no change) affine transformation matrix. - * @details For use with multmatrix transforms. - */ -unity_matrix = [ - [1, 0, 0, 0], - [0, 1, 0, 0], - [0, 0, 1, 0], - [0, 0, 0, 1] -]; - -/** - * @brief Get the magnitude of a 2d or 3d vector - * @param vector A 2d or 3d vectorm - * @returns Magnitude of the vector. - */ - function vector_magnitude(vector) = - sqrt(vector.x^2 + vector.y^2 + (len(vector) == 3 ? vector.z^2 : 0)); - -/** - * @brief Convert a 2d or 3d vector into a unit vector - * @returns The unit vector. Where total magnitude is 1. - */ -function vector_as_unit(vector) = vector / vector_magnitude(vector); - -/** - * @brief Convert a 2d vector into an angle. - * @details Just a wrapper around atan2. - * @param A 2d vectorm - * @returns Angle of the vector. - */ -function atanv(vector) = atan2(vector.y, vector.x); - -/** - * @brief Affine transformation matrix for 2d rotation on the X,Y plane. - * @param angle The angle to rotate things by - * @returns an Affine transformation matrix for use with `multmatrix()` - */ -function affine_rotation(angle) = [ - [cos(angle), 0, sin(angle), 0], - [0, 1, 0, 0], - [-sin(angle), 0, cos(angle), 0], - [0, 0, 0, 1] -]; - - -/** - * @brief Affine transformation matrix for 2d translation on the X,Y plane. - * @param vector 2d Vector to translate by. - * @returns an Affine transformation matrix for use with `multmatrix()` - */ -function affine_translation(vector) = [ - [1, 0, 0, vector.y], - [0, 1, 0, 0], - [0, 0, 1, vector.x], - [0, 0, 0, 1] -]; - -/** - * @brief Create a rectangle with rounded corners by sweeping a 2d object along a path. - * Centered on origin. - */ -module sweep_rounded(width=10, length=10) { - half_width = width/2; - half_length = length/2; - path_points = [ - [-half_width, half_length], //Start - [half_width, half_length], // Over - [half_width, -half_length], //Down - [-half_width, -half_length], // Back over - [-half_width, half_length] // Up to start - ]; - path_vectors = [ - path_points[1] - path_points[0], - path_points[2] - path_points[1], - path_points[3] - path_points[2], - path_points[4] - path_points[3], - ]; - // These contain the translations, but not the rotations - // OpenSCAD requires this hacky for loop to get accumulate to work! - first_translation = affine_translation(path_points[0]); - affine_translations = concat([first_translation], [ - for (i = 0, a = first_translation; - i < len(path_vectors); - a=a * affine_translation(path_vectors[i]), i=i+1) - a * affine_translation(path_vectors[i]) - ]); - - // Affine matrix to rotate around X axis - rot_x = 90; - x_matrix = [ - [1, 0, 0, 0], - [0, cos(rot_x), -sin(rot_x), 0], - [0, sin(rot_x), cos(rot_x), 0], - [0, 0, 0, 1] - ]; - - // Affine matrix to rotate around Z axis - z_rot = 90; - z_matrix = [ - [cos(z_rot), -sin(z_rot), 0, 0], - [sin(z_rot), cos(z_rot), 0, 0], - [0, 0, 1, 0], - [0, 0, 0, 1] - ]; - - // Bring extrusion to the xy plane - affine_matrix = z_matrix * x_matrix; - - walls = [ - for (i = [0 : len(path_vectors) - 1]) - affine_matrix * affine_translations[i] - * affine_rotation(atanv(path_vectors[i])) - ]; - - union() - { - for (i = [0 : len(walls) - 1]){ - multmatrix(walls[i]) - linear_extrude(vector_magnitude(path_vectors[i])) - children(); - - // Rounded Corners - multmatrix(walls[i] - *x_matrix*x_matrix*x_matrix *z_matrix*z_matrix*z_matrix*z_matrix) - rotate_extrude(angle = 90, convexity = 4) - children(); - } - } -}