# Macro MatrixTransform

Other languages:
Description MatrixTransform Applies linear transformation to a shape, defined by a 3x3 matrix. It is possible to: apply non-linear scaling to a shape, shear a shape, rotate a shape.This macro is composed of 2 macro: MatrixTransform.FCMacro (launcher) and MatrixTransform.py (executor).The .FCMacro is installed with AddonManager you must install the .py macro manually.Link of th two macros:MatrixTransform.FCMacro (launcher)MatrixTransform.py (executor)Macro version: 1.0Last modified: 2016-05-25FreeCAD version: AllDownload: ToolBar IconAuthor: DeepSOIC DeepSOIC ToolBar Icon Macros recipesHow to install macrosHow to customize toolbars 1.0 2016-05-25 All None None

## Description

Applies linear transformation to a shape, defined by a 3x3 matrix. It is possible to:

• apply non-linear scaling to a shape
• shear a shape
• rotate a shape

The transformation in the macro is linear. Lines remain straight, planes remain planar, parallel things remain parallel, only angles are distorted.

Temporary code for external macro link. Do not use this code. This code is used exclusively by Addon Manager. Link for optional manual installation: Macro

```
# This code is copied instead of the original macro code
# Use it if the code of the macro is larger than 64 KB and cannot be included in the wiki
# or if the RAW code URL is somewhere else in the wiki.

from PySide import QtGui, QtCore

diag = QtGui.QMessageBox(QtGui.QMessageBox.Information,
"Information",
"\n"
"\n"

diag.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
diag.setWindowModality(QtCore.Qt.ApplicationModal)
diag.exec_()

import webbrowser
```

## How to use:

1. Select the shape to be transformed
2. In FreeCAD menu: Macro -> Macros... -> double-click MatrixTransform.FCMacro . A new object will be created.
3. Select the new object, and edit v1,v2,v3 properties on data tab to set the transformation matrix.

Matrix is defined by three vectors:

```          v1x   v2x   v3x
M = (  v1y   v2y   v3y )
v1z   v2z   v3z
```

Here, v1,v2,v3 are vectors that can be defined in properties. They correspond to new directions of what was originally X,Y,Z axes.

### example matrices

#### No transformation

```   1  0  0
0  1  0
0  0  1
```

#### non-uniform scaling

```   scaleX    0      0
0   scaleY    0
0      0   scaleZ
```

#### shearing

(operation that makes regular text into italic; assuming text is in XY plane)

```   1  shear  0
0    1    0
0    0    1
```

'Shear' coefficient defines the amount of shearing. 0 is no shearing. 1 makes the text italic by 45 degrees. -1 shears in backslash-like fashion.

Warning. All geometry is converted to B-splines, even if it doesn't have to. This can cause all sorts of trouble. Use only if absolutely necessary.

## Script

ToolBar Icon

MatrixTransform.py:

```#***************************************************************************
#*                                                                         *
#*   Copyright (c) 2015 - Victor Titov (DeepSOIC)                          *
#*                                               <vv.titov@gmail.com>      *
#*                                                                         *
#*   This program is free software; you can redistribute it and/or modify  *
#*   it under the terms of the GNU Lesser General Public License (LGPL)    *
#*   as published by the Free Software Foundation; either version 2 of     *
#*   for detail see the LICENCE text file.                                 *
#*                                                                         *
#*   This program is distributed in the hope that it will be useful,       *
#*   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
#*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
#*   GNU Library General Public License for more details.                  *
#*                                                                         *
#*   You should have received a copy of the GNU Library General Public     *
#*   License along with this program; if not, write to the Free Software   *
#*   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
#*   USA                                                                   *
#*                                                                         *
#***************************************************************************

__title__="Macro MatrixTransform"
__author__ = "DeepSOIC"
__doc__ = '''
Macro MatrixTransform.
Distorts geometry according to vector transformation defined by the matrix.

Matrix is defined by three vectors:
v1x   v2x   v3x
M = (  v1y   v2y   v3y )
v1z   v2z   v3z
Here, v1,v2,v3 are vectors that can be defined in properties. They correspond
to new directions of what was originally X,Y,Z axes.

exmaple matrices:

No transformation:
1  0  0
0  1  0
0  0  1

non-uniform scaling:
scaleX    0      0
0   scaleY    0
0      0   scaleZ

shearing (operation that makes regular text into italic; assuming text is in XY
plane):
1  shear  0
0    1    0
0    0    1
('shear' coefficient defines the amount of shearing. 0 is no shearing. 1 makes
the text italic by 45 degrees. -1 shears in backslash-like fashion.)

Warning. All geometry is converted to B-splines, even if it doesn't have to.
This can cause all sorts of trouble. Use only if absolutely necessary.
'''

if App.GuiUp:
import Part

def makeMatrixTransformFeature():
'''makeMatrixTransformFeature(): makes a MatrixTransform parametric feature object. Returns the new object.'''
MatrixTransform(obj)
ViewProviderMatrixTransform(obj.ViewObject)
return obj

class MatrixTransform:
"The FuseCompound object"
def __init__(self,obj):
obj.addProperty("App::PropertyVector","v1","MatrixTransform","Vector for new X axis; first column of transform matrix.")
obj.addProperty("App::PropertyVector","v2","MatrixTransform","Vector for new Y axis; second column of transform matrix.")
obj.addProperty("App::PropertyVector","v3","MatrixTransform","Vector for new Z axis; third column of transform matrix.")
obj.v1 = App.Vector(1,0,0)
obj.v2 = App.Vector(1,1,0)
obj.v3 = App.Vector(0,0,1)
obj.Proxy = self

def execute(self,obj):
v1 = obj.v1
v2 = obj.v2
v3 = obj.v3
m = App.Matrix(  v1.x, v2.x, v3.x, 0,
v1.y, v2.y, v3.y, 0,
v1.z, v2.z, v3.z, 0,
0,    0,    0,    1   )
obj.Shape = obj.Base.Shape.transformGeometry(m)

class ViewProviderMatrixTransform:

def __init__(self,vobj):
vobj.Proxy = self

def getIcon(self):
return ""

def attach(self, vobj):
self.ViewObject = vobj
self.Object = vobj.Object

def setEdit(self,vobj,mode):
return False

def unsetEdit(self,vobj,mode):
return

def __getstate__(self):
return None

def __setstate__(self,state):
return None

def claimChildren(self):
return [self.Object.Base]

def onDelete(self, feature, subelements): # subelements is a tuple of strings
try:
self.Object.Base.ViewObject.show()
except Exception as err:
App.Console.PrintError("Error in onDelete: " + err.message)
return True

def run():
sel = Gui.Selection.getSelection()
try:
if len(sel) != 1:
raise Exception("Select a shape to transform, first! Then run this macro.")
obj = makeMatrixTransformFeature()
obj.Base = sel[0]
obj.Proxy.execute(obj)
except Exception as err:
from PySide import QtGui
mb = QtGui.QMessageBox()
mb.setIcon(mb.Icon.Warning)
mb.setText(err.message)
mb.setWindowTitle("Macro MatrixTransform")
mb.exec_()```

Macro MatrixTransform.FCMacro

```#***************************************************************************
#*                                                                         *
#*   Copyright (c) 2015 - Victor Titov (DeepSOIC)                          *
#*                                               <vv.titov@gmail.com>      *
#*                                                                         *
#*   This program is free software; you can redistribute it and/or modify  *
#*   it under the terms of the GNU Lesser General Public License (LGPL)    *
#*   as published by the Free Software Foundation; either version 2 of     *
#*   for detail see the LICENCE text file.                                 *
#*                                                                         *
#*   This program is distributed in the hope that it will be useful,       *
#*   but WITHOUT ANY WARRANTY; without even the implied warranty of        *
#*   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the         *
#*   GNU Library General Public License for more details.                  *
#*                                                                         *
#*   You should have received a copy of the GNU Library General Public     *
#*   License along with this program; if not, write to the Free Software   *
#*   Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  *
#*   USA                                                                   *
#*                                                                         *
#***************************************************************************

__title__="Macro MatrixTransform"
__author__ = "DeepSOIC"
__doc__ = '''
Macro MatrixTransform.
Distorts geometry according to vector transformation defined by the matrix.

Matrix is defined by three vectors:
v1x   v2x   v3x
M = (  v1y   v2y   v3y )
v1z   v2z   v3z
Here, v1,v2,v3 are vectors that can be defined in properties. They correspond
to new directions of what was originally X,Y,Z axes.

exmaple matrices:

No transformation:
1  0  0
0  1  0
0  0  1

non-uniform scaling:
scaleX    0      0
0   scaleY    0
0      0   scaleZ

shearing (operation that makes regular text into italic; assuming text is in XY
plane):
1  shear  0
0    1    0
0    0    1
('shear' coefficient defines the amount of shearing. 0 is no shearing. 1 makes
the text italic by 45 degrees. -1 shears in backslash-like fashion.)

Instruciotns:
Select the object to be sheared, then run the macro. A new object will be
created, with shear matrix filled in by default. Edit values of v1, v2, v3 to
change the behavior.

Warning. All geometry is converted to B-splines, even if it doesn't have to.
This can cause all sorts of trouble. Use only if absolutely necessary.
'''

import MatrixTransform
MatrixTransform.run()```

Run the macro

MatrixTransform.FCMacro:

```import MatrixTransform
MatrixTransform.run()
```