콘텐츠로 이동

AddVignette

어떤 노드인가요?

AddVignette 노드는 비디오에 비네트(Vignette) 효과를 추가하여 프레임 가장자리를 점진적으로 어둡게 하거나 밝게 만듭니다. 이 효과는 프레임 중앙부로 시선을 집중시키고 영상에 영화 같은 품격을 더해줍니다.

언제 사용하나요?

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

  • 비디오 프레임 중앙으로 시청자의 시선을 집중시키고 싶을 때
  • 영화 같은 필름 느낌을 연출해야 할 때
  • 영상에 깊이감과 분위기를 더하고 싶을 때
  • 전문적이고 완성도 높은 룩의 콘텐츠를 제작할 때
  • 카메라 렌즈 고유의 자연스러운 주변부 광량 저하 현상을 시뮬레이션할 때
  • 비디오의 감정선이나 분위기를 극대화해야 할 때

사용 방법

기본 설정

  1. 워크플로우에 AddVignette 노드를 추가합니다.
  2. "video" 입력에 비디오 소스를 연결합니다.
  3. 비네트 각도(angle), 중심 위치(center_x, center_y), 화면 비율(aspect)을 조절합니다.
  4. 가장자리를 어둡게 하는 "forward" 모드와 밝게 하는 "backward" 모드 중 선택합니다.
  5. 워크플로우를 실행하여 비네트 효과를 적용합니다.

파라미터 (Parameters)

  • video: 비네트를 추가할 비디오 콘텐츠입니다. (VideoArtifact 및 VideoUrlArtifact 지원)

  • angle: 비네트 효과를 위한 렌즈 각도입니다. (0.1-3.14, 기본값: 0.628)

    • 작은 값 = 약한 비네트 효과
    • 0.1 = 매우 은은한 비네트
    • 0.628 = 적당한 비네트 (기본값)
    • 3.14 = 매우 강한 비네트
  • center_x: 가로 중심 오프셋입니다. (-1.0 ~ 1.0, 기본값: 0.0)

    • -1.0 = 맨 왼쪽
    • 0.0 = 중앙 (기본값)
    • 1.0 = 맨 오른쪽
  • center_y: 세로 중심 오프셋입니다. (-1.0 ~ 1.0, 기본값: 0.0)

    • -1.0 = 맨 위
    • 0.0 = 중앙 (기본값)
    • 1.0 = 맨 아래
  • aspect: 비네트의 종횡비입니다. (0.1-10.0, 기본값: 1.0)

    • 0.1 = 매우 넓은 가로 타원형 비네트
    • 1.0 = 원형 비네트 (기본값)
    • 10.0 = 매우 긴 세로 타원형 비네트
  • mode: 비네트 모드입니다. (기본값: "forward")

    • "forward" = 가장자리를 어둡게 처리 (전통적인 비네트)
    • "backward" = 가장자리를 밝게 처리 (반전 비네트)
  • processing_speed: 처리 속도와 출력 품질 간의 균형을 조절합니다. (기본값: "balanced")

    • fast: 가장 빠른 처리 속도, 낮은 품질 (ultrafast 프리셋, CRF 30)
    • balanced: 속도와 품질의 균형 잡힌 설정 (medium 프리셋, CRF 23)
    • quality: 최고 품질, 느린 처리 속도 (slow 프리셋, CRF 18)

출력 (Outputs)

  • video: 비네트 효과가 적용된 비디오이며, 다른 노드에 연결할 수 있는 출력으로 제공됩니다.

예시

인물 비디오에 은은한 비네트를 추가하여 피사체에 시선을 집중시키려는 경우:

  1. 워크플로우에 AddVignette 노드를 추가합니다.
  2. LoadVideo 노드의 비디오 출력을 AddVignette의 "video" 입력에 연결합니다.
  3. 적당한 비네트 효과를 위해 "angle"을 0.5로 설정합니다.
  4. 비네트를 중앙에 배치하기 위해 "center_x"와 "center_y"를 0.0으로 유지합니다.
  5. 원형 비네트를 위해 "aspect"를 1.0으로 설정합니다.
  6. 가장자리를 어둡게 만들기 위해 "forward" 모드를 선택합니다.
  7. 워크플로우를 실행합니다. 비디오에 은은한 비네트 효과가 적용됩니다.
  8. 출력 파일명은 {original_filename}_vignette_a0.50_x0.00_y0.00_r1.00_forward.{format} 형태가 됩니다.

중요 참고 사항

  • AddVignette 노드는 고품질 비네트 알고리즘이 내장된 FFmpeg를 사용합니다.
  • 중앙에서 가장자리로 갈수록 부드럽고 자연스러운 전환 효과를 생성합니다.
  • 원본 오디오 트랙은 그대로 유지됩니다.
  • 처리 시간은 비디오의 길이와 해상도에 따라 달라집니다.
  • 문제 해결을 위한 로그 정보가 제공됩니다.

파라미터 권장 사항

  • 인물 영상 (Portrait): angle 0.4-0.6, 중심 (0,0), aspect 1.0 사용
  • 풍경 영상 (Landscape): angle 0.3-0.5, 중심 (0,0), aspect 1.5-2.0 사용
  • 시네마틱 룩: angle 0.5-0.8, forward 모드 사용
  • 은은한 보정: 아주 부드러운 효과를 위해 angle 0.8-1.2 사용
  • 드라마틱한 효과: 강한 비네트를 위해 angle 2.0-3.0 사용
  • 중앙을 벗어난 피사체: 피사체 위치에 맞추어 center_x와 center_y를 조절하세요.

자주 묻는 질문 및 문제 해결

  • 처리 시간 초과 (Timeout): 고용량 비디오는 처리에 더 긴 시간이 소요될 수 있으며, 노드의 기본 제한 시간은 5분입니다.
  • 비네트가 너무 강함: 효과를 부드럽게 하려면 angle 값을 줄이세요.
  • 비네트가 보이지 않음: 효과를 뚜렷하게 하려면 angle 값을 높이세요.
  • 비디오 입력 없음: "video" 입력에 유효한 비디오 소스가 연결되었는지 확인하세요.
  • FFmpeg 오류: 처리 실패 시 자세한 오류 정보를 확인하려면 logs 파라미터를 참조하세요.