{{docnav/ro |Locație |Documentația sursă }}
Această pagină afișează câteva module suplimentare de tip python sau alte piese de software care pot fi descărcate gratuit de pe internet și pot adăuga funcționalitate pentru FreeCAD instalat.
- homepage (PySide): http://qt-project.org/wiki/PySide
- license: LGPL
- opțional, dar necesare sunt câteva module: Draft, Arch, Ship, Plot, OpenSCAD, Spreadsheet
PySide (anterior numit PyQt) este solicitat de mai multe module ale FreeCAD pentru a accesa interfața Qt a FreeCAD. Acesta este deja inclus în versiunea Windows a FreeCAD și, de obicei, este instalat automat de FreeCAD pe Linux, când se instalează din depozitele oficiale. Dacă aceste module (Draft, Arch etc.) sunt activate după ce FreeCAD este instalat, înseamnă că PySide (anterior PyQt) este deja acolo și nu mai trebuie să mai faceți nimic.
Notă: FreeCAD sa mutat progresiv de la PyQt după versiunea 0.13, în favoareaPySide, care face exact același lucru, dar are o licență (LGPL) mai compatibilă cu FreeCAD.
Cea mai simplă modalitate de a instala PySide este prin managerul de pachete al distribuției. Pe sistemele Debian / Ubuntu, numele pachetului este în general "python-PySide", în timp ce în sistemele bazate pe RPM se numește "pyside". Dependentele necesare (Qt și SIP) vor fi luate în considerare automat.
Programul poate fi descărcat de la http://qt-project.org/wiki/Category:LanguageBindings::PySide::Downloads. Va trebui să instalați bibliotecile Qt și SIP înainte de a instala PySide (pentru a fi documentate).
PyQt on Mac can be installed via homebrew or port. See Compile on MacOS/ro#Install_Dependencies for more information.
Odată ce este instalat, puteți verifica dacă totul funcționează prin tastarea în consolă Python FreeCAD:
import PySide
To access the FreeCAD interface, type :
from PySide import QtCore,QtGui
FreeCADWindow = FreeCADGui.getMainWindow()
Acum puteți începe să explorați interfața cu comanda dir (). Puteți adăuga elemente noi, cum ar fi un widget personalizat, cu comenzi cum ar fi:
FreeCADWindow.addDockWidget(QtCore.Qt.RghtDockWidgetArea,my_custom_widget)
Working with Unicode :
text = text.encode('utf-8')
Working with QFileDialog and OpenFileName :
path = FreeCAD.ConfigGet("AppHomePath")
#path = FreeCAD.ConfigGet("UserAppData")
OpenName, Filter = PySide.QtGui.QFileDialog.getOpenFileName(None, "Read a txt file", path, "*.txt")
Working with QFileDialog and SaveFileName :
path = FreeCAD.ConfigGet("AppHomePath")
#path = FreeCAD.ConfigGet("UserAppData")
SaveName, Filter = PySide.QtGui.QFileDialog.getSaveFileName(None, "Save a file txt", path, "*.txt")
PS: Aceste exemple de erori au fost găsite în tranziția de la PyQt4 la PySide și aceste corecții au fost făcute, alte soluții sunt cu siguranță disponibile cu exemplele de mai sus
try:
import PyQt4 # PyQt4
from PyQt4 import QtGui ,QtCore # PyQt4
from PyQt4.QtGui import QComboBox # PyQt4
from PyQt4.QtGui import QMessageBox # PyQt4
from PyQt4.QtGui import QTableWidget, QApplication # PyQt4
from PyQt4.QtGui import * # PyQt4
from PyQt4.QtCore import * # PyQt4
except Exception:
import PySide # PySide
from PySide import QtGui ,QtCore # PySide
from PySide.QtGui import QComboBox # PySide
from PySide.QtGui import QMessageBox # PySide
from PySide.QtGui import QTableWidget, QApplication # PySide
from PySide.QtGui import * # PySide
from PySide.QtCore import * # PySide
Pentru a accesa interfața FreeCAD, tastați: Puteți adăuga elemente noi, cum ar fi un widget personalizat, cu comenzi cum ar fi:
myNewFreeCADWidget = QtGui.QDockWidget() # create a new dockwidget
myNewFreeCADWidget.ui = Ui_MainWindow() # myWidget_Ui() # load the Ui script
myNewFreeCADWidget.ui.setupUi(myNewFreeCADWidget) # setup the ui
try:
app = QtGui.qApp # PyQt4 # the active qt window, = the freecad window since we are inside it
FCmw = app.activeWindow() # PyQt4 # the active qt window, = the freecad window since we are inside it
FCmw.addDockWidget(QtCore.Qt.RightDockWidgetArea,myNewFreeCADWidget) # add the widget to the main window
except Exception:
FCmw = FreeCADGui.getMainWindow() # PySide # the active qt window, = the freecad window since we are inside it
FCmw.addDockWidget(QtCore.Qt.RightDockWidgetArea,myNewFreeCADWidget) # add the widget to the main window
Working with Unicode :
try:
text = unicode(text, 'ISO-8859-1').encode('UTF-8') # PyQt4
except Exception:
text = text.encode('utf-8') # PySide
Working with QFileDialog and OpenFileName :
OpenName = ""
try:
OpenName = QFileDialog.getOpenFileName(None,QString.fromLocal8Bit("Lire un fichier FCInfo ou txt"),path,"*.FCInfo *.txt") # PyQt4
except Exception:
OpenName, Filter = PySide.QtGui.QFileDialog.getOpenFileName(None, "Lire un fichier FCInfo ou txt", path, "*.FCInfo *.txt")#PySide
Working with QFileDialog and SaveFileName :
SaveName = ""
try:
SaveName = QFileDialog.getSaveFileName(None,QString.fromLocal8Bit("Sauver un fichier FCInfo"),path,"*.FCInfo") # PyQt4
except Exception:
SaveName, Filter = PySide.QtGui.QFileDialog.getSaveFileName(None, "Sauver un fichier FCInfo", path, "*.FCInfo")# PySide
The MessageBox:
def errorDialog(msg):
diag = QtGui.QMessageBox(QtGui.QMessageBox.Critical,u"Error Message",msg )
try:
diag.setWindowFlags(PyQt4.QtCore.Qt.WindowStaysOnTopHint) # PyQt4 # this function sets the window before
except Exception:
diag.setWindowFlags(PySide.QtCore.Qt.WindowStaysOnTopHint)# PySide # this function sets the window before
# diag.setWindowModality(QtCore.Qt.ApplicationModal) # function has been disabled to promote "WindowStaysOnTopHint"
diag.exec_()
Working with setProperty (PyQt4) and setValue (PySide)
self.doubleSpinBox.setProperty("value", 10.0) # PyQt4
înlocuiți cu :
self.doubleSpinBox.setValue(10.0) # PySide
Working with setToolTip
self.doubleSpinBox.setToolTip(_translate("MainWindow", "Coordinate placement Axis Y", None)) # PyQt4
înlocuiți la :
self.doubleSpinBox.setToolTip(_fromUtf8("Coordinate placement Axis Y")) # PySide
ori :
self.doubleSpinBox.setToolTip(u"Coordinate placement Axis Y.")# PySide
- homepage: https://bitbucket.org/Coin3D/coin/wiki/Home
- license: BSD
- optional, but needed by several modules of FreeCAD: Draft, Arch
Pivy is a needed by several modules to access the 3D view of FreeCAD. On windows, Pivy is already bundled inside the FreeCAD installer, and on Linux it is usually automatically installed when you install FreeCAD from an official repository. On MacOSX, unfortunately, you will need to compile pivy yourself.
Am găsit că pentru construirea pe Mac a fost suficient pentru a instala Coin3 binary package. Încercarea de a instala coin de la MacPorts a fost problematică: a încercat să adauge o mulțime de pachete X Windows și în cele din urmă s-a prăbușit cu o eroare de script.
For Fedora I found an RPM with Coin3.
SoQt compiled from source fine on Mac and Linux.
Începând cu Debian Squeeze și Ubuntu Lucid, pivy va fi disponibil direct din depozitele oficiale, economisind astfel o mulțime de bătăi de cap. Între timp, puteți să descărcați unul dintre pachetele pe care le-am făcut (pentru debian și karmic ubuntu) disponibile în paginile Download sau să le compilați singur.
Cea mai bună modalitate de a compila pivy cu ușurință este să luați pachetul sursă debian pentru pivy și să faceți un pachet cu debuild. Este același cod sursă de pe site-ul oficial pivy, dar oamenii de la debian au făcut mai multe adăugări de fixare a bug-urilor. De asemenea, compilează bine karmicul ubuntu: http://packages.debian.org/squeeze/python-pivy descărcați fișierul .orig.gz și .diff.gz, apoi dezarhivați ambele, apoi aplicați .diff la sursă: mergeți la directorul sursă de pivy dezarhivate și aplicați patch-ul .diff:
patch -p1 < ../pivy_0.5.0~svn765-2.diff
then
debuild
to have pivy properly built into an official installable package. Then, just install the package with gdebi.
First get the latest sources from the project's repository:
hg clone http://hg.sim.no/Pivy/default Pivy
As of March 2012, the latest version is Pivy-0.5.
Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Pivy-0.5 raportează că a fost testată numai cu SWIG 1.3.31, 1.3.33, 1.3.35 și 1.3.40. Deci, puteți descărca o sursă tarball pentru una dintre aceste versiuni vechi de la http://www.swig.org. Then unpack it and from a command line do (as root):
./configure
make
make install (or checkinstall if you use it)
Ia doar câteva secunde compilarea.
Alternativ, puteți încerca construirea cu un SWIG mai recent. Începând cu luna martie 2012, o versiune tipică pentru depozit este 2.0.4. Pivy are o problemă minoră de compilare cu SWIG 2.0.4 pe Mac OS (vezi mai jos), dar pare să construiască bine pe Fedora Core 15.
După aceea, mergeți la sursele de pivy și sunați
python setup.py build
which creates the source files. Note that build can produce thousands of warnings, but hopefully there will be no errors.
Acest lucru este probabil depășit, însă este posibil să întâmpinați o eroare de compilator în care un "const char *" nu poate fi convertit într-un 'char *'. Pentru a repara că trebuie doar să scrieți un "const" înainte în liniile corespunzătoare. Există șase linii de rezolvat.
După asta, instalați by issuing (ca root):
python setup.py install (or checkinstall python setup.py install)
Et voila, pivy este instalat.
Este posibil ca aceste instrucțiuni să nu fie complete. Ceva aproape de acest lucru a funcționat pentru OS 10.7 în martie 2012. Eu folosesc MacPorts pentru depozite, dar ar trebui să funcționeze și alte opțiuni.
În ceea ce privește linux, obțineți cea mai recentă sursă:
hg clone http://hg.sim.no/Pivy/default Pivy
Dacă nu aveți hg, îl puteți obține de la MacPorts:
port install mercurial
Then, as above you need SWIG. It should be a matter of:
port install swig
I found I needed also:
port install swig-python
Începând cu luna martie 2012, MacPorts SWIG este la versiunea 2.0.4. După cum s-a menționat mai sus pentru linux, este posibil să fie mai bine să descărcați o versiune mai veche. SWIG 2.0.4 pare să aibă un bug care oprește clădirea Pivy. Vedeți primul mesaj din acest rezumat:https://sourceforge.net/mailarchive/message.php?msg_id=28114815
Acest lucru poate fi corectat prin editarea celor două locații sursă pentru a adăuga dereferențe: *arg4, *arg5 in place of arg4, arg5. Now Pivy should build:
python setup.py build
sudo python setup.py install
Presupunând că utilizați Visual Studio 2005 sau o versiune ulterioară, ar trebui să deschideți un prompt de comandă cu "Visual Studio 2005 Command prompt" din meniul Instrumente. Dacă interpretul Python nu este încă în calea sistemului, faceți acest lucru
set PATH=path_to_python_2.5;%PATH%
Pentru a obține o pivă de lucru, ar trebui să obțineți cele mai recente surse din depozitul proiectului:
svn co https://svn.coin3d.org/repos/Pivy/trunk Pivy
Apoi aveți nevoie de un instrument numit SWIG pentru a genera codul C++ pentru legăturile Python. Se recomandă utilizarea versiunii 1.3.25 a SWIG, nu cea mai recentă versiune, deoarece în acest moment pivy va funcționa corect numai cu 1.3.25. Descărcați binarele pentru 1.3.25 de la http://www.swig.org. Apoi despachetați-l și din linia de comandă adăugați-l pe calea sistemului
set PATH=path_to_swig_1.3.25;%PATH%
și setați COINDIR pe calea potrivită
set COINDIR=path_to_coin
Pe Windows, fișierul config pivy se așteaptă ca SoWin în loc de SoQt ca implicit. Nu am găsit o modalitate evidentă de a construi cu SoQt, așa că am modificat fișierul setup.py direct. În linia 200, scoateți doar partea "sowin": ('gui._sowin', 'sowin-config', 'pivy.gui.') (Nu scoateți paranteza de închidere).
After that go to the pivy sources and call
python setup.py build
care creează fișierele sursă. S-ar putea să întâlniți o eroare de compilator că nu au putut fi găsite mai multe fișiere antet. În acest caz, ajustați variabila INCLUDE
set INCLUDE=%INCLUDE%;path_to_coin_include_dir
și dacă antetele SoQt nu se află în același loc ca și antetele de Coin
set INCLUDE=%INCLUDE%;path_to_soqt_include_dir
și în final anteturile Qt
set INCLUDE=%INCLUDE%;path_to_qt4\include\Qt
Dacă utilizați Express Edition din Visual Studio, puteți obține o excepție python keyerror. În acest caz, trebuie să modificați câteva lucruri în msvccompiler.py localizate în instalarea dvs. python.
Mergeți la linia 122 și înlocuiți linia de cod
vsbase = r"Software\Microsoft\VisualStudio\%0.1f" % version
cu
vsbase = r"Software\Microsoft\VCExpress\%0.1f" % version
Apoi încercați din nou. Dacă primiți o a doua eroare cum ar fi
error: Python was built with Visual Studio 2003;...
trebui să înlocuiți și linia 128
self.set_macro("FrameworkSDKDir", net, "sdkinstallrootv1.1")
cu
self.set_macro("FrameworkSDKDir", net, "sdkinstallrootv2.0")
Reîncercați încă o dată. Dacă apare din nou o eroare cum ar fi
error: Python was built with Visual Studio version 8.0, and extensions need to be built with the same version of the compiler, but it isn't installed.
then you should check the environment variables DISTUTILS_USE_SDK and MSSDK with
echo %DISTUTILS_USE_SDK%
echo %MSSDK%
If not yet set then just set it e.g. to 1
set DISTUTILS_USE_SDK=1
set MSSDK=1
Acum, puteți întâlni o eroare de compilator în care un 'const char *' nu poate fi convertit într-un 'char *'. Pentru a repara că trebuie doar să scrieți un "const" înainte în liniile corespunzătoare. Există șase linii de rezolvat. Dupa ce copiați directorul generat pivy într-un loc in care interpretul python din FreeCAD îl poate gasi.
import pivy
To have Pivy access the FreeCAD scenegraph do the following:
from pivy import coin
App.newDocument() # Open a document and a view
view = Gui.ActiveDocument.ActiveView
FCSceneGraph = view.getSceneGraph() # returns a pivy Python object that holds a SoSeparator, the main "container" of the Coin scenegraph
FCSceneGraph.addChild(coin.SoCube()) # add a box to scene
You can now explore the FCSceneGraph with the dir() command.
Din păcate, documentația despre pivu este încă aproape inexistentă pe net. Dar s-ar putea să găsiți documentația Coin utilă, deoarece pivy pur și simplu traduce funcții de coin, noduri și metode în Python, totul păstrează același nume și proprietăți, ținând cont de diferența de sintaxă dintre C și python:
- https://bitbucket.org/Coin3D/coin/wiki/Documentation - Coin3D API Reference
- http://www-evasion.imag.fr/~Francois.Faure/doc/inventorMentor/sgi_html/index.html - The Inventor Mentor - The "bible" of Inventor scene description language.
You can also look at the Draft.py file in the FreeCAD Mod/Draft folder, since it makes big use of pivy.
- homepage: http://pycollada.github.com
- license: BSD
- optional, needed to enable import and export of Collada (.DAE) files
pyCollada is a python library that allow programs to read and write Collada (*.DAE) files. When pyCollada is installed on your system, FreeCAD will be able to handle importing and exporting in the Collada file format.
sudo apt-get install python3-collada
You can check if pycollada was correctly installed by issuing in a python console:
import collada
If it returns nothing (no error message), then all is OK
Pe Windows, de la 0.15 pycollada este inclus atât în versiunea FreeCAD, cât și în versiunea dezvoltatorului, deci nu sunt necesare pași suplimentari.
Dacă utilizați buildul Homebrew al FreeCAD, puteți instala pycollada în sistemul dvs. Python folosind pip.
If you need to install pip:
$ sudo easy_install pip
Install pycollada:
$ sudo pip install pycollada
Dacă utilizați o versiune binară a FreeCAD, puteți spune pip-ului să instaleze pycollada în pachetele de site-uri din cadrul FreeCAD.app:
$ pip install --target="/Applications/FreeCAD.app/Contents/lib/python2.7/site-packages" pycollada
sau după descărcarea codului pycollada
$ export PYTHONPATH=/Applications/FreeCAD\ 0.16.6706.app/Contents/lib/python2.7/site-packages:$PYTHONPATH
$ python setup.py install --prefix=/Applications/FreeCAD\ 0.16.6706.app/Contents
- homepage: http://www.ifcopenshell.org
- license: LGPL
- optional, needed to extend import abilities of IFC files
IFCOpenShell este o bibliotecă în curs de dezvoltare, care permite importul fișierelor Classes Fundation Classes (* .IFC) pentru import (și, în curând, export). IFC este o extensie a formatului STEP și devine standard în fluxurile de lucru BIM. Când sistemul ifcopenshell este instalat corect pe sistem, FreeCAD Arch Workbench/ro îl va detecta și îl va folosi pentru a importa fișiere IFC în locul importatorului său rudimentar integrat. Deoarece ifcopenshell se bazează pe OpenCasCade, precum FreeCAD, calitatea importului este foarte mare, producând o geometrie solidă de înaltă calitate.
Din moment ce ifcopenshell este destul de nou, probabil că va trebui să-l compilați singur.
Veți avea nevoie de câteva pachete de dezvoltare instalate pe sistemul dvs. pentru a compila ifcopenshell:
liboce-*-dev
python-dev
swig
dar din moment ce FreeCAD le cere tuturor, dacă puteți compila FreeCAD, nu veți avea nevoie de nici o dependență suplimentară pentru a compila IfcOpenShell.
Grab the latest source code from here:
git clone https://github.com/IfcOpenShell/IfcOpenShell.git
The build process is very easy:
mkdir ifcopenshell-build
cd ifcopenshell-build
cmake ../IfcOpenShell/cmake
or, if you are using oce instead of opencascade:
cmake -DOCC_INCLUDE_DIR=/usr/include/oce ../ifcopenshell/cmake
Deoarece ifcopenshell este făcut în primul rând pentru Blender, el folosește în mod implicit python3. Pentru a o folosi în interiorul FreeCAD, trebuie să o compilați împotriva aceleiași versiuni de Python care este folosită de FreeCAD. Deci este posibil să trebuiască să forțați versiunea python cu parametri suplimentari de tip cmake (ajustați versiunea python la a ta):
cmake -DOCC_INCLUDE_DIR=/usr/include/oce -DPYTHON_INCLUDE_DIR=/usr/include/python2.7 -DPYTHON_LIBRARY=/usr/lib/python2.7.so ../ifcopenshell/cmake
Then:
make
sudo make install
You can check that ifcopenshell was correctly installed by issuing in a python console:
import ifcopenshell
If it returns nothing (no error message), then all is OK
Notă: Instalatorii oficiali FreeCAD obținuți de pe pagina web/github a FreeCAD conțin acum ifcopenshell.
Copied from the IfcOpenShell README file
Users are advised to use the Visual Studio .sln file in the win/ folder. For Windows users a prebuilt Open CASCADE version is available from the http://opencascade.org website. Download and install this version and provide the paths to the Open CASCADE header and library files to MS Visual Studio C++.
Pentru a construi învelișul IfcPython, trebuie instalat SWIG. Descărcați cea mai recentă versiune swigwin de la http://www.swig.org/download.html. După extragerea fișierului .zip, adăugați dosarul extras la variabila de mediu PATH. Python trebuie să fie instalat, vă rugăm să furnizați căile de includere și bibliotecă la Visual Studio.
LazyLoader is a Python module that allows deferred loading, while still importing at the top of the script. This is useful if you are importing another module that is slow, and it is used several times throughout the script. Using LazyLoader can improve workbench startup times, but the module will still need to be loaded on first use.
LazyLoader is included with FreeCAD v0.19
You will need to import LazyLoader, then change the import of whatever module you want to be deferred.
from lazy_loader.lazy_loader import LazyLoader
Part = LazyLoader('Part', globals(), 'Part')
The variable Part is how the module is named in your script. You can replicate "import Part as P" by changing the variable.
P = LazyLoader('Part', globals(), 'Part')
You can also import a module from a package.
utils = LazyLoader('PathScripts', globals(), 'PathScripts.PathUtils')
``` You can\'t import individual functions, just entire modules.
### Links
- Original source: <https://github.com/tensorflow/tensorflow/blob/master/tensorflow/python/util/lazy_loader.py>
- Further explanation: <https://wil.yegelwel.com/lazily-importing-python-modules/>
- Code within the FreeCAD source code: <https://github.com/FreeCAD/FreeCAD/tree/master/src/3rdParty/lazy_loader>
- Forum discussion: <https://forum.freecadweb.org/viewtopic.php?f=10&t=45298>
<div class="mw-translate-fuzzy">
{{docnav/ro
|[Locație](Localisation/ro.md)
|[Documentația sursă](Source_documentation/ro.md)
}}
</div>
---
⏵ [documentation index](../README.md) > [Python Code](Category_Python Code.md) > [Developer Documentation](Category_Developer Documentation.md) > Extra python modules/ro