Editly 옵션 설명
nodejs 기반 동영상 생성 라이브러리 editly 에 대한 주요 옵션을 설명하였습니다.
매개변수
매개변수 | CLI 동등값 | 설명 | 기본값 |
---|---|---|---|
outPath | --out | 출력 경로 (mp4, mkv), .gif도 가능 | - |
width | --width | 모든 미디어가 변환될 너비 | 640 |
height | --height | 모든 미디어가 변환될 높이 | 너비와 첫 비디오의 화면비에 따라 자동 설정 |
fps | --fps | 모든 비디오가 변환될 FPS | 첫 비디오의 FPS 또는 25 |
customOutputArgs | - | ffmpeg용 사용자 지정 출력 코덱/포맷 인수 지정 (예제 참조) | 자동 (h264) |
allowRemoteRequests | --allow-remote-requests | 경로로 원격 URL 허용 | false |
fast | --fast, -f | 빠른 모드 (미리보기용 낮은 해상도와 FPS ⏩) | false |
defaults.layer.fontPath | --font-path | 기본 폰트를 .ttf로 설정 | 시스템 폰트 |
defaults.layer.* | - | 모든 레이어가 상속할 레이어 매개변수 설정 | - |
defaults.duration | --clip-duration | 자체 지속 시간이 없는 클립의 기본 지속 시간 설정 | 4초 |
defaults.transition | - | 기본 전환을 설명하는 객체 { name, duration }. null로 설정하면 전환 비활성화 | - |
defaults.transition.duration | --transition-duration | 기본 전환 지속 시간 | 0.5초 |
defaults.transition.name | --transition-name | 기본 전환 유형. 전환 유형 참조 | random |
defaults.transition.audioOutCurve | - | 오디오 크로스페이드의 기본 페이드 아웃 곡선 | tri |
defaults.transition.audioInCurve | - | 오디오 크로스페이드의 기본 페이드 인 곡선 | tri |
clips[] | - | 순차적으로 재생될 클립 객체 목록. 각 클립은 하나 이상의 레이어를 가질 수 있음 | - |
clips[].duration | - | 클립 지속 시간. defaults.duration 참조. 설정되지 않은 경우 첫 비디오 레이어의 지속 시간 | defaults.duration |
clips[].transition | - | 이 클립 끝의 전환 지정. defaults.transition 참조 | defaults.transition |
clips[].layers[] | - | 자연스러운 순서로 오버레이될 현재 클립 내의 레이어 목록 (최종 레이어가 맨 위) | - |
clips[].layers[].type | - | 레이어 유형, 아래 참조 | - |
clips[].layers[].start | - | 이 레이어가 클립에서 시작할 시간 | - |
clips[].layers[].stop | - | 이 레이어가 클립에서 멈출 시간 | - |
audioTracks[] | - | 임의의 오디오 트랙 목록. 오디오 트랙 참조 | [] |
audioFilePath | --audio-file-path | 전체 비디오의 오디오 트랙 설정. 오디오 트랙도 참조 | - |
loopAudio | --loop-audio | 오디오 트랙이 비디오보다 짧을 경우 반복? | false |
keepSourceAudio | --keep-source-audio | 클립의 원본 오디오 유지? | false |
clipsAudioVolume | - | audioTracks에 대한 클립의 상대적 오디오 볼륨. 오디오 트랙 참조 | 1 |
outputVolume | --output-volume | 출력 볼륨 조정 (최종 단계). 예제 참조 | 1 (예: 0.5 또는 10dB) |
audioNorm.enable | - | 오디오 정규화 활성화? 오디오 정규화 참조 | false |
audioNorm.gaussSize | - | 오디오 정규화 가우스 크기. 오디오 정규화 참조 | 5 |
audioNorm.maxGain | - | 오디오 정규화 최대 게인. 오디오 정규화 참조 | 30 |
전환 유형과 레이어 유형
전환 유형
transition.name은 gl-transitions 중 하나이거나 다음 중 하나일 수 있습니다:
- directional-left (왼쪽 방향)
- directional-right (오른쪽 방향)
- directional-up (위쪽 방향)
- directional-down (아래쪽 방향)
- random (무작위)
레이어 유형
비디오 레이어
부모 clip.duration이 지정된 경우 비디오는 clip.duration에 맞게 속도가 조절됩니다. cutFrom/cutTo가 설정된 경우 해당 구간(cutTo-cutFrom)이 clip.duration에 맞게 속도가 조절됩니다. 레이어에 오디오가 있는 경우 유지됩니다(다른 오디오 레이어가 있는 경우 믹싱됨).
매개변수 | 설명 | 기본값 |
---|---|---|
path | 비디오 파일 경로 | - |
resizeMode | 크기 조정 모드 참조 | - |
cutFrom | 자르기 시작 시간 | 0초 |
cutTo | 자르기 종료 시간 | 비디오 끝 |
width | 화면 너비 대비 상대 너비 | 1 (0~1) |
height | 화면 높이 대비 상대 높이 | 1 (0~1) |
left | 화면 너비 대비 X 위치 | 0 (0~1) |
top | 화면 높이 대비 Y 위치 | 0 (0~1) |
originX | X 앵커 포인트 | left |
originY | Y 앵커 포인트 | top |
mixVolume | 다른 오디오와 믹싱 시 상대 볼륨 | 1 |
오디오 레이어
오디오 레이어들은 함께 믹싱됩니다. cutFrom/cutTo가 설정된 경우 해당 구간은 clip.duration에 맞게 속도가 조절됩니다. 속도 조절은 0.5x에서 100x 사이로 제한됩니다.
매개변수 | 설명 | 기본값 |
---|---|---|
path | 오디오 파일 경로 | - |
cutFrom | 자르기 시작 시간 | 0초 |
cutTo | 자르기 종료 시간 | clip.duration |
mixVolume | 다른 오디오와 믹싱 시 상대 볼륨 | 1 |
분리된 오디오 레이어
detached-audio
는 audioTracks
의 특별한 경우로, 전체 시작 시간을 계산할 필요 없이 클립의 시작 시간을 기준으로 오디오를 시작할 수 있게 해줍니다.
detached-audio
는 audioTracks
와 동일한 속성을 가지고 있지만, start
시간이 전체 영상이 아닌 해당 클립의 시작을 기준으로 계산된다는 점이 다릅니다.
즉, detached-audio
는 개별 클립 단위로 오디오 시작 시간을 더 쉽게 제어할 수 있게 해주는 레이어 타입입니다.
이미지 레이어
전체 화면 이미지를 위한 레이어입니다.
매개변수 | 설명 | 기본값 |
---|---|---|
path | 이미지 파일 경로 | - |
resizeMode | 크기 조정 모드 참조 | - |
Ken Burns 매개변수도 참조하세요.
레이어 유형 상세
이미지 오버레이 레이어
화면에 사용자 지정 위치와 크기로 이미지를 오버레이합니다. 참고: 애니메이션 GIF를 사용하려면 대신 비디오를 사용하세요.
매개변수 | 설명 | 기본값 |
---|---|---|
path | 이미지 파일 경로 | - |
position | 위치 매개변수 참조 | - |
width | 너비 (0~1, 1은 화면 너비) | - |
height | 높이 (0~1, 1은 화면 높이) | - |
Ken Burns 매개변수도 참조하세요.
제목 레이어
- fontPath: defaults.layer.fontPath 참조
- text: 표시할 제목 텍스트 (짧게 유지)
- textColor: 기본값 #ffffff
- position: 위치 매개변수 참조
Ken Burns 매개변수도 참조하세요.
자막 레이어
- fontPath: defaults.layer.fontPath 참조
- text: 표시할 자막 텍스트
- textColor: 기본값 #ffffff
제목 배경 레이어
배경이 있는 제목
- text: 제목 유형 참조
- textColor: 제목 유형 참조
- background: { type, ... } - radial-gradient, linear-gradient 또는 fill-color 유형 참조
- fontPath: 제목 유형 참조
뉴스 제목 레이어
- fontPath: defaults.layer.fontPath 참조
- text: 텍스트
- textColor: 기본값 #ffffff
- backgroundColor: 기본값 #d02a42
- position: 위치 매개변수 참조
슬라이드인 텍스트 레이어
- fontPath: defaults.layer.fontPath 참조
- text: 텍스트
- fontSize: 글꼴 크기
- charSpacing: 문자 간격
- color: 색상
- position: 위치 매개변수 참조
단색 채우기, 일시 정지 레이어
- color: 배경을 채울 색상, 기본값: 무작위
방사형 그라데이션 레이어
- colors: 두 색상의 배열, 기본값: 무작위
선형 그라데이션 레이어
- colors: 두 색상의 배열, 기본값: 무작위
무지개 색상 레이어
🌈🌈🌈
캔버스 레이어
customCanvas.js 참조
- func: 사용자 지정 JavaScript 함수
Fabric 레이어
customFabric.js 참조
- func: 사용자 지정 JavaScript 함수
GL 레이어
GLSL 셰이더를 로드합니다. gl.json5와 rainbow-colors.frag 참조
- fragmentPath: 프래그먼트 셰이더 경로
- vertexPath: 버텍스 셰이더 경로 (선택사항)
임의의 오디오 트랙
audioTracks 속성은 최종 영상에서 임의의 시점에 시작할 수 있는 오디오 트랙 목록을 선택적으로 포함할 수 있습니다. 이러한 트랙들은 함께 믹싱되며 (mixVolume은 다른 트랙들과 비교하여 각 트랙의 상대적인 볼륨을 지정합니다). 클립의 오디오는 audioTracks와 별도로 믹싱되기 때문에, clipsAudioVolume은 audioTracks의 각 오디오 트랙 볼륨과 비교하여 클립에서 결합된 오디오의 볼륨을 지정합니다.
매개변수 | 설명 | 기본값 |
---|---|---|
audioTracks[].path | 이 트랙의 파일 경로 | - |
audioTracks[].mixVolume | 이 트랙의 상대적 볼륨 | 1 |
audioTracks[].cutFrom | 원본 파일을 자르기 시작할 시간 값 | 0초 |
audioTracks[].cutTo | 원본 파일을 자를 끝 지점의 시간 값 | - |
audioTracks[].start | 이 오디오 트랙을 시작할 비디오 내 시점(초) | 0초 |
audioTracks와 'audio' 타입 레이어의 차이점은 audioTracks가 여러 클립에 걸쳐 계속 재생되며 필요할 때 언제든지 시작하고 멈출 수 있다는 것입니다.audioTracks 예제를 참조하세요.'detached-audio' 레이어 타입도 참조하세요.
오디오 정규화와 크기 조정
오디오 정규화
최종 출력 오디오의 정규화를 활성화할 수 있습니다. 이는 오디오 더킹(예: 보이스오버가 나올 때 다른 트랙의 볼륨을 자동으로 낮추기)을 구현할 때 유용합니다.
audioNorm 매개변수는 다음과 같습니다:
- audioNorm.enable: 오디오 정규화 활성화 여부
- audioNorm.gaussSize: 가우스 크기 설정
- audioNorm.maxGain: 최대 게인 설정
크기 조정 모드
resizeMode - 화면에 맞추는 방법을 지정합니다. 다음 중 하나를 선택할 수 있습니다:
- contain: 모든 비디오가 프레임 내에 포함되며 레터박스 처리됨
- contain-blur: contain과 유사하지만 레터박스에 블러 처리된 복사본 사용
- cover: 전체 화면을 덮도록 비디오가 잘림 (화면 비율 유지)
- stretch: 전체 화면을 덮도록 비디오가 늘어남 (화면 비율 무시)
기본값은 contain-blur입니다.
위치 매개변수
특정 레이어는 position 매개변수를 지원합니다.
position은 다음 중 하나일 수 있습니다:
- 미리 정의된 위치: top, bottom, center, top-left, top-right, center-left, center-right, bottom-left, bottom-right
- 객체 형식: { x, y, originX = 'left', originY = 'top' }
- {x: 0, y: 0}은 화면 좌상단
- {x: 1, y: 1}은 화면 우하단
- x는 비디오 너비에 대한 상대값
- y는 비디오 높이에 대한 상대값
- originX와 originY는 선택사항이며 객체의 기준점(앵커 위치)을 지정
Ken Burns 매개변수
매개변수 | 설명 | 기본값 |
---|---|---|
zoomDirection | Ken Burns 효과의 줌 방향: in, out, left, right 또는 비활성화는 null | - |
zoomAmount | Ken Burns 효과의 줌 양 | - |
'개발' 카테고리의 다른 글
n8n 워크플로우 노드 가이드 (1) | 2024.11.20 |
---|---|
Traefik: 클라우드 네이티브 시대의 현대적인 리버스 프록시 (1) | 2024.11.20 |
n8n - 워크플로우 자동화 도구 (1) | 2024.11.19 |
Select vs Selector: 네이밍 가이드 (1) | 2024.11.17 |