Power users hub/pt-br

---

Este é o local ideal para você, se for um usuário experiente e deseja aprender mais sobre como personalizar e expandir o FreeCAD.

O FreeCAD é extensível por meio de código Python que é executado diretamente no console Python, ou carregado a partir de módulos na inicialização. Isso significa que você pode modificar o FreeCAD sem precisar recompilar o programa. Por exemplo, você pode:

• Criar e modificar geometria: você pode criar um novo tipo de objeto, seja do zero ou adaptando um tipo existente.
• Criar ferramentas e comandos personalizados: adicione seu próprio conjunto de ferramentas que executam seu código.
• Modificar a interface: crie barras de ferramentas para adicionar suas ferramentas, crie janelas especiais, painéis ou interfaces para interagir com suas ferramentas.
• Modificar a representação do scenegraph: O FreeCAD possui processos separados para construir a geometria e exibi-la na tela. Você tem acesso total à maneira como o conteúdo da cena é exibido, portanto, pode modificar essa representação, interagir com ela ou adicionar comportamentos personalizados. Também é possível adicionar widgets de tela personalizados, como informações, manipuladores, âncoras ou entidades temporárias.

Se você gostaria de contribuir com conteúdo para essas páginas, solicite uma conta na wiki com permissões de editor [aqui no fórum](https://forum.freecadweb.org/viewtopic.php?f=21&t=6830) e leia as Páginas da Wiki para as diretrizes gerais que você deve seguir. Para outras formas de contribuir com o projeto, veja a página Ajuda FreeCAD.

Customizando o FreeCAD

• Personalização da Interface: Começando pelo básico: Barras de ferramentas e atalhos
• Trabalhando com Macros: Grave facilmente tarefas repetidas ou código Python
• Receitas de Macros
• Personalizar Barras de Ferramentas
• Instalando mais Workbenches

Programação em FreeCAD

Gerais

• Programação e Macros - Uma lista de páginas relevantes do wiki
• Introdução ao Python - Veja também outros tutoriais de Python no final desta página
• Tutorial de Programação em FreeCAD - Uma visão geral sobre a programação em Python no FreeCAD
• Noções Básicas de Programação no FreeCAD: Bem, as noções básicas
• Manual do FreeCAD - Seção Programação em Python: Introdução de vários capítulos sobre a Programação em Python no FreeCAD
• Comando de Interface Gráfica: Adicionando comandos personalizados à interface gráfica
• Usando unidades mistas Unidades no FreeCAD
• Análise de Desempenho do código Python
• Depuração do código Python
• Ambiente de Desenvolvimento Python - Um ambiente de desenvolvimento simples para Python dentro do FreeCAD

Modulos

The functionality of FreeCAD is separated in Modules which deal with special data types and applications. FreeCAD has built-in modules and Extension Modules (plug-ins). Once plugin modules are installed, they become availible to you as easily as the built-in modules. The modules described below are the default modules, includeed in every FreeCAD installation.

• The Builtin modules are the principal FreeCAD modules. They contain tools for manipulating general FreeCAD configurations, documents and their contents.
• Workbench creation shows you how to create your own workbench

Working with Meshes

• Mesh Scripting: How to interact with the Mesh Workbench

Working with Parts

• The Part Workbench: How Open CASCADE Technology tools and structure is used in FreeCAD
• Topological data scripting: How to interact with the Part Module
• PythonOCC: How to unleash the whole Open CASCADE power
• Mesh to Part: Converting between object types

Accessing the Coin scenegraph

• The Coin/Inventor scenegraph: How the FreeCAD scene representation works
• Pivy: How to access and modify the scenegraph

Controlling the Qt interface

• PySide: How to access the interface, and modify its contents
• Using the FreeCAD GUI in another Qt application with PyQt

Working with parametric objects

• Scripted objects: how to make 100% Python-scripted objects.
  • Scripted objects with attachment: how to make scripted objects attachable to other objects.
  • Scripted objects saving attributes: how to save and restore attributes of the proxy class with dumps and loads.
  • Scripted objects migration: how to migrate old scripted objects to a new class.

Examples

• Code snippets : A collection of pieces of FreeCAD Python code, to serve as ingredients in your scripts...
• Line drawing function: How to build a simple tool to draw lines
• Dialog creation: How to construct dialogs with Qt designer, and use them in FreeCAD
• Embedding FreeCAD: How to import FreeCAD as a Python module in other applications
• The Draft Workbench adds basic 2d drawing functions to freecad. It is written entirely in Python, so it can be a good example if you want to write your own modules.
• FreeCAD vector math library : A couple of handy functions to manipulate FreeCAD vectors. This library is also included in the Draft module.

API Functions

The complete API documentation of FreeCAD is located at http://www.freecadweb.org/api/ . It contains both C++ and Python APIs, and is not totally well formatted yet, which can be confusing when looking for python-only code. An easier to browse version can be found here. Note that it can be incomplete, since it is updated manually. For more accurate information, browse the modules directly from FreeCAD's Python console.

Related: Exposing C++ to Python

Advanced modification

• Start up and Configuration: Startup and command line options
• Installing on Windows: Using the windows installer
• Compiling FreeCAD on Windows and Compiling FreeCAD on Linux
• Branding: Simple modifications you can do to the source code to change some aspects of FreeCAD
• Extra python modules : Extend the FreeCAD python interpreter with these powerful modules!

Python tutorials

These are good generic tutorials, not specific to FreeCAD, that might interest you if you are totally new to python.

Python

• Official python tutorial - A very complete tutorial for discovering python
• Non-programmer tutorial for python - an excellent wikibook
• Python for newbies - one big tutorial covering all the basics

PySide - How to create and manage FreeCAD's Qt UI interface from python

• PySide tutorial : A platform-agnostic tutorial showing the usage of PySide with examples
• PySide/PyQt tutorial : A easy to read tutorial that covers PySide and PyQt with examples
• PySide documentation : from the Qt Project (the people who wrote it all)
• Using QtCreator in PySide : also from the Qt Project
• PySide reference : endless detail on the minutiae of PySide and Qt, a reliable reference source
• PySide code snippets : a searchable database of PySide code snippets

The following two references are PyQt specific (not PySide) but may offer some information of use:

• Basic PyQt tutorial : A simple and short linux-based tutorial that will explain how to work with PyQt and Qt Designer
• Programming Qt applications in python : A more in-depth tutorial covering all the process of working with qt and python

Pivy - How to interact with FreeCAD's 3D scenes

• Pivy - Embedding a Dynamic Scripting Language into a Scene Graph Library : Thesis that explains Pivy in detail
• High Level 3D Graphics Programming in Python : Pivy example from Pycon 2004
• Introducing Pivy into studierstube (Mirror) : A paper that is not really a tutorial, but that illustrates well how Pivy works (requires an academic account)

Community projects

On the Community portal, you can find other FreeCAD-based projects run by the FreeCAD users community. If you are starting a new FreeCAD project, be sure to list it there! We also have a page with things you can do if you would like to Help FreeCAD.