276 lines
12 KiB
HTML
276 lines
12 KiB
HTML
<html><head><title>Macro MatrixTransform/it</title><meta http-equiv="Content-Type" content="text/html; charset=utf-8"><link type='text/css' href='wiki.css' rel='stylesheet'></head><body><h1>Macro MatrixTransform/it</h1></div>
|
|
|
|
<div id="mw-content-text" lang="it" dir="ltr" class="mw-content-ltr"><hr/><div class="mw-parser-output"><table class="fcinfobox wikitable ct" width="100%" style="float: right; width: 230px; margin-left: 10px;">
|
|
<tr>
|
|
<td class="ctTitle">
|
|
<h3><span class="mw-headline" id="Trasformazioni"><a href="https://www.freecadweb.org/wiki/index.php?title=File:Text-x-python.png" class="image"><img alt="Text-x-python.png" src="32px-Text-x-python.png" width="32" height="32" srcset="/wiki/images/2/2c/Text-x-python.png 1.5x" /></a> Trasformazioni</span></h3>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Descrizione
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven left">Trasforma una forma utilizzando una matrice 3x3 (parametrica)
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Autore
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven"><a href="https://www.freecadweb.org/wiki/index.php?title=User:DeepSOIC" title="User:DeepSOIC">DeepSOIC</a>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Link
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven"><a href="https://www.freecadweb.org/wiki/index.php?title=Macros_recipes/it" title="Macros recipes/it">Esempi di macro</a><br /><a href="https://www.freecadweb.org/wiki/index.php?title=How_to_install_macros/it" title="How to install macros/it">Come installare le Macro</a><br /><a href="https://www.freecadweb.org/wiki/index.php?title=Customize_Toolbars/it" title="Customize Toolbars/it">Personalizzare la barra degli strumenti</a>
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Versione
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven macro-version">1.0
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">Data ultima modifica
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctEven macro-date">2016-05-25
|
|
</td></tr>
|
|
<tr>
|
|
<th class="ctOdd">
|
|
</th></tr>
|
|
<tr>
|
|
<td class="ctToc"><br /><div id="toc" class="toc"><div class="toctitle"><h2>Contents</h2></div>
|
|
<ul>
|
|
<li class="toclevel-1"><a href="#Trasformazioni"><span class="tocnumber">1</span> <span class="toctext">Trasformazioni</span></a></li>
|
|
<li class="toclevel-1 tocsection-1"><a href="#Installazione:"><span class="tocnumber">2</span> <span class="toctext">Installazione:</span></a></li>
|
|
<li class="toclevel-1 tocsection-2"><a href="#Uso:"><span class="tocnumber">3</span> <span class="toctext">Uso:</span></a>
|
|
<ul>
|
|
<li class="toclevel-2 tocsection-3"><a href="#Esempi_di_matrici"><span class="tocnumber">3.1</span> <span class="toctext">Esempi di matrici</span></a>
|
|
<ul>
|
|
<li class="toclevel-3 tocsection-4"><a href="#Nessuna_trasformazione"><span class="tocnumber">3.1.1</span> <span class="toctext">Nessuna trasformazione</span></a></li>
|
|
<li class="toclevel-3 tocsection-5"><a href="#Scalatura_non_uniforme"><span class="tocnumber">3.1.2</span> <span class="toctext">Scalatura non uniforme</span></a></li>
|
|
<li class="toclevel-3 tocsection-6"><a href="#Tosatura"><span class="tocnumber">3.1.3</span> <span class="toctext">Tosatura</span></a></li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</li>
|
|
</ul>
|
|
</div>
|
|
|
|
</td></tr>
|
|
</table>
|
|
<p><br />
|
|
</p><p>Applica a una forma una trasformazione lineare definita da una matrice 3x3. È possibile:
|
|
</p>
|
|
<ul><li> applicare una scalatura non lineare ad una forma</li>
|
|
<li> tosare una forma (accorciarla)</li>
|
|
<li> ruotare una forma</li></ul>
|
|
<h2><span class="mw-headline" id="Installazione:">Installazione:</span></h2>
|
|
<p>Scaricare questi due file e salvarli nella directory delle macro:
|
|
</p><p><a rel="nofollow" class="external free" href="https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/MatrixTransform/MatrixTransform.FCMacro">https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/MatrixTransform/MatrixTransform.FCMacro</a>
|
|
</p><p><a rel="nofollow" class="external free" href="https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/MatrixTransform/MatrixTransform.py">https://github.com/DeepSOIC/FreeCAD-Macros/raw/master/MatrixTransform/MatrixTransform.py</a>
|
|
</p>
|
|
<h2><span class="mw-headline" id="Uso:">Uso:</span></h2>
|
|
<ol><li> Selezionare la forma da trasformare</li>
|
|
<li> Nel menu di FreeCAD: Macro -> Macros... -> fare doppio click su MatrixTransform.FCMacro . Viene creato un nuovo oggetto.</li>
|
|
<li> Selezionare il nuovo oggetto, e editare le proprietà v1,v2,v3 nella scheda dati per impostare la matrice di trasformazione.</li></ol>
|
|
<p>La matrice è definita da tre vettori:
|
|
</p>
|
|
<pre> v1x v2x v3x
|
|
M = ( v1y v2y v3y )
|
|
v1z v2z v3z
|
|
</pre>
|
|
<p>Quì, v1,v2,v3 sono vettori che possono essere definiti nelle proprietà. essi corrispondono
|
|
alle nuove direzioni di quelle che erano gli assi X, Y, Z originali
|
|
</p>
|
|
<h3><span class="mw-headline" id="Esempi_di_matrici">Esempi di matrici</span></h3>
|
|
<h4><span class="mw-headline" id="Nessuna_trasformazione">Nessuna trasformazione</span></h4>
|
|
<pre> 1 0 0
|
|
0 1 0
|
|
0 0 1
|
|
</pre>
|
|
<h4><span class="mw-headline" id="Scalatura_non_uniforme">Scalatura non uniforme</span></h4>
|
|
<pre> scaleX 0 0
|
|
0 scaleY 0
|
|
0 0 scaleZ
|
|
</pre>
|
|
<h4><span class="mw-headline" id="Tosatura">Tosatura</span></h4>
|
|
<p>(operazione che fa testo normale in corsivo (italic inclinato); assumendo che il testo è nel piano XY)
|
|
</p>
|
|
<pre> 1 shear 0
|
|
0 1 0
|
|
0 0 1
|
|
</pre>
|
|
<p>'Shear' Coefficiente definisce la quantità di taglio. 0 non c'è tosatura. 1 inclina il testo in corsivo di 45°. -1 inclna all'indietro.
|
|
</p><p><br />
|
|
Avvertimento. Tutta la geometria viene convertita in B-spline, anche se non deve. Ciò può causare ogni sorta di guai. Utilizzare solo se assolutamente necessaria.
|
|
</p><p><br />
|
|
</p>
|
|
<div style="clear:both"></div>
|
|
<p><br />
|
|
MatrixTransform.py:
|
|
</p>
|
|
<pre>#***************************************************************************
|
|
#* *
|
|
#* 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_() </pre>
|
|
<p>MatrixTransform.FCMacro:
|
|
</p>
|
|
<pre>import MatrixTransform
|
|
MatrixTransform.run() </pre>
|
|
</div>
|
|
|
|
|
|
|
|
</div>
|
|
|
|
</div><div class="printfooter">
|
|
Online version: "<a dir="ltr" href="https://www.freecadweb.org/wiki/index.php?title=Macro_MatrixTransform/it&oldid=240876">http://www.freecadweb.org/wiki/index.php?title=Macro_MatrixTransform/it&oldid=240876</a>"</div>
|
|
<div id="catlinks" class="catlinks" data-mw="interface"></div><div class="visualClear"></div>
|
|
</div>
|
|
</div>
|
|
<div id="mw-navigation">
|
|
<h2>Navigation menu</h2>
|
|
|
|
</body></html> |