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

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


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

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 - содержит путь к файлу фонового изображения для Окна основного описания. * Фон в окне основного описания отображается в том случае, если значение данной переменной отлично от (пустая строка) и файл изображения удалось загрузить. * Необходимо указывать путь к изображению относительно файла игры:<sxh qsp> ! файл игры лежит в папке C:\QSP\myCoolGame ! файл изображения лежит в папке C:\QSP\myCoolGame\image и называется picture.png ! значит установить изображение фоном в окно основного описания мы можем так: $backimage='image\picture.png' </sxh> * При этом фон вписывается в границы Окна основного описания, и управлять им в классическом плеере нельзя. * Если вы хотите убрать фон, присвойте переменной $BACKIMAGE пустую строку:<sxh qsp> $backimage= </sxh> ===== Другие примеры ===== <sxh qsp> *P '1' *PL '23' *NL '456' '78' </sxh> После выполнения кода в Окно основного описания** будет выведено:

123

45678

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

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

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

help/main.1672404317.txt.gz · Последние изменения: 2022/12/30 12:45 — aleks_versus