Biblioteci de la terți

From FreeCAD Documentation
Revision as of 21:20, 10 February 2020 by FuzzyBot (talk | contribs) (Updating to match new version of source page)

Prezentare generală

Acestea sunt biblioteci care nu sunt modificate în proiectul FreeCAD. Ele sunt practic utilizate ca o bibliotecă dinamică de legătură (* .so sau * .dll). Dacă este nevoie de schimbare, sau a wrapper class este necesar , atunci codul wrapper sau biblioteca modificată trebuie mutat în pachetul de bază FreeCAD. Bibliotecile folosite sunt:

The dependencies need to be installed in the system before proceeding with compilation; see compile on Linux/Unix, compile on Windows, and compile on MacOS for more information.

Dacă utilizați Windows, luați în considerare folosireaLibPack în loc de a descărca și a instala tot felul de chestii pe cont propriu.

Legături

Link table
Lib name Version needed Link to get it
Python >= 2.5.x http://www.python.org/
OpenCasCade >= 5.2 http://www.opencascade.org
Qt >= 4.1.x https://www.qt.io/
Coin3D >= 2.x http://www.coin3d.org
SoQt >= 1.2 http://www.coin3d.org
Xerces-C++ >= 2.7.x < 3.0 http://xml.apache.org/xerces-c/
Zlib >= 1.x.x http://www.zlib.net/
Boost >= 1.33.x http://www.boost.org/
Eigen3 >= 3.0.1 http://eigen.tuxfamily.org/index.php?title=Main_Page
Shiboken >= 1.1.2 http://shiboken.readthedocs.org/en/latest/
libarea N/A https://github.com/danielfalck/libarea

Detalii

Python

Version: 2.5 or higher

License: Python 2.5 license

Python 2 became obsolete in 2019. Further development of FreeCAD will use exclusively Python 3; compatibility with Python 2 won't be tested, so old workbenches and macros that use this version will have to be updated or they may stop working. Please post on the FreeCAD forum if you encounter problems with Python 3.

Python is a popular all-purpose scripting language that is widely used in Linux and open source software. In FreeCAD, Python is used during compilation and also at runtime in different ways. It is used

  • to write test scripts to test for different conditions, such as memory leaks, to ensure functionality of the software after changes, for post build checks, and test coverage tests,
  • to write macros and macro recording,
  • to implement application logic for standard packages,
  • to implement auxiliary tools such as the Addon Manager,
  • to implement entire workbenches like Draft and Arch,
  • to dynamically load packages,
  • to implement rules for design (knowledge engineering),
  • to do fancy Internet interactions like work groups and PDM

Puteți folosi programul sursă sau binarul de la http://www.python.org/ ori să utlizați alternativ ActiveState Python from http://www.activestate.com/ deși este puțin greu să obțineți depanarea bibliotecilor/libs din ActiveState.

Python was chosen as the scripting language for FreeCAD for different reasons:

  • It is more object oriented than Perl and Tcl.
  • The code is more readable than Perl and Visual Basic.
  • It is easier to embed in another application, unlike, say, Java.

In summary, Python is well documented, and it's easy to embed and extend in a C++ application. It is also well tested and has strong support from the open source community. Read more about Python and browse the official documentation at Python.org.

Boost

Version: 1.33.x

License: Boost Software License - Version 1.0

Bibliotecile Boost C ++ sunt o colecție de biblioteci evaluate de colegi, care extind funcționalitatea C ++. Bibliotecile sunt licențiate sub licența Boost Software License, concepute pentru a permite ca Boost să fie utilizat atât cu proiecte deschise, cât și cu surse închise. Mulți dintre fondatorii lui Boost se află în comitetul standard C ++ și mai multe biblioteci Boost au fost acceptate pentru a fi încorporate în raportul tehnic 1 al C ++ 0x.

Due to their popularity and stability, many Boost libraries have been accepted for incorporation into the C++11 standard, and more are planned for inclusion in subsequent C++ standards.

Pentru a asigura eficiența și flexibilitatea, Boost folosește pe scară largă șabloanele. Boost a fost o sursă de muncă și cercetări ample privind programarea generică și meta-programarea în C ++.

OpenCasCade

Version: 5.2 or higher

License: v6.7.0 and later are governed by GNU Lesser General Public License (LGPL) version 2.1 with additional exception. https://www.opencascade.com/content/licensing Earlier versions use a slightly different license: https://www.opencascade.com/content/occt-public-license

OCC este un kernel CAD complet echipat. Inițial, este dezvoltat de Matra Datavision în Franța pentru aplicațiile Strim (Styler) și Euclid Quantum și mai târziu l-au făcut Open Source. Este o bibliotecă cu adevărat imensă și face posibilă o aplicație CAO gratuită, oferind câteva pachete care ar fi greu sau imposibil de implementat într-un proiect Open Source:

  • Un nucleu geometric complet compatibil cu STEP
  • Un model topologic de date și toate funcțiile necesare pentru a lucra pe (tăiere, fuziune, extrudere, și așa mai departe ...)
  • Procese standard de import / export precum STEP, IGES, VRML
  • Viewer 3D și 2D cu selectare suport
  • O structura de document și a datelor unui proiect cu suport pentru salvare și restaurare, legătura externă a documentelor, recalcularea istoricului de desenului/proiectului (modelarea parametrică) și a unui centru de încărcare a datelor de tip nou, ca un modul de extensie dinamic.

OCCT is a big and complex set of C++ libraries that provide functionality required by a CAD application:

  • A complete STEP compliant geometry kernel.
  • A topological data model and needed functions to work with shapes (cut, fuse, extrude, and many others).
  • Standard import and export processors for files like STEP, IGES, VRML.
  • A 2D and 3D viewer with selection support.
  • A document and project data structure with support for save and restore, external linking of documents, recalculation of design history (parametric modeling) and a facility to load new data types as an extension package dynamically.

There are two main versions of OpenCASCADE in existence in different Linux distributions. One is distributed by the original developers; it is known as OCCT, and is packaged under the names occ or occt. The other version is the "community edition", abbreviated OCE, and is normally found with the oce name. FreeCAD can compile against either version, however, since 2016 FreeCAD recommends compiling against the official OCCT libraries rather than the OCE ones. The reason is that the community edition lacks important bug fixes and functions that make using FreeCAD better.

To learn more about OpenCasCade take a look at the OpenCasCade page or http://www.opencascade.org.

Qt

Version: 4.1.x or higher

License: GPL v2.0/v3.0 or Commercial (from version 4.5 on also LPGL v2.1)

Nu cred că trebuie să spun foarte multe despre QT. Este unul dintre cele mai utilizate instrumente de GUI în proiectele Open Source. Pentru mine cel mai important punct de utilizare a Qt este designerul Qt și posibilitatea de a încărca toate casetele dialog ca resursă (XML) și care încorporează widget-uri specializate. Într-o aplicație CAX interacțiunea cu utilizatorul și casetele de dialog sunt de departe cea mai mare parte a codului și o bună proiectarea a dialogului ester foarte importantă pentru extinderea freeCAD cu noi funcționalități. Informații suplimentare și foarte bună documentație on line o veți găsi pe http://www.qtsoftware.com.

Further information about Qt libraries and their programming documentation are available at Qt Documentation.

Shiboken and Pyside

Shiboken (Shi bō ken, 死某剣)este generatorul de legare Python pe care îl utilizează Qt pentru Python pentru a crea modulul PySide, cu alte cuvinte, este sistemul pe care îl folosim pentru a expune API-ul Qt C ++ către Python.

Numele de Shiboken2 și PySide2 face referire la compatibilitatea Qt 5, deoarece versiunile anterioare (fără 2) se referă la Qt 4. Citiți mai multe despre Shiboken și Pyside pe Qt for Python wiki page

Read more about Shiboken and Pyside on Qt for Python.

Coin3D

Version: 2.0 or higher

License: GPL v2.0 or Commercial

Coin este o bibliotecă grafică 3D de nivel înalt cu o interfață de programare a aplicațiilor C ++Application Programming Interface. Coin utilizează structuri de date grafice de scenă pentru a oferi grafică în timp real potrivită pentru majoritatea aplicațiilor de vizualizare științifică și inginerie.

Coin este construit pe standardul industrial OpenGL cu biblioteca de randare imediată și adaugă abstracții pentru primitive de nivel superior, oferă interactivitate 3D, îmbunătățește foarte mult confortul și productivitatea programatorului și conține multe funcții de optimizare complexe pentru randarea rapidă și în plus care este transparentă pentru programatorul de aplicații.

Coin se bazează pe SGI Open Inventor API . Open Inventor, pentru cei care nu sunt familiarizați cu acesta, a devenit de mult timp biblioteca grafică standard de facto pentru vizualizarea 3D și software-ul de simulare vizuală în comunitatea științifică și de inginerie. Și-a demonstrat valoarea timp de peste 10 ani, maturitatea sa contribuind la succesul său ca o fundație majoră în mii de aplicații de inginerie la scară largă din întreaga lume.

Vom folosi OpenInventor ca vizualizator 3D în FreeCAD, deoarece vizualizatorul OpenCasCade (AIS și Graphics3D) au limitele lor din cauza fluxului ridicat de date, mai ales atunci când intră în randarea inginerească la scară largă. Alte lucruri, cum ar fi texturile sau randarea volumetrică, nu sunt cu adevărat susținute și așa mai departe....

Software Coin este portabil pe o gamă largă de platforme: orice platformă UNIX / Linux / * BSD, tot sistemul de operare Microsoft Windows și Mac OS X.

SoQt

Version: 1.2.0 or higher

License: GPL v2.0 or Commercial

SoQt este Inventorul fr lrgături pentru Qt Gui Toolkit. Din păcate, nu mai este LGPL, deci trebuie să îl eliminăm din codul de bază a FreeCAD și să îl conectăm ca o bibliotecă. Are același model de licență ca și Coin. Și trebuie să îl compilați cu versiunea Qt.

SoQt is no longer used in FreeCAD, it was replaced by Quarter which is a more recent Qt binding.

Quarter

Version: 1.0 or higher

License: BSD 3-clause license

Quarter is a newer Coin3D binding to the Qt toolkit. A version of it is included in the source code of FreeCAD so it is compiled together with it.

Pivy

Version: 0.6.3 or higher

License: BSD 3-clause license

Pivy is a library that wraps the Coin3d library for use in Python. It is not needed to build FreeCAD or to start it, but it is needed as a runtime dependency by the Draft Workbench, and by other workbenches that use it internally, like Arch and BIM.

If you are not going to use these workbenches, you won't need Pivy.

Ply

Version: 3.11 or higher

License: BSD 3-clause license

Ply is the Python-Lex-Yacc parser. It is used as a runtime dependency by the OpenSCAD Workbench. If you don't use this workbench, you may not need this package.

For more information see Ply homepage

Xerces-C++

Version: 2.7.0 or higher

License: Apache Software License Version 2.0

Xerces-C ++ este un analizor de validare (parser) XML scris într-un subset portabil de C ++. Cu Xerces-C ++ se ușurează oferirea aplicației dvs. abilității de a citi și scrie date în format XML. O bibliotecă partajată este prevăzută analizarea, generarea, manipularea și validarea documentelor XML.

The parser is used for saving and restoring parameters in FreeCAD.

Eigen3

Version: 3.0 or higher

License: Starting from the 3.1.1 version, it is licensed under the Mozilla Public License 2.0. Earlier versions were licensed under the GNU Lesser General Public License 3.

Eigen is a C++ template library for linear algebra: matrices, vectors, numerical solvers, and related algorithms.

If you just want to use Eigen, you can use the header files right away. There is no binary library to link to, and no configured header file. Eigen is a pure template library defined in the headers.

Eigen is used in FreeCAD for many vector operations in 3D space. To learn more, visit Eigen homepage.

Zipios++

Version: 0.1.5 or higher

License: GNU Lesser General Public License 2.1

Zipios++ is a C++ library for reading and writing .zip files. Access to individual entries is provided through standard C++ iostreams. A simple read-only virtual file system that mounts regular directories and .zip files is also provided. The structure and public interface of Zipios++ are loosely based on the java.util.zip package of Java.

FreeCAD's native file format .FCstd is in reality a .zip file that stores and compresses other types of data within it, such as BREP and XML files. Therefore, Zipios++ is used to save and open compressed archives, including FreeCAD files.

A copy of Zipios++ is included in the source code of FreeCAD so it is compiled together with it. If you want to use an external Zipios++ library, provided by your operating system, you may set -DFREECAD_USE_EXTERNAL_ZIPIOS=ON with cmake.

Zipios++ uses the Zlib library to perform the actual decompression of files.

Zlib

Version: 1.x.x

License: zlib License

zlib este conceput pentru a fi gratuit, cu scop general, fără a fi limitat din punct de vedere juridic - adică nu este acoperit de nici un brevet- Biblioteca de compresie a datelor fără pierderi pentru utilizare pe orice hardware și sistem de operare. Formatul de date zlib este auto-portabil pe orice platformă. Spre deosebire de metoda de compresie LZW folosită în compresia Unix compress(1) și în formatul de imagine GIF, metoda de comprimare utilizată în mod curent în zlib nu extinde niciodată datele. (LZW poate dubla sau tripla mărimea fișierului în cazuri extreme). Amprenta de memorie a bibliotecii zlib este, de asemenea, independentă de datele de intrare și poate fi redusă, dacă este necesar, la un anumit raport de compresie.

A copy of this library is included in the source code of FreeCAD so it is compiled together with it.

libarea

Version: N/A

License: New BSD (BSD 3-Clause)

Area is a piece of software created by Dan Heeks for HeeksCNC. It is employed as a library for generation of CAM related operations in the Path Workbench.

A copy of the library is included with the source code of the Path Workbench, so it is compiled together with it.

LibPack

LibPack este un pachet convenabil cu toate bibliotecile de mai sus ambalate împreună. Este necesar doar dacă construiți pe Platforma Windows și îl puteți găsi la https://github.com/FreeCAD/FreeCAD-ports-cache/releases. Dacă lucrați sub Linux, trebuie să utilizați depozitele de pachete ale distribuției dvs. Linux, adică nu este nevoie de libPack și oferit pentru Linux.

If you're working under Linux, you don't need the LibPack, as you can get the dependencies from your distribution's repositories as mentioned in the compile on Unix page.

FreeCAD 12.1.2

See the announcement in the forum: New libpacks for Windows with Qt5.12, OCC7.3 and Python 3.6 by apeltauer

It includes among other things: Boost 1.67, Coin3D 4.0.0a, Eigen3, Open CASCADE Technology 7.3.0, Python 3.6.8, PySide2, Qt 5.12.1, Salome SMESH, Shiboken2, vtk7, Xerces-C, Zipios++, zlib 1.2.11

Compiling (Speeding up)
Third Party Tools