Blender
V3.3
|
#include <Python.h>
#include <structmember.h>
#include "BLI_utildefines.h"
#include "BPY_extern.h"
#include "bpy_app_translations.h"
#include "MEM_guardedalloc.h"
#include "BLT_lang.h"
#include "BLT_translation.h"
#include "RNA_types.h"
#include "../generic/python_utildefines.h"
Go to the source code of this file.
Classes | |
struct | BlenderAppTranslations |
Macros | |
#define | SetObjString(item) PyStructSequence_SET_ITEM(translations_contexts, pos++, PyUnicode_FromString((item))) |
#define | SetObjNone() PyStructSequence_SET_ITEM(translations_contexts, pos++, Py_INCREF_RET(Py_None)) |
Functions | |
Helpers for GHash | |
PyDoc_STRVAR (app_translations_py_messages_register_doc, ".. method:: register(module_name, translations_dict)\n" "\n" " Registers an addon's UI translations.\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support.\n" "\n" " :arg module_name: The name identifying the addon.\n" " :type module_name: string\n" " :arg translations_dict: A dictionary built like that:\n" " ``{locale: {msg_key: msg_translation, ...}, ...}``\n" " :type translations_dict: dict\n" "\n") | |
static PyObject * | app_translations_py_messages_register (BlenderAppTranslations *self, PyObject *args, PyObject *kw) |
PyDoc_STRVAR (app_translations_py_messages_unregister_doc, ".. method:: unregister(module_name)\n" "\n" " Unregisters an addon's UI translations.\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support.\n" "\n" " :arg module_name: The name identifying the addon.\n" " :type module_name: string\n" "\n") | |
static PyObject * | app_translations_py_messages_unregister (BlenderAppTranslations *self, PyObject *args, PyObject *kw) |
Variables | |
Local Struct to Store Translation | |
static BlenderAppTranslations * | _translations = NULL |
C-defined Contexts | |
static PyTypeObject | BlenderAppTranslationsContextsType |
static BLT_i18n_contexts_descriptor | _contexts [] = BLT_I18NCONTEXTS_DESC |
static PyStructSequence_Field | app_translations_contexts_fields [ARRAY_SIZE(_contexts)] = {{NULL}} |
static PyStructSequence_Desc | app_translations_contexts_desc |
static PyObject * | app_translations_contexts_make (void) |
Main #BlenderAppTranslations #PyObject Definition | |
static PyMemberDef | app_translations_members [] |
static PyGetSetDef | app_translations_getseters [] |
static PyMethodDef | app_translations_methods [] |
static PyTypeObject | BlenderAppTranslationsType |
PyDoc_STRVAR (app_translations_contexts_doc, "A named tuple containing all predefined translation contexts.\n" "\n" ".. warning::\n" " Never use a (new) context starting with \"" BLT_I18NCONTEXT_DEFAULT_BPYRNA "\", it would be internally\n" " assimilated as the default one!\n") | |
PyDoc_STRVAR (app_translations_contexts_C_to_py_doc, "A readonly dict mapping contexts' C-identifiers to their py-identifiers.") | |
PyDoc_STRVAR (app_translations_locale_doc, "The actual locale currently in use (will always return a void string when Blender " "is built without " "internationalization support).") | |
static PyObject * | app_translations_locale_get (PyObject *UNUSED(self), void *UNUSED(userdata)) |
PyDoc_STRVAR (app_translations_locales_doc, "All locales currently known by Blender (i.e. available as translations).") | |
static PyObject * | app_translations_locales_get (PyObject *UNUSED(self), void *UNUSED(userdata)) |
static PyObject * | _py_pgettext (PyObject *args, PyObject *kw, const char *(*_pgettext)(const char *, const char *)) |
PyDoc_STRVAR (app_translations_pgettext_doc, ".. method:: pgettext(msgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt).\n" "\n" " .. note::\n" " The ``(msgid, msgctxt)`` parameters order has been switched compared to gettext " "function, to allow\n" " single-parameter calls (context then defaults to BLT_I18NCONTEXT_DEFAULT).\n" "\n" " .. note::\n" " You should really rarely need to use this function in regular addon code, as all " "translation should be\n" " handled by Blender internal code. The only exception are string containing formatting " "(like \"File: %r\"),\n" " but you should rather use :func:`pgettext_iface`/:func:`pgettext_tip` in those cases!\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support (hence always " "returns ``msgid``).\n" "\n" " :arg msgid: The string to translate.\n" " :type msgid: string\n" " :arg msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt: string or None\n" " :return: The translated string (or msgid if no translation was found).\n" "\n") | |
static PyObject * | app_translations_pgettext (BlenderAppTranslations *UNUSED(self), PyObject *args, PyObject *kw) |
PyDoc_STRVAR (app_translations_pgettext_iface_doc, ".. method:: pgettext_iface(msgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt), if labels' translation " "is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid: The string to translate.\n" " :type msgid: string\n" " :arg msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt: string or None\n" " :return: The translated string (or msgid if no translation was found).\n" "\n") | |
static PyObject * | app_translations_pgettext_iface (BlenderAppTranslations *UNUSED(self), PyObject *args, PyObject *kw) |
PyDoc_STRVAR (app_translations_pgettext_tip_doc, ".. method:: pgettext_tip(msgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt), if tooltips' " "translation is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid: The string to translate.\n" " :type msgid: string\n" " :arg msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt: string or None\n" " :return: The translated string (or msgid if no translation was found).\n" "\n") | |
static PyObject * | app_translations_pgettext_tip (BlenderAppTranslations *UNUSED(self), PyObject *args, PyObject *kw) |
PyDoc_STRVAR (app_translations_pgettext_data_doc, ".. method:: pgettext_data(msgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt), if new data name's " "translation is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid: The string to translate.\n" " :type msgid: string\n" " :arg msgctxt: The translation context (defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt: string or None\n" " :return: The translated string (or ``msgid`` if no translation was found).\n" "\n") | |
static PyObject * | app_translations_pgettext_data (BlenderAppTranslations *UNUSED(self), PyObject *args, PyObject *kw) |
PyDoc_STRVAR (app_translations_locale_explode_doc, ".. method:: locale_explode(locale)\n" "\n" " Return all components and their combinations of the given ISO locale string.\n" "\n" " >>> bpy.app.translations.locale_explode(\"sr_RS@latin\")\n" " (\"sr\", \"RS\", \"latin\", \"sr_RS\", \"sr@latin\")\n" "\n" " For non-complete locales, missing elements will be None.\n" "\n" " :arg locale: The ISO locale string to explode.\n" " :type msgid: string\n" " :return: A tuple ``(language, country, variant, language_country, language@variant)``.\n" "\n") | |
static PyObject * | app_translations_locale_explode (BlenderAppTranslations *UNUSED(self), PyObject *args, PyObject *kw) |
static PyObject * | app_translations_new (PyTypeObject *type, PyObject *UNUSED(args), PyObject *UNUSED(kw)) |
static void | app_translations_free (void *obj) |
PyDoc_STRVAR (app_translations_doc, "This object contains some data/methods regarding internationalization in Blender, " "and allows every py script\n" "to feature translations for its own UI messages.\n" "\n") | |
PyObject * | BPY_app_translations_struct (void) |
void | BPY_app_translations_end (void) |
This file defines a singleton py object accessed via 'bpy.app.translations', which exposes various data and functions useful in i18n work. Most notably, it allows to extend main translations with py dicts.
Definition in file bpy_app_translations.c.
#define SetObjNone | ( | ) | PyStructSequence_SET_ITEM(translations_contexts, pos++, Py_INCREF_RET(Py_None)) |
#define SetObjString | ( | item | ) | PyStructSequence_SET_ITEM(translations_contexts, pos++, PyUnicode_FromString((item))) |
|
static |
Definition at line 525 of file bpy_app_translations.c.
References BLT_I18NCONTEXT_DEFAULT, NULL, and void.
Referenced by app_translations_pgettext(), app_translations_pgettext_data(), app_translations_pgettext_iface(), and app_translations_pgettext_tip().
|
static |
Definition at line 415 of file bpy_app_translations.c.
References _contexts, BlenderAppTranslationsContextsType, BLT_i18n_contexts_descriptor::c_id, NULL, pos, SetObjNone, SetObjString, and BLT_i18n_contexts_descriptor::value.
Referenced by app_translations_new().
Definition at line 761 of file bpy_app_translations.c.
|
static |
Definition at line 669 of file bpy_app_translations.c.
References BLT_lang_locale_explode(), MEM_SAFE_FREE, and NULL.
|
static |
Definition at line 481 of file bpy_app_translations.c.
References BLT_lang_get().
|
static |
Definition at line 489 of file bpy_app_translations.c.
References BLT_lang_RNA_enum_properties(), EnumPropertyItem::description, EnumPropertyItem::identifier, pos, ret, and EnumPropertyItem::value.
|
static |
Definition at line 731 of file bpy_app_translations.c.
References _contexts, _translations, app_translations_contexts_make(), ARRAY_SIZE, BLT_i18n_contexts_descriptor::c_id, BlenderAppTranslations::contexts, BlenderAppTranslations::contexts_C_to_py, BLT_i18n_contexts_descriptor::py_id, BlenderAppTranslations::py_messages, and type.
|
static |
Definition at line 581 of file bpy_app_translations.c.
References _py_pgettext(), and BLT_pgettext().
|
static |
Definition at line 647 of file bpy_app_translations.c.
References _py_pgettext(), and BLT_translate_do_new_dataname().
|
static |
Definition at line 603 of file bpy_app_translations.c.
References _py_pgettext(), and BLT_translate_do_iface().
|
static |
Definition at line 625 of file bpy_app_translations.c.
References _py_pgettext(), and BLT_translate_do_tooltip().
|
static |
Definition at line 306 of file bpy_app_translations.c.
|
static |
Definition at line 359 of file bpy_app_translations.c.
Definition at line 891 of file bpy_app_translations.c.
Referenced by BPY_python_end().
PyObject* BPY_app_translations_struct | ( | void | ) |
Definition at line 856 of file bpy_app_translations.c.
References _contexts, app_translations_contexts_desc, BlenderAppTranslationsContextsType, BlenderAppTranslationsType, BLT_i18n_contexts_descriptor::c_id, NULL, BLT_i18n_contexts_descriptor::py_id, and ret.
Referenced by make_app_info().
PyDoc_STRVAR | ( | app_translations_contexts_C_to_py_doc | , |
"A readonly dict mapping contexts' C-identifiers to their py-identifiers." | |||
) |
PyDoc_STRVAR | ( | app_translations_contexts_doc | , |
"A named tuple containing all predefined translation contexts.\n" "\n" ".. warning::\n" " Never use a (new) context starting with \"" BLT_I18NCONTEXT_DEFAULT_BPYRNA "\" | , | ||
it would be internally\n" " assimilated as the default one!\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_doc | , |
"This object contains some data/methods regarding internationalization in | Blender, | ||
" "and allows every py script\n" "to feature translations for its own UI messages.\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_locale_doc | , |
"The actual locale currently in use (will always return a void string when Blender " "is built without " "internationalization support)." | |||
) |
PyDoc_STRVAR | ( | app_translations_locale_explode_doc | , |
".. method:: locale_explode(locale)\n" "\n" " Return all components and their combinations of the given ISO locale string.\n" "\n" " >> | , | ||
bpy.app.translations.locale_explode(\"sr_RS@latin\")\n" " (\"sr\", \"RS\", \"latin\", \"sr_RS\", \"sr@latin\")\n" "\n" " For non-complete | locales, | ||
missing elements will be None.\n" "\n" " :arg locale:The ISO locale string to explode.\n" " :type msgid:string\n" " :return:A tuple ``(language, country, variant, language_country, language @variant)``.\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_locales_doc | , |
"All locales currently known by Blender (i.e. available as translations)." | |||
) |
PyDoc_STRVAR | ( | app_translations_pgettext_data_doc | , |
".. method:: | pgettext_datamsgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt, | ||
if new data name 's " "translation is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid:The string to translate.\n" " :type msgid:string\n" " :arg msgctxt:The translation context(defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt:string or None\n" " :return:The translated string(or ``msgid`` if no translation was found).\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_pgettext_doc | , |
".. method:: pgettext(msgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt).\n" "\n" " .. note::\n" " The ``(msgid, msgctxt)`` parameters order has been switched compared to gettext " " | function, | ||
to allow\n" " single-parameter calls(context then defaults to BLT_I18NCONTEXT_DEFAULT).\n" "\n" " .. note::\n" " You should really rarely need to use this function in regular addon | code, | ||
as all " "translation should be\n" " handled by Blender internal code. The only exception are string containing formatting " " | like \"File: %r\", | ||
\n" " but you should rather use :func:`pgettext_iface`/:func:`pgettext_tip` in those cases!\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support(hence always " "returns ``msgid``).\n" "\n" " :arg msgid:The string to translate.\n" " :type msgid:string\n" " :arg msgctxt:The translation context(defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt:string or None\n" " :return:The translated string(or msgid if no translation was found).\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_pgettext_iface_doc | , |
".. method:: | pgettext_ifacemsgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt, | ||
if labels' translation " "is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid:The string to translate.\n" " :type msgid:string\n" " :arg msgctxt:The translation context(defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt:string or None\n" " :return:The translated string(or msgid if no translation was found).\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_pgettext_tip_doc | , |
".. method:: | pgettext_tipmsgid, msgctxt=None)\n" "\n" " Try to translate the given msgid (with optional msgctxt, | ||
if tooltips' " "translation is enabled.\n" "\n" " .. note::\n" " See :func:`pgettext` notes.\n" "\n" " :arg msgid:The string to translate.\n" " :type msgid:string\n" " :arg msgctxt:The translation context(defaults to BLT_I18NCONTEXT_DEFAULT).\n" " :type msgctxt:string or None\n" " :return:The translated string(or msgid if no translation was found).\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_py_messages_register_doc | , |
".. method:: register(module_name, translations_dict)\n" "\n" " Registers an addon's UI translations.\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support.\n" "\n" " :arg module_name: The name identifying the addon.\n" " :type module_name: string\n" " :arg translations_dict: A dictionary built like that:\n" " ``{locale: {msg_key: msg_translation, ...}, ...}``\n" " :type translations_dict: dict\n" "\n" | |||
) |
PyDoc_STRVAR | ( | app_translations_py_messages_unregister_doc | , |
".. method:: unregister(module_name)\n" "\n" " Unregisters an addon's UI translations.\n" "\n" " .. note::\n" " Does nothing when Blender is built without internationalization support.\n" "\n" " :arg module_name: The name identifying the addon.\n" " :type module_name: string\n" "\n" | |||
) |
|
static |
Definition at line 401 of file bpy_app_translations.c.
Referenced by app_translations_contexts_make(), app_translations_new(), and BPY_app_translations_struct().
|
static |
Definition at line 54 of file bpy_app_translations.c.
Referenced by app_translations_new().
|
static |
Definition at line 408 of file bpy_app_translations.c.
Referenced by BPY_app_translations_struct().
|
static |
Definition at line 406 of file bpy_app_translations.c.
|
static |
Definition at line 517 of file bpy_app_translations.c.
|
static |
Definition at line 463 of file bpy_app_translations.c.
|
static |
Definition at line 698 of file bpy_app_translations.c.
|
static |
Definition at line 399 of file bpy_app_translations.c.
Referenced by app_translations_contexts_make(), and BPY_app_translations_struct().
|
static |
Definition at line 774 of file bpy_app_translations.c.
Referenced by BPY_app_translations_struct().