diff --git a/docs/images/lib-m_cumulate-1.JPG b/docs/images/lib-m_cumulate-1.JPG new file mode 100644 index 00000000..d194c206 Binary files /dev/null and b/docs/images/lib-m_cumulate-1.JPG differ diff --git a/docs/lib-m_cumulate.md b/docs/lib-m_cumulate.md new file mode 100644 index 00000000..ff1b604e --- /dev/null +++ b/docs/lib-m_cumulate.md @@ -0,0 +1,30 @@ +# m_cumulate + +The power of using transformation matrice is that you can cumulate all transformations in a matrix. This function multipies all transformation matrice. + +**Since:** 1.1 + +## Parameters + +- `matrice` : A list of 4x4 transformation matrice. + +## Examples + + include ; + include ; + include ; + include + + m = m_cumulate([ + m_translation([10, 20, 10]), m_scaling(2), m_rotation(60)] + ); + + multmatrix(m) + cube(1); + + multmatrix(m) + sphere(1); + + +![m_cumulate](images/lib-m_cumulate-1.JPG) + diff --git a/src/m_cumulate.scad b/src/m_cumulate.scad index 7f20767c..e9893b33 100644 --- a/src/m_cumulate.scad +++ b/src/m_cumulate.scad @@ -1,3 +1,13 @@ +/** +* m_cumulate.scad +* +* @copyright Justin Lin, 2019 +* @license https://opensource.org/licenses/lgpl-3.0.html +* +* @see https://openhome.cc/eGossip/OpenSCAD/lib-m_cumulate.html +* +**/ + include <__private__/__m_multiply.scad>; function _m_cumulate(matrice, i) =