Здесь показаны различия между двумя версиями данной страницы.
Both sides previous revision Предыдущая версия Следущая версия | Предыдущая версия | ||
help:stat [2022/12/30 13:07] aleks_versus статья переписана |
help:stat [2024/10/10 17:39] (текущий) aleks_versus проба обновления до 5.9.0 |
||
---|---|---|---|
Строка 1: | Строка 1: | ||
- | |||
[[help:main|Назад: Окно основного описания]] | [[help:main|Назад: Окно основного описания]] | ||
- | ====== Дополнительное окно описания ====== | + | ====== Окно дополнительного описан ====== |
- | Чаще всего **Окно дополнительного описания** используется для вывода сопроводительной информации, игровой статистики, логов и других сообщений, которые не требуется постоянно менять. Оно не очищается автоматически при смене локации, в отличие от Окна основного описания, и чтобы его очистить нужно использовать специальные команды. | + | Чаще всего **Окно дополнительного описания** используется для вывода сопроводительной информации, игровой статистики, логов и других сообщений, которые не требуется постоянно менять. Оно не очищается автоматически при смене локации, в отличие от **Окна основного описания**, и чтобы его очистить нужно использовать специальные команды. |
- | Использование этого окна без необходимости считается дурным тоном, т.к. это перегружает интерфейс и создаёт проблемы отображения игры на Android и iOS. | + | Использование этого окна **без необходимости** считается дурным тоном, т.к. это перегружает интерфейс и создаёт проблемы отображения игры на Android и iOS. |
**ВНИМАНИЕ!** При написании кроссплатформенных игр использовать дополнительное окно описания настоятельно не рекомендуется **Nex**-ом. | **ВНИМАНИЕ!** При написании кроссплатформенных игр использовать дополнительное окно описания настоятельно не рекомендуется **Nex**-ом. | ||
Строка 12: | Строка 11: | ||
===== Команды для работы с Окном дополнительного описания ===== | ===== Команды для работы с Окном дополнительного описания ===== | ||
- | + | Под обозначением ''%%[$текст]%%'' ниже на странице понимается любая строка текста, число, значение выражения, переменной или функции. | |
- | Под обозначением ''[$текст]'' ниже на странице понимается любая строка текста, число, значение выражения, переменной или функции. | + | |
==== Включение и выключение Окна дополнительного описания ==== | ==== Включение и выключение Окна дополнительного описания ==== | ||
- | * ''**SHOWSTAT** [#выражение]'' - если значение выражения отлично от 0, то показывает **Окно дополнительного описания**, иначе скрывает его. Пример:<sxh qsp> | + | * ''%%SHOWSTAT [#выражение]%%'' - если значение выражения отлично от 0, то показывает **Окно дополнительного описания**, иначе скрывает его. Пример: <sxh qsp> |
- | showstat 0 & ! скрываем окно дополнительного описания | + | showstat 0 & ! скрываем окно дополнительного описания |
- | showstat 1 & ! окно дополнительного описания снова отображается | + | showstat 1 & ! окно дополнительного описания снова отображается |
- | </sxh> Для удобства чтения кода можно заранее определить переменные ''on'' и ''off'' с соответствующими значениями:<sxh qsp> | + | </sxh> Для удобства чтения кода можно заранее определить переменные ''%%on%%'' и ''%%off%%'' с соответствующими значениями: <sxh qsp> |
- | on,off = 1,0 | + | on, off = 1, 0 |
- | showstat on & ! включаем окно дополнительного описания | + | showstat on & ! включаем окно дополнительного описания |
- | showstat off & ! выключаем окно дополнительного описания | + | showstat off & ! выключаем окно дополнительного описания |
</sxh> | </sxh> | ||
==== Команды для вывода текста в Окно дополнительного описания ==== | ==== Команды для вывода текста в Окно дополнительного описания ==== | ||
- | * ''**P** [$текст]'' - простой вывод текста. Выводит текст в **Окно дополнительного описания** без перехода на новую строку. Пример:<sxh qsp> | + | * ''%%P [$текст]%%'' - простой вывод текста. Выводит текст в **Окно дополнительного описания** без перехода на новую строку. Пример: <sxh qsp> |
- | p 'Бобр' | + | p 'Бобр' |
- | p 'Добр' | + | p 'Добр' |
- | p 'До' | + | p 'До' |
- | p 'Бобрят' | + | p 'Бобрят' |
- | </sxh> После выполнения кода (если запустим игру) — в **Окне дополнительного описания** мы увидим:<sxh qsp> | + | </sxh> После выполнения кода (если запустим игру) — в **Окне дополнительного описания** мы увидим: <sxh> |
- | БобрДобрДоБобрят | + | БобрДобрДоБобрят |
</sxh> | </sxh> | ||
- | * ''**PL** [$текст]'' - вывод текста, затем переход на новую строку. Пример:<sxh qsp> | + | * ''%%PL [$текст]%%'' - вывод текста, затем переход на новую строку. Пример: <sxh qsp> |
- | p 'Бобр' & ! выводим текст без перевода на новую строку | + | p 'Бобр' & ! выводим текст без перевода на новую строку |
- | p 'Добр' & ! и здесь тоже | + | p 'Добр' & ! и здесь тоже |
- | pl 'До' | + | pl 'До' |
- | pl 'Бобрят' | + | pl 'Бобрят' |
- | </sxh> После выполнения кода (если запустим игру) — в **Окне дополнительного описания** мы увидим:<sxh qsp> | + | </sxh> После выполнения кода (если запустим игру) — в **Окне дополнительного описания** мы увидим: <sxh> |
- | БобрДобрДо | + | БобрДобрДо |
- | Бобрят | + | Бобрят |
</sxh> | </sxh> | ||
- | * Если не указать ''[$текст]'', то команда просто создаст переход на новую строку:<sxh qsp> | + | * Если не указать ''%%[$текст]%%'', то команда просто создаст переход на новую строку: <sxh qsp> |
- | p 'Бобр Добр' | + | p 'Бобр Добр' |
- | pl | + | pl |
- | p 'До Бобрят' | + | p 'До Бобрят' |
- | </sxh> В **Окне дополнительного описания** мы увидим: <sxh qsp> | + | </sxh> В **Окне дополнительного описания** мы увидим: <sxh qsp> |
- | Бобр Добр | + | Бобр Добр |
- | До Бобрят | + | До Бобрят |
</sxh> | </sxh> | ||
- | * ''**NL** [$текст]'' - переход на новую строку, а затем вывод текста. Пример:<sxh qsp> | + | * ''%%NL [$текст]%%'' - переход на новую строку, а затем вывод текста. Пример: <sxh qsp> |
- | p 'Бобр' & ! здесь выводим текст без перехода на новую строку | + | p 'Бобр' & ! здесь выводим текст без перехода на новую строку |
- | p 'Добр' & ! и здесь тоже | + | p 'Добр' & ! и здесь тоже |
- | nl 'До' | + | nl 'До' |
- | nl 'Бобрят' | + | nl 'Бобрят' |
- | </sxh> После выполнения кода — в **Окне дополнительного описания** мы увидим:<sxh qsp> | + | </sxh> После выполнения кода — в **Окне дополнительного описания** мы увидим: <sxh qsp> |
- | БобрДобр | + | БобрДобр |
- | До | + | До |
- | Бобрят | + | Бобрят |
</sxh> | </sxh> | ||
- | * Если не указать ''[$текст]'', то команда просто совершит переход на новую строку:<sxh qsp> | + | * Если не указать ''%%[$текст]%%'', то команда просто совершит переход на новую строку: <sxh qsp> |
- | *p 'Бобр Добр' | + | *p 'Бобр Добр' |
- | *nl | + | *nl |
- | *p 'До Бобрят' | + | *p 'До Бобрят' |
- | </sxh> В **Окне дополнительного описания** мы увидим:<sxh qsp> | + | </sxh> В **Окне дополнительного описания** мы увидим: <sxh qsp> |
- | Бобр Добр | + | Бобр Добр |
- | До Бобрят | + | До Бобрят |
</sxh> | </sxh> | ||
==== Команды для очистки Окна дополнительного описания ==== | ==== Команды для очистки Окна дополнительного описания ==== | ||
- | * ''**CLEAR**'' или ''**CLR**'' - очищает **Окно дополнительного описания**. Пример:<sxh qsp> | + | * ''%%CLEAR%%'' или ''%%CLR%%'' - очищает **Окно дополнительного описания**. Пример: <sxh qsp> |
- | *p 'Бобр' & ! выводим текст без перехода на новую строку | + | *p 'Бобр' & ! выводим текст без перехода на новую строку |
- | *pl 'Добр' & ! выводим текст и переходим на новую строку | + | *pl 'Добр' & ! выводим текст и переходим на новую строку |
- | *nl 'До' & ! переходим на новую строку и выводим текст | + | *nl 'До' & ! переходим на новую строку и выводим текст |
- | *nl 'Бобрят' & ! переходим на новую строку и выводим текст | + | *nl 'Бобрят' & ! переходим на новую строку и выводим текст |
- | *clear & ! очищаем окно дополнительного описания от всего текста | + | *clear |
- | </sxh> В результате работы этого кода **Окно дополнительного описания** окажется пустым. | + | & ! очищаем окно дополнительного описания от всего текста |
- | * ''**CLS**'' - эквивалентно конструкции "''CLEAR & *CLEAR & CLA & CMDCLEAR''", т.е. очищает все окна, кроме списка предметов. | + | </sxh> В результате работы этого кода **Окно дополнительного описания** окажется пустым. |
+ | * ''%%CLS%%'' - эквивалентно конструкции “''%%CLEAR & *CLEAR & CLA & CMDCLEAR%%''”, т.е. очищает все окна, кроме списка предметов. | ||
==== Функции для работы с Окном дополнительного описания ==== | ==== Функции для работы с Окном дополнительного описания ==== | ||
- | * ''**$STATTXT**'' - эта функция возвращает текст, выведенный в окно дополнительного описания. Пример:<sxh qsp> | + | * ''%%$STATTXT%%'' - эта функция возвращает текст, выведенный в окно дополнительного описания. Пример: <sxh qsp> |
- | p 'Вёз Корабль Карамель' | + | p 'Вёз Корабль Карамель' |
- | nl 'Наскочил Корабль На Мель' | + | nl 'Наскочил Корабль На Мель' |
- | $string = $stattxt | + | $string = $stattxt |
- | </sxh> В данном случае при выполнении кода в переменную ''**$string**'' запишутся две строки текста:<sxh qsp> | + | </sxh> В данном случае при выполнении кода в переменную ''%%$string%%'' запишутся две строки текста: <sxh qsp> |
- | Вёз Корабль Карамель | + | Вёз Корабль Карамель |
- | Наскочил Корабль На Мель | + | Наскочил Корабль На Мель |
</sxh> | </sxh> | ||
==== Системные переменные для управления Окном дополнительного описания ==== | ==== Системные переменные для управления Окном дополнительного описания ==== | ||
- | * ''**DISABLESCROLL**'' - если значение переменной не равно 0, то запрещает автопрокрутку текста при его выводе в окно основного или дополнительное описания. **Что это значит**. Предположим, мы вывели на экран большой объём текста, а затем при нажатии на **действие** у нас выводится ещё один фрагментик текста. Если ''DISABLESCROLL = 0'', этот фрагментик текста при выводе заставит экран прокрутиться вниз. Если мы не хотим, чтобы экран прокручивался вниз в этом случае, мы присваиваем переменной ''DISABLESCROLL'' единицу. | + | * ''%%DISABLESCROLL%%'' - если значение переменной не равно 0, то запрещает автопрокрутку текста при его выводе в окно основного или дополнительное описания.\\ **Что это значит**. Предположим, мы вывели на экран большой объём текста, а затем при нажатии на **действие** у нас выводится ещё один фрагментик текста. Если ''%%DISABLESCROLL = 0%%'', этот фрагментик текста при выводе заставит экран прокрутиться вниз. Если мы не хотим, чтобы экран прокручивался вниз в этом случае, мы присваиваем переменной ''%%DISABLESCROLL%%'' единицу. |
- | + | ||
===== Другие примеры ===== | ===== Другие примеры ===== | ||
Строка 106: | Строка 105: | ||
'78' | '78' | ||
</sxh> | </sxh> | ||
+ | |||
После выполнения кода в **Окно дополнительного описания** будет выведено: | После выполнения кода в **Окно дополнительного описания** будет выведено: | ||
- | <sxh qsp> | + | <sxh> |
123 | 123 | ||
Строка 117: | Строка 117: | ||
<sxh qsp> | <sxh qsp> | ||
- | p 'I♥QSP!' | + | p 'I ♥ QSP!' |
- | pl 256/12*9 | + | pl 256 / 12 * 9 |
- | pl 137+(2*9) | + | pl 137 + (2 * 9) |
p $curloc | p $curloc | ||
nl rand(999) | nl rand(999) | ||
- | x=15 & ! присваиваем значение переменной | + | x = 15 & ! присваиваем значение переменной |
nl x | nl x | ||
</sxh> | </sxh> | ||
- | [[help:msgbox|Вперёд: Диалоговое окно]] | + | [[help:msgbox|Вперёд: Окно сообщений]] |