Здесь показаны различия между двумя версиями данной страницы.
| Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия | ||
|
help:main [2024/10/10 17:29] aleks_versus проба обновления до 5.9.0 |
help:main [2025/09/27 18:20] (текущий) aleks_versus [Функции для работы с Окном основного описания] |
||
|---|---|---|---|
| Строка 18: | Строка 18: | ||
| ==== Команды для вывода текста в Окно основного описания ==== | ==== Команды для вывода текста в Окно основного описания ==== | ||
| - | * ''%%*P [$текст]%%'' - простой вывод текста. Выводит текст в **Окно основного описания** без перехода на новую строку. Пример: <sxh qsp> | + | * ''%%*P [$текст]%%'' - простой вывод текста. Выводит текст в **Окно основного описания** без перехода на новую строку. Пример:<sxh qsp> |
| *p 'Шла' | *p 'Шла' | ||
| *p 'Саша' | *p 'Саша' | ||
| *p 'По' | *p 'По' | ||
| *p 'Шоссе' | *p 'Шоссе' | ||
| - | </sxh> После выполнения кода (если запустим игру) — в **Окне основного описания** мы увидим: <sxh> | + | </sxh> После выполнения кода (если запустим игру) — в **Окне основного описания** мы увидим:<sxh> |
| ШлаСашаПоШоссе | ШлаСашаПоШоссе | ||
| </sxh> | </sxh> | ||
| - | * ''%%*PL [$текст]%%'' - вывод текста, затем переход на новую строку. Пример: <sxh qsp> | + | * ''%%*PL [$текст]%%'' - вывод текста, затем переход на новую строку. Пример:<sxh qsp> |
| *p 'Шла' & ! здесь выводим текст без перехода на новую строку | *p 'Шла' & ! здесь выводим текст без перехода на новую строку | ||
| *p 'Саша' & ! и здесь тоже | *p 'Саша' & ! и здесь тоже | ||
| *pl 'По' | *pl 'По' | ||
| *pl 'Шоссе' | *pl 'Шоссе' | ||
| - | </sxh> После выполнения кода — в **Окне основного описания** мы увидим: <sxh> | + | </sxh> После выполнения кода — в **Окне основного описания** мы увидим:<sxh> |
| ШлаСашаПо | ШлаСашаПо | ||
| Шоссе | Шоссе | ||
| </sxh> | </sxh> | ||
| * Если не указать ''%%[$текст]%%'', то команда просто создаст переход на новую строку: <sxh qsp> | * Если не указать ''%%[$текст]%%'', то команда просто создаст переход на новую строку: <sxh qsp> | ||
| - | *p 'Шла Саша' | + | *p 'Шла Саша' |
| - | *pl | + | *pl |
| - | *p 'По шоссе' | + | *p 'По шоссе' |
| - | </sxh> В **Окне основного описания** мы увидим: <sxh> | + | </sxh> В **Окне основного описания** мы увидим:<sxh> |
| - | Шла Саша | + | Шла Саша |
| - | По Шоссе | + | По Шоссе |
| </sxh> | </sxh> | ||
| * Если не указать ''%%*pl%%'', а указать только ''%%[$текст]%%'', работа такой команды почти не будет отличаться от работы команды с операторм **''%%*pl%%''**. Это называется **[[help:keywords_operator|неявный оператор]]**: <sxh qsp> | * Если не указать ''%%*pl%%'', а указать только ''%%[$текст]%%'', работа такой команды почти не будет отличаться от работы команды с операторм **''%%*pl%%''**. Это называется **[[help:keywords_operator|неявный оператор]]**: <sxh qsp> | ||
| - | 'Во поле' | + | 'Во поле' |
| - | 'берёзка' | + | 'берёзка' |
| - | 'стояла' | + | 'стояла' |
| ! эквивалентно | ! эквивалентно | ||
| - | pl 'Во поле' | + | *pl 'Во поле' |
| - | pl 'берёзка' | + | *pl 'берёзка' |
| *pl 'стояла' | *pl 'стояла' | ||
| </sxh> | </sxh> | ||
| - | * ''%%*NL [$текст]%%'' - переход на новую строку, а затем вывод текста. Пример: <sxh qsp> | + | * ''%%*NL [$текст]%%'' - переход на новую строку, а затем вывод текста. Пример: <sxh qsp> |
| *p 'Шла' & ! здесь выводим текст без перехода на новую строку | *p 'Шла' & ! здесь выводим текст без перехода на новую строку | ||
| *p 'Саша' & ! и здесь тоже | *p 'Саша' & ! и здесь тоже | ||
| Строка 69: | Строка 67: | ||
| </sxh> | </sxh> | ||
| * Если не указать ''%%[$текст]%%'', то команда просто совершит переход на новую строку: <sxh qsp> | * Если не указать ''%%[$текст]%%'', то команда просто совершит переход на новую строку: <sxh qsp> | ||
| - | *p 'Шла Саша' | + | *p 'Шла Саша' |
| - | *nl | + | *nl |
| - | *p 'По Шоссе' | + | *p 'По Шоссе' |
| </sxh> В **Окне основного описания** мы увидим: <sxh> | </sxh> В **Окне основного описания** мы увидим: <sxh> | ||
| - | Шла Саша | + | Шла Саша |
| - | По Шоссе | + | По Шоссе |
| </sxh> | </sxh> | ||
| Строка 84: | Строка 82: | ||
| *nl 'По' & ! переходим на новую строку и выводим текст | *nl 'По' & ! переходим на новую строку и выводим текст | ||
| *nl 'Шоссе' & ! переходим на новую строку и выводим текст | *nl 'Шоссе' & ! переходим на новую строку и выводим текст | ||
| - | *clear | + | *clear & ! очищаем окно основного описания от всего текста |
| - | & ! очищаем окно основного описания от всего текста | + | |
| </sxh> В результате работы этого кода **Окно основного описания** окажется пустым. | </sxh> В результате работы этого кода **Окно основного описания** окажется пустым. | ||
| - | |||
| * **''%%CLS%%''** - эквивалентно конструкции “''%%CLEAR & *CLEAR & CLA & CMDCLEAR%%''”, т.е. очищает все окна, кроме списка предметов. | * **''%%CLS%%''** - эквивалентно конструкции “''%%CLEAR & *CLEAR & CLA & CMDCLEAR%%''”, т.е. очищает все окна, кроме списка предметов. | ||
| Строка 100: | Строка 96: | ||
| Видит Грека В Реке Рак | Видит Грека В Реке Рак | ||
| </sxh> | </sxh> | ||
| - | + | * ''%%$DESC([$локация])%%'' - возвращает текст базового описания локации с названием ''%%[$локация]%%''. | |
| - | * ''%%$DESC([$локация])%%'' - возвращает текст базового описания локации с названием ''%%[$локация]%%''. Обратите внимание! Функция возвращает текст, написанный только в поле “Описание” (**Базовое описание**) редактора **Quest Generator**. При работе в текстовом редакторе данное поле вам недоступно и функция будет всегда возвращать пустую строку.\\ В **Базовом описании** можно использовать [[help:strings#podvyrazhenija|подвыражения]], функция **''%%$DESC%%''** автоматически “раскроет” их. | + | * **Обратите внимание!** Функция возвращает текст, написанный только в поле “Описание” (**Базовое описание**) редактора **Quest Generator**. При работе в текстовом редакторе данное поле преобразуется в команды ''%%*p%%'' между тегами ''! BASE'' и ''! END BASE''. Функция всегда будет возвращать сумму строк этих команд. |
| + | * В **Базовом описании** можно использовать [[help:strings#podvyrazhenija|подвыражения]], функция **''%%$DESC%%''** автоматически “раскроет” их. | ||
| ==== Системные переменные для управления Окном основного описания ==== | ==== Системные переменные для управления Окном основного описания ==== | ||
| * **''%%DISABLESCROLL%%''** - если значение переменной не равно ''%%0%%'', то запрещает автопрокрутку текста при его выводе в окно основного или дополнительное описания. **Что это значит**. Предположим, мы вывели на экран большой объём текста, а затем при нажатии на **действие** у нас выводится ещё один фрагментик текста. Если ''%%DISABLESCROLL = 0%%'', этот фрагментик текста при выводе заставит экран прокрутиться вниз. Если мы не хотим, чтобы экран прокручивался вниз в этом случае, мы присваиваем переменной **''%%DISABLESCROLL%%''** единицу. | * **''%%DISABLESCROLL%%''** - если значение переменной не равно ''%%0%%'', то запрещает автопрокрутку текста при его выводе в окно основного или дополнительное описания. **Что это значит**. Предположим, мы вывели на экран большой объём текста, а затем при нажатии на **действие** у нас выводится ещё один фрагментик текста. Если ''%%DISABLESCROLL = 0%%'', этот фрагментик текста при выводе заставит экран прокрутиться вниз. Если мы не хотим, чтобы экран прокручивался вниз в этом случае, мы присваиваем переменной **''%%DISABLESCROLL%%''** единицу. | ||
| - | |||
| * **''%%$BACKIMAGE%%''** - содержит путь к файлу фонового изображения для **Окна основного описания**. | * **''%%$BACKIMAGE%%''** - содержит путь к файлу фонового изображения для **Окна основного описания**. | ||
| * Фон в окне основного описания отображается в том случае, если значение данной переменной отлично от ''%%""%%'' (пустая строка) и файл изображения удалось загрузить. | * Фон в окне основного описания отображается в том случае, если значение данной переменной отлично от ''%%""%%'' (пустая строка) и файл изображения удалось загрузить. | ||
| * Необходимо указывать путь к изображению относительно файла игры: <sxh qsp> | * Необходимо указывать путь к изображению относительно файла игры: <sxh qsp> | ||
| - | ! файл игры лежит в папке C:\QSP\myCoolGame | + | ! файл игры лежит в папке C:\QSP\myCoolGame |
| - | ! файл изображения лежит в папке C:\QSP\myCoolGame\image и называется picture.png | + | ! файл изображения лежит в папке C:\QSP\myCoolGame\image и называется picture.png |
| - | ! значит установить изображение фоном в окно основного описания мы можем так: | + | ! значит установить изображение фоном в окно основного описания мы можем так: |
| - | $backimage='image\picture.png' | + | $backimage='image\picture.png' |
| </sxh> | </sxh> | ||
| * При этом фон вписывается в границы **Окна основного описания**, и управлять им в классическом плеере нельзя. | * При этом фон вписывается в границы **Окна основного описания**, и управлять им в классическом плеере нельзя. | ||
| * Если вы хотите убрать фон, присвойте переменной **''%%$BACKIMAGE%%''** пустую строку: <sxh qsp> | * Если вы хотите убрать фон, присвойте переменной **''%%$BACKIMAGE%%''** пустую строку: <sxh qsp> | ||
| - | $backimage = '' | + | $backimage = '' |
| </sxh> | </sxh> | ||