Запуск приложений GTK+

Переменные окружения

GTK+ проверяет ряд переменных окружения помимо стандартных переменных, таких как LANG, PATH, HOME или DISPLAY; в основном для определения путей поиска определённых файлов. X11, Windows и Broadway GDK-бекенды используют дополнительные переменные окружения.

GTK_DEBUG. Если GTK+ не был сконфигурирован с --enable-debug=no, эта переменная может быть установлена в список опций отладки, которые заставляют GTK+ выводить различные виды отладочной информации.

Специальное значение all может быть использовано для включения всех опций отладки. Специальное значение help может быть использовано для получения списка всех поддерживаемых опций отладки.

GTK3_MODULES. Список модулей для загрузки. Обратите внимание, что GTK+ также позволяет указать модули для загрузки через опцию командной строки (--gtk-module) и с помощью настройки gtk-modules.

GTK_MODULES. Список модулей для загрузки дополнительно к тем, которые находятся в переменной GTK3_MODULES.

GTK_PATH. Указывает список каталогов для поиска при поиске GTK+ динамически загружаемых объектов, таких как модули, указанные в GTK_MODULES, движки тем, модули методов ввода, бэкенды файловой системы и бэкенды печати. Если путь к динамически загружаемому объекту задан как абсолютный путь, то GTK+ загружает его напрямую. В противном случае GTK+ последовательно проходит каталоги в GTK_PATH, за которым следует каталог .gtk-3.0 в домашнем каталоге пользователя, а затем системный каталог по умолчанию, который является libdir/gtk-3.0/modules. (Если GTK_EXE_PREFIX определён, libdir является $GTK_EXE_PREFIX/lib. В противном случае это libdir, указанный при конфигурации GTK+, обычно /usr/lib, или /usr/local/lib.) Для каждого каталога в этом списке GTK+ фактически ищет подкаталог directory/version/host/type, где version выводится из версии GTK+ (используйте pkg-config --variable=gtk_binary_version gtk+-3.0 для определения этого из скрипта), host - архитектура, на которой был построен GTK+ (используйте pkg-config --variable=gtk_host gtk+-3.0 для определения этого из скрипта), а type - каталог, специфичный для типа модулей; в настоящее время он может быть modules, engines, immodules, filesystems или printbackends, соответствующие типам модулей, упомянутым выше. Либо version, host, или оба могут быть опущены. GTK+ сначала ищет в самом специфичном каталоге, а затем в каталогах с меньшим количеством компонентов. Компоненты GTK_PATH разделяются символом ':' на Linux и Unix, и символом ';' на Windows.

GTK_IM_MODULE. Указывает модуль IM, который необходимо использовать в приоритете по сравнению с модулем, определённым по локали. Если это не установлено, и вы работаете на системе, которая включает XSETTINGS и имеет значение в Gtk/IMModule, это значение будет использовано для модуля IM по умолчанию. Это также может быть список методов ввода, разделённых двоеточием, которые GTK+ будет пытаться использовать по очереди, пока не найдёт доступный в системе.

GTK_IM_MODULE_FILE. Указывает файл, содержащий список модулей IM для загрузки. Эта переменная окружения использует значение по умолчанию libdir/gtk-3.0/3.0.0/immodules.cache (libdir имеет то же значение, что и в случае с GTK_PATH). Файл immodules.cache создаётся утилитой gtk-query-immodules-3.0.

GTK_EXE_PREFIX. Если установлено, GTK+ использует $GTK_EXE_PREFIX/lib вместо libdir, сконфигурированного во время компиляции GTK+.

GTK_DATA_PREFIX. Если установлено, заставляет GTK+ использовать $GTK_DATA_PREFIX вместо префикса, сконфигурированного во время компиляции GTK+.

GTK_THEME. Если установлено, заставляет GTK+ использовать указанную тему вместо темы, заданной настройкой gtk-theme-name. Это предназначено в основном для удобства отладки проблем с темой. Также можно указать вариант темы для загрузки, добавив имя варианта с двоеточием, например: `GTK_THEME=Adwaita:dark`.

Следующие переменные окружения используются GdkPixbuf, GDK или Pango, а не самим GTK+, но мы всё же включили их для полноты.

GDK_PIXBUF_MODULE_FILE. Указывает файл, содержащий список модулей загрузчика GdkPixbuf для загрузки. Эта переменная окружения переопределяет значение по умолчанию libdir/gtk-3.0/3.0.0/loaders.cache (libdir - sysconfdir, заданный при конфигурации GTK+, обычно /usr/local/lib.) Файл loaders.cache генерируется утилитой gdk-pixbuf-query-loaders.

GDK_DEBUG. Если GTK+ был сконфигурирован с --enable-debug=yes, эта переменная может быть установлена в список опций отладки, которые заставляют GDK выводить различные типы отладочной информации.

Специальное значение all может быть использовано для включения всех опций отладки.

GDK_RENDERING. Если установлено, выбирает способ, которым GDK создаёт подобные поверхности. Это влияет как на функциональность функции gdk_window_create_similar_surface(), так и на способ, которым GDK создаёт поверхности для буферизации (double buffering). Можно использовать следующие значения:

Все остальные значения будут игнорироваться и вернуться к поведению по умолчанию. В будущем могут быть добавлены другие значения.

GDK_BACKEND. Если установлено, выбирает GDK бэкенд для использования. Выбор бэкенда требует, чтобы GTK+ был скомпилирован с поддержкой этого бэкенда. Следующие бэкенды могут быть выбраны, при условии, что они включены в GDK библиотеки, которые вы используете:

Начиная с версии 3.10, эта переменная окружения может содержать список имён бэкэндов, разделённых запятыми, которые будут пробоваться в указанном порядке. Список также может содержать *, что означает: попробовать все оставшиеся бэкэнды. Специальное значение "help" можно использовать для вывода GDK списка всех доступных бэкэндов. Более подробную информацию о выборе бэкэндов см. в функции gdk_display_manager_get().

XDG_DATA_HOME, XDG_DATA_DIRS. GTK+ использует эти переменные среды для поиска тем иконок и информации MIME. Дополнительную информацию можно найти в Спецификации темы иконок, Базе данных общих сведений о MIME и Спецификации базового каталога.

DESKTOP_STARTUP_ID. GTK+ использует эту переменную среды для предоставления уведомлений о запуске в соответствии со Спецификацией уведомлений о запуске. В соответствии со спецификацией, GTK+ сбрасывает эту переменную после ее считывания (чтобы не допустить ее утечки в дочерние процессы). Таким образом, если вам нужно получить ее значение для своих целей, вам нужно прочитать её перед вызовом gtk_init().