블렌더 커맨드라인 렌더 명령: -b·-s·-e·-o·-a 순서

블렌더 커맨드라인 렌더에서 애니메이션을 실행할 때는 -b <blend-file> -s <start> -e <end> -o <output-prefix> -a 순서로 작성합니다. 지금 사용 중인 .blend 파일을 먼저 지정하고, 시작·끝 프레임과 출력 위치를 넣은 뒤, -a를 마지막에 놓으세요. 한 장만 렌더한다면 -f를 대신 사용합니다. 이 순서는 설정이 의도대로 적용되도록 돕지만, 프로젝트의 렌더 엔진이나 외부 에셋까지 정상 작동한다고 보장하지는 않습니다. 먼저 짧은 구간을 시험하고 실제 이미지가 저장됐는지 확인하세요.

명령 순서가 먼저인 이유

터미널에서 Blender를 실행한다고 해서 화면에서 버튼을 누르던 순서가 사라지는 것은 아닙니다. 명령줄의 옵션은 왼쪽부터 차례로 처리합니다. 따라서 어떤 설정을 언제 주는지가 결과에 영향을 줍니다. -b는 Blender를 백그라운드 모드로 실행하도록 지정합니다. 별도의 작업 창을 열지 않고 렌더 작업을 진행할 때 쓰며, 배치 렌더나 자동화 작업의 출발점이 됩니다.

가장 먼저 구별할 부분은 설정 옵션과 실행 옵션입니다. -s는 시작 프레임, -e는 끝 프레임, -o는 이미지가 저장될 경로와 파일명 앞부분을 지정합니다. 반면 -a는 애니메이션 렌더를 시작하고, -f는 지정한 프레임의 렌더를 시작합니다. 마지막 두 옵션은 단순한 표시가 아니라 실제 작업을 발생시키는 지점입니다.

일상적인 비유로 보면 .blend 파일을 여는 일은 작업 서류를 펼치는 것이고, 프레임과 출력 경로를 지정하는 일은 서류 위에 작업 지시를 적는 것입니다. -a나 -f는 최종 실행 버튼에 가깝습니다. 다만 이것은 순서를 이해하기 위한 비유입니다. Blender가 실제로 서류를 만들거나 확인 창을 띄우는 것은 아닙니다. 명령 인수를 순서대로 해석하여 장면을 불러오고 렌더를 실행합니다.

.blend 파일은 출력 설정보다 먼저 불러옵니다

순서 오류 중 특히 찾기 어려운 경우는 출력 경로가 예상과 다를 때입니다. -o를 .blend 파일 앞에 놓으면, 뒤이어 파일을 읽는 과정에서 장면에 저장돼 있던 출력 경로가 앞선 설정을 덮어쓸 수 있습니다. 실행 자체가 실패하지 않아도 결과가 원래 프로젝트 폴더로 갈 수 있습니다. 터미널에 명령을 입력한 사람은 새 폴더를 지정했다고 생각하기 때문에 렌더가 누락된 것으로 오해하기 쉽습니다.

따라서 blender -b -o ... scene.blend -a처럼 작성하지 말고, blender -b scene.blend -o ... -a처럼 파일을 연 뒤 출력 설정을 적용하세요. 여기서 blender는 실행 파일을 가리키는 자리이며, 실제로는 설치된 실행 파일 경로나 실행 가능한 명령 이름을 입력해야 합니다. 긴 프로젝트 경로에 공백이 있다면 경로마다 셸에 맞는 따옴표도 필요합니다.

-a와 -f 뒤에는 렌더 설정을 두지 않습니다

-a가 나오면 지정된 애니메이션 범위의 렌더가 시작됩니다. -f 2가 나오면 2번 프레임의 렌더가 시작됩니다. 이 뒤에 -o를 붙여도 이미 시작된 렌더에는 새 경로가 적용되지 않습니다. 시작·끝 프레임과 출력 위치를 모두 결정한 다음 마지막에 렌더 옵션을 두세요. 애니메이션에는 -a, 단일 이미지에는 -f 중 하나를 선택하면 명령의 의도가 분명해집니다.

실행 전에 확인할 네 가지 입력

블렌더 커맨드라인 렌더를 시작하려면 명령 뼈대와 네 가지 입력값이 모두 맞아야 합니다. 첫째, Blender 실행 파일 위치를 확인하세요. 둘째, 렌더하려는 .blend 파일을 정확히 고르세요. 셋째, 필요한 프레임이 하나인지 연속 구간인지 결정하세요. 넷째, 결과 이미지를 저장할 폴더와 파일명 앞부분을 별도로 정하세요. 이 네 항목은 서로 다른 오류 원인이므로, 문제가 생겼을 때도 따로 점검하는 편이 빠릅니다.

Windows에서 Blender가 기본 설치 폴더에 있다면 실행 파일 경로에 Program Files처럼 공백이 들어갑니다. .blend 파일 이름에도 공백이 있을 수 있습니다. 출력 폴더까지 공백이 있다면 세 경로를 각각 한 덩어리로 전달해야 합니다. 경로 전체를 한 번에 감싸는 방식과 개별 경로 인수를 따옴표로 감싸는 방식은 같지 않습니다. 아래 예시처럼 실행 파일, .blend 파일, 출력 경로를 독립된 인수로 작성하세요.

프레임 번호는 타임라인에서 실제로 필요한 범위를 사용합니다. 애니메이션 명령의 시작과 끝은 모두 포함됩니다. 예를 들어 1부터 2까지 지정하면 1번과 2번, 두 프레임이 대상입니다. 100부터 110까지라면 양 끝을 포함한 11프레임이 대상입니다. 이는 파일 개수를 미리 예상하는 기준이지만, 실제 저장 개수는 명령을 실행한 뒤 결과 폴더에서 다시 확인해야 합니다.

출력 경로에는 저장 폴더와 파일명 앞부분을 함께 적습니다. 예를 들어 D:\Renders\shotA\seq_#####처럼 지정하고, 실제 확장자와 저장 위치는 장면의 이미지 출력 설정과 렌더 로그에서 확인하세요. Blender와 다른 프로그램 사이의 프레임 번호 표기 변환은 V60 시퀀스 파일명 패딩 표기를 참고하세요.

애니메이션과 한 프레임 명령은 이렇게 구분합니다

Windows PowerShell에서 Blender 5.0 실행 파일과 장면 경로를 직접 지정하는 애니메이션 예시는 다음과 같습니다. 각 경로를 작은따옴표로 감싸고, 실행 파일 앞에는 호출 연산자 &를 붙입니다. -s 1 -e 2는 두 프레임을 지정하며 -a가 마지막에서 실제 렌더를 시작합니다. 예시 폴더와 .blend 파일은 자신의 PC에 존재하는 경로로 바꾸세요.

& 'C:\Program Files\Blender Foundation\Blender 5.0\blender.exe' -b 'D:\Scenes\shot 01.blend' -s 1 -e 2 -o 'D:\Renders\shotA_v02\seq_#####' -a

지정한 범위 전체가 아니라 특정 프레임 하나만 먼저 보고 싶다면 다음 구조를 사용합니다. -f 2가 2번 프레임만 실행하므로 -s와 -e를 별도로 줄 필요가 없습니다. 장면 내용, 재질, 카메라 구도 등을 먼저 확인할 때 유용한 접근입니다. 이 명령은 전체 시퀀스를 만들지 않습니다. 테스트 한 장을 확인한 뒤 전체 구간용 명령을 따로 실행하세요.

& 'C:\Program Files\Blender Foundation\Blender 5.0\blender.exe' -b 'D:\Scenes\shot 01.blend' -o 'D:\Renders\shotA_test\frame_#####' -f 2

두 예시는 파일 형식을 명령에서 강제로 변경하지 않습니다. .blend 안에 저장된 출력 형식과 렌더 설정을 바탕으로 동작한다는 뜻입니다. 프레임 번호와 접두어가 맞더라도 실제 산출물의 확장자와 저장 위치를 확인하세요. 자동 납품 과정에서는 작업자가 기대한 파일명이 나오는지 미리 검증하는 것이 명령 한 줄을 외우는 것보다 중요합니다.

내 경로로 블렌더 커맨드라인 렌더 명령 만들기

아래 도구에서 셸을 먼저 선택한 뒤 Blender 실행 파일, .blend 파일, 프레임 번호, 출력 경로를 입력하세요. 애니메이션을 선택하면 -b, 파일, -s, -e, -o, -a 순으로 만듭니다. 한 프레임을 선택하면 첫 프레임 입력값을 사용하여 -b, 파일, -o, -f 순으로 만듭니다. Windows PowerShell과 macOS/Linux Bash/Zsh의 경로 인용 규칙이 서로 달라 별도 옵션을 제공합니다.

이 도구는 프레임을 0 이상의 정수로 제한합니다. Blender의 상대 프레임 표기(예: -f -2, 끝에서 두 번째 프레임)는 여기서 생성되지 않으므로, 해당 프레임이 필요하면 명령을 직접 작성하세요.

이 도구는 입력값을 실행 가능한 형식의 명령 문자열로 조합할 뿐 실제 Blender를 실행하지 않습니다. 파일이 존재하는지, 출력 폴더가 있는지, 현재 장면이 렌더되는지, 기존 이미지와 이름이 겹치는지도 검사하지 않습니다. 특히 긴 배치 렌더를 돌리기 전에는 출력 폴더의 기존 파일을 확인하고 새 버전 이름이나 별도 폴더를 사용하세요. 생성된 문자열을 복사한 뒤 자신의 터미널에서 실행해야 합니다.

PowerShell과 Bash/Zsh에서 경로를 적는 방법

Windows PowerShell에서는 공백이 있는 실행 파일 경로를 문자열로만 적으면 실행 지시로 해석되지 않을 수 있습니다. 그래서 생성기는 & 'C:\...\blender.exe' 형태로 호출 연산자를 앞에 둡니다. .blend 경로와 출력 경로도 각각 작은따옴표로 감쌉니다. 경로 자체에 작은따옴표가 있다면 PowerShell 문자열 안에서는 그 문자를 두 번 써야 하므로 생성기가 해당 부분을 변환합니다. 경로를 직접 수정한다면 이 처리를 지우지 마세요.

Bash/Zsh 선택 시에는 실행 파일 경로 앞에 PowerShell의 &를 붙이지 않습니다. 대신 각 경로를 작은따옴표로 감싸 셸이 공백이나 특수문자를 여러 인수로 나누지 않도록 합니다. 경로에 작은따옴표가 포함되면 인용을 잠시 닫고 해당 문자를 안전하게 끼워 넣는 방식으로 문자열을 만듭니다. 이는 명령 문자열의 인용 규칙을 구현한 것이며, macOS/Linux에서 Blender를 실행해 성공을 확인했다는 뜻은 아닙니다.

셸마다 경로 구분자, 설치 위치, 실행 파일 이름이 다를 수 있습니다. 도구에서 운영체제 선택만 바꾼다고 Windows의 C:\ 경로가 macOS/Linux 경로로 자동 변환되지는 않습니다. 설치된 Blender 실행 파일의 실제 위치를 직접 입력하세요. 또한 생성기는 경로에 들어 있는 줄바꿈과 제어문자를 거부하지만, 경로의 철자가 맞는지 또는 사용할 권한이 있는지는 알지 못합니다. 파일 경로 인용과 파일 존재 검사를 혼동하지 마세요.

실제 파일로 렌더 성공을 확인하는 순서

첫 실행은 한 장 또는 두 프레임처럼 짧게 제한하세요. 콘솔에 렌더 진행 메시지가 나오더라도 파일이 없으면 납품할 결과가 만들어졌다고 볼 수 없습니다. 출력 폴더를 열어 지정한 접두어와 프레임 번호를 가진 파일이 생겼는지 확인하세요. Blender 콘솔의 Saved: 줄은 실제로 어디에 저장하려 했는지 추적하는 단서가 됩니다. 이 경로와 탐색기 또는 파일 관리자의 실제 파일 위치가 맞는지 비교하세요.

애니메이션의 경우 시작 프레임과 끝 프레임을 포함해 예상 개수를 먼저 적어 두면 빠르게 대조할 수 있습니다. 1~2를 요청했는데 00001만 있다면 두 번째 이미지가 없는 이유를 확인해야 합니다. 한 프레임 명령을 실행하고 전체 구간이 없다고 판단해서도 안 됩니다. -f는 애초에 지정한 번호 한 장만 대상으로 합니다. 번호가 맞는 파일이 있어도 직접 열어 장면 내용, 해상도, 이미지 손상 여부를 확인하세요.

프로세스 종료 코드나 마지막 로그 한 줄만으로 사용할 수 있는 렌더가 완성됐다고 결론 내리지 마세요. 렌더 엔진이 장면을 다르게 처리했거나 텍스처를 찾지 못해 기대하지 않은 화면을 저장했을 수도 있습니다. 작업 검수 기준은 실행 완료 표시가 아니라 실제 저장된 결과물입니다. 중요한 납품이라면 시퀀스 첫 장, 중간 장, 마지막 장을 열어 컷의 연속성과 이미지 내용을 확인하세요.

동일한 경로로 다시 실행하면 기존 이미지가 바뀔 수 있습니다

재실행은 단순한 확인 동작이 아닙니다. 같은 파일명과 프레임으로 다시 렌더하면 기존 결과를 새 이미지로 바꿔 쓸 수 있습니다. Windows PowerShell에서 수행한 Blender 5.0.0 소규모 시험에서는 같은 출력 경로를 다시 렌더했을 때 파일의 마지막 수정 시각이 실제로 달라졌습니다. 이 관찰은 기존 파일을 보존하는 기능이 있다는 근거가 아니라 반대의 주의 신호입니다. 중요한 시퀀스를 보관 중이라면 새 폴더나 v02 같은 새 버전 접두어를 사용하세요.

출력 폴더가 비어 있는지, 이미 같은 번호의 파일이 있는지, 그 파일이 다른 작업자가 검수 중인 버전은 아닌지 확인하세요. 폴더 경로를 새로 지정했다고 해서 폴더가 자동으로 준비돼 있다는 보장도 없습니다. 경로가 가리키는 위치와 쓰기 권한을 먼저 점검하세요. 이 점검은 생성기의 입력 유효성 검사와 별개이며 실제 파일 시스템을 확인하는 작업입니다.

문제가 생겼을 때 원인을 분리하는 법

명령이 작동하지 않을 때 모든 문제를 옵션 순서 탓으로 돌리면 진단이 길어집니다. 먼저 Blender 프로세스 자체가 시작됐는지 확인하세요. 실행 명령을 찾지 못하거나 프로그램이 열리지 않는다면 실행 파일 경로, PowerShell의 &, 경로의 따옴표를 살펴보세요. 이 단계는 프레임 범위를 바꿔 해결할 문제가 아닙니다. 정상적으로 시작했다면 다음으로 .blend 파일을 읽었는지, 그다음 출력이 어디에 생성됐는지 확인합니다.

보이는 증상	우선 점검할 곳
Blender 자체가 실행되지 않음	실행 파일 경로, 셸 인용, PowerShell 호출 연산자
.blend를 읽지 못함	장면 파일 경로, 파일 존재 여부와 접근 권한
다른 폴더에 이미지가 생김	.blend 로드와 -o의 순서, 콘솔 Saved: 경로
필요한 프레임이 빠짐	-a/-f 선택, 시작·끝 범위, 실제 파일 개수
이미지는 있지만 내용이 이상함	장면 설정, 렌더 엔진, 카메라, 외부 에셋 및 애드온

명령에서 지정한 폴더와 다르게 저장됐다면 Saved: 줄부터 읽으세요. 저장 경로가 .blend 파일의 기존 설정과 같다면 -o가 파일 로드보다 앞에 있었는지 확인할 이유가 있습니다. 반면 -o가 파일 뒤에 놓였고 로그에도 새 경로가 찍혔다면, 파일 관리자에서 다른 위치를 찾고 있거나 파일명 앞부분을 다르게 예상했을 가능성을 살펴봐야 합니다. 같은 증상처럼 보여도 수정할 곳은 달라집니다.

프레임이 예상보다 적다면 명령의 마지막 토큰부터 보세요. -f로 끝났다면 한 프레임만 렌더하라는 뜻입니다. -a로 끝났다면 앞쪽의 -s와 -e를 확인하세요. -a 뒤에 출력 경로를 추가했다면 그 경로는 시작된 렌더에 적용되지 않습니다. 필요한 경우 명령을 고치되, 재실행 전에 기존 이미지가 덮어써질 위치인지 확인하세요.

로그에서 렌더가 진행됐고 파일도 만들어졌는데 화면이 기대와 다르다면 명령의 문법과 장면 문제를 분리해야 합니다. 예를 들어 카메라, 조명, 재질, 링크된 파일, 특정 렌더 엔진이나 애드온이 관여하는 장면은 단순한 큐브 테스트와 조건이 다릅니다. 올바른 명령 순서가 장면 구성 문제까지 해결하지는 않습니다. 파일 한 장을 열어 어떤 내용이 저장됐는지 먼저 확인한 뒤 프로젝트 설정을 검사하세요.

Blender 5.0 확인 범위와 실무 적용선

여기서 실제 실행으로 확인한 내용은 Windows PowerShell의 Blender 5.0.0, 32×32 크기의 두 프레임짜리 큐브 장면으로 한정됩니다. 이 환경에서 -b 실행 중 Blender 작업 창은 열리지 않았고, 애니메이션 명령은 seq_00001.png와 seq_00002.png를 저장했습니다. -f 2 명령은 2번 프레임 한 장을 저장했습니다. 공백이 있는 실행 파일 경로와 장면·출력 경로도 PowerShell에서 따옴표와 호출 연산자를 사용했을 때 처리됐습니다.

같은 시험에서 .blend 파일을 열기 전에 지정한 -o는 저장된 장면의 경로로 되돌아갔고, 파일을 연 다음 지정한 -o는 요청한 위치를 사용했습니다. -a 또는 -f 뒤에 붙인 출력 변경도 이미 시작된 렌더에는 반영되지 않았습니다. 출력 토큰 #####는 시험 경로의 파일명에 반영됐고, 같은 경로를 재사용했을 때 기존 이미지의 수정 시각도 바뀌었습니다. 이 관찰은 옵션 순서를 검증한 작은 재현 시험이지 성능이나 대규모 장면의 안정성 검증은 아닙니다.

macOS/Linux에서는 Blender를 직접 실행해 보지 않았습니다. 임의의 사용자 프로젝트, 여러 렌더 엔진, GPU 설정, 외부 에셋, 애드온 조합의 성공 여부도 시험하지 않았습니다. 독립적인 사용자 커뮤니티 사례를 수집해 일반화한 결과도 아닙니다. 이 글의 명령 구조는 Blender 5.0 공식 문서의 인수 의미와 순서에 근거하지만, 납품용으로 사용하기 전에는 자신의 실제 장면과 실행 환경에서 짧은 구간부터 검증해야 합니다.

최종 실행 전에는 .blend 파일이 먼저, 출력 설정이 그다음, -a 또는 -f가 마지막인지 확인하세요. 한 장을 시험 저장하고 Saved: 로그와 실제 파일을 대조한 뒤 전체 구간을 실행합니다. 마감 가능성 계산은 V62 렌더 시간과 마감 계산을 참고하세요. 여기서는 시간 계산을 반복하지 않고 명령 순서와 저장 위치에 집중합니다.

파일을 먼저 열고, 설정을 뒤에, 실행 옵션을 마지막에 두세요.