콘텐츠로 이동

ResizeVideo

어떤 노드인가요?

ResizeVideo 노드는 FFmpeg을 사용하여 여러 배율 모드(너비, 높이, 비율 또는 너비와 높이 지정)로 비디오 콘텐츠의 크기를 조정합니다. 종횡비를 유지하거나 배경색으로 패딩을 추가하거나 맞춤 모드에 따라 잘라내기(crop to fill)를 적용할 수 있습니다.

언제 사용하나요?

다음과 같은 상황에서 ResizeVideo 노드를 사용합니다:

  • 정확한 백분율 비율로 비디오 크기를 조정해야 할 때
  • 종횡비를 유지하면서 특정 너비 또는 높이를 목표로 지정하고 싶을 때
  • 패딩이나 자르기를 적용하여 정확한 치수에 비디오를 맞추어야 할 때
  • 비디오 워크플로우 전반에 걸쳐 일관된 크기 조정 제어가 필요할 때

사용 방법

기본 설정

  1. 워크플로우에 ResizeVideo 노드를 추가합니다.
  2. "video" 입력에 비디오 소스를 연결합니다.
  3. "resize_mode"를 선택합니다.
  4. 해당 모드에 맞는 크기 파라미터를 구성합니다.
  5. 워크플로우를 실행하여 비디오 크기를 조정합니다.

파라미터 (Parameters)

  • video: 크기를 조정할 비디오 콘텐츠 (VideoArtifact 및 VideoUrlArtifact 지원)

  • resize_mode: 비디오 크기 조정 방식

    • width: 종횡비를 유지하면서 목표 너비로 크기 조정
    • height: 종횡비를 유지하면서 목표 높이로 크기 조정
    • percentage: 원본 크기의 백분율로 크기 조정
    • width and height: 맞춤 옵션을 적용하여 정확한 치수로 크기 조정

  • target_size: 너비/높이 모드에서의 픽셀 단위 목표 크기 (1-8000)

  • percentage: 크기 조정 백분율 (1-500, 기본값: 100)

  • target_width: 너비 및 높이 모드에서의 픽셀 단위 목표 너비

  • target_height: 너비 및 높이 모드에서의 픽셀 단위 목표 높이

  • fit_mode: 목표 치수 내에서 비디오를 맞추는 방법

    • fit: 종횡비를 유지하고 패딩 추가 (레터박스)
    • fill: 종횡비를 유지하고 목표 영역을 채우도록 자름
    • stretch: 종횡비를 무시하고 목표 영역에 맞게 늘림

  • background_color: fit 모드에서 레터박스에 사용할 배경색 (16진수 hex 코드)

  • scaling_algorithm: 크기 조정에 사용되는 스케일링 알고리즘 (기본값: "bicubic")

    • neighbor, bilinear, bicubic, lanczos

  • lanczos_parameter: Lanczos 스케일링 알고리즘 세부 조정 (1.0-10.0, 기본값: 3.0)

    scaling_algorithm이 "lanczos"로 설정된 경우에만 출력에 영향을 줍니다.

출력 (Outputs)

  • resized_video: 크기가 조정된 비디오 콘텐츠 (다른 노드에 연결하여 사용 가능)

예시

종횡비를 유지하고 패딩을 적용하여 비디오 크기를 1280x720으로 조정하려면:

  1. resize_mode를 width and height로 설정합니다.
  2. target_width를 1280으로 설정합니다.
  3. target_height를 720으로 설정합니다.
  4. fit_mode를 fit으로 설정합니다.
  5. background_color를 #000000으로 설정합니다.

중요 참고 사항

  • ResizeVideo 노드는 비디오 처리를 위해 FFmpeg을 사용합니다.
  • 코덱 호환성을 위해 치수는 자동으로 2의 배수로 조정됩니다.
  • 이 노드는 일반적인 비디오 형식(mp4, avi, mov 등)을 지원합니다.
  • 크기가 조정된 비디오는 원본 오디오 트랙을 그대로 유지합니다.
  • 처리 문제 발생 시 로그를 통해 디버깅 정보를 확인할 수 있습니다.