Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

ericardos/MappEduc

Repository files navigation

🎓 MappEduc - Mapeamento de Projeção Educacional

Ferramenta livre e leve para educadores explorarem o projection mapping em sala de aula.

Licença Versão Status


✨ Sobre o Projeto

Criado pelo Prof. Edson Ricardo dos Santos da Silva, o MappEduc nasceu da necessidade de uma ferramenta acessível para o ensino de artes visuais. Permite deformar imagens e vídeos em tempo real, adaptando projeções a superfícies irregulares de forma simples e intuitiva.

Objetivo: Ser um recurso educacional livre para que professores e alunos possam explorar o mapeamento de projeção sem custos e com baixa exigência de hardware.


🚀 Funcionalidades

🎯 Mapeamento

  • Deformação por grade de pontos de controle (malha de 1x1 a 6x6)
  • Zoom e Pan para ajustes precisos
  • Mover pontos selecionados ou camadas inteiras com as setas do teclado
  • Escala da camada (aumentar/diminuir mantendo proporção)

📁 Camadas

  • Suporte a múltiplas camadas
  • Imagens: JPG, PNG (com transparência nativa)
  • Vídeos: MP4, AVI, MOV, MKV, WEBM
  • Controle individual de opacidade e visibilidade
  • Travar/destravar pontos de controle

🎭 Chroma Key (Máscara por Cor)

  • Remova cores específicas da imagem (preto, branco, verde, azul, vermelho)
  • Controle de tolerância para ajuste fino
  • Ideal para remover fundos ou criar recortes

📋 Gerenciamento de Camadas

  • Duplicar Camada (Ctrl+D) - Cria cópia idêntica
  • Substituir Arquivo - Troca a mídia mantendo todas as deformações
  • Menu de contexto (clique direito) - Acesso rápido a todas as opções

💾 Projetos

  • Salvar projeto completo (.mep)
  • Carregar projetos salvos
  • Inclui todas as deformações, opacidades e configurações

⌨️ Desfazer/Refazer

  • Ctrl+Z para desfazer
  • Ctrl+Shift+Z para refazer

⌨️ Atalhos de Teclado

Tecla Ação
V Mostrar/Esconder camada
L Travar/Destravar pontos de controle
R Resetar grid (voltar ao formato original)
F Alternar modo Fit/Stretch
S Aumentar escala da camada
Shift+S Diminuir escala da camada
Ctrl+S Resetar escala da camada
Ctrl+D Duplicar camada selecionada
Setas Mover ponto selecionado OU camada inteira
ESC Deselecionar ponto
+ / - Zoom in / Zoom out
0 ou Home Resetar visualização (zoom e pan)
F11 Tela cheia na janela de projeção
Del Remover camada selecionada
Ctrl+Z Desfazer última ação
Ctrl+Shift+Z Refazer ação desfeita
F1 Ajuda completa

🖱️ Controles do Mouse

Ação Descrição
Scroll Zoom no ponto do mouse
Botão do meio arrastar Pan (mover visualização)
Botão direito arrastar Pan (mover visualização)
Arrastar ponto verde Deformar a imagem
Arrastar área vazia Pan (quando nenhum ponto selecionado)
Duplo clique Resetar visualização (zoom 100%, pan zerado)
Clique na camada Selecionar camada
Clique direito na camada Menu de contexto (duplicar, substituir, máscara, resetar)

🔧 Como Instalar e Usar

📦 Requisitos

  • Python 3.7 ou superior
  • pip (gerenciador de pacotes do Python)

⚙️ Instalação das Dependências

pip install PySide6 PyOpenGL opencv-python numpy

About

Ferramenta de projeção mapeada, vídeomapping, livre e leve. Criada por um professor para professores.

Topics

Resources

License

GPL-3.0, Unknown licenses found

Licenses found

GPL-3.0
LICENSE
Unknown
LICENSE.txt

Stars

Watchers

Forks

Releases

No releases published

Packages

Contributors

AltStyle によって変換されたページ (->オリジナル) /