Переменные предпочтения (Preference Variables)

Материал из Ren'Py Wiki
Перейти к навигации Перейти к поиску

Переменные предпочтения хранят значения предпочтений Ren'Py. Несмотря на то, что значение предпочтения следует установить во время выполнения программы с помощью действия Preference(), переменные предпочтения необходимо использовать вместе с оператором default для установки значение предпочтения по умолчанию. Например:

default preferences.text_cps = 142

устанавливает скорость текста по умолчанию до 40 символов в секунду. Оператор default устанавливает значение предпочтения только в том случае, если значение по умолчанию изменилось с момента установки предпочтения. Например, если игрок изменяет скорость текста до 50, она останется на уровне 50 при последующих запусках игры. Если при обновлении значение по умолчанию установлено до 42, настройка игрока будет изменена на 42 (игрок может изменить её снова).


preferences.afm_after_click = False

Если принимает значение True, то авточтение будет продолжено после нажатия кнопки мыши. Если принимает значение False, нажатие на кнопку мыши выключит режим авточтения. Эквивалент предпочтения «auto-forward after click».


preferences.afm_time = 15

Время ожидания режима авточтения. Большие числа замедляют авточтение, несмотря на то, что преобразование фактического времени является сложным процессом, поскольку скорость учитывает длину строки. Эквивалент предпочтения «auto-forward».


preferences.desktop_rollback_side = "disable"

На настольной платформе прикосновения или клики по этой стороне окна вызывают откат. Одной из «left», «right» или «disable». Это эквивалентно предпочтению «rollback side» на настольной платформе.


preferences.mobile_rollback_side = "disable"

На мобильной платформе прикосновения или клики по этой стороне окна вызывают откат. Одной из «left», «right» или «disable». Это эквивалентно предпочтению «rollback side» на мобильной платформе.


preferences.emphasize_audio = False

Если принимает значение True, Ren'Py будет выделять звуковые каналы, найденные в config.emphasize_audio_channels за счёт уменьшения громкости других каналов. Например, уменьшение громкости музыки во время воспроизведения голоса. Если принимает значение False, этого не происходит.


preferences.fullscreen = False

Принимает значение True, когда Ren'Py находится в полноэкранном режиме, и принимает значение False, когда он работает в оконном режиме. Эквивалент предпочтения «display».


preferences.gl_framerate = None

Это либо целое число, либо None. Если принимает значение не None, это целевая частота кадров, которую Ren'Py попытается достичь. Если этот параметр установлен на низком уровне (например, 30) на мониторе с высокой частотой кадров (скажем, 60 кадров в секунду), то Ren'Py будет рисовать только на каждом втором кадре.
Если принимает значение None, Ren'Py попытается рисовать кадры с максимально возможной частотой кадров для вашего монитора.


preferences.gl_powersave = "auto"

Определяет, как часто Ren'Py будет перерисовывать неизменяющийся экран. Если принимает значение True, Ren'Py будет отрисовывать экран только 5 раз в секунду. Если значение False, он всегда будет отображаться с максимально возможной частотой кадров. Если установлено значение "auto", он будет работать на полной скорости, когда устройство работает, и 5 Гц при работе от аккумулятора.


preferences.gl_tearing = False

Определяет, является ли разрыв (True) или пропуск кадров (False) предпочтительным поведением, когда игра не успевает за предполагаемой частотой кадров.


preferences.mouse_move = False

Если принимает значение True, указатель мыши автоматически переместится на выбранную кнопку. Если принимает значение False, то это не произойдёт. Эквивалент предпочтения «automatic mouse move».


preferences.show_empty_window = True

Если принимает значение True, операторы window show и window auto будут функционировать. Если принимает значение False, эти операторы отключены. Эквивалент предпочтения «show empty window».


preferences.skip_after_choices = False

Если принимает значение True, пропуск возобновятся после выбора. Если принимает значение False, выбор помешает Ren'Py осуществить пропуск. Эквивалент предпочтения «after choices».


preferences.skip_unseen = False

Когда принимает значение True, Ren'Py пропустит весь текст. При значении False, Ren'Py будет пропускать только текст, прочитанный игроком в любой сессии. Эквивалент предпочтения «skip».


preferences.text_cps = 0

Скорость отображения текста. 0 – бесконечность, иначе это количество отображаемых символов в секунду. Эквивалент предпочтения «text speed».


preferences.transitions = 2

Определяет, какие переходы должны быть показаны. 2 – показывает все переходы, 0 – переходы не отображаются (1 зарезервировано). Эквивалент предпочтения «transitions».


preferences.video_image_fallback = False

Если принимает значение True, изображения отображаются вместо видеоспрайтов. Если принимает значение False, видеоспрайты отображаются нормально. Эквивалент (инвертированный) предпочтения «video sprites».


preferences.voice_sustain = False

Если принимает значение True, голос продолжает воспроизводиться до тех пор, пока не закончится, или его заменяет другая голосовая строка. Если принимает значение False, голосовая строка заканчивается, когда строка диалога продвигается. Эквивалент предпочтения «voice sustain».


preferences.wait_voice = True

Если принимает значение True, режим авточтения ждёт, когда завершится воспроизведение голосовых файлов и озвучивания текста на экране, прежде чем выполнить переход. Если принимает значение False, то это не произойдёт. Эквивалент предпочтения «wait for voice».

Звуковой канал по умолчанию (Audio Channel Defaults)[править | править код]

Эти переменные конфигурации устанавливают значение громкости по умолчанию на различных звуковых микшерах.


define config.default_music_volume = 1.0

Громкость по умолчанию для микшера music, используемого для звукового канала, на котором воспроизводится музыка и видео. Это должно быть число от 0.0 до 1.0, при этом 1.0 – значение для полной громкости.


define config.default_sfx_volume = 1.0

Громкость по умолчанию для микшера sfx, используемого для звукового канала, на котором воспроизводятся звуковые эффекты. Это должно быть число от 0.0 до 1.0, при этом 1.0 – значение для полной громкости.


define config.default_voice_volume = 1.0

Громкость по умолчанию для микшера voice, используемого для звукового канала, на котором воспроизводится голосовая озвучка. Это должно быть число от 0.0 до 1.0, при этом 1.0 – значение для полной громкости.

Источник[править | править код]

Статья "Preference Variables" на английском языке.


На главную страницу Официальная документация движка Вернуться к началу статьи