Скрипты Python в Blender: автоматизация рутинных операций и создание параметрических моделей

Расширенные примеры скриптов для Blender

Пример 1: Параметрическая лестница с перилами

Скрипт создаёт лестницу из ступеней, автоматически расставляя их с заданным шагом и высотой, и добавляет перила из трубок.

import bpy
import math

def create_stairs(steps=10, step_width=0.3, step_height=0.2, step_depth=0.4, rail_height=1):
    bpy.ops.object.select_all(action='SELECT')
    bpy.ops.object.delete(use_global=False)
    
    for i in range(steps):
        # Ступень
        bpy.ops.mesh.primitive_cube_add(size=1, location=(i*step_depth, 0, i*step_height))
        cube = bpy.context.active_object
        cube.scale = (step_depth/2, step_width/2, step_height/2)
        # Применяем масштаб, чтобы дальше работать с правильными размерами
        bpy.ops.object.transform_apply(scale=True)
    
    # Перила: две трубы по бокам
    for side in [-1, 1]:
        # Стойки
        for i in range(steps):
            bpy.ops.mesh.primitive_cylinder_add(radius=0.02, depth=rail_height, location=(i*step_depth, side*step_width/1.8, i*step_height + rail_height/2))
        # Перила (поручень) – цилиндр, согнутый не будем, просто прямая труба
        bpy.ops.mesh.primitive_cylinder_add(radius=0.03, depth=steps*step_depth, location=((steps-1)*step_depth/2, side*step_width/1.8, steps*step_height))
        railing = bpy.context.active_object
        railing.rotation_euler.x = math.pi/2

create_stairs()

Результат: в сцене появляется лестница из 10 ступеней и перила. Объекты можно дополнительно модифицировать.

Пояснение:

• Цилиндры для стоек создаются в каждой точке ступени, высота rail_height.
• Поручень – один длинный цилиндр, повёрнутый на 90 градусов, чтобы лежал вдоль лестницы.
• Применение масштаба (transform_apply) необходимо, чтобы координаты вершин соответствовали визуальному размеру (иначе при повороте поручня масштаб исказится).

Пример 2: Пакетный рендер с разными настройками

Скрипт автоматически меняет камеру, фон или материалы и последовательно рендерит изображения в папку.

import bpy
import os

def batch_render(output_dir, camera_list, material_list):
    for cam_name in camera_list:
        # Устанавливаем активную камеру
        cam = bpy.data.objects[cam_name]
        bpy.context.scene.camera = cam
        
        for mat_name in material_list:
            # Назначаем материал выделенному объекту (например, 'Cube')
            obj = bpy.data.objects['Cube']
            mat = bpy.data.materials.get(mat_name)
            if mat:
                obj.data.materials[0] = mat
            else:
                print(f'Материал {mat_name} не найден')
            
            # Настройки рендера
            bpy.context.scene.render.filepath = os.path.join(output_dir, f'{cam_name}_{mat_name}.png')
            bpy.ops.render.render(write_still=True)

batch_render('C:/renders', ['Camera.001', 'Camera.002'], ['Red', 'Blue'])

Результат: в папке renders появятся файлы: Camera.001_Red.png, Camera.001_Blue.png, Camera.002_Red.png, Camera.002_Blue.png.

Пояснение:

• Скрипт перебирает все комбинации камер и материалов из списков.
• Для каждого сочетания устанавливает камеру, меняет материал на объекте 'Cube', задаёт путь и запускает рендер.
• Обратите внимание, что материал должен быть заранее создан в файле.

Пример 3: Очистка и оптимизация меша

Скрипт удаляет двойные вершины, неиспользуемые рёбра и пересчитывает нормали для всех выбранных объектов.

import bpy

def clean_mesh_objects(obj_list):
    for obj in obj_list:
        if obj.type != 'MESH':
            continue
        # Переходим в режим редактирования
        bpy.context.view_layer.objects.active = obj
        bpy.ops.object.mode_set(mode='EDIT')
        bpy.ops.mesh.select_all(action='SELECT')
        
        # Удаление двойных вершин
        bpy.ops.mesh.remove_doubles(threshold=0.0001)
        # Удаление неиспользуемых рёбер (связанные с пустыми гранями)
        bpy.ops.mesh.delete_loose()
        # Пересчёт нормалей
        bpy.ops.mesh.normals_make_consistent(inside=False)
        
        # Возвращаемся в объектный режим
        bpy.ops.object.mode_set(mode='OBJECT')

clean_mesh_objects(bpy.context.selected_objects)

Результат: у каждого выбранного меша удалены лишние вершины, исправлены нормали.

Пояснение:

• Операции редактирования доступны только в режиме EDIT. После завершения нужно вернуться в OBJECT.
• threshold в remove_doubles – расстояние, в пределах которого вершины считаются дубликатами. Для больших моделей можно увеличить до 0.001.

Пример 4: Создание сплайнового пути с помощью кривых Безье

Скрипт генерирует кривую Безье по точкам из списка – полезно для создания траекторий анимации или дорог.

import bpy
import mathutils

def create_bezier_path(points):
    # Создаём пустую кривую
    curve_data = bpy.data.curves.new(name='Path', type='CURVE')
    curve_data.dimensions = '3D'
    spline = curve_data.splines.new('BEZIER')
    spline.bezier_points.add(len(points)-1)
    
    for i, loc in enumerate(points):
        bp = spline.bezier_points[i]
        bp.co = mathutils.Vector(loc)
        # Задаём автоматические ручки (handle_type='AUTO')
        bp.handle_left_type = 'AUTO'
        bp.handle_right_type = 'AUTO'
    
    obj = bpy.data.objects.new('BezierCurve', curve_data)
    bpy.context.collection.objects.link(obj)

# Пример: точки на спирали
ts = [(math.sin(t), math.cos(t), t*0.5) for t in [i*0.5 for i in range(50)]]
create_bezier_path(ts)

Результат: в сцене появляется сглаженная кривая, проходящая через заданные точки.

Пояснение:

• Создаётся объект кривой с типом BEZIER. Количество точек задаётся через add(len-1), так как первая точка уже есть.
• Ручки (handles) ставятся в автоматический режим для плавности. Можно задать вручную, передавая вторую и третью точки как handle_left и handle_right.
• Кривая может использоваться как путь для камеры или объекта с модификатором Follow Path.

Пример 5: Геометрический шум (вертексная деформация)

Скрипт добавляет случайный шум к координатам вершин выбранного меша – для создания неровных поверхностей.

import bpy
import random
import math

def vertex_noise(obj, strength=0.1, seed=0):
    random.seed(seed)
    mesh = obj.data
    # Работаем с вершинами напрямую
    for v in mesh.vertices:
        noise = (random.random() - 0.5) * 2 * strength
        v.co.x += noise
        v.co.y += noise * 0.5  # дополнительное искажение
        v.co.z += noise * 0.3
    # Обновляем mesh
    mesh.update()

# Применяем к активному объекту
vertex_noise(bpy.context.active_object, strength=0.2, seed=42)

Результат: вершины объекта смещены случайным образом, поверхность становится «шумной».

Пояснение:

• Используется random.seed для воспроизводимости.
• Изменения происходят непосредственно в mesh.vertices, после чего нужно вызвать mesh.update() для перерисовки.
• Для больших объектов (миллионы вершин) такой подход может быть медленным; лучше использовать модификатор Displace с текстурой.