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

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

Окно основного описания очищается автоматически, при переходе на локацию с помощью оператора 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

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