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

Макро | Файлы | Новая сцена | Открыть файл | Открыть последний | Добавление файла в сцену | Просмотр содержимого диска | Выход из К3 | Сохранение сцены | Записать модель в формате других систем | Записать изображение в формате других систем | Загрузить модель из других систем | Информация о текущей сцене | Функции файловой системы | Печать

---

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

Информация о сцене (комментарий и эскиз) показываются в диалоге открытия или добавления файла. Эта информация также используется внешними программами для отображения информации о 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) использовать видовое окно №1
• vp2 — (для форматов эскизов 1—4) использовать видовое окно №2
• vp3 — (для форматов эскизов 1—4) использовать видовое окно №3
• vp4 — (для форматов эскизов 1—4) использовать видовое окно №4
• visibleonly — (для форматов эскизов 1—4) только видимая в видовом окне часть сцены
• wholescene — (для форматов эскизов 1—4) вся сцена
• width <w> — (для форматов эскизов 1—4) ширина создаваемого эскиза. Число в пределах от 104 до 1920. Рекомендуется выдерживать соотношение сторон w:h как 4:3
• height <h> — (для форматов эскизов 1—4) высота создаваемого эскиза. Число в пределах от 88 до 1080. Рекомендуется выдерживать соотношение сторон w:h как 4:3
• background <color> — (для форматов эскизов 2—4) индекс цвета фона эскиза, число от 0 до 239
• parameter <manner> — (для формата эскизов 3) способ создания эскиза, представляет собой сумму параметров:

• 1 — отображать без невидимых линий
• 2 — отображать цветом объекта, не используя текстурные материалы
• 4 — отображать без источников света
• 8 — отображать без линий

Например, для отображения цветом объекта и без источников света нужно указать значение 2+4 или 6

• pquality <pqual> — (формат эскизов 4) Баланс ‘Скорость — Качество’ при создании фотореалистического изображения, число от 0 (Скорость) до 3 (Качество)
• filename <FileName> — (для формата эскизов 5) имя файла внешнего файла с эскизом. Это может быть файл с расширением jpg, png, bmp или wmf
• keys <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);

---

Макро | Файлы | Новая сцена | Открыть файл | Открыть последний | Добавление файла в сцену | Просмотр содержимого диска | Выход из К3 | Сохранение сцены | Записать модель в формате других систем | Записать изображение в формате других систем | Загрузить модель из других систем | Информация о текущей сцене | Функции файловой системы | Печать