Различия

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

--- help:interface [2023/01/03 12:08]
aleks_versus
+++ help:interface [2024/10/14 12:34] (текущий)
aleks_versus
@@ Строка 1: / Строка 1: @@
 [[help:graphics|Назад: Графика]]
 ====== Настройки интерфейса ======
 Возможности работы с интерфейсом отличаются для различных версий плееров. В данном разделе будет рассказано об основных возможностях, реализованных в классическом плеере и **qSpider**.
@@ Строка 9: / Строка 7: @@
 ===== Функция кодирования цвета =====
-Прежде всего следует ознакомиться с функцией кодирования цвета ''**RGB**'', поскольку именно она используется при работе с переменными, задающими основные цвета интерфейса.
+Прежде всего следует ознакомиться с функцией кодирования цвета ''%%RGB%%'', поскольку именно она используется при работе с переменными, задающими основные цвета интерфейса.
-	* ''**RGB**'' —  возвращает числовой код цвета на основе четырёх числовых аргумнтов, каждый из которых соответствует составляющей требуемого цвета и составляющей прозрачности. Общая запись:<sxh qsp>
-		RGB([#красный],[#зелёный],[#синий],[#альфа])
-</sxh>		, где ''[#красный]'',''[#зелёный]'' и ''[#синий]'' — числовое выражение трёх составляющих цвета соответственно красной, зелёной и синей; ''[#альфа]'' — составляющая прозрачности; должны принимать значения от 0 до 255.\\ Данная функция обычно используется совместно с системными переменными ''**BCOLOR**'', ''**FCOLOR**'', ''**LCOLOR**''. Пример:<sxh qsp>
-		! гиперссылки светло-жёлтого цвета
-		lcolor=rgb(255,255,100)
-		! фон тёмно-серого цвета
-		bcolor=rgb(25,25,25)
-		! текст светло-зелёного цвета
-		fcolor=rgb(100,255,100)
-</sxh>Пример полупрозрачного цвета ссылок:<sxh qsp>
-		lcolor=rgb(0,255,255,128)
-</sxh>Прозрачность (альфа-канал) может не работать в классическом плеере.
+  * ''%%RGB%%'' — возвращает числовой код цвета на основе четырёх числовых аргументов, каждый из которых соответствует составляющей требуемого цвета и составляющей прозрачности. Общая запись: <sxh qsp>
+RGB([#красный],[#зелёный],[#синий],[#альфа])
+</sxh> , где ''%%[#красный]%%'',''%%[#зелёный]%%'' и ''%%[#синий]%%'' — числовое выражение трёх составляющих цвета соответственно красной, зелёной и синей; ''%%[#альфа]%%'' — составляющая прозрачности; должны принимать значения от 0 до 255.\\ Данная функция обычно используется совместно с системными переменными ''%%BCOLOR%%'', ''%%FCOLOR%%'', ''%%LCOLOR%%''. Пример: <sxh qsp>
+! гиперссылки светло-жёлтого цвета
+lcolor = rgb(255,255,100)
+! фон тёмно-серого цвета
+bcolor = rgb(25,25,25)
+! текст светло-зелёного цвета
+fcolor = rgb(100,255,100)
+</sxh> Пример полупрозрачного цвета ссылок: <sxh qsp>
+lcolor = rgb(0,255,255,128)
+</sxh> Прозрачность (альфа-канал) может не работать в классическом плеере.
 ===== Общие настройки отображения текста =====
@@ Строка 31: / Строка 28: @@
 ==== Переменные, задающие цвета ====
-	* ''**BCOLOR**'' —  содержит цвет текущего фона. Если равна 0, то используется цвет, заданный в настройках программы. Примеры:<sxh qsp>
+  * ''%%BCOLOR%%'' — содержит цвет текущего фона. Если равна 0, то используется цвет, заданный в настройках программы. Примеры: <sxh qsp>
-		! чёрный цвет фона
+! чёрный цвет фона
-		bcolor=-16777216
+bcolor=-16777216
-		! красный цвет фона
+! красный цвет фона
-		bcolor=-16776961
+bcolor=-16776961
-		! белый цвет фона
+! белый цвет фона
-		bcolor=-1
+bcolor=-1
-</sxh>		Поскольку цвет фона кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
+</sxh> Поскольку цвет фона кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''%%RGB%%'', которой в качестве аргументов передаются три составляющие цвета: <sxh qsp>
-		! задаём цвет фона через функцию rgb(red,green,blue)
+! задаём цвет фона через функцию rgb(red,green,blue)
-		! фон синего цвета
+! фон синего цвета
-		bcolor=rgb(0,0,255)
+bcolor=rgb(0,0,255)
-		! фон жёлтого цвета
+! фон жёлтого цвета
-		bcolor=rgb(255,255,0)
+bcolor=rgb(255,255,0)
-		! фон оранжевого цвета
+! фон оранжевого цвета
-		bcolor=rgb(255,130,0)
+bcolor=rgb(255,130,0)
-		! фон голубого цвета
+! фон голубого цвета
-		bcolor=rgb(0,255,255)
+bcolor=rgb(0,255,255)
-		! фон малинового цвета
+! фон малинового цвета
-		bcolor=rgb(255,0,255)
+bcolor=rgb(255,0,255)
 </sxh>
-	*''**FCOLOR**'' —  содержит цвет используемого в данный момент шрифта. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет всего текста игры, кроме гиперссылок и текста, цвет которого переназначен через HTML. Пример:<sxh qsp>
+  * ''%%FCOLOR%%'' — содержит цвет используемого в данный момент шрифта. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет всего текста игры, кроме гиперссылок и текста, цвет которого переназначен через HTML. Пример: <sxh qsp>
-		! чёрный цвет текста
+! чёрный цвет текста
-		fcolor=-16777216
+fcolor=-16777216
-		! красный цвет текста
+! красный цвет текста
-		fcolor=-16776961
+fcolor=-16776961
-		! белый цвет текста
+! белый цвет текста
-		fcolor=-1
+fcolor=-1
-</sxh>		Поскольку цвет шрифта кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
+</sxh> Поскольку цвет шрифта кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''%%RGB%%'', которой в качестве аргументов передаются три составляющие цвета: <sxh qsp>
-		! задаём цвет текста через функцию rgb(red,green,blue)
+! задаём цвет текста через функцию rgb(red,green,blue)
-		! текст чёрного цвета
+! текст чёрного цвета
-		fcolor=rgb(0,0,0)
+fcolor=rgb(0,0,0)
-		! текст белого цвета
+! текст белого цвета
-		fcolor=rgb(255,255,255)
+fcolor=rgb(255,255,255)
-		! текст красного цвета
+! текст красного цвета
-		fcolor=rgb(255,0,0)
+fcolor=rgb(255,0,0)
-		! текст зелёного цвета
+! текст зелёного цвета
-		fcolor=rgb(0,255,0)
+fcolor=rgb(0,255,0)
 </sxh>
-	* ''**LCOLOR**'' —  содержит текущий цвет шрифта гиперссылок. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет текста всех гиперссылок, кроме тех, цвет которых переназначен через HTML. Пример:<sxh qsp>
+  * ''%%LCOLOR%%'' — содержит текущий цвет шрифта гиперссылок. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет текста всех гиперссылок, кроме тех, цвет которых переназначен через HTML. Пример: <sxh qsp>
-		! чёрный цвет гиперссылок
+! чёрный цвет гиперссылок
-		lcolor=-16777216
+lcolor=-16777216
-		! красный цвет гиперссылок
+! красный цвет гиперссылок
-		lcolor=-16776961
+lcolor=-16776961
-		! белый цвет гиперссылок
+! белый цвет гиперссылок
-		lcolor=-1
+lcolor=-1
-</sxh>		Поскольку цвет в QSP кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
+</sxh> Поскольку цвет в QSP кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''%%RGB%%'', которой в качестве аргументов передаются три составляющие цвета: <sxh qsp>
-		! задаём цвет  гиперссылок через функцию rgb(red,green,blue)
+! задаём цвет  гиперссылок через функцию rgb(red,green,blue)
-		!  гиперссылки синего цвета
+!  гиперссылки синего цвета
-		lcolor=rgb(0,0,255)
+lcolor=rgb(0,0,255)
-		! гиперссылки жёлтого цвета
+! гиперссылки жёлтого цвета
-		lcolor=rgb(255,255,0)
+lcolor=rgb(255,255,0)
-		! гиперссылки оранжевого цвета
+! гиперссылки оранжевого цвета
-		lcolor=rgb(255,130,0)
+lcolor=rgb(255,130,0)
-		! гиперссылки голубого цвета
+! гиперссылки голубого цвета
-		lcolor=rgb(0,255,255)
+lcolor=rgb(0,255,255)
-		! гиперссылки малинового цвета
+! гиперссылки малинового цвета
-		lcolor=rgb(255,0,255)
+lcolor=rgb(255,0,255)
 </sxh>
 ==== Переменные, задающие шрифт ====
-	*''**FSIZE**'' —  содержит размер используемого в данный момент шрифта. Если равна 0, то используется размер, заданный в настройках программы. Относительно данного значения в HTML-режиме вычисляются размеры шрифтов тега ''[<font>]''. Пример:<sxh qsp>
+  * ''%%FSIZE%%'' — содержит размер используемого в данный момент шрифта. Если равна **0**, то используется размер, заданный в настройках программы. Относительно данного значения в HTML-режиме вычисляются размеры шрифтов тега ''%%<font>%%''. Пример: <sxh qsp>
-		fsize=18
+fsize=18
-</sxh>		Размер шрифта устанавливается для всего текста в игре, кроме текста, размер которого переназначен через HTML.
+</sxh> Размер шрифта устанавливается для всего текста в игре, кроме текста, размер которого переназначен через HTML.
-	* ''**$FNAME**'' —  содержит название используемого в данный момент шрифта во всей игре. Если равна ''**""**'' (пустая строка), то используется шрифт, заданный в настройках программы.\\ Пример:<sxh qsp>
+  * ''%%$FNAME%%'' — содержит название используемого в данный момент шрифта во всей игре. Если равна ''%%""%%'' (пустая строка), то используется шрифт, заданный в настройках программы. Пример: <sxh qsp>
-		! устанавливаем для всей игры шрифт Courier New
+! устанавливаем для всей игры шрифт Courier New
-		$fname="Courier New"
+$fname = "Courier New"
 </sxh>
 ===== Настройки отображения окон =====
-	* ''**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>
-	* ''**SHOWACTS** [#выражение]'' - если значение выражения отлично от 0, то показывает **Список действий**, иначе скрывает его.\\ Пример:<sxh qsp>
+  * ''%%SHOWACTS [#выражение]%%'' - если значение выражения отлично от 0, то показывает **Список действий**, иначе скрывает его.\\
-		showacts 0 & ! скрываем Окно действий
+Пример: <sxh qsp>
-		showacts 1 & ! выводим Окно действий на экран
+showacts 0 & ! скрываем Окно действий
-</sxh>Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' с соответствующими значениями:<sxh qsp>
+showacts 1 & ! выводим Окно действий на экран
-		on, off = 1, 0
+</sxh> Для удобства чтения кода можно заранее определить переменные ''%%on%%'' и ''%%off%%'' с соответствующими значениями: <sxh qsp>
-		showacts on & ! включаем окно дополнительного описания
+on, off = 1, 0
-		showacts off & ! выключаем окно дополнительного описания
+showacts on & ! включаем окно дополнительного описания
+showacts off & ! выключаем окно дополнительного описания
 </sxh>
-	* ''**SHOWOBJS** [#выражение]'' - если значение выражения отлично от 0, то показывает **Список предметов**, иначе скрывает его.\\ Пример:<sxh qsp>
+  * ''%%SHOWOBJS [#выражение]%%'' - если значение выражения отлично от 0, то показывает **Список предметов**, иначе скрывает его.\\
-		showobjs 0 & ! скрываем Окно предметов
+Пример: <sxh qsp>
-		showobjs 1 & ! выводим Окно предметов на экран
+showobjs 0 & ! скрываем Окно предметов
-</sxh>Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' с соответствующими значениями:<sxh qsp>
+showobjs 1 & ! выводим Окно предметов на экран
-		on, off = 1, 0
+</sxh> Для удобства чтения кода можно заранее определить переменные ''%%on%%'' и ''%%off%%'' с соответствующими значениями: <sxh qsp>
-		showobjs on & ! включаем окно дополнительного описания
+on, off = 1, 0
-		showobjs off & ! выключаем окно дополнительного описания
+showobjs on & ! включаем окно дополнительного описания
+showobjs off & ! выключаем окно дополнительного описания
 </sxh>
-	* ''**SHOWINPUT**'' — управляет отображением строки ввода на экране. Общая запись:<sxh qsp>
+  * ''%%SHOWINPUT%%'' — управляет отображением строки ввода на экране. Общая запись: <sxh qsp>
-		SHOWINPUT [#выражение]
+SHOWINPUT [#выражение]
-</sxh>		, где ''[#выражение]'' — это число. Обычно используются значения 0 и 1. Если значение выражения ''[#выражение]'' отлично от нуля, строка ввода отображается. Если значение выражения ''[#выражение]'' равно нулю, строка ввода скрыта. Примеры:<sxh qsp>
+</sxh> , где ''%%[#выражение]%%'' — это число. Обычно используются значения 0 и 1. Если значение выражения ''%%[#выражение]%%'' отлично от нуля, строка ввода отображается. Если значение выражения ''%%[#выражение]%%'' равно нулю, строка ввода скрыта. Примеры: <sxh qsp>
-		showinput 1 & ! показывает строку ввода
+showinput 1 & ! показывает строку ввода
-		showinput 0 & ! скрывает строку ввода
+showinput 0 & ! скрывает строку ввода
-</sxh>		Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' и использовать их:<sxh qsp>
+</sxh> Для удобства чтения кода можно заранее определить переменные ''%%on%%'' и ''%%off%%'' и использовать их: <sxh qsp>
-		on, off = 1, 0
+on, off = 1, 0
-		showinput on & ! показывает строку ввода
+showinput on & ! показывает строку ввода
-		showinput off & ! скрывает строку ввода
+showinput off & ! скрывает строку ввода
 </sxh>
 ===== Обновление настроек интерфейса =====
-	* ''**REFINT**'' — принудительное обновление интерфейса (в т.ч. смена цветов, шрифтов, назначенных с помощью системных переменных).
+  * ''%%REFINT%%'' — принудительное обновление интерфейса (в т.ч. смена цветов, шрифтов, назначенных с помощью системных переменных). По умолчанию обновление интерфейса происходит 2 раза в секунду (каждые 500 мс). Также см. оператор [[help:service_locations|SETTIMER]].
-		По умолчанию обновление интерфейса происходит 2 раза в секунду (каждые 500 мс). Так же см. оператор ''**[[help:service_locations|SETTIMER]]**''. Также см. оператор ''**[[help:service_locations|SETTIMER]]**''.
 [[help:html|Вперёд: HTML]]

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

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

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

Различия

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

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