> Hello World !!!

     

@syaku

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-audioaudioTracks의 특별한 경우로, 전체 시작 시간을 계산할 필요 없이 클립의 시작 시간을 기준으로 오디오를 시작할 수 있게 해줍니다.

detached-audioaudioTracks와 동일한 속성을 가지고 있지만, 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 효과의 줌 양 -
반응형