So erstellen Sie das Substance Painter Python-Plugin (Einführung)
Ab Substance Painter 2020.1 (6.1.0) wurde zusätzlich zur traditionellen JavaScript-API die Python-API hinzugefügt.
[Substance Painter Version 2020 \ .1 \ (6 \ .1 \ .0 ) Versionshinweis - Born Digital Support](https://support.borndigital.co.jp/hc/ja/articles/900000700626-Substance-Painter -Version-2020-1-6-1-0-% E3% 83% AA% E3% 83% AA% E3% 83% BC% E3% 82% B9% E3% 83% 8E% E3% 83% BC% E3% 83% 88)
In der offiziellen Dokumentation wurde die Existenz der Python-API jedoch noch nicht erwähnt. Es war schwierig zu wissen, wo ich anfangen sollte, notieren Sie sich also nur den Eingang.
Ab SP 2020.2 ist die Python-API-Version 0.0.2. Bitte beachten Sie, dass der Inhalt dieses Artikels wahrscheinlich bald veraltet sein wird.
Speicherort der Python-API-Referenz
- Klicken Sie in der In-App-Menüleiste auf Help> Documentation> Python API, um eine lokale HTML-Datei zu öffnen
- Unter Windows lautet der tatsächliche Pfad C: \ Programme \ Allegorithmic \ Substance Painter \ resources \ python-doc \ index.html
- Aus irgendeinem Grund wird es nicht online veröffentlicht
- Ähnlich wie bei der JavaScript-API
- Ich bin in Schwierigkeiten, weil ich nicht googeln kann ...
Speicherort des Skripts
- _ "Python> Plugin-Ordner" _ öffnet den Ordner, in dem das Plugin gespeichert ist
- Unter Windows C: \ Benutzer \
\ Dokumente \ Allegorithmic \ Substance Painter \ python \ plugins - Platziere .py-Dateien direkt unter Plugins /
- Wird nicht geladen, auch wenn es in einem Unterordner abgelegt ist
Python-Konsole
- _ "Windows> Ansichten> Python-Konsole" _ zum Anzeigen des Konsolenfensters
- Sie können die Referenz beispielsweise mit dem folgenden Befehl anzeigen
- Die Zeichen sind eher klein, daher sollten Sie sich die HTML-Referenz ansehen
#Modul laden
import substance_painter
#Modulbeschreibung anzeigen
help(substance_painter)
#Beschreibung des Projektmoduls anzeigen
help(substance_painter.project)
Tutorial zum Erstellen eines einfachen Plug-Ins
Erstellen Sie plugins / hello_plugin.py mit den folgenden Inhalten.
"""The hello world of python scripting in Substance Painter
"""
from PySide2 import QtWidgets
import substance_painter.ui
plugin_widgets = []
"""Keep track of added ui elements for cleanup"""
def start_plugin():
"""This method is called when the plugin is started."""
# Create a simple text widget
hello_widget = QtWidgets.QTextEdit()
hello_widget.setText("Hello from python scripting!")
hello_widget.setReadOnly(True)
hello_widget.setWindowTitle("Hello Plugin")
# Add this widget as a dock to the interface
substance_painter.ui.add_dock_widget(hello_widget)
# Store added widget for proper cleanup when stopping the plugin
plugin_widgets.append(hello_widget)
def close_plugin():
"""This method is called when the plugin is stopped."""
# We need to remove all added widgets from the UI.
for widget in plugin_widgets:
substance_painter.ui.delete_ui_element(widget)
plugin_widgets.clear()
if __name__ == "__main__":
start_plugin()
Scannen Sie die Ordner erneut mit _ "Python> Plugin-Ordner neu laden" _.
Es gibt ein Element namens _ "Python> Hallo \ _plugin" _, also klicken Sie darauf.
Wenn ein Widget (Bereich) mit dem Namen "HALLO PLUGIN" auf dem Bildschirm erstellt wird, ist dies erfolgreich.
Andere Ergänzungen
- Zum 30. Juli 2020 werden Python-Plug-Ins nicht auf der offiziellen Website für die Freigabe von Plug-Ins freigegeben.
- Es gibt nur wenige JavaScripts, und die meisten davon sind alt
- Ist das Painter-Plug-In überhaupt nicht beliebt?
- Die Motivation für das Schreiben eines Plug-Ins war, dass es sehr ärgerlich war, jedes Mal, wenn ich das Netz änderte, von _ "Bearbeiten> Projektkonfiguration ..." _ neu zu laden, aber anscheinend gibt es eine API zum Neuladen. Ich scheine nicht. Warum nicht schaffen? : Wut:
- Anfragen werden ebenfalls gesammelt → Schaltfläche zum erneuten Laden des Netzes . - Feedback
Recommended Posts