Blender 3D Scripting : Introduction to Blender Python - 001

1. Introduction

 

Blender 3D Scripting : Introduction to Blender Python - 001.

 

블렌더 v5.0 기본 환경 상태에서, <Ctrl + PgUp>  또는 <Ctrl + PgDn 여러번>으로 스크립트 창 열기. 오른쪽 코드 편집창 열기. New.. 아이콘을 클릭해야 코드 입력 가능함. 참고용 코드 복붙 후, 테스트!

 

◈ 코드 텍스트 입력을 위한 코드 에디터 창 열기 : Shift + F11

◈ 코드 텍스트 글자 크기 조절 : Ctrl + Mouse Wheel 앞 뒤로 돌리기.

 

 

2. Code 예제 - 1

# 예제 코드 1 : 3 x 3 정방형 규브 배열 생성하기

import bpy

# 기존 오브젝트 삭제 (선택 사항)
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete(use_global=False)

# 큐브 크기와 간격 설정
cube_size = 2
spacing = 3

# 3x3 배열 생성
for i in range(3):
    for j in range(3):
        # 큐브 생성
        bpy.ops.mesh.primitive_cube_add(
            size=cube_size,
            location=(i * spacing, j * spacing, 0)
        )

 

 

◈ 결과 :

 

 

 

 

 

3. Code 예제 - 2

 

# 예제 코드 2 : 3 x 3 x 3 정방형 입체 규브 배열 생성하기

import bpy

# 기존 오브젝트 삭제 (선택 사항)
bpy.ops.object.select_all(action='SELECT')
bpy.ops.object.delete(use_global=False)

# 큐브 크기와 간격 설정
cube_size = 2
spacing = 3

# 3x3x3 배열 생성
for i in range(3):       # X축 방향
    for j in range(3):   # Y축 방향
        for k in range(3):  # Z축 방향
            bpy.ops.mesh.primitive_cube_add(
                size=cube_size,
                location=(i * spacing, j * spacing, k * spacing)
            )

 

 

◈ 결과 :

 

 

 

 

 

 

4. Notes

 

 

◈  블렌더에서 Python 스크립트를 사용해 3×3 정방형 배열로 큐브를 생성하려면 bpy 모듈을 활용하면 됩니다. 아래 예시는 Blender 5.0 환경에서 실행 가능한 코드입니다.

 

코드 설명

• bpy.ops.mesh.primitive_cube_add() : 큐브를 생성하는 함수입니다.
• primitive_cube_add() 함수는 큐브를 새로 하나 생성합니다. bpy.ops.mesh 부분은 이 함수가 소속된 위치('=.모듈)를 나타낸다고 생각할 수 있습니다.
• size = cube_size : 큐브의 크기를 지정합니다. 단위는 블렌더에서 자체로 사용하는 고유의 '블렌더 단위'라고 할 수 있습니다.
• location = (i * spacing, j * spacing, 0) : X, Y 좌표를 반복문으로 계산해 3×3 배열 형태로 배치합니다.
• spacing : 큐브 간격을 조절할 수 있습니다.

이렇게 하면 바닥 평면 위에 3×3 정방형 배열로 큐브가 생성됩니다.

 

만약 3×3×3, 즉 **입체적인 배열(큐브 배열)**을 원한다면 for k in range(3):를 추가해 Z축에도 반복문을 적용하면 됩니다.

 

 

◈  여기서는 큐브를 3×3×3 입체 배열로 생성하는 Python 코드 예시를 드리겠습니다. Blender 5.0에서 실행하면 X, Y, Z 축 방향으로 각각 3개씩 총 27개의 큐브가 생성됩니다.

 

코드 설명

• for i in range(3) --> X축 방향으로 3개
• for j in range(3) --> Y축 방향으로 3개
• for k in range(3) --> Z축 방향으로 3개
• 결과적으로 3 x 3 x 3 = 27개의 큐브가 격자 형태로 배치됩니다.
• spacing 값을 조절하면 큐브 간격을 넓히거나 좁힐 수 있습니다.

만약 배열 전체를 한 덩어리처럼 중앙에 배치하고 싶다면, location 계산 시 -(spacing)을 곱해 중심을 맞추는 방식도 가능합니다.

 

◈  시작 지점 좌표 수정법 : 입체 도형 큐브의 시작 지점 좌표가 마음에 들지 않을 대 수정은 대략 이렇게 합니다만.

 

# 큐브 크기와 간격 설정
cube_size = 2
spacing = 4

# 3x3 배열 생성. 2축 체계는 그대로 살려두고, 한 축 값만 고정 시키면 될 듯. 없애도 되지만.
for i in range(12):       # X축 방향
    for j in range(1):   # Y축 방향. Z축은 일단 제거.
        bpy.ops.mesh.primitive_cube_add(
                size=cube_size,
                location=(j * spacing, i * spacing-((4*11)/2), 0)
            )

 

# 완전한 코드는 3번 파일을 참고하세요. location은 x, y, z 3축 좌표값을 받는 튜플 변수.

 

 

◈ 실행결과

 

 

 

 

■ 응용 연습 과제

1) Not Yet!

2) Not Yet!

 

 

5. Files

 

Blender_Python_Ex_001_.blend

0.10MB

Blender_Python_Ex_002_.blend

0.11MB

Blender_Python_Ex_003_.blend

0.11MB

 

 

6. Ref.

 

 

Happy Programming!

^.^;