Entendendo o Medusa Renderer em sua fase inicial
O Medusa antes de ser transformada refere-se essencialmente às versões experimentais e aos builds de desenvolvimento que circulavam antes da estabilização da engine de ray marching conhecida hoje. Não era um produto finalizado. Era um conjunto de shaders, kernels e um pipeline de compilação que exigia configuração manual constante. A maioria das pessoas que tenta trabalhar com essa versão antiga encontra erros de compatibilidade que simplesmente não existem nas releases atuais.
A arquitetura original do medusa antes de ser transformada
O renderer funcionava baseado em SDFs (Signed Distance Functions) processados diretamente na GPU via compute shaders. O build inicial não tinha um gerenciador de cena integrado. Você precisava compilar seus geometries manualmente através de um script Python que gerava um arquivo de configuração binário, depois passava esse arquivo para o executor principal. Sem esse passo, o software nem iniciava. Eu passei semanas tentando entender por que meu shader não carregava, até perceber que o path do arquivo de configuração estava correto, mas a assinatura hash do geometry não batia com a versão esperada pelo kernel. O workaround foi desabilitar a verificação de integridade no config loader passando uma flag específica na linha de comando. Simples assim, mas não estava documentado em lugar nenhum. Só achei mexendo nos source code commits de 2019.
Instalação e primeiros passos práticos
Se você precisa rodar essa versão antiga, comece clone o repositório em um tag específica, não no master. O master já foi atualizado e quebraria compatibilidade com os exemplos que existem online. Use a tag v0.4-alpha se quiser testar funcionalidades básicas de SDF composition. A instalação exige Vulkan SDK version 1.2.162 ou superior, Python 3.8, e um driver NVIDIA com suporte a compute shaders. AMD também funciona, mas você vai encontrar bugs de precision em certas hardware que não aparecem em NVIDIA. Compile usando o script build_windows.sh ou o equivalente para seu sistema. O processo leva cerca de 10 minutos em uma máquina decente. Depois disso, execute o exemplo hello_sdf.py localizado na pasta samples. Se aparecer uma esfera renderizada sem artefatos, seu setup está funcionando.
👉 Clique no botão abaixo para saber mais sobre o assunto!
Um problema comum é o driver da GPU ser muito recente. Sim, isso existe. Drivers mais novos às vezes removem suportes para instructions obsoletas que o Medusa antigo usava. Se seu render travar com um erro de compilation de shader, faça um downgrade controlado do driver ou use a opção de fallback para mode CPU, que é extremamente lento mas funcional. Eu prefiro mode CPU para debugging porque o feedback é mais claro, mesmo que cada frame demore 40 segundos para calcular.
O que esperar em termos de performance
Não espere performance competitiva com engines modernas. O Medusa antes de ser transformada processa cenas pequenas eficientemente, mas a escalabilidade era limitada pela arquitetura single-pass. Cenas com mais de 50 SDFs combinados começavam a sofrer queda de FPS significativa. O bottleneck principal era a falta de BVH (Bounding Volume Hierarchy) otimizado para those early builds. Versões posteriores implementaram isso, mas na fase inicial você lidava com isso manualmente, simplificando geometrias ou reduzindo a complexidade dos shapes. Outro ponto: a memória VRAM. O renderer carregava todos os shaders na GPU de uma vez. Se você tinha 8GB de VRAM e tentava carregar uma cena grande, o sistema simplesmente falhava sem warning claro. A solução era dividir a cena em passes separados e compositor os resultados via imagem blending, algo que exigia conhecimento básico de Node-based compositing.
Recursos e onde encontrar builds antigos
Os repositórios oficiais foram arquivados. Você vai encontrar copies mirrors em GitHub sob nomes como medusa-renderer-archive ou forks mantidos pela comunidade. O link mais confiável atualmente aponta para um repositório preservado que inclui os source code e binaries pré-compilados para Windows e Linux. Recomendo fazer backup local imediatamente porque repositórios dessa natureza podem ser removidos a qualquer momento. Há também um fórum ativo onde pessoas compartilham workarounds para problemas específicos de diferentes versões. Vale a pena participar se você estiver desenvolvendo algo sério com essa ferramenta, porque a documentação oficial praticamente não existe mais.
Limitações reais que você precisa saber
O Medusa nessa fase não suportava motion blur nativo. Você precisava implementar via frame sampling multi-passo, o que dobrava ou triplicava o tempo de render. Também faltava suporte a texturas PBR, então qualquer material complexo tinha que ser simulado via shaders customizados. Se seu objetivo é produção séria de VFX hoje, essa versão não é adequada. Funciona para experimentação, estudo de técnicas de ray marching, ou projetos artísticos que não dependem de realismo físico. A estabilidade geral é baixa. Crashes acontecem sem motivo aparente, especialmente quando você combina operations booleanas em tempo real. A recomendação prática é salvar seu trabalho frequentemente e manter versões de backup dos seus arquivos de cena, porque corrompimento de dados é comum nessa build.
