Информация о текущей сцене - История изменений

Aleksandro: Замена текста — « » на « »

2024-06-27T14:09:16Z

Замена текста — « » на « »

← Предыдущая версия		Версия от 17:09, 27 июня 2024
Строка 10:		Строка 10:
	<code>'''comment''' ''<Comment>''</code>		<code>'''comment''' ''<Comment>''</code>

	Команда позволяет создать комментарий к текущей сцене, заданный строкой <code>''<Comment>''</code>. Длина строки не должна превышать 79 символов.		Команда позволяет создать комментарий к текущей сцене, заданный строкой <code>''<Comment>''</code>. Длина строки не должна превышать 79 символов.

	===Эскиз===		===Эскиз===
Строка 27:		Строка 27:
	<code>'''picture''' ''<VPort>'' {yes \| no}</code>		<code>'''picture''' ''<VPort>'' {yes \| no}</code>

	Команда создает черно-белую векторную "картинку" по изображению на видовом окне с номером <code>''<VPort></code>.'' Ключ <code>yes</code> задает режим вписывания всего изображения в "картинку", в то время как ключ <code>no</code> предписывает включить в "картинку" только видимую на видовом окне часть изображения.		Команда создает черно-белую векторную "картинку" по изображению на видовом окне с номером <code>''<VPort></code>.'' Ключ <code>yes</code> задает режим вписывания всего изображения в "картинку", в то время как ключ <code>no</code> предписывает включить в "картинку" только видимую на видовом окне часть изображения.


Строка 35:		Строка 35:


	<code>'''colorpicture''' new<nowiki> [</nowiki>keys]</code>		<code>'''colorpicture''' new<nowiki> [</nowiki>keys]</code>

	Команда создает картинку (эскиз) в новом формате, доступном, начиная с версии 7.3.		Команда создает картинку (эскиз) в новом формате, доступном, начиная с версии 7.3.
Строка 97:		Строка 97:

	<code>typedef int(WINAPI CreateK3BMP)(char name, char *bmpname);</code>		<code>typedef int(WINAPI CreateK3BMP)(char name, char *bmpname);</code>

	<code>typedef int(WINAPI GetK3BMPComment)(char name, char bmpname, char comment);</code>		<code>typedef int(WINAPI GetK3BMPComment)(char name, char bmpname, char comment);</code>

	<code>typedef int(WINAPI GetK3Comment)(char name, char *comment);</code>		<code>typedef int(WINAPI GetK3Comment)(char name, char *comment);</code>
	----		----
	{{Работа_с_файлами}}		{{Работа_с_файлами}}

Aleksandro: /* Интерактивное создание информации о текущей сцене */

2024-04-03T14:02:05Z

Интерактивное создание информации о текущей сцене

← Предыдущая версия		Версия от 17:02, 3 апреля 2024
Строка 82:		Строка 82:
	[[Файл:Karteto-2.png\|thumb\|center\|Текущая сцена]]		[[Файл:Karteto-2.png\|thumb\|center\|Текущая сцена]]

	Для удаления эскиза нажмите кнопку '''~~«Очистить»~~''', для создания эскиза нажмите кнопку ~~«Создать»~~. Появится диалоговое окно создания эскиза:		Для удаления эскиза нажмите кнопку '''Очистить''', для создания эскиза нажмите кнопку '''Создать'''. Появится диалоговое окно создания эскиза:

	[[Файл:Karteto-3.png\|thumb\|center\|Создание эскиза]]		[[Файл:Karteto-3.png\|thumb\|center\|Создание эскиза]]

Aleksandro: /* Удалить эскиз */

2024-04-03T13:59:22Z

Удалить эскиз

Aleksandro в 12:59, 1 сентября 2021

2021-09-01T12:59:02Z

← Предыдущая версия		Версия от 15:59, 1 сентября 2021
Строка 1:		Строка 1:
	[[Категория:Работа с файлами\|И]]		[[Категория:Работа с файлами\|И]]
			{{Работа_с_файлами}}
			----
	[[Файл:Karteto-2.png\|thumb\|right\|265px\|Информация о текущей сцене]]		[[Файл:Karteto-2.png\|thumb\|right\|265px\|Информация о текущей сцене]]
	Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.		Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.
Строка 99:		Строка 101:

	<code>typedef int(WINAPI GetK3Comment)(char name, char *comment);</code>		<code>typedef int(WINAPI GetK3Comment)(char name, char *comment);</code>
			----
			{{Работа_с_файлами}}

Aleksandro в 13:06, 29 июля 2021

2021-07-29T13:06:52Z

← Предыдущая версия		Версия от 16:06, 29 июля 2021
Строка 1:		Строка 1:
	[[Категория:Работа с файлами\|И]]		[[Категория:Работа с файлами\|И]]
	''Эта статья — об информации о текущей сцене в макропрограммировании. Об информации о текущей сцене в интерфейсе '''К3''' читайте [[Информация о текущей сцене (К3)\|здесь]]''
	[[Файл:Karteto-2.png\|thumb\|right\|265px\|Информация о текущей сцене]]		[[Файл:Karteto-2.png\|thumb\|right\|265px\|Информация о текущей сцене]]
	Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.		Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.

Aleksandro: Новая страница: «И ''Эта статья — об информации о текущей сцене в макропрогр...»

2021-07-29T13:06:27Z

Новая страница: «И ''Эта статья — об информации о текущей сцене в макропрогр...»

Новая страница

[[Категория:Работа с файлами|И]]
''Эта статья — об информации о текущей сцене в макропрограммировании. Об информации о текущей сцене в интерфейсе '''К3''' читайте [[Информация о текущей сцене (К3)|здесь]]''
[[Файл:Karteto-2.png|thumb|right|265px|Информация о текущей сцене]]
Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.

==Создание информации через код==
===Комментарий===

<code>'''comment''' ''<Comment>''</code>

Команда позволяет создать комментарий к текущей сцене, заданный строкой <code>''<Comment>''</code>. Длина строки не должна превышать 79 символов.

===Эскиз===

Со сценой может быть связан эскиз – небольшая картинка, показывающая изображение видового окна. Эскиз может быть в следующих форматах:
* Отсутствовать
* Чёрно-белый векторный эскиз
* Цветной векторный эскиз
* Полутоновый эскиз
* Фотореалистический эскиз
* Ссылка на файл внешнего эскиза

Следующие команды позволяют выполнить работу с эскизами.

<code>'''picture''' ''<VPort>'' {yes | no}</code>

Команда создает черно-белую векторную "картинку" по изображению на видовом окне с номером <code>''<VPort></code>.'' Ключ <code>yes</code> задает режим вписывания всего изображения в "картинку", в то время как ключ <code>no</code> предписывает включить в "картинку" только видимую на видовом окне часть изображения.

<code>'''colorpicture'''<nowiki> [rend] </nowiki>''<VPort>'' {yes | no}</code>

Команда создает цветную векторную "картинку" или полутоновую "картинку", если указан ключ <code>rend</code> по изображению на видовом окне с номером <code>''<VPort>''</code>. Ключ yes задает режим вписывания всего изображения в "картинку", в то время как ключ no предписывает включить в "картинку" только видимую на видовом окне часть изображения.

<code>'''colorpicture''' new<nowiki> [</nowiki>keys]</code>

Команда создает картинку (эскиз) в новом формате, доступном, начиная с версии 7.3.

Теперь доступны следующие ключи <code>[keys]</code>:

* <code>format ''<N>''</code> — задать формат эскиза. Число <code>''<N>''</code> в пределах от 1 до 5 задаёт формат эскиза:
:* 1 — чёрно-белый векторный эскиз;
:* 2 — цветной векторный эскиз;
:* 3 — полутоновый эскиз;
:* 4 — фотореалистический эскиз;
:* 5 — ссылка на файл внешнего эскиза.
* <code>currentvp</code> — (для форматов эскизов ''1—4'') использовать текущее видовое окно
* <code>vp1</code> — (для форматов эскизов ''1—4'') использовать видовое окно №1
* <code>vp2</code> — (для форматов эскизов ''1—4'') использовать видовое окно №2
* <code>vp3</code> — (для форматов эскизов ''1—4'') использовать видовое окно №3
* <code>vp4</code> — (для форматов эскизов ''1—4'') использовать видовое окно №4
* <code>visibleonly</code> — (для форматов эскизов ''1—4'') только видимая в видовом окне часть сцены
* <code>wholescene</code> — (для форматов эскизов ''1—4'') вся сцена
* <code>width ''<w>''</code> — (для форматов эскизов ''1—4'') ширина создаваемого эскиза. Число в пределах от 104 до 1920. Рекомендуется выдерживать соотношение сторон w:h как 4:3
* <code>height ''<h>''</code> — (для форматов эскизов ''1—4'') высота создаваемого эскиза. Число в пределах от 88 до 1080. Рекомендуется выдерживать соотношение сторон w:h как 4:3
* <code>background ''<color>''</code> — (для форматов эскизов ''2—4'') индекс цвета фона эскиза, число от 0 до 239
* <code>parameter ''<manner>''</code> — (для формата эскизов ''3'') способ создания эскиза, представляет собой сумму параметров:
:* 1 — отображать без невидимых линий
:* 2 — отображать цветом объекта, не используя текстурные материалы
:* 4 — отображать без источников света
:* 8 — отображать без линий
Например, для отображения цветом объекта и без источников света нужно указать значение 2+4 или 6
* <code>pquality ''<pqual>''</code> — (формат эскизов ''4'') Баланс ‘Скорость - Качество’ при создании фотореалистического изображения, число от 0 (Скорость) до 3 (Качество)
* <code>filename ''<FileName>''</code> — (для формата эскизов ''5'') имя файла внешнего файла с эскизом. Это может быть файл с расширением '''jpg, png, bmp''' или '''wmf'''
* <code>keys ''<value>''</code> — (для формата эскизов ''5'') ключ, определяющий метод поиска внешнего файла эскиза::
:* 0 — имя файла задаёт реальное имя файла внешнего файла эскиза;
:* 1 — полное имя внешнего файла эскиза пересчитывается в относительное имя, относительно имени K3-файла;
:* 2 — от имени внешнего файла эскиза берётся только расширение, а при формировании реального имени файла эскиза берётся имя, в котором расширение «.'''k3»''' меняется на соответствующее расширение;;
:* 4 — K3-папка + имя файла эскиза: у внешнего файла эскиза берётся только имя, а сам он ищется в папке, в которой находится K3-файл.

===Удалить эскиз===
<code>'''clearpicture'''</code>

Команда очищает текущую сцену от "картинки".

== Интерактивное создание информации о текущей сцене ==

Создать комментарий к текущей сцене и эскиз можно и в диалоговом окне. Вызывается диалог из меню '''Установки/Текущая сцена'''.

[[Файл:Karteto-2.png|thumb|center|Текущая сцена]]

Для удаления эскиза нажмите кнопку '''«Очистить»''', для создания эскиза нажмите кнопку «Создать». Появится диалоговое окно создания эскиза:

[[Файл:Karteto-3.png|thumb|center|Создание эскиза]]

В случае использования файла внешнего эскиза диалог выглядит так:

[[Файл:Karteto-3a.png|thumb|center|Использование внешнего файла]]

== Использование K32.DLL для доступа к информации сцены ==

Для доступа произвольных программ к информации о сцене, существует динамическая библиотека '''<nowiki>K32.dl</nowiki>l.'''

Существуют три функции, которые по имени K3-файла <code>name</code> могут создать растр с эскизом сцены и с именем <code>bmpname</code>, а также извлечь строку комментария.

<code>typedef int(WINAPI *CreateK3BMP)(char *name, char *bmpname);</code>

<code>typedef int(WINAPI *GetK3BMPComment)(char *name, char *bmpname, char *comment);</code>

<code>typedef int(WINAPI *GetK3Comment)(char *name, char *comment);</code>

← Предыдущая версия		Версия от 16:59, 3 апреля 2024
Строка 42:		Строка 42:

	* <code>format ''<N>''</code> — задать формат эскиза. Число <code>''<N>''</code> в пределах от 1 до 5 задаёт формат эскиза:		* <code>format ''<N>''</code> — задать формат эскиза. Число <code>''<N>''</code> в пределах от 1 до 5 задаёт формат эскиза:
	:* 1 — чёрно-белый векторный эскиз;		:* '''1''' — чёрно-белый векторный эскиз;
	:* 2 — цветной векторный эскиз;		:* '''2''' — цветной векторный эскиз;
	:* 3 — полутоновый эскиз;		:* '''3''' — полутоновый эскиз;
	:* 4 — фотореалистический эскиз;		:* '''4''' — фотореалистический эскиз;
	:* 5 — ссылка на файл внешнего эскиза.		:* '''5''' — ссылка на файл внешнего эскиза.
	* <code>currentvp</code> — (для форматов эскизов ''1—4'') использовать текущее видовое окно		* <code>currentvp</code> — (для форматов эскизов ''1—4'') использовать текущее видовое окно
	* <code>vp1</code> — (для форматов эскизов ''1—4'') использовать видовое окно №1		* <code>vp1</code> — (для форматов эскизов ''1—4'') использовать видовое окно №1
Строка 54:		Строка 54:
	* <code>visibleonly</code> — (для форматов эскизов ''1—4'') только видимая в видовом окне часть сцены		* <code>visibleonly</code> — (для форматов эскизов ''1—4'') только видимая в видовом окне часть сцены
	* <code>wholescene</code> — (для форматов эскизов ''1—4'') вся сцена		* <code>wholescene</code> — (для форматов эскизов ''1—4'') вся сцена
	* <code>width ''<w>''</code> — (для форматов эскизов ''1—4'') ширина создаваемого эскиза. Число в пределах от 104 до 1920. Рекомендуется выдерживать соотношение сторон w:h как 4:3		* <code>width ''<w>''</code> — (для форматов эскизов ''1—4'') ширина создаваемого эскиза. Число в пределах от '''104''' до '''1920'''. Рекомендуется выдерживать соотношение сторон w:h как 4:3
	* <code>height ''<h>''</code> — (для форматов эскизов ''1—4'') высота создаваемого эскиза. Число в пределах от 88 до 1080. Рекомендуется выдерживать соотношение сторон w:h как 4:3		* <code>height ''<h>''</code> — (для форматов эскизов ''1—4'') высота создаваемого эскиза. Число в пределах от '''88''' до '''1080'''. Рекомендуется выдерживать соотношение сторон w:h как 4:3
	* <code>background ''<color>''</code> — (для форматов эскизов ''2—4'') индекс цвета фона эскиза, число от 0 до 239		* <code>background ''<color>''</code> — (для форматов эскизов ''2—4'') индекс цвета фона эскиза, число от '''0''' до '''239'''
	* <code>parameter ''<manner>''</code> — (для формата эскизов ''3'') способ создания эскиза, представляет собой сумму параметров:		* <code>parameter ''<manner>''</code> — (для формата эскизов ''3'') способ создания эскиза, представляет собой сумму параметров:
	:* 1 — отображать без невидимых линий		:* '''1''' — отображать без невидимых линий
	:* 2 — отображать цветом объекта, не используя текстурные материалы		:* '''2''' — отображать цветом объекта, не используя текстурные материалы
	:* 4 — отображать без источников света		:* '''4''' — отображать без источников света
	:* 8 — отображать без линий		:* '''8''' — отображать без линий
	Например, для отображения цветом объекта и без источников света нужно указать значение 2+4 или 6		Например, для отображения цветом объекта и без источников света нужно указать значение 2+4 или 6
	* <code>pquality ''<pqual>''</code> — (формат эскизов ''4'') Баланс ‘Скорость - Качество’ при создании фотореалистического изображения, число от 0 (Скорость) до 3 (Качество)		* <code>pquality ''<pqual>''</code> — (формат эскизов ''4'') Баланс '''‘Скорость — Качество’''' при создании фотореалистического изображения, число от '''0''' (Скорость) до '''3''' (Качество)
	* <code>filename ''<FileName>''</code> — (для формата эскизов ''5'') имя файла внешнего файла с эскизом. Это может быть файл с расширением '''jpg, png, bmp''' или '''wmf'''		* <code>filename ''<FileName>''</code> — (для формата эскизов ''5'') имя файла внешнего файла с эскизом. Это может быть файл с расширением '''jpg, png, bmp''' или '''wmf'''
	* <code>keys ''<value>''</code> — (для формата эскизов ''5'') ключ, определяющий метод поиска внешнего файла эскиза::		* <code>keys ''<value>''</code> — (для формата эскизов ''5'') ключ, определяющий метод поиска внешнего файла эскиза:
	:* 0 — имя файла задаёт реальное имя файла внешнего файла эскиза;		:* '''0''' — имя файла задаёт реальное имя файла внешнего файла эскиза;
	:* 1 — полное имя внешнего файла эскиза пересчитывается в относительное имя, относительно имени K3-файла;		:* '''1''' — полное имя внешнего файла эскиза пересчитывается в относительное имя, относительно имени K3-файла;
	:* 2 — от имени внешнего файла эскиза берётся только расширение, а при формировании реального имени файла эскиза берётся имя, в котором расширение «.'''k3»''' меняется на соответствующее расширение;;		:* '''2''' — от имени внешнего файла эскиза берётся только расширение, а при формировании реального имени файла эскиза берётся имя, в котором расширение «.'''k3»''' меняется на соответствующее расширение;;
	:* 4 — K3-папка + имя файла эскиза: у внешнего файла эскиза берётся только имя, а сам он ищется в папке, в которой находится K3-файл.		:* '''4''' — K3-папка + имя файла эскиза: у внешнего файла эскиза берётся только имя, а сам он ищется в папке, в которой находится K3-файл.

	===Удалить эскиз===		===Удалить эскиз===
	<code>'''clearpicture'''</code>		<code>'''clearpicture'''</code>

	Команда очищает текущую сцену от ~~"картинки"~~.		Команда очищает текущую сцену от «картинки».

	== Интерактивное создание информации о текущей сцене ==		== Интерактивное создание информации о текущей сцене ==