Инструменты и Скрипты

Boxshot предоставляет набор инструментов, и вы можете использовать их и из скриптов. Нажмите на ссылку ниже, чтобы перейти к коду:

• Подогнать под вид
• Поставить на пол
• Центрировать камеру по выделению
• Сгруппировать выделение
• Выравнивание
• Распределение
• Стопка
• Шаг и повтор
• Копировать материалы
• Преобразовать во встроенную модель

Подогнать под вид

var params = {
	padding : 0.1,
	keepAspect : false
};
tools.fitToView(params);

Поставить на пол

tools.putOnTheFloor();

Центрировать камеру по выделению

tools.centerCameraOnSelection();

Сгруппировать выделение

tools.groupSelection();

Инструмент “Выравнивание”

var params = {
	alignment: 1,
	keyObject: 0,
	actionX: 1,
	actionY: 0,
	actionZ: 0,
};
tools.align(scene.selection, params);

Вы передаете индексы во все параметры, и эти индексы должны соответствовать вариантам во выпадающем списке, которые вы видите в окне инструмента. Для выравнивания это:

• 0 — выравнивать по выделению;
• 1 — выравнивать по ключевому объекту;
• 2 — выравнивать по сцене.

Для действий доступны варианты:

• 0 — оставить как есть;
• 1 — выровнять по минимумам;
• 2 — выровнять по центрам;
• 3 — выровнять по максимумам.

Индекс ключевого объекта должен быть корректным индексом внутри списка объектов, переданного первым параметром методу align().

Инструмент “Распределение”

var params = {
	distribute: 3,
	axis: 0,
	alignment: 2,
	distance: 3
};
tools.distribute(scene.selection, params);

Вы передаете индексы в большинстве параметров, и эти индексы должны соответствовать вариантам во выпадающем списке, которые вы видите в окне инструмента. Для distribute это:

• 0 — распределить минимумы;
• 1 — распределить центры;
• 2 — распределить максимумы;
• 3 — распределить свободное пространство.

Для axis все очевидно:

• 0 — ось X;
• 1 — ось Y;
• 2 — ось Z.

Наконец, для alignment это:

• 0 — распределять в пределах выделения;
• 1 — распределять в пределах сцены;
• 2 — распределять, используя заданное расстояние.

Инструмент “Стопка”

tools.stack(scene.selection, {});

Он создает стопку из 3 элементов для текущего выделенного объекта — если объект поддерживает создание стопки. Первый параметр — это узел (или массив узлов), а второй параметр — словарь свойств стопки:

• repeats
• seed
• twistStep
• twistDisorder
• offsetX
• offsetY
• offsetDisorder

Все свойства работают точно так же, как в интерфейсе. Вот более подробный пример:

var params = {
	repeats: 5,
	twistStep: 2,
	offsetDisorder: 0.1
};
tools.stack(scene.selection, params);

Шаг и повтор

tools.stepAndRepeat(scene.selection, {});

Инструмент клонирует выбранный объект с настройками по умолчанию. При желании вы можете изменить настройки, передав их в словаре вторым параметром. Вот список свойств:

• repeatsLeft
• repeatsRight
• repeatsFront
• repeatsBack
• repeatsUp
• repeatsDown
• offsetX
• offsetY
• offsetZ

Все свойства работают точно так же, как в интерфейсе. Вот более подробный пример:

var params = {
	repeatLeft: 0,
	repeatRight: 0,
	repeatsFront: 0,
	repeatsBack: 1,
	repeatsUp: 2,
	repeatsDown: 1,
	offsetX: 0,
	offsetY: 0,
	offsetZ: 1
};
tools.stepAndRepeat(scene.selection, params);

Копировать материалы

var src = scene.selection[0]
var mtls = ["Front", "Back"];
var targets = [scene.selection[1], scene.selection[2]]
tools.copyMaterials(src, mtls, targets);

Первый параметр — исходный узел, затем идет массив имен материалов для копирования, и в конце — массив целевых узлов, к которым нужно применить материалы.

Преобразовать во встроенную модель

var src = scene.selection[0]
tools.convertToEmbeddedModel(src);

Больше Информации о Скриптах

• Обзор — общая информация об использовании скриптов в Boxshot.
• Управление объектами — обход сцены и работа с ее элементами;
• Специальные объекты — камера, материалы, освещение итп;
• Объекты сцены — настройка встроенных объектов;
• Инструменты — использование инструментов из скриптов;
• Командная строка — запуск скриптов Boxshot из командной строки.