Информация о текущей сцене
Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о K3-файле.
Создание информации через код
Комментарий
comment <Comment>
Команда позволяет создать комментарий к текущей сцене, заданный строкой <Comment>. Длина строки не должна превышать 79 символов.
Эскиз
Со сценой может быть связан эскиз – небольшая картинка, показывающая изображение видового окна. Эскиз может быть в следующих форматах:
- Отсутствовать
- Чёрно-белый векторный эскиз
- Цветной векторный эскиз
- Полутоновый эскиз
- Фотореалистический эскиз
- Ссылка на файл внешнего эскиза
Следующие команды позволяют выполнить работу с эскизами.
picture <VPort> {yes | no}
Команда создает черно-белую векторную "картинку" по изображению на видовом окне с номером <VPort>. Ключ yes задает режим вписывания всего изображения в "картинку", в то время как ключ no предписывает включить в "картинку" только видимую на видовом окне часть изображения.
colorpicture [rend] <VPort> {yes | no}
Команда создает цветную векторную "картинку" или полутоновую "картинку", если указан ключ rend по изображению на видовом окне с номером <VPort>. Ключ yes задает режим вписывания всего изображения в "картинку", в то время как ключ no предписывает включить в "картинку" только видимую на видовом окне часть изображения.
colorpicture new [keys]
Команда создает картинку (эскиз) в новом формате, доступном, начиная с версии 7.3.
Теперь доступны следующие ключи [keys]:
format <N>— задать формат эскиза. Число<N>в пределах от 1 до 5 задаёт формат эскиза:
- 1 — чёрно-белый векторный эскиз;
- 2 — цветной векторный эскиз;
- 3 — полутоновый эскиз;
- 4 — фотореалистический эскиз;
- 5 — ссылка на файл внешнего эскиза.
currentvp— (для форматов эскизов 1—4) использовать текущее видовое окноvp1— (для форматов эскизов 1—4) использовать видовое окно №1vp2— (для форматов эскизов 1—4) использовать видовое окно №2vp3— (для форматов эскизов 1—4) использовать видовое окно №3vp4— (для форматов эскизов 1—4) использовать видовое окно №4visibleonly— (для форматов эскизов 1—4) только видимая в видовом окне часть сценыwholescene— (для форматов эскизов 1—4) вся сценаwidth <w>— (для форматов эскизов 1—4) ширина создаваемого эскиза. Число в пределах от 104 до 1920. Рекомендуется выдерживать соотношение сторон w:h как 4:3height <h>— (для форматов эскизов 1—4) высота создаваемого эскиза. Число в пределах от 88 до 1080. Рекомендуется выдерживать соотношение сторон w:h как 4:3background <color>— (для форматов эскизов 2—4) индекс цвета фона эскиза, число от 0 до 239parameter <manner>— (для формата эскизов 3) способ создания эскиза, представляет собой сумму параметров:
- 1 — отображать без невидимых линий
- 2 — отображать цветом объекта, не используя текстурные материалы
- 4 — отображать без источников света
- 8 — отображать без линий
Например, для отображения цветом объекта и без источников света нужно указать значение 2+4 или 6
pquality <pqual>— (формат эскизов 4) Баланс ‘Скорость - Качество’ при создании фотореалистического изображения, число от 0 (Скорость) до 3 (Качество)filename <FileName>— (для формата эскизов 5) имя файла внешнего файла с эскизом. Это может быть файл с расширением jpg, png, bmp или wmfkeys <value>— (для формата эскизов 5) ключ, определяющий метод поиска внешнего файла эскиза::
- 0 — имя файла задаёт реальное имя файла внешнего файла эскиза;
- 1 — полное имя внешнего файла эскиза пересчитывается в относительное имя, относительно имени K3-файла;
- 2 — от имени внешнего файла эскиза берётся только расширение, а при формировании реального имени файла эскиза берётся имя, в котором расширение «.k3» меняется на соответствующее расширение;;
- 4 — K3-папка + имя файла эскиза: у внешнего файла эскиза берётся только имя, а сам он ищется в папке, в которой находится K3-файл.
Удалить эскиз
clearpicture
Команда очищает текущую сцену от "картинки".
Интерактивное создание информации о текущей сцене
Создать комментарий к текущей сцене и эскиз можно и в диалоговом окне. Вызывается диалог из меню Установки/Текущая сцена.
Для удаления эскиза нажмите кнопку «Очистить», для создания эскиза нажмите кнопку «Создать». Появится диалоговое окно создания эскиза:
В случае использования файла внешнего эскиза диалог выглядит так:
Использование K32.DLL для доступа к информации сцены
Для доступа произвольных программ к информации о сцене, существует динамическая библиотека K32.dll.
Существуют три функции, которые по имени K3-файла name могут создать растр с эскизом сцены и с именем bmpname, а также извлечь строку комментария.
typedef int(WINAPI *CreateK3BMP)(char *name, char *bmpname);
typedef int(WINAPI *GetK3BMPComment)(char *name, char *bmpname, char *comment);
typedef int(WINAPI *GetK3Comment)(char *name, char *comment);
