🔧 TECHDRAW - STL

#TECHDRAW - STL É O NOME CURTO PARA O APLICATIVO STL2TechnicalDrawing

Gerador Automático de Desenhos Técnicos a partir de Arquivos STL

🇧🇷 Português

📖 Sobre o Projeto

STL2TechnicalDrawing é uma aplicação desktop poderosa e intuitiva que converte automaticamente modelos 3D em arquivos STL para desenhos técnicos profissionais com projeções ortográficas, dimensionamento automático e exportação em alta resolução.

🌍 Supported Languages (12 languages)

Portuguese (Brazil) - PT-BR (Original)
English (United States) - EN-US
Spanish - ES
Russian - RU
Chinese (Simplified) - ZH-CN
Japanese - JA
French - FR
German - DE
Polish - PL
Italian - IT
Korean - KO
Hindi - HI

Contributions for additional languages are welcome!

✨ Principais Funcionalidades

🎯 Visualização 3D Interativa: Navegação completa com rotação, zoom e pan
📐 7 Vistas Predefinidas: Frontal, traseira, superior, inferior, laterais e isométrica
🔄 Geração Automática de Desenhos: Projeções ortográficas profissionais
📏 Dimensionamento Inteligente: Cotas automáticas com detecção de features
⚡ Otimização de Malha: Redução inteligente de até 83% das arestas
💾 Exportação em Alta Resolução: PNG/JPG até 300 DPI (formato A4)
🎨 Interface Moderna: Tema escuro e design intuitivo
🖱️ Drag & Drop: Arraste arquivos STL diretamente

🚀 Instalação Rápida

Pré-requisitos

Python 3.11+ (Download)
pip (gerenciador de pacotes Python)
Git (opcional, para clonar o repositório)

Passo 1: Clonar o Repositório

git clone https://github.com/seu-usuario/STL2TechnicalDrawing.git
cd STL2TechnicalDrawing

Passo 2: Criar Ambiente Virtual (Recomendado)

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/macOS
python3 -m venv venv
source venv/bin/activate

Passo 3: Instalar Dependências

pip install -r requirements.txt

Passo 4: Executar a Aplicação

python main.py

🎮 Como Usar

1️⃣ Carregar Modelo STL

Método 1: Menu Arquivo → Abrir STL
Método 2: Drag & Drop do arquivo na janela
Método 3: Via linha de comando:

  python main.py caminho/para/arquivo.stl

2️⃣ Visualizar em 3D

Ação	Controle
Rotacionar	Botão esquerdo + arrastar
Pan (mover)	Botão do meio + arrastar
Zoom	Scroll do mouse
Zoom alternativo	Botão direito + arrastar

3️⃣ Atalhos de Teclado

Tecla	Função
`1`	Vista Frontal
`2`	Vista Traseira
`3`	Vista Superior
`4`	Vista Inferior
`5`	Vista Esquerda
`6`	Vista Direita
`7`	Vista Isométrica
`R`	Resetar Vista
`W`	Toggle Wireframe
`E`	Toggle Arestas
`F`	Toggle Faces
`G`	Toggle Grid

4️⃣ Gerar Desenho Técnico

Clique no botão "🔧 Gerar Desenho"
Aguarde o processamento (barra de progresso)
Visualize o desenho técnico com todas as vistas
Ajuste opções de visualização (linhas ocultas, dimensões, bordas)
Exporte para PNG/JPG em alta resolução

🛠️ Compilação (Executável Standalone)

Usando Nuitka (Recomendado)

Vantagens: Executável rápido, otimizado e sem dependências Python.

Windows

# Instalar Nuitka
pip install nuitka

# Instalar compilador MSVC (necessário)
# Baixe: https://visualstudio.microsoft.com/downloads/
# Instale: "Build Tools for Visual Studio 2022"

# Compilar
python -m nuitka ^
    --standalone ^
    --windows-console-mode=disable ^
    --plugin-enable=pyqt6 ^
    --plugin-enable=numpy ^
    --include-data-dir=gui=gui ^
    --include-data-dir=core=core ^
    --include-data-dir=utils=utils ^
    --output-dir=dist ^
    --windows-icon-from-ico=icon.ico ^
    main.py

Linux

# Instalar Nuitka
pip install nuitka

# Instalar compilador
sudo apt-get install build-essential

# Compilar
python -m nuitka \
    --standalone \
    --plugin-enable=pyqt6 \
    --plugin-enable=numpy \
    --include-data-dir=gui=gui \
    --include-data-dir=core=core \
    --include-data-dir=utils=utils \
    --output-dir=dist \
    main.py

Usando PyInstaller (Alternativa)

# Instalar PyInstaller
pip install pyinstaller

# Compilar
pyinstaller --onefile --windowed \
    --add-data "gui:gui" \
    --add-data "core:core" \
    --add-data "utils:utils" \
    --icon=icon.ico \
    --name STL2TechnicalDrawing \
    main.py

Script PowerShell Automatizado (Windows)

Use o script compile.ps1 incluído:

# Compilação padrão (pasta com dependências)
.\compile.ps1

# Compilação em arquivo único
.\compile.ps1 -Onefile

# Limpar builds anteriores
.\compile.ps1 -Clean

📁 Estrutura do Projeto

STL2TechnicalDrawing/
│
├── main.py                      # ← Arquivo principal
├── requirements.txt             # Dependências
├── compile.ps1                  # Script de compilação
├── README.md                    # Este arquivo
│
├── core/                        # Módulo CORE - Processamento
│   ├── __init__.py
│   ├── stl_loader.py           # Carregamento e simplificação
│   ├── projection_engine.py    # Projeções ortográficas
│   ├── dimension_system.py     # Sistema de dimensionamento
│   ├── feature_detector.py     # Detecção de features
│   ├── geometry_analyzer.py    # Análise geométrica
│   └── mesh_simplifier.py      # Otimização de malha
│
├── gui/                         # Módulo GUI - Interface
│   ├── __init__.py
│   ├── main_window.py          # Janela principal
│   ├── gl_widget.py            # Widget OpenGL 3D
│   ├── technical_drawing_widget.py  # Widget desenho 2D
│   ├── drawing_preview_window.py    # Preview e exportação
│   └── progress_dialog.py      # Diálogo de progresso
│
├── utils/                       # Módulo UTILS - Utilitários
│   ├── __init__.py
│   └── constants.py            # Constantes e configurações
│
├── samples/                     # Arquivos STL de exemplo
│   ├── cube.stl
│   ├── bracket.stl
│   ├── cylinder.stl
│   └── plate.stl
│
└── docs/                        # Documentação
    ├── screenshot.png
    └── technical_drawing.png

🔧 Dependências

PyQt6>=6.4.0              # Interface gráfica
PyOpenGL>=3.1.6           # Renderização 3D
PyOpenGL-accelerate>=3.1.6
numpy>=1.24.0             # Computação numérica
numpy-stl>=3.0.0          # Processamento STL
trimesh>=4.0.0            # Análise de malha
scipy>=1.10.0             # Cálculos científicos
Pillow>=10.0.0            # Processamento de imagens

🐛 Solução de Problemas

❌ Erro: "cannot import name 'BACKGROUND_COLOR'"

Causa: Arquivos __init__.py ausentes.

Solução: Verifique se todas as pastas (core/, gui/, utils/) possuem __init__.py.

❌ Erro: "No module named 'PyQt6'"

Causa: Dependências não instaladas.

Solução:

pip install -r requirements.txt

❌ OpenGL não funciona

Causa: Drivers gráficos desatualizados.

Solução: Atualize os drivers da placa de vídeo.

❌ Incompatible version of OpenGL_accelerate

Solução:

pip install --upgrade PyOpenGL PyOpenGL-accelerate

🎯 Roadmap

📝 Licença

Este projeto é proprietário e de uso privado. Distribuição, modificação ou uso comercial não autorizado é proibido.

👥 Créditos

Desenvolvido por: Roberto Reis
Empresa: SE3D GESTOR
Versão: 1.2.35
Data: 2025

📧 Contato

Email: contato@se3d.com.br
Website: www.se3d.com.br
GitHub: github.com/se3d

🙏 Agradecimentos

Obrigado por usar o STL2TechnicalDrawing!

Se você encontrar bugs ou tiver sugestões, por favor abra uma issue no GitHub.

🇺🇸 English

📖 About the Project

STL2TechnicalDrawing is a powerful and intuitive desktop application that automatically converts 3D models in STL files into professional technical drawings with orthographic projections, automatic dimensioning, and high-resolution export.

✨ Key Features

🎯 Interactive 3D Visualization: Full navigation with rotation, zoom, and pan
📐 7 Predefined Views: Front, back, top, bottom, left, right, and isometric
🔄 Automatic Drawing Generation: Professional orthographic projections
📏 Smart Dimensioning: Automatic dimensions with feature detection
⚡ Mesh Optimization: Intelligent reduction up to 83% of edges
💾 High-Resolution Export: PNG/JPG up to 300 DPI (A4 format)
🎨 Modern Interface: Dark theme and intuitive design
🖱️ Drag & Drop: Drop STL files directly

🚀 Quick Installation

Prerequisites

Python 3.11+ (Download)
pip (Python package manager)
Git (optional, to clone the repository)

Step 1: Clone the Repository

git clone https://github.com/your-username/STL2TechnicalDrawing.git
cd STL2TechnicalDrawing

Step 2: Create Virtual Environment (Recommended)

# Windows
python -m venv venv
venv\Scripts\activate

# Linux/macOS
python3 -m venv venv
source venv/bin/activate

Step 3: Install Dependencies

pip install -r requirements.txt

Step 4: Run the Application

python main.py

🎮 How to Use

1️⃣ Load STL Model

Method 1: Menu File → Open STL
Method 2: Drag & Drop file into window
Method 3: Via command line:

  python main.py path/to/file.stl

2️⃣ View in 3D

Action	Control
Rotate	Left button + drag
Pan (move)	Middle button + drag
Zoom	Mouse scroll
Alternative zoom	Right button + drag

3️⃣ Keyboard Shortcuts

Key	Function
`1`	Front View
`2`	Back View
`3`	Top View
`4`	Bottom View
`5`	Left View
`6`	Right View
`7`	Isometric View
`R`	Reset View
`W`	Toggle Wireframe
`E`	Toggle Edges
`F`	Toggle Faces
`G`	Toggle Grid

4️⃣ Generate Technical Drawing

Click "🔧 Generate Drawing" button
Wait for processing (progress bar)
View technical drawing with all views
Adjust display options (hidden lines, dimensions, borders)
Export to PNG/JPG in high resolution

🛠️ Compilation (Standalone Executable)

Using Nuitka (Recommended)

Advantages: Fast, optimized executable without Python dependencies.

Windows

# Install Nuitka
pip install nuitka

# Install MSVC compiler (required)
# Download: https://visualstudio.microsoft.com/downloads/
# Install: "Build Tools for Visual Studio 2022"

# Compile
python -m nuitka ^
    --standalone ^
    --windows-console-mode=disable ^
    --plugin-enable=pyqt6 ^
    --plugin-enable=numpy ^
    --include-data-dir=gui=gui ^
    --include-data-dir=core=core ^
    --include-data-dir=utils=utils ^
    --output-dir=dist ^
    --windows-icon-from-ico=icon.ico ^
    main.py

Linux

# Install Nuitka
pip install nuitka

# Install compiler
sudo apt-get install build-essential

# Compile
python -m nuitka \
    --standalone \
    --plugin-enable=pyqt6 \
    --plugin-enable=numpy \
    --include-data-dir=gui=gui \
    --include-data-dir=core=core \
    --include-data-dir=utils=utils \
    --output-dir=dist \
    main.py

Using PyInstaller (Alternative)

# Install PyInstaller
pip install pyinstaller

# Compile
pyinstaller --onefile --windowed \
    --add-data "gui:gui" \
    --add-data "core:core" \
    --add-data "utils:utils" \
    --icon=icon.ico \
    --name STL2TechnicalDrawing \
    main.py

🐛 Troubleshooting

❌ Error: "cannot import name 'BACKGROUND_COLOR'"

Cause: Missing __init__.py files.

Solution: Verify that all folders (core/, gui/, utils/) have __init__.py.

❌ Error: "No module named 'PyQt6'"

Cause: Dependencies not installed.

Solution:

pip install -r requirements.txt

❌ OpenGL not working

Cause: Outdated graphics drivers.

Solution: Update your graphics card drivers.

📝 License

This project is proprietary and for private use. Unauthorized distribution, modification, or commercial use is prohibited.

👥 Credits

Developed by: Roberto Reis
Company: SE3D GESTOR
Version: 1.2.35
Date: 2025

📧 Contact

Email: contact@se3d.com
Website: www.se3d.com
GitHub: github.com/se3d

⭐ If this project helped you, please give it a star!

Made with ❤️ by SE3D Team

Name		Name	Last commit message	Last commit date
Latest commit History 16 Commits
core		core
gui		gui
lang		lang
rendering		rendering
samples		samples
utils		utils
LICENSE		LICENSE
README.md		README.md
compile.ps1		compile.ps1
config.json		config.json
create_samples.py		create_samples.py
icon.ico		icon.ico
main.py		main.py
marca.png		marca.png
requirements.txt		requirements.txt
screenshot.png		screenshot.png

Folders and files

Latest commit

History

Repository files navigation

🔧 TECHDRAW - STL

Gerador Automático de Desenhos Técnicos a partir de Arquivos STL

🇧🇷 Português

📖 Sobre o Projeto

🌍 Supported Languages (12 languages)

✨ Principais Funcionalidades

🚀 Instalação Rápida

Pré-requisitos

Passo 1: Clonar o Repositório

Passo 2: Criar Ambiente Virtual (Recomendado)

Passo 3: Instalar Dependências

Passo 4: Executar a Aplicação

🎮 Como Usar

1️⃣ Carregar Modelo STL

2️⃣ Visualizar em 3D

3️⃣ Atalhos de Teclado

4️⃣ Gerar Desenho Técnico

🛠️ Compilação (Executável Standalone)

Usando Nuitka (Recomendado)

Windows

Linux

Usando PyInstaller (Alternativa)

Script PowerShell Automatizado (Windows)

📁 Estrutura do Projeto

🔧 Dependências

🐛 Solução de Problemas

❌ Erro: "cannot import name 'BACKGROUND_COLOR'"

❌ Erro: "No module named 'PyQt6'"

❌ OpenGL não funciona

❌ Incompatible version of OpenGL_accelerate

🎯 Roadmap

📝 Licença

👥 Créditos

📧 Contato

🙏 Agradecimentos

🇺🇸 English

📖 About the Project

✨ Key Features

🚀 Quick Installation

Prerequisites

Step 1: Clone the Repository

Step 2: Create Virtual Environment (Recommended)

Step 3: Install Dependencies

Step 4: Run the Application

🎮 How to Use

1️⃣ Load STL Model

2️⃣ View in 3D

3️⃣ Keyboard Shortcuts

4️⃣ Generate Technical Drawing

🛠️ Compilation (Standalone Executable)

Using Nuitka (Recommended)

Windows

Linux

Using PyInstaller (Alternative)

🐛 Troubleshooting

❌ Error: "cannot import name 'BACKGROUND_COLOR'"

❌ Error: "No module named 'PyQt6'"

❌ OpenGL not working

📝 License

👥 Credits

📧 Contact

⭐ If this project helped you, please give it a star!

About

Resources

License

Uh oh!

Stars

Watchers

Forks

Releases 3

Packages 0

Uh oh!

Contributors

Uh oh!

Languages

Packages