Различия

Здесь показаны различия между двумя версиями данной страницы.

--- help:modules [2013/12/09 06:51]
admin описание, что такое модуль
+++ help:modules [2024/10/14 12:46] (текущий)
aleks_versus
@@ Строка 1: / Строка 1: @@
 [[help:inputs|Назад: Ввод текста игроком]]
-=====Работа с файлами, использование модулей=====
-==== Модули ====
+====== Работа с файлами игр, использование модулей ======
-QSP позволяет "объединять" несколько файлов во время выполнения игры. Игрок запускает основной QSP-файл игры, из основного по необходимости "подгружаются" другие QSP-файлы. В подгружаемых файлах может находиться, например, часть игры, вынесенная в отдельный файл для удобства. Или, например, набор [[organizing|пользовательских функций и процедур]] - такие файлы называются "модулями". Можно использовать один файл модуля для разных игр. Это избавляет автора от излишнего дублирования кода.
+**QSP** позволяет загружать в выполняемую игру другие файлы игр. Это можно сделать двумя способами:
-  * **OPENQST** //[$путь]// - открытие и запуск заданного файла игры.
+  * Добавить локации из другой игры к списку локаций текущей игры.
-    * При использовании данного оператора, не происходит удаления переменных, удаления предметов инвентаря, очистки дополнительного описания и строки ввода, а также остановки проигрываемых файлов (для этого в начале загружаемой игры можно выполнить "KILLALL & CLS & CLOSE ALL").
+  * Заменить локации текущей игры локациями из другой игры.
-  * **ADDQST** //[$путь]// - из заданного файла игры добавляет все локации, названия которых отсутствуют среди текущих игровых локаций. Загруженные локации полностью эквивалентны локациям из основного файла игры.
-    * В более новых версиях библиотеки команда переименована в **ADDLIB**, затем в **INCLIB**
-  * **KILLQST** - удаляет все локации, добавленные с помощью оператора //"ADDQST"//.
-    * В более новых версиях библиотеки команда переименована в **DELLIB**, затем в **FREELIB**
-====Сохранения====
+Первый способ обычно используется для того, чтобы разбить игру на несколько частей и работать над каждой частью отдельно, а затем объединять эти части уже при запуске основного файла игры. Так, например, можно создать различные наборы [[help:organizing|пользовательских функций и процедур]] и повторно использовать их в разных играх.
-  * **OPENGAME** //[$выражение]// - если //[$выражение]// равно "" (пустая строка) или отсутствует, то вызов окна загрузки состояния игры, иначе загрузка состояния из указанного файла.
+Конечно, такие наборы уже не являются самостоятельными играми, хотя и представляют собой обычные QSP-файлы. Подобные, многократно используемые QSP-файлы принято называть **модулями** или **библиотеками**.
-    * См. также [[help:service_locations|$ONGLOAD]].
-  * **SAVEGAME** //[$выражение]// - если //[$выражение]// равно "" (пустая строка) или отсутствует, то вызов окна сохранения состояния игры, иначе сохранение состояния в указанный файл.
-    * См. также [[help:service_locations|$ONGSAVE]].
-  * **NOSAVE** - если значение переменной отлично от 0, то сохранение состояния игры пользователем невозможно.
-  * **DEBUG** - если значение переменной не равно 0, то отключается проверка идентификатора игры при загрузке состояния.
-    * Иначе при каждом изменении файла игры не поддерживаются предыдущие сохранения.
-==== Список готовых авторских модулей ====
+(Ниже по тексту слово **библиотека** означает движок плеера **QSP**, а не подключаемые файлы QSP)
-Olegus
+Второй способ используется достаточно редко, и он позволяет объединить запуск различных игр из одного сеанса работы плеера. При этом во время сеанса сохраняются значения всех переменных, предметов и состояния всех окон, т.е. игрок не замечает, как одна игра подменяется другой.
-    * [[https://forum.ifiction.ru/viewtopic.php?id=1613|экран]]
-    * [[https://forum.ifiction.ru/viewtopic.php?id=1522|таблицы данных]]
+Для примера представьте, что вы пишете симулятор казино на **QSP**. В казино есть множество различных игр: рулетка, покер, блэкджек, кости и другие. И каждая такая игра у вас смоделирована в отдельном QSP-файле. И есть главный файл, из которого вы можете запустить любую из этих игр. Пока работает плеер, деньги, заработанные в любой из этих игр, могут использоваться также и в любой другой, благодаря тому, что во всех отдельных играх они описываются одной и той же переменной ''%%money%%''.
-    * [[https://forum.ifiction.ru/viewtopic.php?id=1527|меню]]
-    * [[https://forum.ifiction.ru/viewtopic.php?id=1540|форматирование текста]]
+Ознакомьтесь с операторами, управляющими подключением файлов к игре, чтобы узнать, как на практике использовать оба способа.
-    * [[https://forum.ifiction.ru/viewtopic.php?id=1873|таймер]]
+===== Операторы для работы с модулями =====
+  * ''%%INCLIB%%'' — из указанного файла игры добавляет все локации, названия которых отсутствуют среди текущих игровых локаций. Загруженные локации полностью эквивалентны локациям из основного файла игры. Общая запись: <sxh qsp>
+INCLIB [$путь к файлу игры]
+</sxh> Пример: <sxh qsp>
+inclib "lib/easy.math.qsp"
+inclib "lib/easy.title.qsp"
+inclib "res/drive.qsp"
+inclib "res/base.qsp"
+inclib "res/intro.qsp"
+</sxh> **Обратите внимание!** Несмотря на то, что с применением оператора ''%%INCLIB%%'' увеличивается список доступных для использования локаций, сама запущенная игра не изменяется и не заменяется. Это позволяет запускать сохранения при отключенном режиме отладки (см. ''**[[help:savegame|DEBUG]]**'') даже в тех случаях, когда вы изменяете подключаемые к игре модули. То есть вы можете написать основной файл игры, включающий всего одну локацию, на которой подключаются все прочие модули, и сохранения от вашей игры будет невозможно запустить в других играх; однако при этом вы спокойно можете изменять все подключаемые к игре модули (например, если выпускаете патчи на игру), не боясь, что старые сохранения не запустятся с новыми версиями модулей.
+  * ''%%FREELIB%%'' — удаляет все локации, добавленные с помощью оператора ''%%INCLIB%%''. <sxh qsp>
+! удаляем все добавленные локации
+freelib
+</sxh>
+  * ''%%OPENQST%%'' — открывает и запускает указанный файл игры. То есть в сеансе плеера полностью очищается весь список локаций, затем добавляются локации из указанной игры, и на самую первую из них осуществляется переход, как если бы этот переход осуществлялся с помощью оператора ''**[[help:goto|GOTO]]**''. Общая запись: <sxh qsp>
+OPENQST [$путь]
+</sxh> , где ''%%[$путь]%%'' — путь к файлу игры, которую требуется запустить. Пример: <sxh qsp>
+openqst "gamespool/cubesgame.qsp"
+</sxh> При использовании данного оператора, не происходит удаления переменных, удаления предметов инвентаря, очистки дополнительного описания и строки ввода, а также остановки проигрываемых файлов. Если вам нужно очистить экран и значения всех переменных, можно прописать в начале загружаемого файла игры такие команды: <sxh qsp>
+killall & cls & close all
+</sxh> **Обратите внимание!** Загружаемая с помощью ''%%OPENQST%%'' игра — это совершенно другая игра, не та, из которой она была вызвана. Поэтому если вы из игры "1" запустили игру "2" и в игре "2" сделали сохранение, это сохранение не получится запустить из игры "1" при отключенном режиме отладки (см. ''**[[help:savegame|DEBUG]]**'').\\ **Внимание!** Не путайте операторы ''%%OPENQST%%'' и [[help:savegame|''OPENGAME'']].
+===== Список готовых авторских модулей =====
+==== Olegus ====
+  * [[https://forum.ifiction.ru/viewtopic.php?id=1613|QSP:Экран]] — модуль для управления отдельными HTML-областями на экране.
+  * [[https://forum.ifiction.ru/viewtopic.php?id=1522|Модуль для работы с таблицами данных]]
+  * [[https://forum.ifiction.ru/viewtopic.php?id=1527|Модуль для работы с меню]] — облегчает работу со всплывающими меню.
+  * [[https://forum.ifiction.ru/viewtopic.php?id=1540|QSP:Типограф]] — модуль для форматирования текста.
+  * [[https://forum.ifiction.ru/viewtopic.php?id=1873|QSP:Таймер]] — модуль для управления событиями по таймеру.
+==== Werewolf ====
+  * [[https://qsp.org/index.php?option=com_content&id=71&Itemid=56|Отладчик]]
+  * [[https://qsp.org/index.php?option=com_content&view=article&id=79:-10&catid=36:2009-02-19-06-11-21&Itemid=76|Гибкий плейлист]]
+==== Ntropy ====
+  * [[https://qsp.org/index.php?option=com_content&view=article&id=70:qsp-inventory-advanced-lib-076&catid=36:2009-02-19-06-11-21&Itemid=76|Библиотечка, дополняющая инвентарь]]
+==== Aleks Versus ====
+  * [[https://github.com/AleksVersus/easy.math.3|Easy.Math]] — математический модуль, расширяющий возможности работы с числами. Вещественные числа, работа со строками и массивами и другие полезные функции.
+[[help:savegame|Вперёд: Файлы сохранений]]
-Werewolf
-    * [[https://qsp.su/index.php?option=com_agora&task=topic&id=170&Itemid=57|Отладчик]]
-    * [[https://qsp.su/index.php?option=com_content&view=article&id=70:qsp-inventory-advanced-lib-076&catid=36:2009-02-19-06-11-21&Itemid=76|Расширенный инвентарь]]
-----
-[[help:realtime|Вперёд: Реальное время]]

Документация QSPСайтФорум

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

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

Различия

Инструменты страницы

Документация QSP
Сайт Форум