Различия

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

--- help:graphics [2023/01/03 11:56]
aleks_versus
+++ help:graphics [2024/10/14 12:30] (текущий)
aleks_versus обновление 5.9.0
@@ Строка 1: / Строка 1: @@
 [[help:sound|Назад: Звук]]
 ====== Графика ======
 Возможности работы с графическими элементами в **QSP** существенно отличаются для разных версий плееров. В данном разделе будут перечислены основные возможности, реализованные в классическом плеере и **qSpider**. Внимательно читайте документацию к плееру, чтобы узнать, какие возможности он предоставляет.
@@ Строка 9: / Строка 7: @@
 ===== Список основных возможностей =====
-	* **Установка картинки фоном в окно основного описания.**\\ Чтобы установить изображение фоном в окно основного описания, воспользуйтесь системной переменнной ''**$BACKIMAGE**'':<sxh qsp>
+==== Установка картинки фоном в окно основного описания. ====
-		$backimage='image/picture.png'
-</sxh>		Подробнее об использовании системной переменной ''**$BACKIMAGE**'' можно почитать в разделе [[help:main|"Окно основного описания"]].
+Чтобы установить изображение фоном в окно основного описания, воспользуйтесь системной переменной ''%%$BACKIMAGE%%'':
-	* **Вывод изображения в отдельном окне.**\\ Чтобы вывести изображение в отдельном окне, которое называется "**Окно предпросмотра**", используйте оператор ''**VIEW**'':<sxh qsp>
-		view 'content/monster.png'
+<sxh qsp>
-</sxh>Подробнее об операторе ''**VIEW**'' можно прочитать в разделе "**Операторы для работы с графической частью**" на данной странице ниже.
+$backimage = 'image/picture.png'
-	* **Добавление иконки в пункт всплывающего меню.**\\ Чтобы добавить иконку к пункту всплывающего меню, необходимо прописать путь к фалу иконки при заполнении массива, отвечающего за формирование пунктов меню, через двоеточие после названия локации-обработчика пункта меню.<sxh qsp>
+</sxh>
-		! нет иконки
-		$usr_menu[0] = 'Взять предмет:take_item'
+Подробнее об использовании системной переменной ''%%$BACKIMAGE%%'' можно почитать в разделе [[help:main|"Окно основного описания"]].
-		! иконка задана gif-файлом
-		$usr_menu[1] = 'Положить предмет:put_item:images/put_item.gif'
+==== Вывод изображения в отдельном окне. ====
-</sxh>Подробнее о добавлении иконок к пунктам меню можно почитать в разделе [[help:menu|"Меню"]].
-	* **Добавление картинки к действиям.**\\ Чтобы добавить картинку к действию, не изменяя фактического названия действия, нужно прописать путь к изображению вторым параметром к оператору ''**ACT**''.<sxh qsp>
+Чтобы вывести изображение в отдельном окне, которое называется "**Окно предпросмотра**", используйте оператор ''%%VIEW%%'':
-		! действие в многострочной форме записи, с изображением
-		act "Сорвать арбуз с куста","img/watermelon.png":
+<sxh qsp>
-			арбуз+=1
+view 'content/monster.png'
-			*pl "Вы сорвали арбуз с куста"
+</sxh>
-		end
-</sxh>	Подробнее об операторе ''**ACT**'' можно прочитать в разделе [[help:acts|"Действия"]].
+Подробнее об операторе ''%%VIEW%%'' можно прочитать в разделе "**Операторы для работы с графической частью**" на данной странице ниже.
-	* **Добавление картинки к предмету в инвентаре.**\\ Чтобы добавить картинку к предмету в инвентере, не изменяя фактического названия предмета, нужно прописать путь к изображению вторым параметром к оператору ''**ADDOBJ**''.<sxh qsp>
-		! добавляем предмет с картинкой в конец списка
+==== Добавление иконки в пункт всплывающего меню. ====
-		addobj 'Гаечный ключ','image/wrench.png'
-</sxh>Подробнее об операторе ''**ADDOBJ**'' можно прочитать в разделе [[help:objs|"Предметы (инвентарь)"]].
+Чтобы добавить иконку к пункту всплывающего меню, необходимо прописать путь к файлу иконки при заполнении массива, отвечающего за формирование пунктов меню:
-	* **Вставка картинок в любую часть текста с помощью [[help:html|HTML]].**\\ Вы можете вставлять изображения в любую часть текста, используя HTML-тег **<img>** при включённом режиме распознавания HTML. Примеры:<sxh qsp>
-		! включаем режим распознавания HTML
+  * Для массива кортежей третьим значением в кортеже: <sxh qsp>
-		usehtml=1
+! нет иконки
-		! вывод изображения в окно основного описания:
+%usr_menu[0] = ['Взять предмет','take_item']
-		*p '<img src="images/pic_01.png">'
+! иконка задана gif-файлом
-		! вывод изображения в окне дополнительного описания:
+%usr_menu[1] = ['Положить предмет','put_item','images/put_item.gif']
-		p '<img src="icons/note_btn.ico">'
+</sxh>
-</sxh>Так же есть возможность вставлять изображения в названия действий и предметов с помощью HTML. <sxh qsp>
+  * Для массива строк — через двоеточие после названия локации-обработчика пункта меню: <sxh qsp>
-		! добавляем предмет с картинкой в названии
+! нет иконки
-		addobj '<img src="res/ico/back_arrow.png"> Назад...'
+$usr_menu[0] = 'Взять предмет:take_item'
-		! добавляем действие с картинкой в названии
+! иконка задана gif-файлом
-		act "Улыбнуться <img src=""res/emoji/smile.gif"">": goto 'smile'
+$usr_menu[1] = 'Положить предмет:put_item:images/put_item.gif'
-</sxh>**Обратите внимание!** При этом фактически изменяются названия действий и предметов. Например, при выборе действия "Назад..." в окне предметов ''**$SELOBJ**'' будет возвращать не только слово ''Назад...'',а всю строку ''<img src="res/ico/back_arrow.png"> Назад...''.\\ С помощью HTML можно вставлять изображения в модальные окошки ''**MSG**'' и ''**$INPUT**''. Следует учитывать, что при этом окошко выводится в определённом размере, и если изображение окажется по размеру больше окошка, то появятся полосы прокрутки.<sxh qsp>
+</sxh>
-		! выводим изображение в окне сообщения
-		msg '<img src="res/message/error.png">'
+Подробнее о добавлении иконок к пунктам меню можно почитать в разделе [[help:menu|"Меню"]].
-		! выводим изображение в окне ввода
-		$name = $input('Введите своё имя? <img src="res/face/elph.jpg">')
+==== Добавление картинки к действиям ====
-</sxh>Более подробно о возможностях HTML читайте в соответствующем [[help:html|разделе]].
+Чтобы добавить картинку к действию, не изменяя фактического названия действия, нужно прописать путь к изображению вторым параметром к оператору ''%%ACT%%''.
+<sxh qsp>
+! действие в многострочной форме записи, с изображением
+act "Сорвать арбуз с куста", "img/watermelon.png":
+  арбуз += 1
+  *pl "Вы сорвали арбуз с куста"
+end
+</sxh>
+Подробнее об операторе ''%%ACT%%'' можно прочитать в разделе [[help:acts|"Действия"]].
+==== Добавление картинки к предмету в инвентаре ====
+Чтобы добавить картинку к предмету в инвентаре, не изменяя фактического названия предмета, нужно прописать путь к изображению вторым параметром к оператору ''%%ADDOBJ%%''.
+<sxh qsp>
+! добавляем предмет с картинкой в конец списка
+addobj 'Гаечный ключ','image/wrench.png'
+</sxh>
+Подробнее об операторе ''%%ADDOBJ%%'' можно прочитать в разделе [[help:objs|"Предметы (инвентарь)"]].
+==== Вставка картинок в любую часть текста с помощью HTML ====
+Вы можете вставлять изображения в любую часть текста, используя HTML-тег ''%%<img>%%'' при включённом режиме распознавания HTML.
+Примеры:
+<sxh qsp>
+! включаем режим распознавания HTML
+usehtml=1
+! вывод изображения в окно основного описания:
+*p '<img src="images/pic_01.png">'
+! вывод изображения в окне дополнительного описания:
+p '<img src="icons/note_btn.ico">'
+</sxh>
+Так же есть возможность вставлять изображения в названия действий и предметов с помощью HTML.
+<sxh qsp>
+! добавляем предмет с картинкой в названии
+addobj '<img src="res/ico/back_arrow.png"> Назад...'
+! добавляем действие с картинкой в названии
+act "Улыбнуться <img src=""res/emoji/smile.gif"">": goto 'smile'
+</sxh>
+**Обратите внимание!** При этом фактически изменяются названия действий и предметов. Например, при выборе действия "Назад..." в окне предметов ''%%$SELOBJ%%'' будет возвращать не только слово "''%%Назад...%%''",а всю строку "''%%<img src="res/ico/back_arrow.png"> Назад...%%''".
+С помощью HTML можно вставлять изображения в модальные окошки ''%%MSG%%'' и ''%%$INPUT%%''. Следует учитывать, что при этом окошко выводится в определённом размере, и если изображение окажется по размеру больше окошка, то появятся полосы прокрутки.
+<sxh qsp>
+! выводим изображение в окне сообщения
+msg '<img src="res/message/error.png">'
+! выводим изображение в окне ввода
+$name = $input('Введите своё имя? <img src="res/face/elph.jpg">')
+</sxh>
+Более подробно о возможностях HTML читайте в соответствующем [[help:html|разделе]].
 ===== Операторы для работы с изображениями =====
-	* ''**VIEW**'' — выводит на экран указанное изображение. В классическом плеере изображение выводися в отдельном окошке (окно предпросмотра). Общая запись:<sxh qsp>
+  * ''%%VIEW%%'' — выводит на экран указанное изображение. В классическом плеере изображение выводися в отдельном окошке (окно предпросмотра). Общая запись: <sxh qsp>
-		VIEW [$путь к графическому файлу]
+VIEW [$путь к графическому файлу]
-</sxh>		, где **[$путь к графическому файлу]** — путь к файлу картинки. Если параметр **[$путь к графическому файлу]** отсутствует, или задан как ''**""**'' (пустая строка), окно предпросмотра закрывается.\\	Примеры:<sxh qsp>
+</sxh> , где ''%%[$путь к графическому файлу]%%'' — путь к файлу картинки. Если параметр ''%%[$путь к графическому файлу]%%'' отсутствует, или задан как ''%%""%%'' (пустая строка), окно предпросмотра закрывается. Примеры: <sxh qsp>
-		! выводим изображение в окне предпросмотра
+! выводим изображение в окне предпросмотра
-		view 'content/monster.png'
+view 'content/monster.png'
-		! закрываем окно предпросмотра
+! закрываем окно предпросмотра
-		view ''
+view ''
-		! закрыть окно предпросмотра можно и так
+! закрыть окно предпросмотра можно и так
-		view
+view
 </sxh>
 ===== Пути к графическим файлам =====
-Пути к графическим файлам указываются относительно файла игры. Например, если файл игры лежит по адресу "''D:\QSP\game\game.qsp''", а картинка - по адресу "''D:\QSP\game\content\picture.jpg''", то путь нужно указывать, как "''content/picture.jpg''".
+Пути к графическим файлам указываются относительно файла игры. Например, если файл игры лежит по адресу "''%%D:\QSP\game\game.qsp%%''", а картинка - по адресу "''%%D:\QSP\game\content\picture.jpg%%''", то путь нужно указывать, как "''%%content/picture.jpg%%''".
 Это не зависит от того, где именно вы хотите вывести изображение:
@@ Строка 80: / Строка 137: @@
 ===== Поддерживаемые форматы изображений =====
-	* Классический плеер поддерживает большинство распространнных форматов: ''.jpg'', ''.png'', ''.bmp'', ''.gif'', ''.ico''.
+  * Классический плеер поддерживает большинство распространнных форматов: ''%%.jpg%%'', ''%%.png%%'', ''%%.bmp%%'', ''%%.gif%%'', ''%%.ico%%''.
-	* **qSpider** поддерживает все форматы изображений, которые поддерживает современный браузер, в т.ч. и "svg".
+  * **qSpider** поддерживает все форматы изображений, которые поддерживает современный браузер, в т.ч. и "''%%svg%%''".
 [[help:interface|Вперёд: Настройки интерфейса]]

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

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

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

Различия

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

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