OpenSCAD Workbench/pt-br

Introdução
The OpenSCAD Workbench is intended to offer interoperability with the open source software OpenSCAD. This program is not distributed as part of FreeCAD, but should be installed to make full use of this workbench. OpenSCAD should not be confused with OpenCASCADE, which is the geometrical kernel that FreeCAD uses to build geometry on screen. The OpenCASCADE libraries are always needed to use FreeCAD, while the OpenSCAD executable is entirely optional.

Ela contém um importador CSG para abrir arquivos CSG do OpenSCAD e um exportador para a saída de um CSG baseado em árvore. A geometria que não está baseada em operações CSG serão exportadas como uma malha.

Esta bancada de trabalho contém funções para modificar o recurso de árvore CSG e reparar modelos. Também contém ferramentas de propósitos gerais que não necessitam de instalação do OpenSCAD; elas também podem ser utilizadas em conjunto com outras bancadas de trabalho.



Dependencies
In FreeCAD 0.19, the Ply (Python-Lex-Yacc) module, which is used to import CSG files, was removed from the FreeCAD source code, as it is a third party library not developed by FreeCAD. As a result, you now need to install Ply before using the OpenSCAD Workbench. When using a pre-packaged, stable version of FreeCAD this dependency should be installed automatically in all platforms; in other cases, for example, when compiling from source, you may have to install it from an online repository.

In openSUSE this is done by:

In Debian/Ubuntu based systems this is done like the following:

The general installation in all platforms can be done from the Python package index.

A linguagem OpenSCAD e formato de arquivo
A linguagem OpenSCAD permite o uso de variáveis e laços de repetição. Permite que você especifique submódulos para reutilizar geometria e código. Este alto grau de flexibilidade torna a análise muito complexa. Atualmente a bancada OpenSCAD não pode manipular a linguagem OpenSCAD nativamente. Em vez disso, se o OpenSCAD estiver instalado, pode ser usado para converter a entrada em formato CSG, o qual é um subconjunto da linguagem OpenSCAD e pode ser utilizada como entrada para o OpenSCAD para processamento adicional.

Ferramentas

 * [[Image:OpenSCAD_ColorCodeShape.svg|32px]] Cor da Forma: Modifica a cor de todas as formas selecionadas baseado na validade delas.
 * [[Image:OpenSCAD_ReplaceObject.svg|32px]] Substituir Objeto: Substitui um objeto no recurso de árvore.
 * [[Image:OpenSCAD_RemoveSubtree.svg|32px]] Remover Subárvore: Remove os objetos selecionados e todos os filhos que não são referenciados de outros objetos.
 * [[Image:OpenSCAD_RefineShapeFeature.svg|32px]] Função Refinar Formas: Cria um recurso de refino de forma.
 * [[Image:OpenSCAD_RefineShapeFeature.svg|32px]] Característica de refinar a forma: Criar característica de refinar a forma.
 * [[Image:OpenSCAD_MirrorMeshFeature.svg|32px]] Simétrica: Crie simetria na Malha.
 * [[Image:OpenSCAD_ScaleMeshFeature.svg|32px]] Escala: Escala uma característica de malha.
 * [[Image:OpenSCAD_ResizeMeshFeature.svg|32px]] Redimensionar: Redimensionar uma malha.
 * [[Image:OpenSCAD_IncreaseToleranceFeature.svg|32px]] Função Aumentar Tolerância: Aumenta a tolerância das arestas/faces/vértices de objetos selecionados.
 * [[Image:OpenSCAD_Edgestofaces.svg|32px]] Converter Arestas em Faces: Converte arestas em faces. É útil para preparar geometria importada DXF para extrusão.
 * [[Image:OpenSCAD_ExpandPlacements.svg|32px]] Expandir Posicionamento: Expanda todas as veiculações para baixo no FeatureTree.
 * [[Image:OpenSCAD_ExplodeGroup.svg|32px]] Explodir Grupo: Explode peças fundidas primitivas.
 * [[Image:OpenSCAD_AddOpenSCADElement.svg|32px]] Adicionar elemento OpenSCAD: Adiciona um elemento OpenSCAD ao inserir um código OpenSCAD no painel de tarefas.
 * [[Image:OpenSCAD_MeshBoolean.svg|32px]] Booleano Malha: Cria um novo objeto de malha através de operação booleana de formas.
 * [[Image:OpenSCAD_Hull.svg|32px]] Casco: Aplica um casco às formas selecionadas.
 * [[Image:OpenSCAD_Minkowski.svg|32px]] Minkowski: Aplica uma soma minkowski às formas selecionadas.

Preferências

 * [[Image:Std_DlgPreferences.svg|32px]] Preferências: Preferências disponíveis para as ferramentas do OpenSCAD.

Limitações
O OpenSCAD cria geometria sólida construtiva, além de importar arquivos de malha e extrudir a geometria 2D dos arquivos DXF. O FreeCAD também permite que você crie CSG com primitivos. A geometria kernel (OCCT) do FreeCAD funciona usando um representação limite.Portanto, a conversão do CSG para o BREP deve, em teoria, ser possível, enquanto a conversão do BREP para o CSG não é, em geral, possível.

O OpenSCAD trabalha internamente nas malhas. Algumas operações que são úteis em malhas não são significativas em um modelo BREP e não podem ser totalmente suportadas. Entre estes estão o casco convexo, soma minkowski, glide e subdiv. Atualmente executamos o binário OpenSCAD para realizar operações de casco e minkwoski e importar o resultado. Isso significa que a geometria envolvida será triangulada. No OpenSCAD, o escalonamento não uniforme é frequentemente usado, o que não impõe nenhum problema ao usar malhas. Em nossa geometria, as primitivas geométricas do kernel (linhas, seções circulares, etc) são convertidas para o BSpline antes de executar tais deformações. Esses BSplines são conhecidas por causar problemas em operações booleanas posteriores. Uma solução automática não está disponível no momento. Por favor, sinta-se livre para postar no fórum se você encontrar tais problemas. Muitas vezes, esses problemas podem ser resolvidos por pequenas peças de remodelação. Uma deformação de um cilindro pode ser substituída por uma extrusão de elipses.

Importing text
Importing OpenSCAD code with texts requires that the fonts that are used are properly installed on your system. You can verify this by opening OpenSCAD as a standalone tool and checking the list in. The list will also give you the correct font names. If a font does not appear in the list after installing, you may have to manually copy the font file to the appropriate system directory.

Importing texts is relatively slow. Behind the scenes FreeCAD uses a DXF file created by OpenSCAD. The more contours there are the slower the import.

It can be a good idea to first import a simple test case (replace with the correct font name):

TESTFONT="NameOfFont"; linear_extrude(0.001) { text("A", size=5, font=TESTFONT); };

Please note that statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a statement is that the provided font file is temporarily added to the list of known fonts (although even there the statement does not work when a script is modified interactively).

Dicas
Ao importar DXF, defina a precisão do rascunho para uma quantidade razoável, pois isso afetará a detecção das arestas conectadas.

Se o FreeCAD travar ao importar o CSG, é altamente recomendável que você ative a opção "verificar automaticamente o modelo após a operação booleana" em.

Tutoriais

 * Importar código OpenSCAD

Links

 * Repositório de código fonte do OpenSCAD em GitHub
 * Open tickets tagged "Openscad" on the FreeCAD bugtracker
 * Things tagged with "OpenSCAD" on Thingiverse