Инструменты пользователя

Инструменты сайта


Боковая панель

help:main

Это старая версия документа.


Назад: Локации

Окно основного описания

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

Окно основного описания очищается автоматически, при переходе на локацию с помощью оператора GOTO (GT).

Чтобы вывести текст в Окно основного описания, нужно воспользоваться одним из следующих способов:

  • Написать текст в поле “Описание” локации (Базовое описание локации) в Quest Generator. Тогда весь текст из этого поля автоматически будет выведен в Окно основного описания при переходе на локацию.
  • Воспользоваться одной из команд для вывода текста, прописав эту команду в поле Выполнить при посещении локации в Quest Generator. При работе в текстовом редакторе у вас есть только этот способ.

Команды для работы с Окном основного описания

Под обозначением [$текст] ниже на странице понимается любая строка текста, число, значение выражения, переменной или функции.

Команды для вывода текста в Окно основного описания

* *P [$текст] - простой вывод текста. Выводит текст в Окно основного описания без перехода на новую строку. Пример:

*p 'Шла'
*p 'Саша'
*p 'По'
*p 'Шоссе'
После выполнения кода (если запустим игру) — в Окне основного описания мы увидим:
ШлаСашаПоШоссе
* *PL [$текст] - вывод текста, затем переход на новую строку. Пример:
*p 'Шла' & ! здесь выводим текст без перехода на новую строку
*p 'Саша' & ! и здесь тоже
*pl 'По'
*pl 'Шоссе'
После выполнения кода — в Окне основного описания мы увидим:
ШлаСашаПо
Шоссе

  • Если не указать [$текст], то команда просто создаст переход на новую строку:
    *p 'Шла Саша'
    *pl
    *p 'По шоссе'
    
    В Окне основного описания мы увидим:
    Шла Саша
    По Шоссе
    
  • Если не указать *pl, а указать только [$текст], работа такой команды почти не будет отличаться от работы команды с операторм *pl. Это называется неявный оператор:
    'Во поле'
    'берёзка'
    'стояла'
    
    ! эквивалентно
    
    pl 'Во поле'
    pl 'берёзка'
    *pl 'стояла'
    

* *NL [$текст] - переход на новую строку, а затем вывод текста. Пример:

*p 'Шла' & ! здесь выводим текст без перехода на новую строку
*p 'Саша' & ! и здесь тоже
*nl 'По'
*nl 'Шоссе'
После выполнения кода — в Окне основного описания мы увидим:
ШлаСаша
По
Шоссе

  • Если не указать [$текст], то команда просто совершит переход на новую строку:
    *p 'Шла Саша'
    *nl
    *p 'По Шоссе'
    
    В Окне основного описания мы увидим:
    Шла Саша
    По Шоссе
    

Команды для очистки Окна основного описания

  • *CLEAR или *CLR - очищает Окно основного описания. Пример:
    *p 'Шла'    & ! выводим текст без перехода на новую строку
    *pl 'Саша'  & ! выводим текст и переходим на новую строку
    *nl 'По'    & ! переходим на новую строку и выводим текст
    *nl 'Шоссе' & ! переходим на новую строку и выводим текст
    *clear & ! очищаем окно основного описания от всего текста
    
    В результате работы этого кода Окно основного описания окажется пустым.
  • CLS - эквивалентно конструкции “CLEAR & *CLEAR & CLA & CMDCLEAR”, т.е. очищает все окна, кроме списка предметов.

Функции для работы с Окном основного описания

  • $MAINTXT - возвращает текст, выведенный в окно основного описания. Пример:
    *p 'Ехал Грека Через Реку'
    *nl 'Видит Грека В Реке Рак'
    $text = $maintxt
    
    В данном случае в переменную $text запишутся две строки текста:
    Ехал Грека Через Реку
    Видит Грека В Реке Рак
    
  • $DESC([$локация]) - возвращает текст базового описания локации с названием [$локация]. Обратите внимание! Функция возвращает текст, написанный только в поле “Описание” (Базовое описание) редактора Quest Generator. При работе в текстовом редакторе данное поле вам недоступно и функция будет всегда возвращать пустую строку.
    В Базовом описании можно использовать подвыражения, функция $DESC автоматически “раскроет” их.

Системные переменные для управления Окном основного описания

  • DISABLESCROLL - если значение переменной не равно 0, то запрещает автопрокрутку текста при его выводе в окно основного или дополнительное описания. Что это значит. Предположим, мы вывели на экран большой объём текста, а затем при нажатии на действие у нас выводится ещё один фрагментик текста. Если DISABLESCROLL = 0, этот фрагментик текста при выводе заставит экран прокрутиться вниз. Если мы не хотим, чтобы экран прокручивался вниз в этом случае, мы присваиваем переменной DISABLESCROLL единицу.
  • $BACKIMAGE - содержит путь к файлу фонового изображения для Окна основного описания.
    • Фон в окне основного описания отображается в том случае, если значение данной переменной отлично от "" (пустая строка) и файл изображения удалось загрузить.
    • Необходимо указывать путь к изображению относительно файла игры:
      ! файл игры лежит в папке C:\QSP\myCoolGame
      ! файл изображения лежит в папке C:\QSP\myCoolGame\image и называется picture.png
      ! значит установить изображение фоном в окно основного описания мы можем так:
      $backimage='image\picture.png'
      
    • При этом фон вписывается в границы Окна основного описания, и управлять им в классическом плеере нельзя.
    • Если вы хотите убрать фон, присвойте переменной $BACKIMAGE пустую строку:
      $backimage = ''
      

Другие примеры

*P '1'
*PL '23'
*NL '456'
'78'

После выполнения кода в Окно основного описания будет выведено:

123

45678

Можно выводить не только строки, но и числа, и значения переменных, функций и результаты вычисления выражений:

*pl 'I ♥ QSP!'
*pl 256 / 12 * 9
137 + (2 * 9)
$curloc
*nl rand(999)
x = 15
*nl x

Вперёд: Окно дополнительного описания

help/main.1728581638.txt.gz · Последние изменения: 2024/10/10 17:33 — aleks_versus