[PYTHON] [Blender] So erstellen Sie Blender-Skripte mehrsprachig

Auf Twitter wurde ein wenig darüber gesprochen, wie Blender-Skripte mehrsprachig sein können, da die Blender-Dokumentation verwirrend ist. Aufgrund verschiedener Untersuchungen konnte ich mehrere Sprachen unterstützen, daher werde ich sie anhand eines Beispiels vorstellen.

Stichprobe

Hier sind einige Beispiele, die mehrere Sprachen unterstützen. Dieses Mal habe ich einfach versucht, die folgenden zwei Sprachen zu unterstützen.

• Englisch
• Japanisch

translation.py

import bpy

bl_info = {
    "name" : "Translation Test",
    "author" : "Nutti",
    "version" : (0, 1),
    "blender" : (2, 7, 0),
    "location" : "UV > Translation Test",
    "description" : "Translation Test",
    "warning" : "",
    "wiki_url" : "",
    "tracker_url" : "",
    "category" : "UV"
}

#Übersetzungswörterbuch
translation_dict = {
    "en_US" :
        {("*", "Test: ") : "Test: %d"},
    "ja_JP" :
        {("*", "Test: ") : "Tesuto: %d"}
}


class TranslationTest(bpy.types.Operator):
    bl_idname = "uv.translation_test"
    bl_label = "Translation Test"
    bl_description = "Translation Test"
    bl_options = {'REGISTER', 'UNDO'}
    
    def execute(self, context):
        num = 50
        #Übersetzungsergebnisse in der Benachrichtigungsleiste anzeigen
        self.report({'INFO'}, bpy.app.translations.pgettext("Test: ") % (num))
        return {'FINISHED'}


def menu_func(self, context):
    self.layout.separator()
    self.layout.operator(TranslationTest.bl_idname)


def register():
    bpy.utils.register_module(__name__)
    bpy.types.VIEW3D_MT_uv_map.append(menu_func)
    bpy.app.translations.register(__name__, translation_dict)   #Registrieren eines Wörterbuchs


def unregister():
    bpy.app.translations.unregister(__name__)   #Wörterbuch löschen
    bpy.utils.unregister_module(__name__)
    bpy.types.VIEW3D_MT_uv_map.remove(menu_func)


if __name__ == "__main__":
    register()

Wie benutzt man

Führen Sie zur Installation die folgenden Schritte aus. Blender Wiki

1. Den Mixer japanisieren
2. Führen Sie "Übersetzungstest" aus dem angezeigten Menü aus, indem Sie im Bearbeitungsmodus die Taste "U" drücken.
3. Vergewissern Sie sich, dass "Test: 50" in der Benachrichtigungsleiste angezeigt wird.
4. Übersetzen Sie Blender ins Englische
5. Führen Sie "Übersetzungstest" aus dem angezeigten Menü aus, indem Sie im Bearbeitungsmodus die Taste "U" drücken.
6. Vergewissern Sie sich, dass "Test: 50" in der Benachrichtigungsleiste angezeigt wird.

So ändern Sie die Sprache von Blender

Das Folgende kann beim Ändern der Blender-Sprache hilfreich sein. blender.jp

Beispielerklärung

Den grundlegenden Teil finden Sie unter [\ Blender ] Erstellen eines Blender-Plug-Ins. Dieses Mal werde ich mich auf den mehrsprachigen Teil konzentrieren.

Definition des Übersetzungswörterbuchs

Definieren Sie ein Wörterbuch für die Übersetzung. Das Format des Wörterbuchs ist wie folgt.

{locale: {(context, key): translated_str, ...}, ...}

Jeder Parameter wird unten gezeigt.

In diesem Beispiel ist das Wörterbuch wie folgt definiert.

translation_dict = {
    "en_US" :
        {("*", "Test: ") : "Test: %d"},
    "ja_JP" :
        {("*", "Test: ") : "Tesuto: %d"}
}

Tipps: So erhalten Sie das Gebietsschema

Einige Benutzer wissen möglicherweise nicht, was sie angeben sollen, selbst wenn es sich um ein Gebietsschema handelt. Versuchen Sie in einem solchen Fall Folgendes über die in Blender bereitgestellte Python-Konsole. Sie können das aktuelle Gebietsschema von Blender herausfinden.

>>> bpy.app.translations.locale
'en_US'

Registrierung des Übersetzungswörterbuchs

Führen Sie in der Registerfunktion Folgendes aus, um ein Wörterbuch für die Übersetzung zu registrieren.

bpy.app.translations.register(__name__, translation_dict)

Übersetzung durchführen

Verwenden Sie "bpy.app.translations.pgettext" wie folgt, um die übersetzte Zeichenfolge aus dem angegebenen "Schlüssel" abzurufen.

bpy.app.translations.pgettext("Test: ") 

Wenn Sie das ** Zeichenfolgenformat ** verwenden möchten, verwenden Sie bpy.app.translations.pgettext_iface.

bpy.app.translations.pgettext("Test: ") % (num)

Übersetzungswörterbuch löschen

Das registrierte Übersetzungswörterbuch muss freigegeben werden, wenn das Add-On gestoppt wird. Führen Sie die folgenden Schritte in der Funktion zum Aufheben der Registrierung aus, um die Registrierung des Wörterbuchs aufzuheben.

bpy.app.translations.unregister(__name__)

abschließend

Wir haben gezeigt, wie Blender-Skripte mehrsprachig werden. Durch die Kompatibilität des Skripts mit mehreren Sprachen besteht eine hohe Wahrscheinlichkeit, dass das Skript für die unterstützten Sprachen verwendet wird. Blender ist im englischsprachigen Raum immer noch weit verbreitet. Wenn Sie also Skripte für Japanisch schreiben, nutzen Sie diese Gelegenheit, um auch Englisch zu unterstützen. ** Durch die Unterstützung von Englisch können Sie möglicherweise das Feedback von Ausländern kennenlernen **.

Referenzinformationen

• Blender 2.69.1 - API documentation-
• Projekt, das tatsächlich eine Blender-Übersetzung durchführt