OpenSCAD Workbench/pt-br: Difference between revisions

From FreeCAD Documentation
(Updating to match new version of source page)
(Created page with "A 24px Bancada de trabalho OpenSCAD tem como objetivo oferecer interoperabilidade com o software de código aberto [http://www.openscad.org/ OpenSCAD]. Esse programa não é distribuído como parte do FreeCAD, mas deve ser instalado para fazer uso total desta bancada de trabalho. O OpenSCAD não deve ser confundido com o OpenCASCADE, que é o núcleo geométrico que o FreeCAD utiliza para...")
Line 12: Line 12:
[[Image:Workbench_OpenSCAD.svg|thumb|128px|OpenSCAD workbench icon]]
[[Image:Workbench_OpenSCAD.svg|thumb|128px|OpenSCAD workbench icon]]


<span id="Introduction"></span>
== Introdução ==
== Introdução ==


The [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD_Workbench|OpenSCAD Workbench]] is intended to offer interoperability with the open source software [http://www.openscad.org/ 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|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.
A [[Image:Workbench_OpenSCAD.svg|24px]] [[OpenSCAD_Workbench/pt-br|Bancada de trabalho OpenSCAD]] tem como objetivo oferecer interoperabilidade com o software de código aberto [http://www.openscad.org/ OpenSCAD]. Esse programa não é distribuído como parte do FreeCAD, mas deve ser instalado para fazer uso total desta bancada de trabalho. O OpenSCAD não deve ser confundido com o [[OpenCASCADE/pt-br|OpenCASCADE]], que é o núcleo geométrico que o FreeCAD utiliza para construir a geometria na tela. As bibliotecas do OpenCASCADE são sempre necessárias para usar o FreeCAD, enquanto o executável do OpenSCAD é totalmente opcional.

Traduzido com a versão gratuita do tradutor - www.DeepL.com/Translator


Ela contém um importador [[OpenSCAD_CSG|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.
Ela contém um importador [[OpenSCAD_CSG|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.
Line 45: Line 48:
}}
}}


<span id="OpenSCAD_language_and_file_format"></span>
== A linguagem OpenSCAD e formato de arquivo ==
== 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.
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.


<span id="Tools"></span>
== Ferramentas ==
== Ferramentas ==


Line 68: Line 73:
* [[Image:OpenSCAD_Minkowski.svg|32px]] [[OpenSCAD_Minkowski/pt-br|Minkowski]]: Aplica uma soma minkowski às formas selecionadas.
* [[Image:OpenSCAD_Minkowski.svg|32px]] [[OpenSCAD_Minkowski/pt-br|Minkowski]]: Aplica uma soma minkowski às formas selecionadas.


<span id="Preferences"></span>
== Preferências ==
== Preferências ==


Line 102: Line 108:
Please note that {{Incode|<nowiki>use <FONT>;</nowiki>}} statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a {{Incode|use}} 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).
Please note that {{Incode|<nowiki>use <FONT>;</nowiki>}} statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a {{Incode|use}} 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).


<span id="Hints"></span>
== Dicas ==
== Dicas ==


Line 108: Line 115:
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 {{MenuCommand | Menu → Editar → Preferências → Desenho da Peça → Configuração do Modelo}}.
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 {{MenuCommand | Menu → Editar → Preferências → Desenho da Peça → Configuração do Modelo}}.


<span id="Tutorials"></span>
== Tutoriais ==
== Tutoriais ==



Revision as of 16:59, 11 July 2023

OpenSCAD workbench icon

Introdução

A Bancada de trabalho OpenSCAD tem como objetivo oferecer interoperabilidade com o software de código aberto OpenSCAD. Esse programa não é distribuído como parte do FreeCAD, mas deve ser instalado para fazer uso total desta bancada de trabalho. O OpenSCAD não deve ser confundido com o OpenCASCADE, que é o núcleo geométrico que o FreeCAD utiliza para construir a geometria na tela. As bibliotecas do OpenCASCADE são sempre necessárias para usar o FreeCAD, enquanto o executável do OpenSCAD é totalmente opcional.

Traduzido com a versão gratuita do tradutor - www.DeepL.com/Translator

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:

sudo zypper install python3-ply

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

sudo apt install python3-ply

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

pip3 install --user ply

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

Preferências

  • Preferências: Preferências disponíveis para as ferramentas do OpenSCAD.

Limitations

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 Help → Font List. 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 NameOfFont with the correct font name):

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

The script="Latn" parameter can be left out here, but is required if the text string does not contain any letters, but only punctuation and/or numbers.

Please note that use <FONT>; statements in your source files are ignored when importing in FreeCAD. Under OpenSCAD the effect of a use 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 Menu → Editar → Preferências → Desenho da Peça → Configuração do Modelo.

Tutoriais

Links