Farnblume

Dieses Dokument enthält Informationen über FernFlower, einen Java-Decompiler, und Mitsuba 3, ein forschungsorientiertes Rendering-System. Zu den Details von FernFlower gehören seine Funktionalität, Lizenzierung, Befehlszeilennutzung und Optionen zum Umbenennen von Bezeichnern. Die Beschreibung von Mitsuba 3 behandelt seine Funktionen, Installation, Verwendung und Mitwirkende. Beide Abschnitte bieten ausführliche Erklärungen und Beispiele.

Über FernFlower

FernFlower ist der erste tatsächlich funktionierende analytische Dekompiler für Java und

wahrscheinlich für eine höhere Programmiersprache im Allgemeinen. Natürlich ist es immer noch so

in der Entwicklung, senden Sie bitte Ihre Fehlerberichte und Verbesserungsvorschläge an die

Issue-Tracker.

FernFlower und ForgeFlower

FernFlower enthält einige Patches von ForgeFlower.

Den Betreuern von ForgeFlower gilt ein herzlicher Dank für ihre wertvollen Beiträge und Verbesserungen.

Lizenz

FernFlower ist unter der Apache-Lizenz Version 2.0 lizenziert.

Wird über die Befehlszeile ausgeführt

java -jar fernflower.jar [-

=

]* [

]+

bedeutet 0 oder mehr Mal

bedeutet 1 oder mehrere Male

: Datei oder Verzeichnis mit zu dekompilierenden Dateien. Verzeichnisse werden rekursiv durchsucht. Zulässige Dateierweiterungen sind class, zip und jar.

Quellen mit dem Präfix -e= bedeuten „Bibliotheksdateien“, die nicht dekompiliert werden, aber bei der Analyse der Beziehungen zwischen ihnen berücksichtigt werden

Klassen oder Methoden. Insbesondere das Umbenennen von Bezeichnern (s. Option 'ren') kann von Informationen über externe Klassen profitieren.

: Zielverzeichnis

,

: eine Befehlszeilenoption mit dem entsprechenden Wert (siehe „Befehlszeilenoptionen“ unten).

Beispiele:

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

Befehlszeilenoptionen

Mit Ausnahme von mpm und urc bedeutet der Wert 1, dass die Option aktiviert ist, 0 – deaktiviert. Standard

Der Wert, falls vorhanden, wird in Klammern angegeben.

Normalerweise werden die folgenden Optionen vom Benutzer geändert, falls vorhanden: hes, hdc, dgs, mpm, ren, urc

Die restlichen Optionen können so belassen werden: Sie richten sich an professionelle Reverse Engineers.

Bezeichner umbenennen

Einige Obfuskatoren geben Klassen und ihren Mitgliedselementen kurze, bedeutungslose und vor allem mehrdeutige Namen. Neukompilierung solcher

Code führt zu einer Vielzahl von Konflikten. Daher empfiehlt es sich, den Dekompiler seinerseits Elemente umbenennen zu lassen,

Gewährleistung der Einzigartigkeit jeder Kennung.

Die Option „ren“ (dh -ren=1) aktiviert die Umbenennungsfunktion. Die standardmäßige Umbenennungsstrategie lautet wie folgt:

Die Bedeutung jeder Methode sollte aus der Benennung klar hervorgehen: toBeRenamed bestimmt, ob das Element umbenannt wird, während die anderen drei

Geben Sie jeweils neue Namen für Klassen, Methoden und Felder an.

Beispiel:

Mitsuba Renderer 3

Dokumentation	Tutorial-Videos	Linux	MacOS	Windows	PyPI

️

Warnung

️

Derzeit gibt es hier eine große Menge undokumentierter und instabiler Arbeiten

der master . Wir empfehlen Ihnen dringend, unsere zu verwenden

neueste Version

bis auf Weiteres.

Wenn Sie die bevorstehenden Änderungen bereits ausprobieren möchten, schauen Sie sich bitte um

dieser Portierungsanleitung.

Es sollte die meisten kommenden neuen Funktionen und Breaking Changes abdecken.

Einführung

Mitsuba 3 ist ein forschungsorientiertes Rendering-System für Vorwärts- und Rückwärtslicht

Transportsimulation, entwickelt an der EPFL in der Schweiz.

Es besteht aus einer Kernbibliothek und einer Reihe von Plugins, die Funktionen implementieren

von Materialien und Lichtquellen bis hin zu kompletten Rendering-Algorithmen.

Mitsuba 3 ist retargetierbar : Das bedeutet, dass die zugrunde liegenden Implementierungen und

Datenstrukturen können sich verändern, um verschiedene Aufgaben zu erfüllen. Für

Beispielsweise kann derselbe Code beide skalaren (klassischen, jeweils einen Strahl gleichzeitig ausführenden) RGB-Transporte simulieren

oder differenzieller spektraler Transport auf der GPU. Darauf baut alles auf

Dr.Jit, ein spezialisierter Just-in-Time -Compiler (JIT), der speziell für dieses Projekt entwickelt wurde.

Hauptmerkmale

• Plattformübergreifend : Mitsuba 3 wurde unter Linux ( x86_64 ) und macOS getestet

  ( aarch64 , x8664 ) und Windows ( x8664 ).

• Hohe Leistung : Der zugrunde liegende Dr.Jit-Compiler verschmilzt Rendering-Code

  in Kernel, die modernste Leistung erzielen

  ein LLVM-Backend, das auf die CPU abzielt, und ein CUDA/OptiX-Backend

  zielt auf NVIDIA-GPUs mit Raytracing-Hardwarebeschleunigung ab.

• Python zuerst : Mitsuba 3 ist tief in Python integriert. Materialien,

  Texturen und sogar vollständige Rendering-Algorithmen können in Python entwickelt werden,

  die das System im laufenden Betrieb JIT-kompiliert (und optional differenziert).

  Dies ermöglicht die Experimente, die für die Forschung in der Computergrafik erforderlich sind

  andere Disziplinen.

• Differenzierung : Mitsuba 3 ist ein differenzierbarer Renderer, was bedeutet, dass er

  kann Ableitungen der gesamten Simulation in Bezug auf die Eingabe berechnen

  Parameter wie Kameraposition, Geometrie, BSDFs, Texturen und Volumina. Es

  implementiert aktuelle differenzierbare Rendering-Algorithmen, die an der EPFL entwickelt wurden.

• Spektral und Polarisation : Mitsuba 3 kann monochromatisch verwendet werden

  Renderer, RGB-basierter Renderer oder Spektralrenderer. Jede Variante kann

  Berücksichtigen Sie optional die Auswirkungen der Polarisation, falls gewünscht.

Tutorial-Videos, Dokumentation

Wir haben mehrere YouTube-Videos aufgenommen, die eine sanfte Einführung bieten

Mitsuba 3 und Dr.Jit. Darüber hinaus finden Sie komplette Juypter-Notizbücher

Es umfasst eine Vielzahl von Anwendungen, Anleitungen und Referenzdokumentationen

auf readthedocs.

Installation

Wir stellen vorkompilierte Binärräder über PyPI bereit. Mitsuba auf diese Weise zu installieren ist so einfach wie das Ausführen

 pip install mitsuba

auf der Kommandozeile. Das Python-Paket enthält standardmäßig dreizehn Varianten:

• scalar_rgb

• scalar_spectral

• scalarspectralpolarized

• llvmadrgb

• llvmadmono

• llvmadmono_polarized

• llvmadspectral

• llvmadspectral_polarized

• cudaadrgb

• cudaadmono

• cudaadmono_polarized

• cudaadspectral

• cudaadspectral_polarized

Die ersten beiden führen eine klassische Einzelstrahl-Simulation mit entweder einem RGB durch

oder spektrale Farbdarstellung, wobei die beiden letzteren für die Umkehrung verwendet werden können

Rendern auf der CPU oder GPU. Um auf zusätzliche Varianten zugreifen zu können, müssen Sie Folgendes tun

Kompilieren Sie eine benutzerdefinierte Version von Dr.Jit mit CMake. Bitte beachten Sie die

Dokumentation

Einzelheiten hierzu finden Sie hier.

Anforderungen

• Python >= 3.8

• (optional) Für Berechnung auf der GPU: Nvidia driver >= 495.89

• (optional) Für vektorisierte / parallele Berechnung auf der CPU: LLVM >= 11.1

Verwendung

Hier ist ein einfaches „Hello World“-Beispiel, das zeigt, wie einfach es ist, ein zu rendern

Szene mit Mitsuba 3 aus Python:

 # Importieren Sie die Bibliothek mit dem Alias ​​„mi“import mitsuba as mi# Legen Sie die Variante des Renderers festmi.setvariant('scalarrgb')# Laden Sie eine Szenescene = mi.loaddict(mi.cornellbox())# Rendern Sie die Szeneimg = mi. render(scene)# Schreiben Sie das gerenderte Bild in eine EXR-Dateimi.Bitmap(img).write('cbox.exr')

Es stehen Tutorials und Beispiel-Notebooks für eine Vielzahl von Anwendungen zur Verfügung

in der Dokumentation.

Um

Dieses Projekt wurde von Wenzel Jakob erstellt.

Wesentliche Funktionen und/oder Verbesserungen am Code wurden von beigesteuert

Sébastien Speierer,

Nicolas Roussel,

Merlin Nimier-David,

Delio Vicini,

Tizian Zeltner,

Baptiste Nicolet,

Miguel Crespo,

Vincent Leroy und

Ziyi Zhang.

Wenn Sie Mitsuba 3 in akademischen Projekten verwenden, geben Sie bitte Folgendes an:

 @software{Mitsuba3,title = {Mitsuba 3 renderer},author = {Wenzel Jakob und Sébastien Speierer und Nicolas Roussel und Merlin Nimier-David und Delio Vicini und Tizian Zeltner und Baptiste Nicolet und Miguel Crespo und Vincent Leroy und Ziyi Zhang},Anmerkung = {https://mitsuba-renderer.org},Version = {3.1.1},Jahr = 2022}