Este documento fornece informações sobre o FernFlower, um descompilador Java, e o Mitsuba 3, um sistema de renderização orientado para pesquisa. Os detalhes do FernFlower incluem funcionalidade, licenciamento, uso de linha de comando e opções para renomear identificadores. A descrição do Mitsuba 3 cobre seus recursos, instalação, uso e contribuidores. Ambas as seções oferecem explicações e exemplos abrangentes.
Sobre FernFlower
FernFlower é o primeiro descompilador analítico realmente funcional para Java e
provavelmente para uma linguagem de programação de alto nível em geral. Naturalmente ainda é
em desenvolvimento, envie seus relatórios de bugs e sugestões de melhorias para o
rastreador de problemas.
FernFlower e ForgeFlower
FernFlower inclui alguns patches do ForgeFlower.
Agradecimentos sinceros aos mantenedores do ForgeFlower por suas valiosas contribuições e melhorias.
Licença
FernFlower é licenciado sob a licença Apache versão 2.0.
Executando a partir da linha de comando
java -jar fernflower.jar [-
=
]* [
]+
significa 0 ou mais vezes
significa 1 ou mais vezes
: arquivo ou diretório com arquivos a serem descompilados. Os diretórios são verificados recursivamente. As extensões de arquivo permitidas são class, zip e jar.
Fontes prefixadas com -e= significam arquivos de "biblioteca" que não serão descompilados, mas levados em consideração ao analisar as relações entre
classes ou métodos. Especialmente a renomeação de identificadores (opção 'ren') pode se beneficiar de informações sobre classes externas.
: diretório de destino
,
: uma opção de linha de comando com o valor correspondente (consulte "Opções de linha de comando" abaixo).
Exemplos:
java -jar fernflower.jar -hes=0 -hdc=0 c:Tempbinary -e=c:Javart.jar c:Tempsource
java -jar fernflower.jar -dgs=1 c:Tempbinarylibrary.jar c:TempbinaryBoot.class c:Tempsource
Opções de linha de comando
Com exceção de mpm e urc, o valor 1 significa que a opção está ativada, 0 - desativada. Padrão
o valor, se houver, é fornecido entre parênteses.
Normalmente, as seguintes opções serão alteradas pelo usuário, se houver: hes, hdc, dgs, mpm, ren, urc
As demais opções podem ser deixadas como estão: destinam-se a engenheiros reversos profissionais.
Renomeando identificadores
Alguns ofuscadores dão às classes e aos seus elementos membros nomes curtos, sem sentido e, acima de tudo, ambíguos. Recompilando tal
código leva a um grande número de conflitos. Portanto é aconselhável deixar o descompilador renomear os elementos por sua vez,
garantindo a exclusividade de cada identificador.
A opção 'ren' (ou seja, -ren=1) ativa a funcionalidade de renomeação. A estratégia de renomeação padrão é a seguinte:
O significado de cada método deve ficar claro na nomenclatura: toBeRenamed determina se o elemento será renomeado, enquanto os outros três
forneça novos nomes para classes, métodos e campos, respectivamente.
exemplo:
Renderizador Mitsuba 3
Documentação | Vídeos tutoriais | Linux | Mac OS | Windows | PyPI |
---|---|---|---|---|---|
️
Aviso
️
Actualmente existe uma grande quantidade de trabalho indocumentado e instável em curso no
o ramo master
. É altamente recomendável que você use nosso
último lançamento
até novo aviso.
Se você já deseja experimentar as próximas mudanças, dê uma olhada em
este guia de portabilidade.
Deve cobrir a maioria dos novos recursos e mudanças importantes que estão por vir.
Introdução
Mitsuba 3 é um sistema de renderização orientado para pesquisa para luz direta e inversa
simulação de transporte desenvolvida na EPFL na Suíça.
Consiste em uma biblioteca principal e um conjunto de plug-ins que implementam funcionalidades
variando de materiais e fontes de luz a algoritmos de renderização completos.
Mitsuba 3 é redirecionável : isso significa que as implementações subjacentes e
estruturas de dados podem ser transformadas para realizar várias tarefas diferentes. Para
Por exemplo, o mesmo código pode simular transporte RGB escalar (clássico de um raio por vez)
ou transporte espectral diferencial na GPU. Tudo isso se baseia
Dr.Jit, um compilador just-in-time (JIT) especializado desenvolvido especificamente para este projeto.
Principais recursos
Plataforma cruzada : Mitsuba 3 foi testado em Linux ( x86_64
), macOS
( aarch64
, x8664
) e Windows ( x8664
).
Alto desempenho : o compilador Dr.Jit subjacente funde o código de renderização
em kernels que alcançam desempenho de última geração usando
um back-end LLVM direcionado à CPU e um back-end CUDA/OptiX
visando GPUs NVIDIA com aceleração de hardware de rastreamento de raio.
Python primeiro : Mitsuba 3 está profundamente integrado ao Python. Materiais,
texturas e até mesmo algoritmos de renderização completos podem ser desenvolvidos em Python,
que o sistema compila JIT (e opcionalmente diferencia) em tempo real.
Isso permite a experimentação necessária para pesquisas em computação gráfica e
outras disciplinas.
Diferenciação : Mitsuba 3 é um renderizador diferenciável, o que significa que
pode calcular derivadas de toda a simulação em relação à entrada
parâmetros como pose de câmera, geometria, BSDFs, texturas e volumes. Isto
implementa algoritmos de renderização diferenciáveis recentes desenvolvidos na EPFL.
Espectral e Polarização : Mitsuba 3 pode ser usado como monocromático
renderizador, renderizador baseado em RGB ou renderizador espectral. Cada variante pode
opcionalmente, considere os efeitos da polarização, se desejado.
Vídeos tutoriais, documentação
Gravamos vários vídeos no YouTube que fornecem uma introdução gentil
Mitsuba 3 e Dr.Jit. Além disso você pode encontrar notebooks Juypter completos
cobrindo uma variedade de aplicações, guias de instruções e documentação de referência
em readthedocs.
Instalação
Fornecemos rodas binárias pré-compiladas via PyPI. Instalar o Mitsuba desta forma é tão simples quanto executar
pip instalar mitsuba
na linha de comando. O pacote Python inclui treze variantes por padrão:
scalar_rgb
scalar_spectral
scalarspectralpolarized
llvmadrgb
llvmadmono
llvmadmono_polarized
llvmadspectral
llvmadspectral_polarized
cudaadrgb
cudaadmono
cudaadmono_polarized
cudaadspectral
cudaadspectral_polarized
Os dois primeiros realizam simulação clássica de um raio por vez usando um RGB
ou representação espectral de cores, enquanto os dois últimos podem ser usados para representação inversa
renderização na CPU ou GPU. Para acessar variantes adicionais, você precisará
compilar uma versão personalizada do Dr.Jit usando CMake. Por favor veja o
documentação
para obter detalhes sobre isso.
Requisitos
Python >= 3.8
(opcional) Para computação na GPU: Nvidia driver >= 495.89
(opcional) Para computação vetorizada/paralela na CPU: LLVM >= 11.1
Uso
Aqui está um exemplo simples de "Hello World" que mostra como é simples renderizar um
cena usando Mitsuba 3 do Python:
# Importe a biblioteca usando o alias "mi"import mitsuba as mi# Defina a variante do renderermi.setvariant('scalarrgb')# Carregue uma scenecene = mi.loaddict(mi.cornellbox())# Renderize a cenaimg = mi. render(scene)# Grave a imagem renderizada em um arquivo EXRmi.Bitmap(img).write('cbox.exr')
Tutoriais e cadernos de exemplo cobrindo uma variedade de aplicações podem ser encontrados
na documentação.
Sobre
Este projeto foi criado por Wenzel Jakob.
Recursos e/ou melhorias significativas no código foram contribuídos por
Sébastien Speierer,
Nicolas Roussel,
Merlin Nimier-David,
Délio Vicini,
Tizian Zeltner,
Baptiste Nicolet,
Miguel Crespo,
Vicente Leroy e
Zi Yi Zhang.
Ao usar o Mitsuba 3 em projetos acadêmicos, cite:
@software{Mitsuba3,title = {mitsuba 3 renderer},author = {Wenzel Jakob e Sébastien Speierer e Nicolas Roussel e Merlin Nimier-David e Delio Vicini e Tizian Zeltner e Baptiste Nicolet e Miguel Crespo e Vincent Leroy e Ziyi Zhang},nota = {https://mitsuba-renderer.org},versão = {3.1.1},ano = 2022}