OpenSCAD Workbench/pt-br: Difference between revisions

From FreeCAD Documentation
No edit summary
No edit summary
 
(43 intermediate revisions by 4 users not shown)
Line 1: Line 1:
<languages/>
<languages/>
{{docnav|[[Mesh Module|Mesh Module]]|[[Part Module|Part Module]]|IconL=Workbench_Mesh.svg|IconR=Workbench_Part.svg}}


{{Docnav
[[Image:OpenSCADWorkbench.svg|64px]]
|[[Mesh_Workbench/pt-br|Bancada de trabalho Mesh]]
|[[Part_Workbench/pt-br|Bancada de trabalho Part]]
|IconL=Workbench_Mesh.svg
|IconR=Workbench_Part.svg
}}


[[Image:Workbench_OpenSCAD.svg|thumb|128px|OpenSCAD workbench icon]]

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

A bancada de trabalho OpenSCAD Workbench destina-se a oferecer interoperabilidade com os softwares open source [http://www.openscad.org/ OpenSCAD].
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.


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 14: Line 22:
[[Image:OpenSCADexamaple1.png]]
[[Image:OpenSCADexamaple1.png]]


<span id="Dependencies"></span>
== OpenSCAD language e formato de arquivo ==
== Dependências ==

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|compiling]] from source, you may have to install it from an online repository.

In openSUSE this is done by:

{{Code|code=
sudo zypper install python3-ply
}}

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

{{Code|code=
sudo apt install python3-ply
}}

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

{{Code|code=
pip3 install --user ply
}}

<span id="OpenSCAD_language_and_file_format"></span>
== 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 ==
* [[Image:OpenSCAD_ColorCodeShape.png|32px]] [[OpenSCAD_ColorCodeShape|Cor da Forma]]: Modifica a cor de todas as formas selecionadas baseado na validade delas.
* [[Image:OpenSCAD_ReplaceObject.png|32px]] [[OpenSCAD_ReplaceObject|Substituir Objeto]]: Substitui um objeto no recurso de árvore.
* [[Image:OpenSCAD_RemoveSubtree.png|32px]] [[OpenSCAD_RemoveSubtree|Remover Subárvore]]: Remove os objetos selecionados e todos os filhos que não são referenciados de outros objetos.
* [[Image:OpenSCAD_RefineShapeFeature.png|32px]] [[OpenSCAD_RefineShapeFeature|Função Refinar Formas]]: Cria um recurso de refino de forma.
* [[Image:OpenSCAD_IncreaseTolerance.png|32px]] [[OpenSCAD_IncreaseTolerance|Função Aumentar Tolerância]]: Aumenta a tolerância das bordas/faces/vértices de objetos selecionados.
* [[Image:OpenSCAD_Edgestofaces.png|32px]] [[OpenSCAD_Edgestofaces|Converter Bordas em Faces]]: Converte bordas em faces. É útil para preparar geometria importada DXF para extrusão.
* [[Image:OpenSCAD_ExpandPlacements.png|32px]] [[OpenSCAD_ExpandPlacements|Expandir Posicionamento]]: Expanda todas as veiculações para baixo no FeatureTree.
* [[Image:OpenSCAD_ExplodeGroup.png|32px]] [[OpenSCAD_ExplodeGroup|Explodir Grupo]]: Explode peças fundidas primitivas.
* [[Image:OpenSCAD_AddOpenSCADElement.png|32px]] [[OpenSCAD_AddOpenSCADElement|Adicionar elemento OpenSCAD]]: Adiciona um elemento OpenSCAD ao inserir um código OpenSCAD no painel de tarefas.
* [[Image:OpenSCAD_MeshBoolean.png|32px]] [[OpenSCAD_MeshBoolean|Booleano Malha]]: Cria um novo objeto de malha através de operação booleana de formas.
* [[Image:OpenSCAD_Hull.png|32px]] [[OpenSCAD_Hull|Casco]]: Aplica um casco às formas selecionadas.


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


* [[Image:Std_DlgParameter.png|32px]] [[OpenSCAD_Preferences|Preferências]]: Preferências disponíveis para as ferramentas do OpenSCAD.
* [[Image:Std_DlgPreferences.svg|32px]] [[OpenSCAD_Preferences/pt-br|Preferências]]: Preferências disponíveis para as ferramentas do OpenSCAD.


<span id="Limitations"></span>
== Limitações ==
== Limitações ==

O OpenSCAD cria geometria sólida construtiva, além de importar arquivos de malha e extrudir a geometria 2D dos arquivos [[DXF | 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 cria geometria sólida construtiva, além de importar arquivos de malha e extrudir a geometria 2D dos arquivos [[DXF | 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.
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.


<span id="Importing_text"></span>
== Importação de texto ==

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 {{MenuCommand|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 {{Incode|NameOfFont}} with the correct font name):

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

The {{Incode|<nowiki>script="Latn"</nowiki>}} 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 {{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 ==

Ao importar [[DXF | DXF]], defina a precisão do rascunho para uma quantidade razoável, pois isso afetará a detecção das bordas conectadas.
Ao importar [[DXF | 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 {{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 ==

* [[Import_OpenSCAD_code|Import OpenSCAD code]]
* [[Import_OpenSCAD_code/pt-br|Importar código OpenSCAD]]


== Links ==
== Links ==

<div class="mw-translate-fuzzy">
* Repositório de código fonte do OpenSCAD em [https://github.com/openscad/openscad GitHub]
* [https://freecadweb.org/tracker/search.php?tag_string=OpenSCAD Open tickets tagged "Openscad" on the FreeCAD bugtracker]
* [https://freecadweb.org/tracker/search.php?tag_string=OpenSCAD Open tickets tagged "Openscad" on the FreeCAD bugtracker]
* [http://www.thingiverse.com/tag:openscad Things tagged with "OpenSCAD" on Thingiverse]
* [http://www.thingiverse.com/tag:openscad Things tagged with "OpenSCAD" on Thingiverse]
</div>



{{Docnav
{{docnav/pt-br|Mesh Module/pt-br|Part Module/pt-br}}
|[[Mesh_Workbench/pt-br|Bancada de trabalho Mesh]]
|[[Part_Workbench/pt-br|Bancada de trabalho Part]]
|IconL=Workbench_Mesh.svg
|IconR=Workbench_Part.svg
}}


{{OpenSCAD Tools navi}}
{{OpenSCAD Tools navi{{#translation:}}}}
{{Userdocnavi}}
{{Userdocnavi{{#translation:}}}}
[[Category:Workbenches]]
[[Category:Workbenches{{#translation:}}]]

Latest revision as of 17:03, 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.

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.

Dependências

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.

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.

Importação de texto

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