mirror of
https://github.com/kennetek/gridfinity-rebuilt-openscad.git
synced 2024-05-15 03:44:51 +00:00
Move helper functions / modules to their own file
These are not explicitly tied to Gridfinity.
This commit is contained in:
Arthur Moore
parent
1cf350121d
commit
574d9dc6b1
170
generic-helpers.scad
Normal file
170
generic-helpers.scad
Normal file
|
|
@ -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();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
@ -5,6 +5,7 @@
|
|||
*/
|
||||
|
||||
include <standard.scad>
|
||||
use <generic-helpers.scad>
|
||||
|
||||
// ===== 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();
|
||||
}
|
||||
}
|
||||
}
|
||||
|
|
|
|||
Loading…
Reference in a new issue