Scripted objects/it: Difference between revisions
Renatorivo (talk | contribs) (Created page with "In seguito si crea il fornitore della vista dell'oggetto (view provider object), responsabile di mostrare l'oggetto nella scena 3D:") |
(Updating to match new version of source page) |
||
(122 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
<languages/> |
|||
Oltre ai tipi di oggetti standard, come le Annotazioni, gli oggetti Mesh e gli oggetti Parte, FreeCAD offre anche la straordinaria possibilità di costruire al 100% oggetti in script di Python, chiamati Python Feature (''Caratteristiche'' Python). Questi oggetti si comportano esattamente come un qualsiasi altro oggetto di FreeCAD, e sono salvati e ripristinati automaticamente con salva/apri il file. |
|||
{{Docnav/it |
|||
Deve essere conosciuta una loro particolarità: questi oggetti vengono salvati in un file FcStd di FreeCAD con il modulo [http://docs.python.org/2/library/json.html json] di Python. Tale modulo converte un oggetto Python in una stringa, permettendo di aggiungerlo al file salvato. Quando l'oggetto viene caricato, il modulo json utilizza questa stringa per ricreare l'oggetto originale, fornendo l'accesso al codice sorgente da cui ha creato l'oggetto. Questo significa che se si salva un oggetto personalizzato e lo si apre su una macchina in cui non è presente il codice Python che ha generato l'oggetto, l'oggetto non può essere ricreato. Quando si forniscono ad altri utenti questi oggetti, è necessario fornire anche gli script di Python che li hanno creati. |
|||
|[[Topological_data_scripting/it|Script di dati topologici]] |
|||
|[[Scenegraph/it|Scena grafica]] |
|||
}} |
|||
{{TOCright}} |
|||
Le Python Features seguono le stesse regole di tutte le altre funzionalità di FreeCAD: sono divise in una parte App e una parte GUI. La parte App, cioè il Document Object (oggetto del documento), definisce la geometria dell'oggetto, mentre la sua parte grafica, cioè il View Provider Object (fornitore della vista dell'oggetto), definisce come l'oggetto viene disegnato sullo schermo. Il View Provider Object, come qualsiasi altro elemento di FreeCAD, è disponibile solo quando si esegue FreeCAD nella sua GUI (interfaccia grafica). Per costruire il proprio oggetto, sono disponibili diversi metodi e proprietà. La Proprietà deve essere una qualsiasi dei tipi di proprietà predefinite che FreeCAD mette a disposizione. Le proprietà disponibili sono quelle che appaiono nella finestra di visualizzazione delle proprietà per consentire all'utente di modificarle. Con questa procedura, gli oggetti FeaturePython sono realmente e totalmente parametrici. E' possibile definire separatamente le proprietà per l'oggetto e per la sua ViewObject (rappresentazione). |
|||
<span id="Introduction"></span> |
|||
'''Nota'''. In versioni precedenti abbiamo usato il modulo [http://docs.python.org/release/2.5/lib/module-cPickle.html cPickle] di Python. Questo modulo, però, esegue un codice arbitrario e provoca quindi un problema di sicurezza. Per questo motivo ora utilizziamo il modulo json di Python. |
|||
==Introduzione== |
|||
Oltre ai tipi di oggetti standard, come le Annotazioni, gli oggetti Mesh e gli oggetti Parte, FreeCAD offre anche la straordinaria possibilità di costruire al 100% oggetti parametrici in script di Python, chiamati [[App_FeaturePython/it|Python Features]] (''Caratteristiche'' Python). Questi oggetti si comportano esattamente come un qualsiasi altro oggetto di FreeCAD, e sono salvati e ripristinati automaticamente con salva/apri il file. |
|||
=== Esempio base === |
|||
Una particolarità deve essere compresa: per motivi di sicurezza, i file di FreeCAD non contengono mai alcun codice incorporato. Il codice Python che scrivi per creare oggetti parametrici non viene mai salvato all'interno di un file. Ciò significa che se apri un file contenente tale oggetto su un'altra macchina, e quel codice Python non è disponibile su quella macchina, l'oggetto non verrà completamente ricreato. Se distribuisci tali oggetti ad altri, dovrai distribuire anche il tuo script Python, ad esempio come [[Macro/it|Macro]]. |
|||
L'esempio seguente si trova nella directory [http://free-cad.svn.sourceforge.net/viewvc/free-cad/trunk/src/Mod/TemplatePyMod/FeaturePython.py?view=markup src/Mod/TemplatePyMod/FeaturePython.py], che contiene anche molti altri esempi: |
|||
<syntaxhighlight> |
|||
"Examples for a feature class and its view provider." |
|||
import FreeCAD, FreeCADGui |
|||
from pivy import coin |
|||
class Box: |
|||
def __init__(self, obj): |
|||
"'''Add some custom properties to our box feature'''" |
|||
obj.addProperty("App::PropertyLength","Length","Box","Length of the box").Length=1.0 |
|||
obj.addProperty("App::PropertyLength","Width","Box","Width of the box").Width=1.0 |
|||
obj.addProperty("App::PropertyLength","Height","Box", "Height of the box").Height=1.0 |
|||
obj.Proxy = self |
|||
def onChanged(self, fp, prop): |
|||
"'''Do something when a property has changed'''" |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
def execute(self, fp): |
|||
"'''Do something when doing a recomputation, this method is mandatory'''" |
|||
FreeCAD.Console.PrintMessage("Recompute Python Box feature\n") |
|||
class ViewProviderBox: |
|||
def __init__(self, obj): |
|||
"'''Set this object to the proxy object of the actual view provider'''" |
|||
obj.addProperty("App::PropertyColor","Color","Box","Color of the box").Color=(1.0,0.0,0.0) |
|||
obj.Proxy = self |
|||
def attach(self, obj): |
|||
"'''Setup the scene sub-graph of the view provider, this method is mandatory'''" |
|||
self.shaded = coin.SoGroup() |
|||
self.wireframe = coin.SoGroup() |
|||
self.scale = coin.SoScale() |
|||
self.color = coin.SoBaseColor() |
|||
data=coin.SoCube() |
|||
self.shaded.addChild(self.scale) |
|||
self.shaded.addChild(self.color) |
|||
self.shaded.addChild(data) |
|||
obj.addDisplayMode(self.shaded,"Shaded"); |
|||
style=coin.SoDrawStyle() |
|||
style.style = coin.SoDrawStyle.LINES |
|||
self.wireframe.addChild(style) |
|||
self.wireframe.addChild(self.scale) |
|||
self.wireframe.addChild(self.color) |
|||
self.wireframe.addChild(data) |
|||
obj.addDisplayMode(self.wireframe,"Wireframe"); |
|||
self.onChanged(obj,"Color") |
|||
def updateData(self, fp, prop): |
|||
"'''If a property of the handled feature has changed we have the chance to handle this here'''" |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
l = fp.getPropertyByName("Length") |
|||
w = fp.getPropertyByName("Width") |
|||
h = fp.getPropertyByName("Height") |
|||
self.scale.scaleFactor.setValue(l,w,h) |
|||
pass |
|||
def getDisplayModes(self,obj): |
|||
"'''Return a list of display modes.'''" |
|||
modes=[] |
|||
modes.append("Shaded") |
|||
modes.append("Wireframe") |
|||
return modes |
|||
def getDefaultDisplayMode(self): |
|||
"'''Return the name of the default display mode. It must be defined in getDisplayModes.'''" |
|||
return "Shaded" |
|||
def setDisplayMode(self,mode): |
|||
"'''Map the display mode defined in attach with those defined in getDisplayModes.\''' |
|||
'''Since they have the same names nothing needs to be done. This method is optional'''" |
|||
return mode |
|||
def onChanged(self, vp, prop): |
|||
"'''Here we can do something when a single property got changed'''" |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
if prop == "Color": |
|||
c = vp.getPropertyByName("Color") |
|||
self.color.rgb.setValue(c[0],c[1],c[2]) |
|||
def getIcon(self): |
|||
"'''Return the icon in XPM format which will appear in the tree view. This method is\''' |
|||
'''optional and if not defined a default icon is shown.'''" |
|||
return """ |
|||
/* XPM */ |
|||
static const char * ViewProviderBox_xpm[] = { |
|||
"16 16 6 1", |
|||
" c None", |
|||
". c #141010", |
|||
"+ c #615BD2", |
|||
"@ c #C39D55", |
|||
"# c #000000", |
|||
"$ c #57C355", |
|||
" ........", |
|||
" ......++..+..", |
|||
" .@@@@.++..++.", |
|||
" .@@@@.++..++.", |
|||
" .@@ .++++++.", |
|||
" ..@@ .++..++.", |
|||
"###@@@@ .++..++.", |
|||
"##$.@@$#.++++++.", |
|||
"#$#$.$$$........", |
|||
"#$$####### ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
" #$#$$$$$# ", |
|||
" ##$$$$$# ", |
|||
" ####### "}; |
|||
""" |
|||
def __getstate__(self): |
|||
"'''When saving the document this object gets stored using Python's json module.\''' |
|||
'''Since we have some un-serializable parts here -- the Coin stuff -- we must define this method\''' |
|||
'''to return a tuple of all serializable objects or None.'''" |
|||
return None |
|||
def __setstate__(self,state): |
|||
"'''When restoring the serialized object from document we have the chance to set some internals here.\''' |
|||
'''Since no data were serialized nothing needs to be done here.'''" |
|||
return None |
|||
def makeBox(): |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Box") |
|||
Box(a) |
|||
ViewProviderBox(a.ViewObject) |
|||
</syntaxhighlight> |
|||
=== Propietà disponibili === |
|||
'''Nota''': è possibile impacchettare il codice Python all'interno di un file FreeCAD utilizzando la serializzazione json con un App::PropertyPythonObject, ma quel codice non può mai essere eseguito direttamente, e quindi ha poca utilità per il nostro scopo qui. |
|||
Le proprietà sono i veri e propri mattoni per la costruzione degli oggetti FeaturePython. Attraverso di esse, l'utente è in grado di interagire e modificare l'oggetto. Dopo aver creato un nuovo oggetto FeaturePython nel documento ( obj=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Box") ), è possibile ottenere un elenco delle proprietà disponibili digitando: |
|||
<syntaxhighlight> |
|||
Le [[App_FeaturePython/it|Python Features]] seguono le stesse regole di tutte le altre funzionalità di FreeCAD: sono divise in una parte App e una parte GUI. La parte App, cioè il Document Object (oggetto del documento), definisce la geometria dell'oggetto, mentre la sua parte grafica, cioè il View Provider Object (fornitore della vista dell'oggetto), definisce come l'oggetto viene disegnato sullo schermo. Il View Provider Object, come qualsiasi altro elemento di FreeCAD, è disponibile solo quando si esegue FreeCAD nella sua GUI (interfaccia grafica). Per costruire il proprio oggetto, sono disponibili diversi metodi e proprietà. La Proprietà deve essere una qualsiasi dei tipi di proprietà predefinite che FreeCAD mette a disposizione. Le proprietà disponibili sono quelle che appaiono nella finestra di visualizzazione delle proprietà per consentire all'utente di modificarle. Con questa procedura, gli oggetti FeaturePython sono realmente e totalmente parametrici. E' possibile definire separatamente le proprietà per l'oggetto e per la sua ViewObject (rappresentazione). |
|||
obj.supportedProperties() |
|||
</syntaxhighlight> |
|||
<span id="Basic_example"></span> |
|||
Si ottiene l'elenco delle proprietà disponibili: |
|||
== Esempio di base == |
|||
<syntaxhighlight> |
|||
App::PropertyBool |
|||
L'esempio seguente si trova nel file [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/TemplatePyMod/FeaturePython.py src/Mod/TemplatePyMod/FeaturePython.py], con molti altri esempi: |
|||
App::PropertyFloat |
|||
App::PropertyFloatList |
|||
{{Code|code= |
|||
App::PropertyFloatConstraint |
|||
'''Examples for a feature class and its view provider.''' |
|||
App::PropertyAngle |
|||
App::PropertyDistance |
|||
import FreeCAD, FreeCADGui |
|||
App::PropertyInteger |
|||
from pivy import coin |
|||
App::PropertyIntegerConstraint |
|||
App::PropertyPercent |
|||
class Box: |
|||
App::PropertyEnumeration |
|||
def __init__(self, obj): |
|||
App::PropertyIntegerList |
|||
'''Add some custom properties to our box feature''' |
|||
App::PropertyString |
|||
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box").Length = 1.0 |
|||
App::PropertyStringList |
|||
obj.addProperty("App::PropertyLength", "Width", "Box", "Width of the box").Width = 1.0 |
|||
App::PropertyLink |
|||
obj.addProperty("App::PropertyLength", "Height", "Box", "Height of the box").Height = 1.0 |
|||
App::PropertyLinkList |
|||
obj.Proxy = self |
|||
App::PropertyMatrix |
|||
App::PropertyVector |
|||
def onChanged(self, fp, prop): |
|||
App::PropertyVectorList |
|||
'''Do something when a property has changed''' |
|||
App::PropertyPlacement |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
App::PropertyPlacementLink |
|||
App::PropertyColor |
|||
def execute(self, fp): |
|||
App::PropertyColorList |
|||
'''Do something when doing a recomputation, this method is mandatory''' |
|||
App::PropertyMaterial |
|||
FreeCAD.Console.PrintMessage("Recompute Python Box feature\n") |
|||
App::PropertyPath |
|||
App::PropertyFile |
|||
class ViewProviderBox: |
|||
App::PropertyFileIncluded |
|||
def __init__(self, obj): |
|||
Part::PropertyPartShape |
|||
'''Set this object to the proxy object of the actual view provider''' |
|||
Part::PropertyFilletContour |
|||
obj.addProperty("App::PropertyColor","Color", "Box", "Color of the box").Color = (1.0, 0.0, 0.0) |
|||
Part::PropertyCircle |
|||
obj.Proxy = self |
|||
</syntaxhighlight> |
|||
def attach(self, obj): |
|||
'''Setup the scene sub-graph of the view provider, this method is mandatory''' |
|||
self.shaded = coin.SoGroup() |
|||
self.wireframe = coin.SoGroup() |
|||
self.scale = coin.SoScale() |
|||
self.color = coin.SoBaseColor() |
|||
data=coin.SoCube() |
|||
self.shaded.addChild(self.scale) |
|||
self.shaded.addChild(self.color) |
|||
self.shaded.addChild(data) |
|||
obj.addDisplayMode(self.shaded, "Shaded"); |
|||
style=coin.SoDrawStyle() |
|||
style.style = coin.SoDrawStyle.LINES |
|||
self.wireframe.addChild(style) |
|||
self.wireframe.addChild(self.scale) |
|||
self.wireframe.addChild(self.color) |
|||
self.wireframe.addChild(data) |
|||
obj.addDisplayMode(self.wireframe, "Wireframe"); |
|||
self.onChanged(obj,"Color") |
|||
def updateData(self, fp, prop): |
|||
'''If a property of the handled feature has changed we have the chance to handle this here''' |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
l = fp.getPropertyByName("Length") |
|||
w = fp.getPropertyByName("Width") |
|||
h = fp.getPropertyByName("Height") |
|||
self.scale.scaleFactor.setValue(float(l), float(w), float(h)) |
|||
pass |
|||
def getDisplayModes(self,obj): |
|||
'''Return a list of display modes.''' |
|||
modes=[] |
|||
modes.append("Shaded") |
|||
modes.append("Wireframe") |
|||
return modes |
|||
def getDefaultDisplayMode(self): |
|||
'''Return the name of the default display mode. It must be defined in getDisplayModes.''' |
|||
return "Shaded" |
|||
def setDisplayMode(self,mode): |
|||
'''Map the display mode defined in attach with those defined in getDisplayModes.\ |
|||
Since they have the same names nothing needs to be done. This method is optional''' |
|||
return mode |
|||
def onChanged(self, vp, prop): |
|||
'''Here we can do something when a single property got changed''' |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
if prop == "Color": |
|||
c = vp.getPropertyByName("Color") |
|||
self.color.rgb.setValue(c[0], c[1], c[2]) |
|||
def getIcon(self): |
|||
'''Return the icon in XPM format which will appear in the tree view. This method is\ |
|||
optional and if not defined a default icon is shown.''' |
|||
return """ |
|||
/* XPM */ |
|||
static const char * ViewProviderBox_xpm[] = { |
|||
"16 16 6 1", |
|||
" c None", |
|||
". c #141010", |
|||
"+ c #615BD2", |
|||
"@ c #C39D55", |
|||
"# c #000000", |
|||
"$ c #57C355", |
|||
" ........", |
|||
" ......++..+..", |
|||
" .@@@@.++..++.", |
|||
" .@@@@.++..++.", |
|||
" .@@ .++++++.", |
|||
" ..@@ .++..++.", |
|||
"###@@@@ .++..++.", |
|||
"##$.@@$#.++++++.", |
|||
"#$#$.$$$........", |
|||
"#$$####### ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
" #$#$$$$$# ", |
|||
" ##$$$$$# ", |
|||
" ####### "}; |
|||
""" |
|||
def dumps(self): |
|||
'''When saving the document this object gets stored using Python's json module.\ |
|||
Since we have some un-serializable parts here -- the Coin stuff -- we must define this method\ |
|||
to return a tuple of all serializable objects or None.''' |
|||
return None |
|||
def loads(self,state): |
|||
'''When restoring the serialized object from document we have the chance to set some internals here.\ |
|||
Since no data were serialized nothing needs to be done here.''' |
|||
return None |
|||
def makeBox(): |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython", "Box") |
|||
Box(a) |
|||
ViewProviderBox(a.ViewObject) |
|||
makeBox() |
|||
}} |
|||
<span id="Things_to_note"></span> |
|||
=== Cose da notare === |
|||
Se il tuo oggetto si basa sul ricalcolo non appena viene creato, devi farlo manualmente nella funzione {{incode|__init__}} poiché non viene chiamato automaticamente. Questo esempio non lo richiede, perché il metodo {{incode|onChanged}} della classe {{incode|Box}} ha lo stesso effetto della funzione {{incode|execute}}, ma gli esempi seguenti si basano sull'essere ricalcolati prima che qualsiasi cosa venga visualizzata nella vista 3D. Negli esempi, questo viene fatto manualmente con {{incode|ActiveDocument.recompute()}}, ma in scenari più complessi devi decidere dove ricalcolare l'intero documento o l'oggetto FeaturePython. |
|||
Questo esempio produce una serie di analisi dello stack di eccezioni nella finestra di visualizzazione del report. Questo perché il metodo {{incode|onChanged}} della classe {{incode|Box}} viene chiamato ogni volta che viene aggiunta una proprietà in {{incode|__init__}}. Quando viene aggiunta la prima, le proprietà Width e Height non esistono ancora e quindi il tentativo di accedervi fallisce. |
|||
<div class="mw-translate-fuzzy"> |
|||
Una spiegazione di {{incode|__getstate__}} e {{incode|__setstate__}} è nel thread del forum [https://forum.freecadweb.org/viewtopic.php?f=18&t=44009&start=10#p377892 obj.Proxy.Type è un dizionario, non una stringa]. |
|||
</div> |
|||
{{incode|obj.addProperty(...)}} returns {{incode|obj}}, so that the value of the property can be set on the same line: |
|||
{{Code|code= |
|||
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box").Length = 1.0 |
|||
}} |
|||
Which is equivalent to: |
|||
{{Code|code= |
|||
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box") |
|||
obj.Length = 1.0 |
|||
}} |
|||
<span id="Other_more_complex_example"></span> |
|||
== Un altro esempio più complesso == |
|||
In questo esempio si utilizza il Modulo [[Part_Workbench/it|Part]] per creare un ottaedro, quindi si crea la sua rappresentazione Coin con Pivy. |
|||
Prima si crea l'oggetto del documento: |
|||
{{Code|code= |
|||
import FreeCAD, FreeCADGui, Part |
|||
import pivy |
|||
from pivy import coin |
|||
class Octahedron: |
|||
def __init__(self, obj): |
|||
"Add some custom properties to our box feature" |
|||
obj.addProperty("App::PropertyLength","Length","Octahedron","Length of the octahedron").Length=1.0 |
|||
obj.addProperty("App::PropertyLength","Width","Octahedron","Width of the octahedron").Width=1.0 |
|||
obj.addProperty("App::PropertyLength","Height","Octahedron", "Height of the octahedron").Height=1.0 |
|||
obj.addProperty("Part::PropertyPartShape","Shape","Octahedron", "Shape of the octahedron") |
|||
obj.Proxy = self |
|||
def execute(self, fp): |
|||
# Define six vetices for the shape |
|||
v1 = FreeCAD.Vector(0,0,0) |
|||
v2 = FreeCAD.Vector(fp.Length,0,0) |
|||
v3 = FreeCAD.Vector(0,fp.Width,0) |
|||
v4 = FreeCAD.Vector(fp.Length,fp.Width,0) |
|||
v5 = FreeCAD.Vector(fp.Length/2,fp.Width/2,fp.Height/2) |
|||
v6 = FreeCAD.Vector(fp.Length/2,fp.Width/2,-fp.Height/2) |
|||
# Make the wires/faces |
|||
f1 = self.make_face(v1,v2,v5) |
|||
f2 = self.make_face(v2,v4,v5) |
|||
f3 = self.make_face(v4,v3,v5) |
|||
f4 = self.make_face(v3,v1,v5) |
|||
f5 = self.make_face(v2,v1,v6) |
|||
f6 = self.make_face(v4,v2,v6) |
|||
f7 = self.make_face(v3,v4,v6) |
|||
f8 = self.make_face(v1,v3,v6) |
|||
shell=Part.makeShell([f1,f2,f3,f4,f5,f6,f7,f8]) |
|||
solid=Part.makeSolid(shell) |
|||
fp.Shape = solid |
|||
# helper mehod to create the faces |
|||
def make_face(self,v1,v2,v3): |
|||
wire = Part.makePolygon([v1,v2,v3,v1]) |
|||
face = Part.Face(wire) |
|||
return face |
|||
}} |
|||
In seguito si crea il fornitore della vista dell'oggetto (view provider object), responsabile di mostrare l'oggetto nella scena 3D: |
|||
{{Code|code= |
|||
class ViewProviderOctahedron: |
|||
def __init__(self, obj): |
|||
"Set this object to the proxy object of the actual view provider" |
|||
obj.addProperty("App::PropertyColor","Color","Octahedron","Color of the octahedron").Color=(1.0,0.0,0.0) |
|||
obj.Proxy = self |
|||
def attach(self, obj): |
|||
"Setup the scene sub-graph of the view provider, this method is mandatory" |
|||
self.shaded = coin.SoGroup() |
|||
self.wireframe = coin.SoGroup() |
|||
self.scale = coin.SoScale() |
|||
self.color = coin.SoBaseColor() |
|||
self.data=coin.SoCoordinate3() |
|||
self.face=coin.SoIndexedFaceSet() |
|||
self.shaded.addChild(self.scale) |
|||
self.shaded.addChild(self.color) |
|||
self.shaded.addChild(self.data) |
|||
self.shaded.addChild(self.face) |
|||
obj.addDisplayMode(self.shaded,"Shaded"); |
|||
style=coin.SoDrawStyle() |
|||
style.style = coin.SoDrawStyle.LINES |
|||
self.wireframe.addChild(style) |
|||
self.wireframe.addChild(self.scale) |
|||
self.wireframe.addChild(self.color) |
|||
self.wireframe.addChild(self.data) |
|||
self.wireframe.addChild(self.face) |
|||
obj.addDisplayMode(self.wireframe,"Wireframe"); |
|||
self.onChanged(obj,"Color") |
|||
def updateData(self, fp, prop): |
|||
"If a property of the handled feature has changed we have the chance to handle this here" |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
if prop == "Shape": |
|||
s = fp.getPropertyByName("Shape") |
|||
self.data.point.setNum(6) |
|||
cnt=0 |
|||
for i in s.Vertexes: |
|||
self.data.point.set1Value(cnt,i.X,i.Y,i.Z) |
|||
cnt=cnt+1 |
|||
self.face.coordIndex.set1Value(0,0) |
|||
self.face.coordIndex.set1Value(1,1) |
|||
self.face.coordIndex.set1Value(2,2) |
|||
self.face.coordIndex.set1Value(3,-1) |
|||
self.face.coordIndex.set1Value(4,1) |
|||
self.face.coordIndex.set1Value(5,3) |
|||
self.face.coordIndex.set1Value(6,2) |
|||
self.face.coordIndex.set1Value(7,-1) |
|||
self.face.coordIndex.set1Value(8,3) |
|||
self.face.coordIndex.set1Value(9,4) |
|||
self.face.coordIndex.set1Value(10,2) |
|||
self.face.coordIndex.set1Value(11,-1) |
|||
self.face.coordIndex.set1Value(12,4) |
|||
self.face.coordIndex.set1Value(13,0) |
|||
self.face.coordIndex.set1Value(14,2) |
|||
self.face.coordIndex.set1Value(15,-1) |
|||
self.face.coordIndex.set1Value(16,1) |
|||
self.face.coordIndex.set1Value(17,0) |
|||
self.face.coordIndex.set1Value(18,5) |
|||
self.face.coordIndex.set1Value(19,-1) |
|||
self.face.coordIndex.set1Value(20,3) |
|||
self.face.coordIndex.set1Value(21,1) |
|||
self.face.coordIndex.set1Value(22,5) |
|||
self.face.coordIndex.set1Value(23,-1) |
|||
self.face.coordIndex.set1Value(24,4) |
|||
self.face.coordIndex.set1Value(25,3) |
|||
self.face.coordIndex.set1Value(26,5) |
|||
self.face.coordIndex.set1Value(27,-1) |
|||
self.face.coordIndex.set1Value(28,0) |
|||
self.face.coordIndex.set1Value(29,4) |
|||
self.face.coordIndex.set1Value(30,5) |
|||
self.face.coordIndex.set1Value(31,-1) |
|||
def getDisplayModes(self,obj): |
|||
"Return a list of display modes." |
|||
modes=[] |
|||
modes.append("Shaded") |
|||
modes.append("Wireframe") |
|||
return modes |
|||
def getDefaultDisplayMode(self): |
|||
"Return the name of the default display mode. It must be defined in getDisplayModes." |
|||
return "Shaded" |
|||
def setDisplayMode(self,mode): |
|||
return mode |
|||
def onChanged(self, vp, prop): |
|||
"Here we can do something when a single property got changed" |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
if prop == "Color": |
|||
c = vp.getPropertyByName("Color") |
|||
self.color.rgb.setValue(c[0],c[1],c[2]) |
|||
def getIcon(self): |
|||
return """ |
|||
/* XPM */ |
|||
static const char * ViewProviderBox_xpm[] = { |
|||
"16 16 6 1", |
|||
" c None", |
|||
". c #141010", |
|||
"+ c #615BD2", |
|||
"@ c #C39D55", |
|||
"# c #000000", |
|||
"$ c #57C355", |
|||
" ........", |
|||
" ......++..+..", |
|||
" .@@@@.++..++.", |
|||
" .@@@@.++..++.", |
|||
" .@@ .++++++.", |
|||
" ..@@ .++..++.", |
|||
"###@@@@ .++..++.", |
|||
"##$.@@$#.++++++.", |
|||
"#$#$.$$$........", |
|||
"#$$####### ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
" #$#$$$$$# ", |
|||
" ##$$$$$# ", |
|||
" ####### "}; |
|||
""" |
|||
def dumps(self): |
|||
return None |
|||
def loads(self,state): |
|||
return None |
|||
}} |
|||
Infine, dopo che l'oggetto e il suo visualizzatore sono definiti, basta solo chiamarli (La classe Octahedron e il codice della classe viewprovider possono essere copiati direttamente nella console Python di FreeCAD):: |
|||
{{Code|code= |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Octahedron") |
|||
Octahedron(a) |
|||
ViewProviderOctahedron(a.ViewObject) |
|||
}} |
|||
<span id="Making_objects_selectable"></span> |
|||
== Rendere gli oggetti selezionabili == |
|||
Se volete rendere il vostro oggetto selezionabile, o almeno una parte di esso, facendo clic su di esso nella finestra, è necessario includere la sua geometria Coin all'interno di un nodo SoFCSelection. Se l'oggetto ha una rappresentazione complessa, con widget, annotazioni, etc, si potrebbe voler includere solo una parte di esso in un SoFCSelection. Tutto quello che compone un SoFCSelection viene costantemente analizzato da FreeCAD per rilevare selezioni/preselezioni, quindi non ha senso sovraccaricarlo con delle scansioni non necessarie. |
|||
Una volta che le parti dello scenegraph, che devono essere selezionabili, si trovano all'interno dei nodi SoFCSelection, è necessario fornire due metodi per gestire il percorso di selezione. Il percorso di selezione può assumere la forma di una stringa che fornisce i nomi di ciascun elemento nel percorso o di un array di oggetti scenegraph. I due metodi che fornisci sono {{incode|getDetailPath}}, che converte da un percorso stringa in un array di oggetti scenegraph, e {{incode|getElementPicked}}, che prende un elemento su cui è stato fatto clic nello scenegraph e restituisce il suo nome di stringa (nota, non il suo percorso di stringa). |
|||
Ecco l'esempio della molecola sopra, adattato per rendere selezionabili gli elementi della molecola: |
|||
{{Code|code= |
|||
class Molecule: |
|||
def __init__(self, obj): |
|||
''' Add two point properties ''' |
|||
obj.addProperty("App::PropertyVector","p1","Line","Start point") |
|||
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(5,0,0) |
|||
obj.Proxy = self |
|||
def onChanged(self, fp, prop): |
|||
if prop == "p1" or prop == "p2": |
|||
''' Print the name of the property that has changed ''' |
|||
fp.Shape = Part.makeLine(fp.p1,fp.p2) |
|||
def execute(self, fp): |
|||
''' Print a short message when doing a recomputation, this method is mandatory ''' |
|||
fp.Shape = Part.makeLine(fp.p1,fp.p2) |
|||
class ViewProviderMolecule: |
|||
def __init__(self, obj): |
|||
''' Set this object to the proxy object of the actual view provider ''' |
|||
obj.Proxy = self |
|||
self.ViewObject = obj |
|||
sep1=coin.SoSeparator() |
|||
sel1 = coin.SoType.fromName('SoFCSelection').createInstance() |
|||
# sel1.policy.setValue(coin.SoSelection.SHIFT) |
|||
sel1.ref() |
|||
sep1.addChild(sel1) |
|||
self.trl1=coin.SoTranslation() |
|||
sel1.addChild(self.trl1) |
|||
sel1.addChild(coin.SoSphere()) |
|||
sep2=coin.SoSeparator() |
|||
sel2 = coin.SoType.fromName('SoFCSelection').createInstance() |
|||
sel2.ref() |
|||
sep2.addChild(sel2) |
|||
self.trl2=coin.SoTranslation() |
|||
sel2.addChild(self.trl2) |
|||
sel2.addChild(coin.SoSphere()) |
|||
obj.RootNode.addChild(sep1) |
|||
obj.RootNode.addChild(sep2) |
|||
self.updateData(obj.Object, 'p2') |
|||
self.sel1 = sel1 |
|||
self.sel2 = sel2 |
|||
def getDetailPath(self, subname, path, append): |
|||
vobj = self.ViewObject |
|||
if append: |
|||
path.append(vobj.RootNode) |
|||
path.append(vobj.SwitchNode) |
|||
mode = vobj.SwitchNode.whichChild.getValue() |
|||
if mode >= 0: |
|||
mode = vobj.SwitchNode.getChild(mode) |
|||
path.append(mode) |
|||
sub = Part.splitSubname(subname)[-1] |
|||
if sub == 'Atom1': |
|||
path.append(self.sel1) |
|||
elif sub == 'Atom2': |
|||
path.append(self.sel2) |
|||
else: |
|||
path.append(mode.getChild(0)) |
|||
return True |
|||
def getElementPicked(self, pp): |
|||
path = pp.getPath() |
|||
if path.findNode(self.sel1) >= 0: |
|||
return 'Atom1' |
|||
if path.findNode(self.sel2) >= 0: |
|||
return 'Atom2' |
|||
raise NotImplementedError |
|||
def updateData(self, fp, prop): |
|||
"If a property of the handled feature has changed we have the chance to handle this here" |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
if prop == "p1": |
|||
p = fp.getPropertyByName("p1") |
|||
self.trl1.translation=(p.x,p.y,p.z) |
|||
elif prop == "p2": |
|||
p = fp.getPropertyByName("p2") |
|||
self.trl2.translation=(p.x,p.y,p.z) |
|||
def dumps(self): |
|||
return None |
|||
def loads(self,state): |
|||
return None |
|||
def makeMolecule(): |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Molecule") |
|||
Molecule(a) |
|||
ViewProviderMolecule(a.ViewObject) |
|||
FreeCAD.ActiveDocument.recompute() |
|||
}} |
|||
<span id="Working_with_simple_shapes"></span> |
|||
== Lavorare con forme semplici == |
|||
Se l'oggetto parametrico produce semplicemente una forma, non è necessario utilizzare un fornitore di vista dell'oggetto (view provider object). La forma viene visualizzata utilizzando la rappresentazione della forma standard di FreeCAD: |
|||
{{Code|code= |
|||
import FreeCAD as App |
|||
import FreeCADGui |
|||
import FreeCAD |
|||
import Part |
|||
class Line: |
|||
def __init__(self, obj): |
|||
'''"App two point properties" ''' |
|||
obj.addProperty("App::PropertyVector","p1","Line","Start point") |
|||
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(1,0,0) |
|||
obj.Proxy = self |
|||
def execute(self, fp): |
|||
'''"Print a short message when doing a recomputation, this method is mandatory" ''' |
|||
fp.Shape = Part.makeLine(fp.p1,fp.p2) |
|||
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Line") |
|||
Line(a) |
|||
a.ViewObject.Proxy=0 # just set it to something different from None (this assignment is needed to run an internal notification) |
|||
FreeCAD.ActiveDocument.recompute() |
|||
}} |
|||
Lo stesso codice con l'uso di '''ViewProviderLine''' |
|||
{{Code|code= |
|||
import FreeCAD as App |
|||
import FreeCADGui |
|||
import FreeCAD |
|||
import Part |
|||
class Line: |
|||
def __init__(self, obj): |
|||
'''"App two point properties" ''' |
|||
obj.addProperty("App::PropertyVector","p1","Line","Start point") |
|||
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(100,0,0) |
|||
obj.Proxy = self |
|||
def execute(self, fp): |
|||
'''"Print a short message when doing a recomputation, this method is mandatory" ''' |
|||
fp.Shape = Part.makeLine(fp.p1,fp.p2) |
|||
class ViewProviderLine: |
|||
def __init__(self, obj): |
|||
''' Set this object to the proxy object of the actual view provider ''' |
|||
obj.Proxy = self |
|||
def getDefaultDisplayMode(self): |
|||
''' Return the name of the default display mode. It must be defined in getDisplayModes. ''' |
|||
return "Flat Lines" |
|||
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Line") |
|||
Line(a) |
|||
ViewProviderLine(a.ViewObject) |
|||
App.ActiveDocument.recompute() |
|||
}} |
|||
<span id="Scenegraph_Structure"></span> |
|||
== Struttura di Scenegraph == |
|||
Potresti aver notato che gli esempi sopra costruiscono i loro scenegraphs in modi leggermente diversi. Alcuni usano {{incode|obj.addDisplayMode(node, "modename")}} mentre altri usano {{incode|obj.SwitchNode.getChild(x).addChild(y)}}. |
|||
Ogni caratteristica in un documento di FreeCAD si basa sulla seguente struttura di scenegraph: |
|||
{{Code|code= |
|||
RootNode |
|||
\- SwitchNode |
|||
\- Shaded |
|||
- Wireframe |
|||
- etc |
|||
}} |
|||
{{incode|SwitchNode}} mostra solo uno dei suoi figli, a seconda della modalità di visualizzazione selezionata in FreeCAD. |
|||
Gli esempi che utilizzano {{incode|addDisplayMode}} stanno costruendo i loro scenegraph esclusivamente dagli elementi dello scenegraph di coin3d. Dietro le quinte, {{incode|addDisplayMode}} aggiunge un nuovo figlio a {{incode|SwitchNode}}; il nome di quel nodo corrisponderà alla modalità di visualizzazione, che è stata passata. |
|||
Gli esempi che utilizzano {{incode|SwitchNode.getChild(x).addChild}} costruiscono anche parte della loro geometria utilizzando le funzioni dell'ambiente Part, come {{incode|1=fp.Shape = Part.makeLine(fp.p1 ,fp.p2)}}. Questo costruisce i diversi scenegraph della modalità di visualizzazione sotto {{incode|SwitchNode}}; quando in seguito arriveremo ad aggiungere elementi coin3d allo scenegraph, dobbiamo aggiungerli agli scenegraph della modalità di visualizzazione esistenti usando {{incode|addChild}} piuttosto che creare un nuovo figlio di {{incode|SwitchNode}}. |
|||
Quando si utilizza {{incode|addDisplayMode()}} per aggiungere geometria allo scenegraph, ogni modalità di visualizzazione dovrebbe avere il proprio nodo che viene passato a {{incode|addDisplayMode()}}; non riutilizzare lo stesso nodo per questo. Ciò confonderà il meccanismo di selezione. Va bene se il nodo di ciascuna modalità di visualizzazione ha gli stessi nodi geometrici aggiunti sotto di esso, solo la radice di ciascuna modalità di visualizzazione deve essere distinta. |
|||
Ecco l'esempio della molecola sopra, adattato per essere disegnato solo con oggetti scenegraph Coin3D invece di utilizzare oggetti dall'ambiente Part: |
|||
{{Code|code= |
|||
import Part |
|||
from pivy import coin |
|||
class Molecule: |
|||
def __init__(self, obj): |
|||
''' Add two point properties ''' |
|||
obj.addProperty("App::PropertyVector","p1","Line","Start point") |
|||
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(5,0,0) |
|||
obj.Proxy = self |
|||
def onChanged(self, fp, prop): |
|||
pass |
|||
def execute(self, fp): |
|||
''' Print a short message when doing a recomputation, this method is mandatory ''' |
|||
pass |
|||
class ViewProviderMolecule: |
|||
def __init__(self, obj): |
|||
''' Set this object to the proxy object of the actual view provider ''' |
|||
self.constructed = False |
|||
obj.Proxy = self |
|||
self.ViewObject = obj |
|||
def attach(self, obj): |
|||
material = coin.SoMaterial() |
|||
material.diffuseColor = (1.0, 0.0, 0.0) |
|||
material.emissiveColor = (1.0, 0.0, 0.0) |
|||
drawStyle = coin.SoDrawStyle() |
|||
drawStyle.pointSize.setValue(10) |
|||
drawStyle.style = coin.SoDrawStyle.LINES |
|||
wireframe = coin.SoGroup() |
|||
shaded = coin.SoGroup() |
|||
self.wireframe = wireframe |
|||
self.shaded = shaded |
|||
self.coords = coin.SoCoordinate3() |
|||
self.coords.point.setValues(0, 2, [FreeCAD.Vector(0, 0, 0), FreeCAD.Vector(1, 0, 0)]) |
|||
wireframe += self.coords |
|||
wireframe += drawStyle |
|||
wireframe += material |
|||
shaded += self.coords |
|||
shaded += drawStyle |
|||
shaded += material |
|||
g = coin.SoGroup() |
|||
sel1 = coin.SoType.fromName('SoFCSelection').createInstance() |
|||
sel1.style = 'EMISSIVE_DIFFUSE' |
|||
p1 = coin.SoType.fromName('SoIndexedPointSet').createInstance() |
|||
p1.coordIndex.set1Value(0, 0) |
|||
sel1 += p1 |
|||
g += sel1 |
|||
wireframe += g |
|||
shaded += g |
|||
g = coin.SoGroup() |
|||
sel2 = coin.SoType.fromName('SoFCSelection').createInstance() |
|||
sel2.style = 'EMISSIVE_DIFFUSE' |
|||
p2 = coin.SoType.fromName('SoIndexedPointSet').createInstance() |
|||
p2.coordIndex.set1Value(0, 1) |
|||
sel2 += p2 |
|||
g += sel2 |
|||
wireframe += g |
|||
shaded += g |
|||
g = coin.SoGroup() |
|||
sel3 = coin.SoType.fromName('SoFCSelection').createInstance() |
|||
sel3.style = 'EMISSIVE_DIFFUSE' |
|||
p3 = coin.SoType.fromName('SoIndexedLineSet').createInstance() |
|||
p3.coordIndex.setValues(0, 2, [0, 1]) |
|||
sel3 += p3 |
|||
g += sel3 |
|||
wireframe += g |
|||
shaded += g |
|||
obj.addDisplayMode(wireframe, 'Wireframe') |
|||
obj.addDisplayMode(shaded, 'Shaded') |
|||
self.sel1 = sel1 |
|||
self.sel2 = sel2 |
|||
self.sel3 = sel3 |
|||
self.constructed = True |
|||
self.updateData(obj.Object, 'p2') |
|||
def getDetailPath(self, subname, path, append): |
|||
vobj = self.ViewObject |
|||
if append: |
|||
path.append(vobj.RootNode) |
|||
path.append(vobj.SwitchNode) |
|||
mode = vobj.SwitchNode.whichChild.getValue() |
|||
FreeCAD.Console.PrintWarning("getDetailPath: mode {} is active\n".format(mode)) |
|||
if mode >= 0: |
|||
mode = vobj.SwitchNode.getChild(mode) |
|||
path.append(mode) |
|||
sub = Part.splitSubname(subname)[-1] |
|||
print(sub) |
|||
if sub == 'Atom1': |
|||
path.append(self.sel1) |
|||
elif sub == 'Atom2': |
|||
path.append(self.sel2) |
|||
elif sub == 'Line': |
|||
path.append(self.sel3) |
|||
else: |
|||
path.append(mode.getChild(0)) |
|||
return True |
|||
def getElementPicked(self, pp): |
|||
path = pp.getPath() |
|||
if path.findNode(self.sel1) >= 0: |
|||
return 'Atom1' |
|||
if path.findNode(self.sel2) >= 0: |
|||
return 'Atom2' |
|||
if path.findNode(self.sel3) >= 0: |
|||
return 'Line' |
|||
raise NotImplementedError |
|||
def updateData(self, fp, prop): |
|||
"If a property of the handled feature has changed we have the chance to handle this here" |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
if not self.constructed: |
|||
return |
|||
if prop == "p1": |
|||
p = fp.getPropertyByName("p1") |
|||
self.coords.point.set1Value(0, p) |
|||
elif prop == "p2": |
|||
p = fp.getPropertyByName("p2") |
|||
self.coords.point.set1Value(1, p) |
|||
def getDisplayModes(self, obj): |
|||
return ['Wireframe', 'Shaded'] |
|||
def getDefaultDisplayMode(self): |
|||
return 'Shaded' |
|||
def setDisplayMode(self, mode): |
|||
return mode |
|||
def dumps(self): |
|||
return None |
|||
def loads(self,state): |
|||
return None |
|||
def makeMolecule(): |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Molecule") |
|||
Molecule(a) |
|||
b=ViewProviderMolecule(a.ViewObject) |
|||
a.touch() |
|||
FreeCAD.ActiveDocument.recompute() |
|||
return a,b |
|||
a,b = makeMolecule() |
|||
}} |
|||
<span id="Part_Design_scripted_objects"></span> |
|||
== Oggetti con script di Part Design == |
|||
Quando si creano oggetti con script in Part Design, il processo è simile agli oggetti con script discussi sopra, ma con alcune considerazioni aggiuntive. Dobbiamo gestire 2 proprietà della forma, una per la forma, che vediamo nella vista 3D e un'altra per la forma utilizzata dagli strumenti del modello, come le caratteristiche del modello polare. Le forme dell'oggetto devono anche essere fuse con qualsiasi materiale esistente già nel Corpo (o tagliate da esso nel caso di funzioni sottrattive). E dobbiamo tenere conto della collocazione e dell'attaccamento dei nostri oggetti in modo un po' diverso. |
|||
Le feature di oggetti solidi con script di Part Design devono essere basate su PartDesign::FeaturePython, PartDesign::FeatureAdditivePython o PartDesign::FeatureSubtractivePython piuttosto che su Part::FeaturePython. Solo le varianti Additive e Subtractive possono essere utilizzate nelle feature di ripetizione e, se basate su Part::FeaturePython, quando l'utente rilascia l'oggetto in un Body di Part Design, diventa una BaseFeature invece di essere trattato dal Body come un oggetto di Part Design nativo. Nota: tutti questi dovrebbero essere solidi, quindi se stai creando una caratteristica non solida dovrebbe essere basata su Part::FeaturePython altrimenti la caratteristica successiva nell'albero tenterà di fondersi come un solido e fallirà . |
|||
Di seguito è riportato un semplice esempio di creazione di una primitiva Tube, simile alla primitiva Tube nell'ambiente Part, tranne per il fatto che questa sarà un oggetto feature solido di Part Design. Per questo useremo 2 file separati: pdtube.FCMacro e pdtube.py. Il file .FCMacro verrà eseguito dall'utente per creare l'oggetto. Il file .py conterrà le definizioni delle classi, importate da .FCMacro. Il motivo per farlo in questo modo è mantenere la natura parametrica dell'oggetto dopo aver riavviato FreeCAD e aperto un documento contenente uno dei nostri tubi. |
|||
Innanzitutto, il file di definizione della classe: |
|||
{{Code|code= |
|||
# -*- coding: utf-8 -*- |
|||
#classes should go in pdtube.py |
|||
import FreeCAD, FreeCADGui, Part |
|||
class PDTube: |
|||
def __init__(self,obj): |
|||
obj.addProperty("App::PropertyLength","Radius1","Tube","Radius1").Radius1 = 5 |
|||
obj.addProperty("App::PropertyLength","Radius2","Tube","Radius2").Radius2 = 10 |
|||
obj.addProperty("App::PropertyLength","Height","Tube","Height of tube").Height = 10 |
|||
self.makeAttachable(obj) |
|||
obj.Proxy = self |
|||
def makeAttachable(self, obj): |
|||
if int(FreeCAD.Version()[1]) >= 19: |
|||
obj.addExtension('Part::AttachExtensionPython') |
|||
else: |
|||
obj.addExtension('Part::AttachExtensionPython', obj) |
|||
obj.setEditorMode('Placement', 0) #non-readonly non-hidden |
|||
def execute(self,fp): |
|||
outer_cylinder = Part.makeCylinder(fp.Radius2, fp.Height) |
|||
inner_cylinder = Part.makeCylinder(fp.Radius1, fp.Height) |
|||
if fp.Radius1 == fp.Radius2: #just make cylinder |
|||
tube_shape = outer_cylinder |
|||
elif fp.Radius1 < fp.Radius2: |
|||
tube_shape = outer_cylinder.cut(inner_cylinder) |
|||
else: #invert rather than error out |
|||
tube_shape = inner_cylinder.cut(outer_cylinder) |
|||
if not hasattr(fp, "positionBySupport"): |
|||
self.makeAttachable(fp) |
|||
fp.positionBySupport() |
|||
tube_shape.Placement = fp.Placement |
|||
#BaseFeature (shape property of type Part::PropertyPartShape) is provided for us |
|||
#with the PartDesign::FeaturePython and related classes, but it might be empty |
|||
#if our object is the first object in the tree. it's a good idea to check |
|||
#for its existence in case we want to make type Part::FeaturePython, which won't have it |
|||
if hasattr(fp, "BaseFeature") and fp.BaseFeature != None: |
|||
if "Subtractive" in fp.TypeId: |
|||
full_shape = fp.BaseFeature.Shape.cut(tube_shape) |
|||
else: |
|||
full_shape = fp.BaseFeature.Shape.fuse(tube_shape) |
|||
full_shape.transformShape(fp.Placement.inverse().toMatrix(), True) #borrowed from gears workbench |
|||
fp.Shape = full_shape |
|||
else: |
|||
fp.Shape = tube_shape |
|||
if hasattr(fp,"AddSubShape"): #PartDesign::FeatureAdditivePython and |
|||
#PartDesign::FeatureSubtractivePython have this |
|||
#property but PartDesign::FeaturePython does not |
|||
#It is the shape used for copying in pattern features |
|||
#for example in making a polar pattern |
|||
tube_shape.transformShape(fp.Placement.inverse().toMatrix(), True) |
|||
fp.AddSubShape = tube_shape |
|||
class PDTubeVP: |
|||
def __init__(self, obj): |
|||
'''Set this object to the proxy object of the actual view provider''' |
|||
obj.Proxy = self |
|||
def attach(self,vobj): |
|||
self.vobj = vobj |
|||
def updateData(self, fp, prop): |
|||
'''If a property of the handled feature has changed we have the chance to handle this here''' |
|||
pass |
|||
def getDisplayModes(self,obj): |
|||
'''Return a list of display modes.''' |
|||
modes=[] |
|||
modes.append("Flat Lines") |
|||
modes.append("Shaded") |
|||
modes.append("Wireframe") |
|||
return modes |
|||
def getDefaultDisplayMode(self): |
|||
'''Return the name of the default display mode. It must be defined in getDisplayModes.''' |
|||
return "Flat Lines" |
|||
def setDisplayMode(self,mode): |
|||
'''Map the display mode defined in attach with those defined in getDisplayModes.\ |
|||
Since they have the same names nothing needs to be done. This method is optional''' |
|||
return mode |
|||
def onChanged(self, vp, prop): |
|||
'''Here we can do something when a single property got changed''' |
|||
#FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
pass |
|||
def getIcon(self): |
|||
'''Return the icon in XPM format which will appear in the tree view. This method is\ |
|||
optional and if not defined a default icon is shown.''' |
|||
return """ |
|||
/* XPM */ |
|||
static const char * ViewProviderBox_xpm[] = { |
|||
"16 16 6 1", |
|||
" c None", |
|||
". c #141010", |
|||
"+ c #615BD2", |
|||
"@ c #C39D55", |
|||
"# c #000000", |
|||
"$ c #57C355", |
|||
" ........", |
|||
" ......++..+..", |
|||
" .@@@@.++..++.", |
|||
" .@@@@.++..++.", |
|||
" .@@ .++++++.", |
|||
" ..@@ .++..++.", |
|||
"###@@@@ .++..++.", |
|||
"##$.@@$#.++++++.", |
|||
"#$#$.$$$........", |
|||
"#$$####### ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
" #$#$$$$$# ", |
|||
" ##$$$$$# ", |
|||
" ####### "}; |
|||
""" |
|||
def dumps(self): |
|||
'''When saving the document this object gets stored using Python's json module.\ |
|||
Since we have some un-serializable parts here -- the Coin stuff -- we must define this method\ |
|||
to return a tuple of all serializable objects or None.''' |
|||
return None |
|||
def loads(self,state): |
|||
'''When restoring the serialized object from document we have the chance to set some internals here.\ |
|||
Since no data were serialized nothing needs to be done here.''' |
|||
return None |
|||
}} |
|||
E ora il file macro per creare l'oggetto: |
|||
{{Code|code= |
|||
# -*- coding: utf-8 -*- |
|||
#pdtube.FCMacro |
|||
import pdtube |
|||
#above line needed if the class definitions above are place in another file: PDTube.py |
|||
#this is needed if the tube object is to remain parametric after restarting FreeCAD and loading |
|||
#a document containing the object |
|||
body = FreeCADGui.ActiveDocument.ActiveView.getActiveObject("pdbody") |
|||
if not body: |
|||
FreeCAD.Console.PrintError("No active body.\n") |
|||
else: |
|||
from PySide import QtGui |
|||
window = FreeCADGui.getMainWindow() |
|||
items = ["Additive","Subtractive","Neither additive nor subtractive"] |
|||
item,ok =QtGui.QInputDialog.getItem(window,"Select tube type","Select whether you want additive, subtractive, or neither:",items,0,False) |
|||
if ok: |
|||
if item == items[0]: |
|||
className = "PartDesign::FeatureAdditivePython" |
|||
elif item == items[1]: |
|||
className = "PartDesign::FeatureSubtractivePython" |
|||
else: |
|||
className = "PartDesign::FeaturePython" #not usable in pattern features, such as polar pattern |
|||
tube = FreeCAD.ActiveDocument.addObject(className,"Tube") |
|||
pdtube.PDTube(tube) |
|||
pdtube.PDTubeVP(tube.ViewObject) |
|||
body.addObject(tube) #optionally we can also use body.insertObject() for placing at particular place in tree |
|||
}} |
|||
== Available object types == |
|||
The list of all object types you can create with {{incode|FreeCAD.ActiveDocument.addObject()}} can be obtained with {{incode|FreeCAD.ActiveDocument.supportedTypes()}}. Only object types with a name ending in {{incode|Python}} can be used for scripted objects. These are listed here (for FreeCAD v0.21): |
|||
* {{incode|App::DocumentObjectGroupPython}} |
|||
* {{incode|App::FeaturePython}} |
|||
* {{incode|App::GeometryPython}} |
|||
* {{incode|App::LinkElementPython}} |
|||
* {{incode|App::LinkGroupPython}} |
|||
* {{incode|App::LinkPython}} |
|||
* {{incode|App::MaterialObjectPython}} |
|||
* {{incode|App::PlacementPython}} |
|||
* {{incode|Part::CustomFeaturePython}} |
|||
* {{incode|Part::FeaturePython}} |
|||
* {{incode|Part::Part2DObjectPython}} |
|||
* {{incode|Path::FeatureAreaPython}} |
|||
* {{incode|Path::FeatureAreaViewPython}} |
|||
* {{incode|Path::FeatureCompoundPython}} |
|||
* {{incode|Path::FeaturePython}} |
|||
* {{incode|Path::FeatureShapePython}} |
|||
* {{incode|Sketcher::SketchObjectPython}} |
|||
* {{incode|TechDraw::DrawComplexSectionPython}} |
|||
* {{incode|TechDraw::DrawLeaderLinePython}} |
|||
* {{incode|TechDraw::DrawPagePython}} |
|||
* {{incode|TechDraw::DrawRichAnnoPython}} |
|||
* {{incode|TechDraw::DrawTemplatePython}} |
|||
* {{incode|TechDraw::DrawTilePython}} |
|||
* {{incode|TechDraw::DrawTileWeldPython}} |
|||
* {{incode|TechDraw::DrawViewPartPython}} |
|||
* {{incode|TechDraw::DrawViewPython}} |
|||
* {{incode|TechDraw::DrawViewSectionPython}} |
|||
* {{incode|TechDraw::DrawViewSymbolPython}} |
|||
* {{incode|TechDraw::DrawWeldSymbolPython}} |
|||
<span id="Available_methods"></span> |
|||
== Metodi disponibili == |
|||
Vedi [[FeaturePython_methods/it|Metodi FeaturePython]] per i riferimenti completi. |
|||
<span id="Available_properties"></span> |
|||
== Proprietà disponibili == |
|||
<div class="mw-translate-fuzzy"> |
|||
Le proprietà sono i veri e propri mattoni per la costruzione degli oggetti FeaturePython. Attraverso di esse, l'utente è in grado di interagire e modificare l'oggetto. Dopo aver creato un nuovo oggetto FeaturePython nel documento (obj=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Box")), è possibile ottenere un elenco delle proprietà disponibili digitando: |
|||
</div> |
|||
{{Code|code= |
|||
obj = FreeCAD.ActiveDocument.addObject("App::FeaturePython", "Box") |
|||
obj.supportedProperties() |
|||
}} |
|||
<div class="mw-translate-fuzzy"> |
|||
Si ottiene un elenco di proprietà disponibili, che sono descritte in modo più approfondito nella pagina [[FeaturePython_Custom_Properties/it|FeaturePython Custom Properties]]: |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Quando si aggiungono delle proprietà agli oggetti personalizzati, stare attenti a questo: |
Quando si aggiungono delle proprietà agli oggetti personalizzati, stare attenti a questo: |
||
* Non utilizzare i caratteri "<" o ">" nelle descrizioni delle proprietà (questo spezza le parti xml nel file .fcstd) |
* Non utilizzare i caratteri "<" o ">" nelle descrizioni delle proprietà (questo spezza le parti xml nel file .fcstd) |
||
* Le proprietà sono memorizzate in ordine alfabetico nel file .fcstd. Se si dispone di una forma (Shape) nelle proprietà, qualsiasi proprietà il cui nome, in ordine alfabetico, viene dopo "Shape", verrà caricato DOPO la forma (Shape), e questo può causare strani comportamenti. |
* Le proprietà sono memorizzate in ordine alfabetico nel file .fcstd. Se si dispone di una forma (Shape) nelle proprietà, qualsiasi proprietà il cui nome, in ordine alfabetico, viene dopo "Shape", verrà caricato DOPO la forma (Shape), e questo può causare strani comportamenti. |
||
</div> |
|||
The properties are defined in the [https://github.com/FreeCAD/FreeCAD/blob/master/src/App/PropertyStandard.h PropertyStandard C++ header file]. |
|||
<span id="Property_types"></span> |
|||
=== Tipi di Proprietà === |
|||
<div class="mw-translate-fuzzy"> |
|||
==Tipi di proprietà== |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Di default, le proprietà possono essere aggiornate. È possibile creare delle proprietà di sola lettura, per esempio nel caso si vuole mostrare il risultato di un metodo. È anche possibile nascondere una proprietà. Il tipo di proprietà può essere impostata usando |
Di default, le proprietà possono essere aggiornate. È possibile creare delle proprietà di sola lettura, per esempio nel caso si vuole mostrare il risultato di un metodo. È anche possibile nascondere una proprietà. Il tipo di proprietà può essere impostata usando |
||
</div> |
|||
<syntaxhighlight> |
|||
obj.setEditorMode("MyPropertyName", mode) |
|||
{{Code|code= |
|||
</syntaxhighlight> |
|||
obj.setEditorMode("MyPropertyName", mode) |
|||
}} |
|||
dove ''mode'' è un indice che può essere impostato: |
dove ''mode'' è un indice che può essere impostato: |
||
0 -- default mode, lettura e scrittura |
0 -- default mode, lettura e scrittura |
||
Line 194: | Line 988: | ||
2 -- nascosto |
2 -- nascosto |
||
The mode can also be set using a list of strings, e.g. {{incode|obj.setEditorMode("Placement", ["ReadOnly", "Hidden"])}}. |
|||
=== Altro esempio più complesso === |
|||
<div class="mw-translate-fuzzy"> |
|||
In questo esempio si utilizza il [[Part Module/it|Modulo Parte]] per creare un ottaedro, quindi si crea la sua rappresentazione Coin con Pivy. |
|||
Gli EditorModes non sono fissati nel file reload di FreeCAD. Questo può essere fatto dalla funzione __setstate__ . Vedere http://forum.freecadweb.org/viewtopic.php?f=18&t=13460&start=10#p108072. Usando setEditorMode le proprietà sono in sola lettura soltanto in PropertyEditor. Esse possono ancora essere modificate da un comando Python. Per renderle davvero in sola lettura le impostazioni devono essere passate direttamente all'interno della funzione addProperty. Per un esempio, vedere http://forum.freecadweb.org/viewtopic.php?f=18&t=13460&start=20#p109709. |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
Prima si crea l'oggetto del documento: |
|||
Utilizzando l'impostazione diretta nella funzione addProperty, si hanno anche più possibilità. In particolare, è interessante contrassegnare una proprietà come proprietà di output. In questo modo FreeCAD non contrassegnerà l'elemento come variato durante la modifica (quindi non è necessario ricalcolare). |
|||
<syntaxhighlight> |
|||
</div> |
|||
import FreeCAD, FreeCADGui, Part |
|||
class Octahedron: |
|||
def __init__(self, obj): |
|||
"Add some custom properties to our box feature" |
|||
obj.addProperty("App::PropertyLength","Length","Octahedron","Length of the octahedron").Length=1.0 |
|||
obj.addProperty("App::PropertyLength","Width","Octahedron","Width of the octahedron").Width=1.0 |
|||
obj.addProperty("App::PropertyLength","Height","Octahedron", "Height of the octahedron").Height=1.0 |
|||
obj.addProperty("Part::PropertyPartShape","Shape","Octahedron", "Shape of the octahedron") |
|||
obj.Proxy = self |
|||
def execute(self, fp): |
|||
# Define six vetices for the shape |
|||
v1 = FreeCAD.Vector(0,0,0) |
|||
v2 = FreeCAD.Vector(fp.Length,0,0) |
|||
v3 = FreeCAD.Vector(0,fp.Width,0) |
|||
v4 = FreeCAD.Vector(fp.Length,fp.Width,0) |
|||
v5 = FreeCAD.Vector(fp.Length/2,fp.Width/2,fp.Height/2) |
|||
v6 = FreeCAD.Vector(fp.Length/2,fp.Width/2,-fp.Height/2) |
|||
# Make the wires/faces |
|||
f1 = self.make_face(v1,v2,v5) |
|||
f2 = self.make_face(v2,v4,v5) |
|||
f3 = self.make_face(v4,v3,v5) |
|||
f4 = self.make_face(v3,v1,v5) |
|||
f5 = self.make_face(v2,v1,v6) |
|||
f6 = self.make_face(v4,v2,v6) |
|||
f7 = self.make_face(v3,v4,v6) |
|||
f8 = self.make_face(v1,v3,v6) |
|||
shell=Part.makeShell([f1,f2,f3,f4,f5,f6,f7,f8]) |
|||
solid=Part.makeSolid(shell) |
|||
fp.Shape = solid |
|||
# helper mehod to create the faces |
|||
def make_face(self,v1,v2,v3): |
|||
wire = Part.makePolygon([v1,v2,v3,v1]) |
|||
face = Part.Face(wire) |
|||
return face |
|||
</syntaxhighlight> |
|||
In seguito si crea il fornitore della vista dell'oggetto (view provider object), responsabile di mostrare l'oggetto nella scena 3D: |
|||
<syntaxhighlight> |
|||
class ViewProviderOctahedron: |
|||
def __init__(self, obj): |
|||
"Set this object to the proxy object of the actual view provider" |
|||
obj.addProperty("App::PropertyColor","Color","Octahedron","Color of the octahedron").Color=(1.0,0.0,0.0) |
|||
obj.Proxy = self |
|||
def attach(self, obj): |
|||
"Setup the scene sub-graph of the view provider, this method is mandatory" |
|||
self.shaded = coin.SoGroup() |
|||
self.wireframe = coin.SoGroup() |
|||
self.scale = coin.SoScale() |
|||
self.color = coin.SoBaseColor() |
|||
self.data=coin.SoCoordinate3() |
|||
self.face=coin.SoIndexedLineSet() |
|||
self.shaded.addChild(self.scale) |
|||
self.shaded.addChild(self.color) |
|||
self.shaded.addChild(self.data) |
|||
self.shaded.addChild(self.face) |
|||
obj.addDisplayMode(self.shaded,"Shaded"); |
|||
style=coin.SoDrawStyle() |
|||
style.style = coin.SoDrawStyle.LINES |
|||
self.wireframe.addChild(style) |
|||
self.wireframe.addChild(self.scale) |
|||
self.wireframe.addChild(self.color) |
|||
self.wireframe.addChild(self.data) |
|||
self.wireframe.addChild(self.face) |
|||
obj.addDisplayMode(self.wireframe,"Wireframe"); |
|||
self.onChanged(obj,"Color") |
|||
def updateData(self, fp, prop): |
|||
"If a property of the handled feature has changed we have the chance to handle this here" |
|||
# fp is the handled feature, prop is the name of the property that has changed |
|||
if prop == "Shape": |
|||
s = fp.getPropertyByName("Shape") |
|||
self.data.point.setNum(6) |
|||
cnt=0 |
|||
for i in s.Vertexes: |
|||
self.data.point.set1Value(cnt,i.X,i.Y,i.Z) |
|||
cnt=cnt+1 |
|||
self.face.coordIndex.set1Value(0,0) |
|||
self.face.coordIndex.set1Value(1,1) |
|||
self.face.coordIndex.set1Value(2,2) |
|||
self.face.coordIndex.set1Value(3,-1) |
|||
self.face.coordIndex.set1Value(4,1) |
|||
self.face.coordIndex.set1Value(5,3) |
|||
self.face.coordIndex.set1Value(6,2) |
|||
self.face.coordIndex.set1Value(7,-1) |
|||
self.face.coordIndex.set1Value(8,3) |
|||
self.face.coordIndex.set1Value(9,4) |
|||
self.face.coordIndex.set1Value(10,2) |
|||
self.face.coordIndex.set1Value(11,-1) |
|||
self.face.coordIndex.set1Value(12,4) |
|||
self.face.coordIndex.set1Value(13,0) |
|||
self.face.coordIndex.set1Value(14,2) |
|||
self.face.coordIndex.set1Value(15,-1) |
|||
self.face.coordIndex.set1Value(16,1) |
|||
self.face.coordIndex.set1Value(17,0) |
|||
self.face.coordIndex.set1Value(18,5) |
|||
self.face.coordIndex.set1Value(19,-1) |
|||
self.face.coordIndex.set1Value(20,3) |
|||
self.face.coordIndex.set1Value(21,1) |
|||
self.face.coordIndex.set1Value(22,5) |
|||
self.face.coordIndex.set1Value(23,-1) |
|||
self.face.coordIndex.set1Value(24,4) |
|||
self.face.coordIndex.set1Value(25,3) |
|||
self.face.coordIndex.set1Value(26,5) |
|||
self.face.coordIndex.set1Value(27,-1) |
|||
self.face.coordIndex.set1Value(28,0) |
|||
self.face.coordIndex.set1Value(29,4) |
|||
self.face.coordIndex.set1Value(30,5) |
|||
self.face.coordIndex.set1Value(31,-1) |
|||
def getDisplayModes(self,obj): |
|||
"Return a list of display modes." |
|||
modes=[] |
|||
modes.append("Shaded") |
|||
modes.append("Wireframe") |
|||
return modes |
|||
def getDefaultDisplayMode(self): |
|||
"Return the name of the default display mode. It must be defined in getDisplayModes." |
|||
return "Shaded" |
|||
def setDisplayMode(self,mode): |
|||
return mode |
|||
def onChanged(self, vp, prop): |
|||
"Here we can do something when a single property got changed" |
|||
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n") |
|||
if prop == "Color": |
|||
c = vp.getPropertyByName("Color") |
|||
self.color.rgb.setValue(c[0],c[1],c[2]) |
|||
def getIcon(self): |
|||
return """ |
|||
/* XPM */ |
|||
static const char * ViewProviderBox_xpm[] = { |
|||
"16 16 6 1", |
|||
" c None", |
|||
". c #141010", |
|||
"+ c #615BD2", |
|||
"@ c #C39D55", |
|||
"# c #000000", |
|||
"$ c #57C355", |
|||
" ........", |
|||
" ......++..+..", |
|||
" .@@@@.++..++.", |
|||
" .@@@@.++..++.", |
|||
" .@@ .++++++.", |
|||
" ..@@ .++..++.", |
|||
"###@@@@ .++..++.", |
|||
"##$.@@$#.++++++.", |
|||
"#$#$.$$$........", |
|||
"#$$####### ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
"#$$#$$$$$# ", |
|||
" #$#$$$$$# ", |
|||
" ##$$$$$# ", |
|||
" ####### "}; |
|||
""" |
|||
def __getstate__(self): |
|||
return None |
|||
def __setstate__(self,state): |
|||
return None |
|||
</syntaxhighlight> |
|||
Finally, once our object and its viewobject are defined, we just need to call them: |
|||
<syntaxhighlight> |
|||
FreeCAD.newDocument() |
|||
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Octahedron") |
|||
Octahedron(a) |
|||
ViewProviderOctahedron(a.ViewObject) |
|||
</syntaxhighlight> |
|||
== Making objects selectable == |
|||
If you want to make your object selectable, or at least part of it, by clicking on it in the viewport, you must include its coin geometry inside a SoFCSelection node. If your object has complex representation, with widgets, annotations, etc, you might want to include only a part of it in a SoFCSelection. Everything that is a SoFCSelection is constantly scanned by FreeCAD to detect selection/preselection, so it makes sense try not to overload it with unneeded scanning. This is what you would do to include a self.face from the example above: |
|||
<syntaxhighlight> |
|||
selectionNode = coin.SoType.fromName("SoFCSelection").createInstance() |
|||
selectionNode.documentName.setValue(FreeCAD.ActiveDocument.Name) |
|||
selectionNode.objectName.setValue(obj.Object.Name) # here obj is the ViewObject, we need its associated App Object |
|||
selectionNode.subElementName.setValue("Face") |
|||
selectNode.addChild(self.face) |
|||
... |
|||
self.shaded.addChild(selectionNode) |
|||
self.wireframe.addChild(selectionNode) |
|||
</syntaxhighlight> |
|||
Simply, you create a SoFCSelection node, then you add your geometry nodes to it, then you add it to your main node, instead of adding your geometry nodes directly. |
|||
Esempio di proprietà di output (vedi anche https://forum.freecadweb.org/viewtopic.php?t=24928): |
|||
== Working with simple shapes == |
|||
If your parametric object simply outputs a shape, you don't need to use a view provider object. The shape will be displayed using FreeCAD's standard shape representation: |
|||
<syntaxhighlight> |
|||
class Line: |
|||
def __init__(self, obj): |
|||
'''"App two point properties" ''' |
|||
obj.addProperty("App::PropertyVector","p1","Line","Start point") |
|||
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(1,0,0) |
|||
obj.Proxy = self |
|||
def execute(self, fp): |
|||
'''"Print a short message when doing a recomputation, this method is mandatory" ''' |
|||
fp.Shape = Part.makeLine(fp.p1,fp.p2) |
|||
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Line") |
|||
Line(a) |
|||
a.ViewObject.Proxy=0 # just set it to something different from None (this assignment is needed to run an internal notification) |
|||
FreeCAD.ActiveDocument.recompute() |
|||
</syntaxhighlight> |
|||
{{Code|code= |
|||
{{docnav|PyQt|Embedding FreeCAD}} |
|||
obj.addProperty("App::PropertyString", "MyCustomProperty", "", "", 8) |
|||
}} |
|||
<div class="mw-translate-fuzzy"> |
|||
[[Category:Poweruser Documentation]] |
|||
I tipi di proprietà che possono essere impostati all'ultimo parametro della funzione addProperty sono: |
|||
[[Category:Python Code]] |
|||
0 -- Prop_None, nessun tipo di proprietà speciale |
|||
1 -- Prop_ReadOnly, la proprietà è di sola lettura nell'editor |
|||
2 -- Prop_Transient, la proprietà non verrà salvata nel file |
|||
4 -- Prop_Hidden, la proprietà non apparirà nell'editor |
|||
8 -- Prop_Output, la proprietà modificata non tocca il suo contenitore principale |
|||
16 -- Prop_NoRecompute, la proprietà modificata non tocca il suo contenitore per il ricalcolo |
|||
32 -- Prop_NoPersist, la proprietà non verrà affatto salvata nel file |
|||
</div> |
|||
<div class="mw-translate-fuzzy"> |
|||
{{clear}} |
|||
È possibile trovare questi diversi tipi di proprietà definiti nell'intestazione del codice sorgente C++ per [https://github.com/FreeCAD/FreeCAD/blob/master/src/App/PropertyContainer.h PropertyContainer]. |
|||
<languages/> |
|||
</div> |
|||
== Available extensions == |
|||
The list of available extensions can be obtained with {{incode|grep -RI EXTENSION_PROPERTY_SOURCE_TEMPLATE}} in the repository of the source code and is given here (for FreeCAD v0.21). |
|||
For objects: |
|||
* {{incode|App::GeoFeatureGroupExtensionPython}} |
|||
* {{incode|App::GroupExtensionPython}} |
|||
* {{incode|App::LinkBaseExtensionPython}} |
|||
* {{incode|App::LinkExtensionPython}} |
|||
* {{incode|App::OriginGroupExtensionPython}} |
|||
* {{incode|Part::AttachExtensionPython}} |
|||
* {{incode|TechDraw::CosmeticExtensionPython}} |
|||
For view objects: |
|||
* {{incode|Gui::ViewProviderExtensionPython}} |
|||
* {{incode|Gui::ViewProviderGeoFeatureGroupExtensionPython}} |
|||
* {{incode|Gui::ViewProviderGroupExtensionPython}} |
|||
* {{incode|Gui::ViewProviderOriginGroupExtensionPython}} |
|||
* {{incode|PartGui::ViewProviderAttachExtensionPython}} |
|||
* {{incode|PartGui::ViewProviderSplineExtensionPython}} |
|||
There exist other extensions but they do not work as-is: |
|||
* {{incode|App::ExtensionPython}} |
|||
* {{incode|TechDrawGui::ViewProviderCosmeticExtensionPython}} |
|||
* {{incode|TechDrawGui::ViewProviderDrawingViewExtensionPython}} |
|||
* {{incode|TechDrawGui::ViewProviderPageExtensionPython}} |
|||
* {{incode|TechDrawGui::ViewProviderTemplateExtensionPython}} |
|||
<span id="Further_information"></span> |
|||
== Ulteriori informazioni == |
|||
Pagine aggiuntive: |
|||
* [[Scripted_objects_saving_attributes/it|Oggetti creati con script che salvano gli attributi]] |
|||
* [[Scripted_objects_migration/it|Migrazione di oggetti creati con script]] |
|||
* [[Scripted_objects_with_attachment/it|Oggetti creati da script con parti associate]] |
|||
* [[Viewprovider/it|Viewprovider]] |
|||
Interessanti thread del forum sugli oggetti con script: |
|||
* [http://forum.freecadweb.org/viewtopic.php?f=22&t=13740 Python object attributes lost at load] |
|||
* [http://forum.freecadweb.org/viewtopic.php?t=12139 New FeaturePython is grey] |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=18&t=44009 Explanation on dumps and loads], [https://docs.python.org/3/library/pickle.html#object.__getstate__ official documentation] |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=18&t=13460&start=20#p109709 Eigenmode frequency always 0?] |
|||
* [https://forum.freecadweb.org/viewtopic.php?f=22&t=21330 how to implement python feature's setEdit properly?] |
|||
Oltre agli esempi presentati qui dare un'occhiata al codice sorgente di FreeCAD [https://github.com/FreeCAD/FreeCAD/blob/master/src/Mod/TemplatePyMod/FeaturePython.py src/Mod/TemplatePyMod/FeaturePython.py] per ulteriori esempi. |
|||
{{Docnav/it |
|||
|[[Topological_data_scripting/it|Script di dati topologici]] |
|||
|[[Scenegraph/it|Scena grafica]] |
|||
}} |
|||
{{Powerdocnavi{{#translation:}}}} |
|||
[[Category:Developer Documentation{{#translation:}}]] |
|||
[[Category:Python Code{{#translation:}}]] |
Latest revision as of 09:02, 27 January 2024
Introduzione
Oltre ai tipi di oggetti standard, come le Annotazioni, gli oggetti Mesh e gli oggetti Parte, FreeCAD offre anche la straordinaria possibilità di costruire al 100% oggetti parametrici in script di Python, chiamati Python Features (Caratteristiche Python). Questi oggetti si comportano esattamente come un qualsiasi altro oggetto di FreeCAD, e sono salvati e ripristinati automaticamente con salva/apri il file.
Una particolarità deve essere compresa: per motivi di sicurezza, i file di FreeCAD non contengono mai alcun codice incorporato. Il codice Python che scrivi per creare oggetti parametrici non viene mai salvato all'interno di un file. Ciò significa che se apri un file contenente tale oggetto su un'altra macchina, e quel codice Python non è disponibile su quella macchina, l'oggetto non verrà completamente ricreato. Se distribuisci tali oggetti ad altri, dovrai distribuire anche il tuo script Python, ad esempio come Macro.
Nota: è possibile impacchettare il codice Python all'interno di un file FreeCAD utilizzando la serializzazione json con un App::PropertyPythonObject, ma quel codice non può mai essere eseguito direttamente, e quindi ha poca utilità per il nostro scopo qui.
Le Python Features seguono le stesse regole di tutte le altre funzionalità di FreeCAD: sono divise in una parte App e una parte GUI. La parte App, cioè il Document Object (oggetto del documento), definisce la geometria dell'oggetto, mentre la sua parte grafica, cioè il View Provider Object (fornitore della vista dell'oggetto), definisce come l'oggetto viene disegnato sullo schermo. Il View Provider Object, come qualsiasi altro elemento di FreeCAD, è disponibile solo quando si esegue FreeCAD nella sua GUI (interfaccia grafica). Per costruire il proprio oggetto, sono disponibili diversi metodi e proprietà. La Proprietà deve essere una qualsiasi dei tipi di proprietà predefinite che FreeCAD mette a disposizione. Le proprietà disponibili sono quelle che appaiono nella finestra di visualizzazione delle proprietà per consentire all'utente di modificarle. Con questa procedura, gli oggetti FeaturePython sono realmente e totalmente parametrici. E' possibile definire separatamente le proprietà per l'oggetto e per la sua ViewObject (rappresentazione).
Esempio di base
L'esempio seguente si trova nel file src/Mod/TemplatePyMod/FeaturePython.py, con molti altri esempi:
'''Examples for a feature class and its view provider.'''
import FreeCAD, FreeCADGui
from pivy import coin
class Box:
def __init__(self, obj):
'''Add some custom properties to our box feature'''
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box").Length = 1.0
obj.addProperty("App::PropertyLength", "Width", "Box", "Width of the box").Width = 1.0
obj.addProperty("App::PropertyLength", "Height", "Box", "Height of the box").Height = 1.0
obj.Proxy = self
def onChanged(self, fp, prop):
'''Do something when a property has changed'''
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n")
def execute(self, fp):
'''Do something when doing a recomputation, this method is mandatory'''
FreeCAD.Console.PrintMessage("Recompute Python Box feature\n")
class ViewProviderBox:
def __init__(self, obj):
'''Set this object to the proxy object of the actual view provider'''
obj.addProperty("App::PropertyColor","Color", "Box", "Color of the box").Color = (1.0, 0.0, 0.0)
obj.Proxy = self
def attach(self, obj):
'''Setup the scene sub-graph of the view provider, this method is mandatory'''
self.shaded = coin.SoGroup()
self.wireframe = coin.SoGroup()
self.scale = coin.SoScale()
self.color = coin.SoBaseColor()
data=coin.SoCube()
self.shaded.addChild(self.scale)
self.shaded.addChild(self.color)
self.shaded.addChild(data)
obj.addDisplayMode(self.shaded, "Shaded");
style=coin.SoDrawStyle()
style.style = coin.SoDrawStyle.LINES
self.wireframe.addChild(style)
self.wireframe.addChild(self.scale)
self.wireframe.addChild(self.color)
self.wireframe.addChild(data)
obj.addDisplayMode(self.wireframe, "Wireframe");
self.onChanged(obj,"Color")
def updateData(self, fp, prop):
'''If a property of the handled feature has changed we have the chance to handle this here'''
# fp is the handled feature, prop is the name of the property that has changed
l = fp.getPropertyByName("Length")
w = fp.getPropertyByName("Width")
h = fp.getPropertyByName("Height")
self.scale.scaleFactor.setValue(float(l), float(w), float(h))
pass
def getDisplayModes(self,obj):
'''Return a list of display modes.'''
modes=[]
modes.append("Shaded")
modes.append("Wireframe")
return modes
def getDefaultDisplayMode(self):
'''Return the name of the default display mode. It must be defined in getDisplayModes.'''
return "Shaded"
def setDisplayMode(self,mode):
'''Map the display mode defined in attach with those defined in getDisplayModes.\
Since they have the same names nothing needs to be done. This method is optional'''
return mode
def onChanged(self, vp, prop):
'''Here we can do something when a single property got changed'''
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n")
if prop == "Color":
c = vp.getPropertyByName("Color")
self.color.rgb.setValue(c[0], c[1], c[2])
def getIcon(self):
'''Return the icon in XPM format which will appear in the tree view. This method is\
optional and if not defined a default icon is shown.'''
return """
/* XPM */
static const char * ViewProviderBox_xpm[] = {
"16 16 6 1",
" c None",
". c #141010",
"+ c #615BD2",
"@ c #C39D55",
"# c #000000",
"$ c #57C355",
" ........",
" ......++..+..",
" .@@@@.++..++.",
" .@@@@.++..++.",
" .@@ .++++++.",
" ..@@ .++..++.",
"###@@@@ .++..++.",
"##$.@@$#.++++++.",
"#$#$.$$$........",
"#$$####### ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
" #$#$$$$$# ",
" ##$$$$$# ",
" ####### "};
"""
def dumps(self):
'''When saving the document this object gets stored using Python's json module.\
Since we have some un-serializable parts here -- the Coin stuff -- we must define this method\
to return a tuple of all serializable objects or None.'''
return None
def loads(self,state):
'''When restoring the serialized object from document we have the chance to set some internals here.\
Since no data were serialized nothing needs to be done here.'''
return None
def makeBox():
FreeCAD.newDocument()
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython", "Box")
Box(a)
ViewProviderBox(a.ViewObject)
makeBox()
Cose da notare
Se il tuo oggetto si basa sul ricalcolo non appena viene creato, devi farlo manualmente nella funzione __init__
poiché non viene chiamato automaticamente. Questo esempio non lo richiede, perché il metodo onChanged
della classe Box
ha lo stesso effetto della funzione execute
, ma gli esempi seguenti si basano sull'essere ricalcolati prima che qualsiasi cosa venga visualizzata nella vista 3D. Negli esempi, questo viene fatto manualmente con ActiveDocument.recompute()
, ma in scenari più complessi devi decidere dove ricalcolare l'intero documento o l'oggetto FeaturePython.
Questo esempio produce una serie di analisi dello stack di eccezioni nella finestra di visualizzazione del report. Questo perché il metodo onChanged
della classe Box
viene chiamato ogni volta che viene aggiunta una proprietà in __init__
. Quando viene aggiunta la prima, le proprietà Width e Height non esistono ancora e quindi il tentativo di accedervi fallisce.
Una spiegazione di __getstate__
e __setstate__
è nel thread del forum obj.Proxy.Type è un dizionario, non una stringa.
obj.addProperty(...)
returns obj
, so that the value of the property can be set on the same line:
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box").Length = 1.0
Which is equivalent to:
obj.addProperty("App::PropertyLength", "Length", "Box", "Length of the box")
obj.Length = 1.0
Un altro esempio più complesso
In questo esempio si utilizza il Modulo Part per creare un ottaedro, quindi si crea la sua rappresentazione Coin con Pivy.
Prima si crea l'oggetto del documento:
import FreeCAD, FreeCADGui, Part
import pivy
from pivy import coin
class Octahedron:
def __init__(self, obj):
"Add some custom properties to our box feature"
obj.addProperty("App::PropertyLength","Length","Octahedron","Length of the octahedron").Length=1.0
obj.addProperty("App::PropertyLength","Width","Octahedron","Width of the octahedron").Width=1.0
obj.addProperty("App::PropertyLength","Height","Octahedron", "Height of the octahedron").Height=1.0
obj.addProperty("Part::PropertyPartShape","Shape","Octahedron", "Shape of the octahedron")
obj.Proxy = self
def execute(self, fp):
# Define six vetices for the shape
v1 = FreeCAD.Vector(0,0,0)
v2 = FreeCAD.Vector(fp.Length,0,0)
v3 = FreeCAD.Vector(0,fp.Width,0)
v4 = FreeCAD.Vector(fp.Length,fp.Width,0)
v5 = FreeCAD.Vector(fp.Length/2,fp.Width/2,fp.Height/2)
v6 = FreeCAD.Vector(fp.Length/2,fp.Width/2,-fp.Height/2)
# Make the wires/faces
f1 = self.make_face(v1,v2,v5)
f2 = self.make_face(v2,v4,v5)
f3 = self.make_face(v4,v3,v5)
f4 = self.make_face(v3,v1,v5)
f5 = self.make_face(v2,v1,v6)
f6 = self.make_face(v4,v2,v6)
f7 = self.make_face(v3,v4,v6)
f8 = self.make_face(v1,v3,v6)
shell=Part.makeShell([f1,f2,f3,f4,f5,f6,f7,f8])
solid=Part.makeSolid(shell)
fp.Shape = solid
# helper mehod to create the faces
def make_face(self,v1,v2,v3):
wire = Part.makePolygon([v1,v2,v3,v1])
face = Part.Face(wire)
return face
In seguito si crea il fornitore della vista dell'oggetto (view provider object), responsabile di mostrare l'oggetto nella scena 3D:
class ViewProviderOctahedron:
def __init__(self, obj):
"Set this object to the proxy object of the actual view provider"
obj.addProperty("App::PropertyColor","Color","Octahedron","Color of the octahedron").Color=(1.0,0.0,0.0)
obj.Proxy = self
def attach(self, obj):
"Setup the scene sub-graph of the view provider, this method is mandatory"
self.shaded = coin.SoGroup()
self.wireframe = coin.SoGroup()
self.scale = coin.SoScale()
self.color = coin.SoBaseColor()
self.data=coin.SoCoordinate3()
self.face=coin.SoIndexedFaceSet()
self.shaded.addChild(self.scale)
self.shaded.addChild(self.color)
self.shaded.addChild(self.data)
self.shaded.addChild(self.face)
obj.addDisplayMode(self.shaded,"Shaded");
style=coin.SoDrawStyle()
style.style = coin.SoDrawStyle.LINES
self.wireframe.addChild(style)
self.wireframe.addChild(self.scale)
self.wireframe.addChild(self.color)
self.wireframe.addChild(self.data)
self.wireframe.addChild(self.face)
obj.addDisplayMode(self.wireframe,"Wireframe");
self.onChanged(obj,"Color")
def updateData(self, fp, prop):
"If a property of the handled feature has changed we have the chance to handle this here"
# fp is the handled feature, prop is the name of the property that has changed
if prop == "Shape":
s = fp.getPropertyByName("Shape")
self.data.point.setNum(6)
cnt=0
for i in s.Vertexes:
self.data.point.set1Value(cnt,i.X,i.Y,i.Z)
cnt=cnt+1
self.face.coordIndex.set1Value(0,0)
self.face.coordIndex.set1Value(1,1)
self.face.coordIndex.set1Value(2,2)
self.face.coordIndex.set1Value(3,-1)
self.face.coordIndex.set1Value(4,1)
self.face.coordIndex.set1Value(5,3)
self.face.coordIndex.set1Value(6,2)
self.face.coordIndex.set1Value(7,-1)
self.face.coordIndex.set1Value(8,3)
self.face.coordIndex.set1Value(9,4)
self.face.coordIndex.set1Value(10,2)
self.face.coordIndex.set1Value(11,-1)
self.face.coordIndex.set1Value(12,4)
self.face.coordIndex.set1Value(13,0)
self.face.coordIndex.set1Value(14,2)
self.face.coordIndex.set1Value(15,-1)
self.face.coordIndex.set1Value(16,1)
self.face.coordIndex.set1Value(17,0)
self.face.coordIndex.set1Value(18,5)
self.face.coordIndex.set1Value(19,-1)
self.face.coordIndex.set1Value(20,3)
self.face.coordIndex.set1Value(21,1)
self.face.coordIndex.set1Value(22,5)
self.face.coordIndex.set1Value(23,-1)
self.face.coordIndex.set1Value(24,4)
self.face.coordIndex.set1Value(25,3)
self.face.coordIndex.set1Value(26,5)
self.face.coordIndex.set1Value(27,-1)
self.face.coordIndex.set1Value(28,0)
self.face.coordIndex.set1Value(29,4)
self.face.coordIndex.set1Value(30,5)
self.face.coordIndex.set1Value(31,-1)
def getDisplayModes(self,obj):
"Return a list of display modes."
modes=[]
modes.append("Shaded")
modes.append("Wireframe")
return modes
def getDefaultDisplayMode(self):
"Return the name of the default display mode. It must be defined in getDisplayModes."
return "Shaded"
def setDisplayMode(self,mode):
return mode
def onChanged(self, vp, prop):
"Here we can do something when a single property got changed"
FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n")
if prop == "Color":
c = vp.getPropertyByName("Color")
self.color.rgb.setValue(c[0],c[1],c[2])
def getIcon(self):
return """
/* XPM */
static const char * ViewProviderBox_xpm[] = {
"16 16 6 1",
" c None",
". c #141010",
"+ c #615BD2",
"@ c #C39D55",
"# c #000000",
"$ c #57C355",
" ........",
" ......++..+..",
" .@@@@.++..++.",
" .@@@@.++..++.",
" .@@ .++++++.",
" ..@@ .++..++.",
"###@@@@ .++..++.",
"##$.@@$#.++++++.",
"#$#$.$$$........",
"#$$####### ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
" #$#$$$$$# ",
" ##$$$$$# ",
" ####### "};
"""
def dumps(self):
return None
def loads(self,state):
return None
Infine, dopo che l'oggetto e il suo visualizzatore sono definiti, basta solo chiamarli (La classe Octahedron e il codice della classe viewprovider possono essere copiati direttamente nella console Python di FreeCAD)::
FreeCAD.newDocument()
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Octahedron")
Octahedron(a)
ViewProviderOctahedron(a.ViewObject)
Rendere gli oggetti selezionabili
Se volete rendere il vostro oggetto selezionabile, o almeno una parte di esso, facendo clic su di esso nella finestra, è necessario includere la sua geometria Coin all'interno di un nodo SoFCSelection. Se l'oggetto ha una rappresentazione complessa, con widget, annotazioni, etc, si potrebbe voler includere solo una parte di esso in un SoFCSelection. Tutto quello che compone un SoFCSelection viene costantemente analizzato da FreeCAD per rilevare selezioni/preselezioni, quindi non ha senso sovraccaricarlo con delle scansioni non necessarie.
Una volta che le parti dello scenegraph, che devono essere selezionabili, si trovano all'interno dei nodi SoFCSelection, è necessario fornire due metodi per gestire il percorso di selezione. Il percorso di selezione può assumere la forma di una stringa che fornisce i nomi di ciascun elemento nel percorso o di un array di oggetti scenegraph. I due metodi che fornisci sono getDetailPath
, che converte da un percorso stringa in un array di oggetti scenegraph, e getElementPicked
, che prende un elemento su cui è stato fatto clic nello scenegraph e restituisce il suo nome di stringa (nota, non il suo percorso di stringa).
Ecco l'esempio della molecola sopra, adattato per rendere selezionabili gli elementi della molecola:
class Molecule:
def __init__(self, obj):
''' Add two point properties '''
obj.addProperty("App::PropertyVector","p1","Line","Start point")
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(5,0,0)
obj.Proxy = self
def onChanged(self, fp, prop):
if prop == "p1" or prop == "p2":
''' Print the name of the property that has changed '''
fp.Shape = Part.makeLine(fp.p1,fp.p2)
def execute(self, fp):
''' Print a short message when doing a recomputation, this method is mandatory '''
fp.Shape = Part.makeLine(fp.p1,fp.p2)
class ViewProviderMolecule:
def __init__(self, obj):
''' Set this object to the proxy object of the actual view provider '''
obj.Proxy = self
self.ViewObject = obj
sep1=coin.SoSeparator()
sel1 = coin.SoType.fromName('SoFCSelection').createInstance()
# sel1.policy.setValue(coin.SoSelection.SHIFT)
sel1.ref()
sep1.addChild(sel1)
self.trl1=coin.SoTranslation()
sel1.addChild(self.trl1)
sel1.addChild(coin.SoSphere())
sep2=coin.SoSeparator()
sel2 = coin.SoType.fromName('SoFCSelection').createInstance()
sel2.ref()
sep2.addChild(sel2)
self.trl2=coin.SoTranslation()
sel2.addChild(self.trl2)
sel2.addChild(coin.SoSphere())
obj.RootNode.addChild(sep1)
obj.RootNode.addChild(sep2)
self.updateData(obj.Object, 'p2')
self.sel1 = sel1
self.sel2 = sel2
def getDetailPath(self, subname, path, append):
vobj = self.ViewObject
if append:
path.append(vobj.RootNode)
path.append(vobj.SwitchNode)
mode = vobj.SwitchNode.whichChild.getValue()
if mode >= 0:
mode = vobj.SwitchNode.getChild(mode)
path.append(mode)
sub = Part.splitSubname(subname)[-1]
if sub == 'Atom1':
path.append(self.sel1)
elif sub == 'Atom2':
path.append(self.sel2)
else:
path.append(mode.getChild(0))
return True
def getElementPicked(self, pp):
path = pp.getPath()
if path.findNode(self.sel1) >= 0:
return 'Atom1'
if path.findNode(self.sel2) >= 0:
return 'Atom2'
raise NotImplementedError
def updateData(self, fp, prop):
"If a property of the handled feature has changed we have the chance to handle this here"
# fp is the handled feature, prop is the name of the property that has changed
if prop == "p1":
p = fp.getPropertyByName("p1")
self.trl1.translation=(p.x,p.y,p.z)
elif prop == "p2":
p = fp.getPropertyByName("p2")
self.trl2.translation=(p.x,p.y,p.z)
def dumps(self):
return None
def loads(self,state):
return None
def makeMolecule():
FreeCAD.newDocument()
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Molecule")
Molecule(a)
ViewProviderMolecule(a.ViewObject)
FreeCAD.ActiveDocument.recompute()
Lavorare con forme semplici
Se l'oggetto parametrico produce semplicemente una forma, non è necessario utilizzare un fornitore di vista dell'oggetto (view provider object). La forma viene visualizzata utilizzando la rappresentazione della forma standard di FreeCAD:
import FreeCAD as App
import FreeCADGui
import FreeCAD
import Part
class Line:
def __init__(self, obj):
'''"App two point properties" '''
obj.addProperty("App::PropertyVector","p1","Line","Start point")
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(1,0,0)
obj.Proxy = self
def execute(self, fp):
'''"Print a short message when doing a recomputation, this method is mandatory" '''
fp.Shape = Part.makeLine(fp.p1,fp.p2)
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Line")
Line(a)
a.ViewObject.Proxy=0 # just set it to something different from None (this assignment is needed to run an internal notification)
FreeCAD.ActiveDocument.recompute()
Lo stesso codice con l'uso di ViewProviderLine
import FreeCAD as App
import FreeCADGui
import FreeCAD
import Part
class Line:
def __init__(self, obj):
'''"App two point properties" '''
obj.addProperty("App::PropertyVector","p1","Line","Start point")
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(100,0,0)
obj.Proxy = self
def execute(self, fp):
'''"Print a short message when doing a recomputation, this method is mandatory" '''
fp.Shape = Part.makeLine(fp.p1,fp.p2)
class ViewProviderLine:
def __init__(self, obj):
''' Set this object to the proxy object of the actual view provider '''
obj.Proxy = self
def getDefaultDisplayMode(self):
''' Return the name of the default display mode. It must be defined in getDisplayModes. '''
return "Flat Lines"
a=FreeCAD.ActiveDocument.addObject("Part::FeaturePython","Line")
Line(a)
ViewProviderLine(a.ViewObject)
App.ActiveDocument.recompute()
Struttura di Scenegraph
Potresti aver notato che gli esempi sopra costruiscono i loro scenegraphs in modi leggermente diversi. Alcuni usano obj.addDisplayMode(node, "modename")
mentre altri usano obj.SwitchNode.getChild(x).addChild(y)
.
Ogni caratteristica in un documento di FreeCAD si basa sulla seguente struttura di scenegraph:
RootNode
\- SwitchNode
\- Shaded
- Wireframe
- etc
SwitchNode
mostra solo uno dei suoi figli, a seconda della modalità di visualizzazione selezionata in FreeCAD.
Gli esempi che utilizzano addDisplayMode
stanno costruendo i loro scenegraph esclusivamente dagli elementi dello scenegraph di coin3d. Dietro le quinte, addDisplayMode
aggiunge un nuovo figlio a SwitchNode
; il nome di quel nodo corrisponderà alla modalità di visualizzazione, che è stata passata.
Gli esempi che utilizzano SwitchNode.getChild(x).addChild
costruiscono anche parte della loro geometria utilizzando le funzioni dell'ambiente Part, come fp.Shape = Part.makeLine(fp.p1 ,fp.p2)
. Questo costruisce i diversi scenegraph della modalità di visualizzazione sotto SwitchNode
; quando in seguito arriveremo ad aggiungere elementi coin3d allo scenegraph, dobbiamo aggiungerli agli scenegraph della modalità di visualizzazione esistenti usando addChild
piuttosto che creare un nuovo figlio di SwitchNode
.
Quando si utilizza addDisplayMode()
per aggiungere geometria allo scenegraph, ogni modalità di visualizzazione dovrebbe avere il proprio nodo che viene passato a addDisplayMode()
; non riutilizzare lo stesso nodo per questo. Ciò confonderà il meccanismo di selezione. Va bene se il nodo di ciascuna modalità di visualizzazione ha gli stessi nodi geometrici aggiunti sotto di esso, solo la radice di ciascuna modalità di visualizzazione deve essere distinta.
Ecco l'esempio della molecola sopra, adattato per essere disegnato solo con oggetti scenegraph Coin3D invece di utilizzare oggetti dall'ambiente Part:
import Part
from pivy import coin
class Molecule:
def __init__(self, obj):
''' Add two point properties '''
obj.addProperty("App::PropertyVector","p1","Line","Start point")
obj.addProperty("App::PropertyVector","p2","Line","End point").p2=FreeCAD.Vector(5,0,0)
obj.Proxy = self
def onChanged(self, fp, prop):
pass
def execute(self, fp):
''' Print a short message when doing a recomputation, this method is mandatory '''
pass
class ViewProviderMolecule:
def __init__(self, obj):
''' Set this object to the proxy object of the actual view provider '''
self.constructed = False
obj.Proxy = self
self.ViewObject = obj
def attach(self, obj):
material = coin.SoMaterial()
material.diffuseColor = (1.0, 0.0, 0.0)
material.emissiveColor = (1.0, 0.0, 0.0)
drawStyle = coin.SoDrawStyle()
drawStyle.pointSize.setValue(10)
drawStyle.style = coin.SoDrawStyle.LINES
wireframe = coin.SoGroup()
shaded = coin.SoGroup()
self.wireframe = wireframe
self.shaded = shaded
self.coords = coin.SoCoordinate3()
self.coords.point.setValues(0, 2, [FreeCAD.Vector(0, 0, 0), FreeCAD.Vector(1, 0, 0)])
wireframe += self.coords
wireframe += drawStyle
wireframe += material
shaded += self.coords
shaded += drawStyle
shaded += material
g = coin.SoGroup()
sel1 = coin.SoType.fromName('SoFCSelection').createInstance()
sel1.style = 'EMISSIVE_DIFFUSE'
p1 = coin.SoType.fromName('SoIndexedPointSet').createInstance()
p1.coordIndex.set1Value(0, 0)
sel1 += p1
g += sel1
wireframe += g
shaded += g
g = coin.SoGroup()
sel2 = coin.SoType.fromName('SoFCSelection').createInstance()
sel2.style = 'EMISSIVE_DIFFUSE'
p2 = coin.SoType.fromName('SoIndexedPointSet').createInstance()
p2.coordIndex.set1Value(0, 1)
sel2 += p2
g += sel2
wireframe += g
shaded += g
g = coin.SoGroup()
sel3 = coin.SoType.fromName('SoFCSelection').createInstance()
sel3.style = 'EMISSIVE_DIFFUSE'
p3 = coin.SoType.fromName('SoIndexedLineSet').createInstance()
p3.coordIndex.setValues(0, 2, [0, 1])
sel3 += p3
g += sel3
wireframe += g
shaded += g
obj.addDisplayMode(wireframe, 'Wireframe')
obj.addDisplayMode(shaded, 'Shaded')
self.sel1 = sel1
self.sel2 = sel2
self.sel3 = sel3
self.constructed = True
self.updateData(obj.Object, 'p2')
def getDetailPath(self, subname, path, append):
vobj = self.ViewObject
if append:
path.append(vobj.RootNode)
path.append(vobj.SwitchNode)
mode = vobj.SwitchNode.whichChild.getValue()
FreeCAD.Console.PrintWarning("getDetailPath: mode {} is active\n".format(mode))
if mode >= 0:
mode = vobj.SwitchNode.getChild(mode)
path.append(mode)
sub = Part.splitSubname(subname)[-1]
print(sub)
if sub == 'Atom1':
path.append(self.sel1)
elif sub == 'Atom2':
path.append(self.sel2)
elif sub == 'Line':
path.append(self.sel3)
else:
path.append(mode.getChild(0))
return True
def getElementPicked(self, pp):
path = pp.getPath()
if path.findNode(self.sel1) >= 0:
return 'Atom1'
if path.findNode(self.sel2) >= 0:
return 'Atom2'
if path.findNode(self.sel3) >= 0:
return 'Line'
raise NotImplementedError
def updateData(self, fp, prop):
"If a property of the handled feature has changed we have the chance to handle this here"
# fp is the handled feature, prop is the name of the property that has changed
if not self.constructed:
return
if prop == "p1":
p = fp.getPropertyByName("p1")
self.coords.point.set1Value(0, p)
elif prop == "p2":
p = fp.getPropertyByName("p2")
self.coords.point.set1Value(1, p)
def getDisplayModes(self, obj):
return ['Wireframe', 'Shaded']
def getDefaultDisplayMode(self):
return 'Shaded'
def setDisplayMode(self, mode):
return mode
def dumps(self):
return None
def loads(self,state):
return None
def makeMolecule():
FreeCAD.newDocument()
a=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Molecule")
Molecule(a)
b=ViewProviderMolecule(a.ViewObject)
a.touch()
FreeCAD.ActiveDocument.recompute()
return a,b
a,b = makeMolecule()
Oggetti con script di Part Design
Quando si creano oggetti con script in Part Design, il processo è simile agli oggetti con script discussi sopra, ma con alcune considerazioni aggiuntive. Dobbiamo gestire 2 proprietà della forma, una per la forma, che vediamo nella vista 3D e un'altra per la forma utilizzata dagli strumenti del modello, come le caratteristiche del modello polare. Le forme dell'oggetto devono anche essere fuse con qualsiasi materiale esistente già nel Corpo (o tagliate da esso nel caso di funzioni sottrattive). E dobbiamo tenere conto della collocazione e dell'attaccamento dei nostri oggetti in modo un po' diverso.
Le feature di oggetti solidi con script di Part Design devono essere basate su PartDesign::FeaturePython, PartDesign::FeatureAdditivePython o PartDesign::FeatureSubtractivePython piuttosto che su Part::FeaturePython. Solo le varianti Additive e Subtractive possono essere utilizzate nelle feature di ripetizione e, se basate su Part::FeaturePython, quando l'utente rilascia l'oggetto in un Body di Part Design, diventa una BaseFeature invece di essere trattato dal Body come un oggetto di Part Design nativo. Nota: tutti questi dovrebbero essere solidi, quindi se stai creando una caratteristica non solida dovrebbe essere basata su Part::FeaturePython altrimenti la caratteristica successiva nell'albero tenterà di fondersi come un solido e fallirà .
Di seguito è riportato un semplice esempio di creazione di una primitiva Tube, simile alla primitiva Tube nell'ambiente Part, tranne per il fatto che questa sarà un oggetto feature solido di Part Design. Per questo useremo 2 file separati: pdtube.FCMacro e pdtube.py. Il file .FCMacro verrà eseguito dall'utente per creare l'oggetto. Il file .py conterrà le definizioni delle classi, importate da .FCMacro. Il motivo per farlo in questo modo è mantenere la natura parametrica dell'oggetto dopo aver riavviato FreeCAD e aperto un documento contenente uno dei nostri tubi.
Innanzitutto, il file di definizione della classe:
# -*- coding: utf-8 -*-
#classes should go in pdtube.py
import FreeCAD, FreeCADGui, Part
class PDTube:
def __init__(self,obj):
obj.addProperty("App::PropertyLength","Radius1","Tube","Radius1").Radius1 = 5
obj.addProperty("App::PropertyLength","Radius2","Tube","Radius2").Radius2 = 10
obj.addProperty("App::PropertyLength","Height","Tube","Height of tube").Height = 10
self.makeAttachable(obj)
obj.Proxy = self
def makeAttachable(self, obj):
if int(FreeCAD.Version()[1]) >= 19:
obj.addExtension('Part::AttachExtensionPython')
else:
obj.addExtension('Part::AttachExtensionPython', obj)
obj.setEditorMode('Placement', 0) #non-readonly non-hidden
def execute(self,fp):
outer_cylinder = Part.makeCylinder(fp.Radius2, fp.Height)
inner_cylinder = Part.makeCylinder(fp.Radius1, fp.Height)
if fp.Radius1 == fp.Radius2: #just make cylinder
tube_shape = outer_cylinder
elif fp.Radius1 < fp.Radius2:
tube_shape = outer_cylinder.cut(inner_cylinder)
else: #invert rather than error out
tube_shape = inner_cylinder.cut(outer_cylinder)
if not hasattr(fp, "positionBySupport"):
self.makeAttachable(fp)
fp.positionBySupport()
tube_shape.Placement = fp.Placement
#BaseFeature (shape property of type Part::PropertyPartShape) is provided for us
#with the PartDesign::FeaturePython and related classes, but it might be empty
#if our object is the first object in the tree. it's a good idea to check
#for its existence in case we want to make type Part::FeaturePython, which won't have it
if hasattr(fp, "BaseFeature") and fp.BaseFeature != None:
if "Subtractive" in fp.TypeId:
full_shape = fp.BaseFeature.Shape.cut(tube_shape)
else:
full_shape = fp.BaseFeature.Shape.fuse(tube_shape)
full_shape.transformShape(fp.Placement.inverse().toMatrix(), True) #borrowed from gears workbench
fp.Shape = full_shape
else:
fp.Shape = tube_shape
if hasattr(fp,"AddSubShape"): #PartDesign::FeatureAdditivePython and
#PartDesign::FeatureSubtractivePython have this
#property but PartDesign::FeaturePython does not
#It is the shape used for copying in pattern features
#for example in making a polar pattern
tube_shape.transformShape(fp.Placement.inverse().toMatrix(), True)
fp.AddSubShape = tube_shape
class PDTubeVP:
def __init__(self, obj):
'''Set this object to the proxy object of the actual view provider'''
obj.Proxy = self
def attach(self,vobj):
self.vobj = vobj
def updateData(self, fp, prop):
'''If a property of the handled feature has changed we have the chance to handle this here'''
pass
def getDisplayModes(self,obj):
'''Return a list of display modes.'''
modes=[]
modes.append("Flat Lines")
modes.append("Shaded")
modes.append("Wireframe")
return modes
def getDefaultDisplayMode(self):
'''Return the name of the default display mode. It must be defined in getDisplayModes.'''
return "Flat Lines"
def setDisplayMode(self,mode):
'''Map the display mode defined in attach with those defined in getDisplayModes.\
Since they have the same names nothing needs to be done. This method is optional'''
return mode
def onChanged(self, vp, prop):
'''Here we can do something when a single property got changed'''
#FreeCAD.Console.PrintMessage("Change property: " + str(prop) + "\n")
pass
def getIcon(self):
'''Return the icon in XPM format which will appear in the tree view. This method is\
optional and if not defined a default icon is shown.'''
return """
/* XPM */
static const char * ViewProviderBox_xpm[] = {
"16 16 6 1",
" c None",
". c #141010",
"+ c #615BD2",
"@ c #C39D55",
"# c #000000",
"$ c #57C355",
" ........",
" ......++..+..",
" .@@@@.++..++.",
" .@@@@.++..++.",
" .@@ .++++++.",
" ..@@ .++..++.",
"###@@@@ .++..++.",
"##$.@@$#.++++++.",
"#$#$.$$$........",
"#$$####### ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
"#$$#$$$$$# ",
" #$#$$$$$# ",
" ##$$$$$# ",
" ####### "};
"""
def dumps(self):
'''When saving the document this object gets stored using Python's json module.\
Since we have some un-serializable parts here -- the Coin stuff -- we must define this method\
to return a tuple of all serializable objects or None.'''
return None
def loads(self,state):
'''When restoring the serialized object from document we have the chance to set some internals here.\
Since no data were serialized nothing needs to be done here.'''
return None
E ora il file macro per creare l'oggetto:
# -*- coding: utf-8 -*-
#pdtube.FCMacro
import pdtube
#above line needed if the class definitions above are place in another file: PDTube.py
#this is needed if the tube object is to remain parametric after restarting FreeCAD and loading
#a document containing the object
body = FreeCADGui.ActiveDocument.ActiveView.getActiveObject("pdbody")
if not body:
FreeCAD.Console.PrintError("No active body.\n")
else:
from PySide import QtGui
window = FreeCADGui.getMainWindow()
items = ["Additive","Subtractive","Neither additive nor subtractive"]
item,ok =QtGui.QInputDialog.getItem(window,"Select tube type","Select whether you want additive, subtractive, or neither:",items,0,False)
if ok:
if item == items[0]:
className = "PartDesign::FeatureAdditivePython"
elif item == items[1]:
className = "PartDesign::FeatureSubtractivePython"
else:
className = "PartDesign::FeaturePython" #not usable in pattern features, such as polar pattern
tube = FreeCAD.ActiveDocument.addObject(className,"Tube")
pdtube.PDTube(tube)
pdtube.PDTubeVP(tube.ViewObject)
body.addObject(tube) #optionally we can also use body.insertObject() for placing at particular place in tree
Available object types
The list of all object types you can create with FreeCAD.ActiveDocument.addObject()
can be obtained with FreeCAD.ActiveDocument.supportedTypes()
. Only object types with a name ending in Python
can be used for scripted objects. These are listed here (for FreeCAD v0.21):
App::DocumentObjectGroupPython
App::FeaturePython
App::GeometryPython
App::LinkElementPython
App::LinkGroupPython
App::LinkPython
App::MaterialObjectPython
App::PlacementPython
Part::CustomFeaturePython
Part::FeaturePython
Part::Part2DObjectPython
Path::FeatureAreaPython
Path::FeatureAreaViewPython
Path::FeatureCompoundPython
Path::FeaturePython
Path::FeatureShapePython
Sketcher::SketchObjectPython
TechDraw::DrawComplexSectionPython
TechDraw::DrawLeaderLinePython
TechDraw::DrawPagePython
TechDraw::DrawRichAnnoPython
TechDraw::DrawTemplatePython
TechDraw::DrawTilePython
TechDraw::DrawTileWeldPython
TechDraw::DrawViewPartPython
TechDraw::DrawViewPython
TechDraw::DrawViewSectionPython
TechDraw::DrawViewSymbolPython
TechDraw::DrawWeldSymbolPython
Metodi disponibili
Vedi Metodi FeaturePython per i riferimenti completi.
Proprietà disponibili
Le proprietà sono i veri e propri mattoni per la costruzione degli oggetti FeaturePython. Attraverso di esse, l'utente è in grado di interagire e modificare l'oggetto. Dopo aver creato un nuovo oggetto FeaturePython nel documento (obj=FreeCAD.ActiveDocument.addObject("App::FeaturePython","Box")), è possibile ottenere un elenco delle proprietà disponibili digitando:
obj = FreeCAD.ActiveDocument.addObject("App::FeaturePython", "Box")
obj.supportedProperties()
Si ottiene un elenco di proprietà disponibili, che sono descritte in modo più approfondito nella pagina FeaturePython Custom Properties:
Quando si aggiungono delle proprietà agli oggetti personalizzati, stare attenti a questo:
- Non utilizzare i caratteri "<" o ">" nelle descrizioni delle proprietà (questo spezza le parti xml nel file .fcstd)
- Le proprietà sono memorizzate in ordine alfabetico nel file .fcstd. Se si dispone di una forma (Shape) nelle proprietà, qualsiasi proprietà il cui nome, in ordine alfabetico, viene dopo "Shape", verrà caricato DOPO la forma (Shape), e questo può causare strani comportamenti.
The properties are defined in the PropertyStandard C++ header file.
Tipi di proprietà
Di default, le proprietà possono essere aggiornate. È possibile creare delle proprietà di sola lettura, per esempio nel caso si vuole mostrare il risultato di un metodo. È anche possibile nascondere una proprietà. Il tipo di proprietà può essere impostata usando
obj.setEditorMode("MyPropertyName", mode)
dove mode è un indice che può essere impostato:
0 -- default mode, lettura e scrittura 1 -- solo lettura 2 -- nascosto
The mode can also be set using a list of strings, e.g. obj.setEditorMode("Placement", ["ReadOnly", "Hidden"])
.
Gli EditorModes non sono fissati nel file reload di FreeCAD. Questo può essere fatto dalla funzione __setstate__ . Vedere http://forum.freecadweb.org/viewtopic.php?f=18&t=13460&start=10#p108072. Usando setEditorMode le proprietà sono in sola lettura soltanto in PropertyEditor. Esse possono ancora essere modificate da un comando Python. Per renderle davvero in sola lettura le impostazioni devono essere passate direttamente all'interno della funzione addProperty. Per un esempio, vedere http://forum.freecadweb.org/viewtopic.php?f=18&t=13460&start=20#p109709.
Utilizzando l'impostazione diretta nella funzione addProperty, si hanno anche più possibilità. In particolare, è interessante contrassegnare una proprietà come proprietà di output. In questo modo FreeCAD non contrassegnerà l'elemento come variato durante la modifica (quindi non è necessario ricalcolare).
Esempio di proprietà di output (vedi anche https://forum.freecadweb.org/viewtopic.php?t=24928):
obj.addProperty("App::PropertyString", "MyCustomProperty", "", "", 8)
I tipi di proprietà che possono essere impostati all'ultimo parametro della funzione addProperty sono:
0 -- Prop_None, nessun tipo di proprietà speciale 1 -- Prop_ReadOnly, la proprietà è di sola lettura nell'editor 2 -- Prop_Transient, la proprietà non verrà salvata nel file 4 -- Prop_Hidden, la proprietà non apparirà nell'editor 8 -- Prop_Output, la proprietà modificata non tocca il suo contenitore principale 16 -- Prop_NoRecompute, la proprietà modificata non tocca il suo contenitore per il ricalcolo 32 -- Prop_NoPersist, la proprietà non verrà affatto salvata nel file
È possibile trovare questi diversi tipi di proprietà definiti nell'intestazione del codice sorgente C++ per PropertyContainer.
Available extensions
The list of available extensions can be obtained with grep -RI EXTENSION_PROPERTY_SOURCE_TEMPLATE
in the repository of the source code and is given here (for FreeCAD v0.21).
For objects:
App::GeoFeatureGroupExtensionPython
App::GroupExtensionPython
App::LinkBaseExtensionPython
App::LinkExtensionPython
App::OriginGroupExtensionPython
Part::AttachExtensionPython
TechDraw::CosmeticExtensionPython
For view objects:
Gui::ViewProviderExtensionPython
Gui::ViewProviderGeoFeatureGroupExtensionPython
Gui::ViewProviderGroupExtensionPython
Gui::ViewProviderOriginGroupExtensionPython
PartGui::ViewProviderAttachExtensionPython
PartGui::ViewProviderSplineExtensionPython
There exist other extensions but they do not work as-is:
App::ExtensionPython
TechDrawGui::ViewProviderCosmeticExtensionPython
TechDrawGui::ViewProviderDrawingViewExtensionPython
TechDrawGui::ViewProviderPageExtensionPython
TechDrawGui::ViewProviderTemplateExtensionPython
Ulteriori informazioni
Pagine aggiuntive:
- Oggetti creati con script che salvano gli attributi
- Migrazione di oggetti creati con script
- Oggetti creati da script con parti associate
- Viewprovider
Interessanti thread del forum sugli oggetti con script:
- Python object attributes lost at load
- New FeaturePython is grey
- Explanation on dumps and loads, official documentation
- Eigenmode frequency always 0?
- how to implement python feature's setEdit properly?
Oltre agli esempi presentati qui dare un'occhiata al codice sorgente di FreeCAD src/Mod/TemplatePyMod/FeaturePython.py per ulteriori esempi.
- FreeCAD scripting: Python, Introduction to Python, Python scripting tutorial, FreeCAD Scripting Basics
- Modules: Builtin modules, Units, Quantity
- Workbenches: Workbench creation, Gui Commands, Commands, Installing more workbenches
- Meshes and Parts: Mesh Scripting, Topological data scripting, Mesh to Part, PythonOCC
- Parametric objects: Scripted objects, Viewproviders (Custom icon in tree view)
- Scenegraph: Coin (Inventor) scenegraph, Pivy
- Graphical interface: Interface creation, Interface creation completely in Python (1, 2, 3, 4, 5), PySide, PySide examples beginner, intermediate, advanced
- Macros: Macros, How to install macros
- Embedding: Embedding FreeCAD, Embedding FreeCADGui
- Other: Expressions, Code snippets, Line drawing function, FreeCAD vector math library (deprecated)
- Hubs: User hub, Power users hub, Developer hub