Macro MatrixTransform
|
|
| Description |
|---|
| Transforme unobjet en modifiant la matrice 3x3 (parametrique). Cette macro est composée de 2 macro: MatrixTransform.FCMacro (lanceur) et MatrixTransform.py (exécuteur). Le .FCMacro est installé avec AddonManager vous devez installer la macro .py manuellement. Lien des deux macros: MatrixTransform.FCMacro MatrixTransform.FCMacro (lanceur) MatrixTransform.py (exécuteur) Version macro : 1.0 Date dernière modification : 2016-05-25 Version FreeCAD : All Téléchargement : ToolBar Icon Auteur: DeepSOIC |
| Auteur |
| DeepSOIC |
| Téléchargement |
| ToolBar Icon |
| Liens |
| Page des macros Comment installer une macro Comment créer une barre d'outils |
| Version Macro |
| 1.0 |
| Dernière modification |
| 2016-05-25 |
| Version(s) FreeCAD |
| All |
| Raccourci clavier |
| None |
| Voir aussi |
| None |
Description
Applique une transformation linéaire définie par une matrice 3x3 à une forme. Il est possible de:
- appliquer une mise à l'échelle non linéaire à une forme
- cisailler une forme
- faire pivoter une forme
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
# to guide the user to the online download page.
# 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",
"This macro must be downloaded from this link\n"
"\n"
"https://raw.githubusercontent.com/DeepSOIC/FreeCAD-Macros/master/MatrixTransform/MatrixTransform.FCMacro" + "\n"
"\n"
"Quit this window to access the download page")
diag.setWindowFlags(QtCore.Qt.WindowStaysOnTopHint)
diag.setWindowModality(QtCore.Qt.ApplicationModal)
diag.exec_()
import webbrowser
webbrowser.open("https://raw.githubusercontent.com/DeepSOIC/FreeCAD-Macros/master/MatrixTransform/MatrixTransform.FCMacro")
Installation
Téléchargez ces deux fichiers et enregistrez-les dans votre répertoire de macros:
Utilisation
- Sélectionnez la forme à transformer
- Dans le menu FreeCAD: Macro → Macros ... → ouble-cliquez sur MatrixTransform.FCMacro. Un nouvel objet sera créé.
- Sélectionnez le nouvel objet et modifiez les propriétés v1, v2, v3 de l'onglet Données pour définir la matrice de transformation.
La Matrix est définies par trois vecteurs:
v1x v2x v3x
M = ( v1y v2y v3y )
v1z v2z v3z
Ici, v1,v2,v3 sont les secteurs définis dans les propriétés. Elles correspondent à la nouvelle direction par rapport aux axes originaux X,Y,Z.
Exemple de matrices
Pas de transformation
1 0 0 0 1 0 0 0 1
Echelle non uniforme
scaleX 0 0
0 scaleY 0
0 0 scaleZ
Partage
(Opération qui rend le texte normal en italique; en supposant que le texte est dans le plan XY)
1 shear 0 0 1 0 0 0 1
'Shear' coefficient qui définit la quantité de cisaillement. 0 n'est pas un cisaillement. 1 crée le texte en italique avec une inclinaison de 45 degrés. -1 cisaille à la façon d'une barre oblique inverse.
Attention: Toute la géométrie est convertie en B-splines, même si ce n'est pas obligatoire.
Cela peut causer toutes sortes de problèmes. A n'utilisez que si c'est absolument nécessaire.
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 *
#* the License, or (at your option) any later version. *
#* 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.
'''
import FreeCAD as App
if App.GuiUp:
import FreeCADGui as Gui
import Part
def makeMatrixTransformFeature():
'''makeMatrixTransformFeature(): makes a MatrixTransform parametric feature object. Returns the new object.'''
obj = App.ActiveDocument.addObject("Part::FeaturePython","Transform")
MatrixTransform(obj)
ViewProviderMatrixTransform(obj.ViewObject)
return obj
class MatrixTransform:
"The FuseCompound object"
def __init__(self,obj):
obj.addProperty("App::PropertyLink","Base","MatrixTransform","Input shape")
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 *
#* the License, or (at your option) any later version. *
#* 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()