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

Эта страница только для чтения. Вы можете посмотреть исходный текст, но не можете его изменить. Сообщите администратору, если считаете, что это неправильно.

[[help:graphics|Назад: Графика]]

====== Настройки интерфейса ======


Возможности работы с интерфейсом отличаются для различных версий плееров. В данном разделе будет рассказано об основных возможностях, реализованных в классическом плеере и **qSpider**.

===== Функция кодирования цвета =====

Прежде всего следует ознакомиться с функцией кодирования цвета ''**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>Прозрачность (альфа-канал) может не работать в классическом плеере.


===== Общие настройки отображения текста =====

Для того, чтобы задавать общие настройки отображения текста в QSP используется ряд системных переменных.

==== Переменные, задающие цвета ====

	* ''**BCOLOR**'' —  содержит цвет текущего фона. Если равна 0, то используется цвет, заданный в настройках программы. Примеры:<sxh qsp>
		! чёрный цвет фона
		bcolor=-16777216
		! красный цвет фона
		bcolor=-16776961
		! белый цвет фона
		bcolor=-1
</sxh>		Поскольку цвет фона кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
		! задаём цвет фона через функцию rgb(red,green,blue)
		! фон синего цвета
		bcolor=rgb(0,0,255)
		! фон жёлтого цвета
		bcolor=rgb(255,255,0)
		! фон оранжевого цвета
		bcolor=rgb(255,130,0)
		! фон голубого цвета
		bcolor=rgb(0,255,255)
		! фон малинового цвета
		bcolor=rgb(255,0,255)
</sxh>
	*''**FCOLOR**'' —  содержит цвет используемого в данный момент шрифта. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет всего текста игры, кроме гиперссылок и текста, цвет которого переназначен через HTML. Пример:<sxh qsp>
		! чёрный цвет текста
		fcolor=-16777216
		! красный цвет текста
		fcolor=-16776961
		! белый цвет текста
		fcolor=-1
</sxh>		Поскольку цвет шрифта кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
		! задаём цвет текста через функцию rgb(red,green,blue)
		! текст чёрного цвета
		fcolor=rgb(0,0,0)
		! текст белого цвета
		fcolor=rgb(255,255,255)
		! текст красного цвета
		fcolor=rgb(255,0,0)
		! текст зелёного цвета
		fcolor=rgb(0,255,0)
</sxh>
	* ''**LCOLOR**'' —  содержит текущий цвет шрифта гиперссылок. Если равна 0, то используется цвет, заданный в настройках программы. Изменение значения переменной меняет цвет текста всех гиперссылок, кроме тех, цвет которых переназначен через HTML. Пример:<sxh qsp>
		! чёрный цвет гиперссылок
		lcolor=-16777216
		! красный цвет гиперссылок
		lcolor=-16776961
		! белый цвет гиперссылок
		lcolor=-1
</sxh>		Поскольку цвет в QSP кодируется специальным числом, а вычислять это число самостоятельно неудобно, следует пользоваться функцией ''**RGB**'', которой в качестве аргументов передаются три составляющие цвета:<sxh qsp>
		! задаём цвет  гиперссылок через функцию rgb(red,green,blue)
		!  гиперссылки синего цвета
		lcolor=rgb(0,0,255)
		! гиперссылки жёлтого цвета
		lcolor=rgb(255,255,0)
		! гиперссылки оранжевого цвета
		lcolor=rgb(255,130,0)
		! гиперссылки голубого цвета
		lcolor=rgb(0,255,255)
		! гиперссылки малинового цвета
		lcolor=rgb(255,0,255)
</sxh>

==== Переменные, задающие шрифт ====

	*''**FSIZE**'' —  содержит размер используемого в данный момент шрифта. Если равна 0, то используется размер, заданный в настройках программы. Относительно данного значения в HTML-режиме вычисляются размеры шрифтов тега ''[<font>]''. Пример:<sxh qsp>
		fsize=18
</sxh>		Размер шрифта устанавливается для всего текста в игре, кроме текста, размер которого переназначен через HTML.
	* ''**$FNAME**'' —  содержит название используемого в данный момент шрифта во всей игре. Если равна ''**""**'' (пустая строка), то используется шрифт, заданный в настройках программы.\\ Пример:<sxh qsp>
		! устанавливаем для всей игры шрифт Courier New
		$fname="Courier New"
</sxh>
===== Настройки отображения окон =====

	* ''**SHOWSTAT** [#выражение]'' - если значение выражения отлично от 0, то показывает **Окно дополнительного описания**, иначе скрывает его.		Пример:<sxh qsp>
		showstat 0 & ! скрываем окно дополнительного описания
		showstat 1 & ! окно дополнительного описания снова отображается
</sxh>		Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' с соответствующими значениями:<sxh qsp>
		on, off = 1, 0
		showstat on & ! включаем окно дополнительного описания
		showstat off & ! выключаем окно дополнительного описания
</sxh>
	* ''**SHOWACTS** [#выражение]'' - если значение выражения отлично от 0, то показывает **Список действий**, иначе скрывает его.\\ Пример:<sxh qsp>
		showacts 0 & ! скрываем Окно действий
		showacts 1 & ! выводим Окно действий на экран
</sxh>Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' с соответствующими значениями:<sxh qsp>
		on, off = 1, 0
		showacts on & ! включаем окно дополнительного описания
		showacts off & ! выключаем окно дополнительного описания
</sxh>
	* ''**SHOWOBJS** [#выражение]'' - если значение выражения отлично от 0, то показывает **Список предметов**, иначе скрывает его.\\ Пример:<sxh qsp>
		showobjs 0 & ! скрываем Окно предметов
		showobjs 1 & ! выводим Окно предметов на экран
</sxh>Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' с соответствующими значениями:<sxh qsp>
		on, off = 1, 0
		showobjs on & ! включаем окно дополнительного описания
		showobjs off & ! выключаем окно дополнительного описания
</sxh>
	* ''**SHOWINPUT**'' — управляет отображением строки ввода на экране. Общая запись:<sxh qsp>
		SHOWINPUT [#выражение]
</sxh>		, где ''[#выражение]'' — это число. Обычно используются значения 0 и 1. Если значение выражения ''[#выражение]'' отлично от нуля, строка ввода отображается. Если значение выражения ''[#выражение]'' равно нулю, строка ввода скрыта. Примеры:<sxh qsp>
		showinput 1 & ! показывает строку ввода
		showinput 0 & ! скрывает строку ввода
</sxh>		Для удобства чтения кода можно заранее определить переменные ''**on**'' и ''**off**'' и использовать их:<sxh qsp>
		on, off = 1, 0
		showinput on & ! показывает строку ввода
		showinput off & ! скрывает строку ввода
</sxh>

===== Обновление настроек интерфейса =====

	* ''**REFINT**'' — принудительное обновление интерфейса (в т.ч. смена цветов, шрифтов, назначенных с помощью системных переменных).
		По умолчанию обновление интерфейса происходит 2 раза в секунду (каждые 500 мс). Так же см. оператор ''**[[help:service_locations|SETTIMER]]**''. Также см. оператор ''**[[help:service_locations|SETTIMER]]**''.

[[help:html|Вперёд: HTML]]
Документация QSPСайтФорум

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

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

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

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