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

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