워터마크 설정

이 항목에는 비디오 워터 마크와 관련된 인코딩 설정에 대한 세부 정보가 포함되어 있습니다.

서문

워터마크는 동영상에 추가되는 이미지로, 종종 동영상의 출처나 소유권을 나타냅니다. 워터마크를 지정하면 이미지가 해당 출력에 포함됩니다. 비디오 입력과 마찬가지로 워터마크의 위치는 Zencoder가 액세스할 수url있는 를 통해 지정됩니다.

Zencoder를 사용하면 다음 설정을 통해 워터마크의 위치를 지정하고 크기를 조정할 수 있습니다.

위치/크기 설정
설정 설명
x 픽셀 수, 비디오 너비의 백분율 또는 다음과 같이 표시되는 워터마크의 가로centered위치입니다. x가 양수 또는 백분율일 경우 비디오의 왼쪽 가장자리부터 이미지의 왼쪽 가장자리까지 측정됩니다. 값이 음수이면x비디오의 오른쪽 가장자리부터 이미지의 오른쪽 가장자리까지 측정됩니다. 기본: -10
y 픽셀 수, 비디오 너비의 백분율 또는 다음과 같이 표시되는 워터마크의 세로centered위치입니다. y가 양수 또는 백분율일 경우 비디오 상단 가장자리부터 이미지 상단 가장자리까지 측정됩니다. 값이 음수이면y비디오의 아래쪽 가장자리부터 이미지의 아래쪽 가장자리까지 측정됩니다. 기본: -10
width 픽셀 수 또는 비디오 너비의 백분율로 표시되는 워터마크의 너비입니다. 기본값: 이미지의 실제 너비.
height 픽셀 수 또는 비디오 높이의 백분율로 표시되는 워터마크의 높이입니다. 기본값: 이미지의 실제 높이.

참고 사항

  • 위의 모든 설정은 픽셀 값이 있는 경우 문자열이나 숫자로 입력할 수 있습니다.
  • 사용하지width않으면 이미지가 늘어나거나 눌려 이미지 품질이 저하됩니다. height
  • 이미지 크기를 조정해야 하는 경우width또는 중 하나를height지정하되 둘 다 지정하지는 마십시오. 이 경우 종횡비를 유지하면서 다른 차원의 크기가 적절하게 조정됩니다.
  • 워터마크는 할당된 출력의 프레임 크기에 완전히 맞도록 크기와 위치를 지정해야 합니다. 그렇지 않으면 Zencoder에서 오류를 반환합니다.
  • 콘텐츠 크기가 다른 경우 콘텐츠 크기가 아닌 비디오 프레임 크기를 기준으로 모든 측정을 수행할 수 있는 기능도 있지만 이는 드문 경우입니다. origin

아래 다이어그램은x및y설정의 작동 방식을 보여줍니다.

워터마크 위치 지정
워터마크 위치 지정

샘플

아래 샘플은 다음 설정으로 워터마크 처리되었습니다.

{
  "input": "https://support.brightcove.com/test-assets/videos/oystercatcher.mp4",
  "outputs": [
    {
      "watermarks": {
        "url": "https://support.brightcove.com/test-assets/images/watermark.png",
        "x": "centered",
        "y": "centered"
      }
    }
  ]
}

투명무늬

watermarks:Array or Hash

API 버전: V2

부모의:출력또는 dynamic_profile_options

유효한 값 : 워터 마크 설정의 배열 또는 해시

호환 가능한 작업 유형: VOD

설명:

워터 마킹 API를 사용하여 출력 비디오에 하나 이상의 워터 마크를 추가 할 수 있습니다. Zencoder는 JPEG, BMP 또는 PNG 형식의 출력 당 최대 4 개의 워터 마크 파일을 지원합니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        "워터 마크": [
          {
            "url": "s3 : //bucket/watermark_file.png",
            “x”: 20,
            "y": "-10 %",
            “ 너비”: 32,
            “높이”: 24
          }
        ]
      }
    ]
  }

URL

url:String

API 버전: V2

부모의:출력 / 워터 마크

유효한 값 : 이미지 파일에 대한 유효한 URL입니다.

호환 가능한 작업 유형: 주문형 비디오

예:

  • https://s3.amazonaws.com/bucket/img.png
  • ftp : // user : pass@example.com/path/to/watermark.jpg

설명:

워터마크로 사용할 원격 이미지 파일의 URL입니다. 사용입력 URL 구문. 인증 유무에 관계없이 S3, GCS, 클라우드 파일, HTTP / S, FTP 및 SFTP를 지원합니다.

Zencoder는 JPEG, BMP 또는 PNG 형식의 워터마크 파일을 지원합니다.

투명한 워터 마크의 경우 알파 또는 인덱스 투명도가있는 PNG를 사용합니다.

지원되는 PNG 형식

  • 8 비트 RGB
  • 8 비트 RGB + 알파
  • 8 비트 그레이 스케일
  • 8 비트 인덱스
  • 8 비트 인덱싱 + 투명성
  • 16 비트 RGB
  • 16 비트 그레이 스케일

지원되지 않는 PNG 형식

  • 8 비트 그레이 스케일 + 알파
  • 16 비트 그레이 스케일 + 알파
  • 16 비트 RGB + 알파
  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          "url": "https://s3.amazonaws.com/bucket/img.png"
        }
      }
    ]
  }

x

x:String or Number

API 버전: V2

부모의:출력 / 워터 마크

기본: -10

호환 가능한 작업 유형: 주문형 비디오

예:

  • -0
  • 320
  • 중심에 있는

설명:

비디오 내 x 축 (왼쪽 / 오른쪽)에서 워터 마크를 배치 할 위치입니다. 픽셀 수 (예: 100 또는 -20), 비디오 폭의 퍼센트 (예: 25% 또는 -5%) 또는 워터마크를 비디오 가운데에 맞추기 위해 '가운데'가 될 수 있습니다. 양수를 사용하여 비디오의 왼쪽을 기준으로 배치하고 음수를 사용하여 비디오의 오른쪽을 기준으로 배치합니다. "-0"(문자열)을 사용하여 오른쪽으로 잠급니다.

기본적으로 위치는 패딩을 포함하지 않고 표시되는 내용 영역을 기반으로 합니다. 사용하다유래전체 출력을 기준으로 워터 마크 위치를 설정합니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          “x”: 320
        }
      }
    ]
  }

또한보십시오:와이과유래

y

y:String or Number

API 버전: V2

부모의:출력 / 워터 마크

기본: -10

호환 가능한 작업 유형: 주문형 비디오

예:

  • -0
  • 320
  • 중심에 있는

설명:

비디오 내 y 축 (위 / 아래)에서 워터 마크를 배치 할 위치입니다. 픽셀 수 (예: 100 또는 -20), 비디오 폭의 퍼센트 (예: 25% 또는 -5%) 또는 워터마크를 비디오 가운데에 맞추기 위해 '가운데'가 될 수 있습니다. 양수를 사용하여 비디오의 위쪽을 기준으로 배치하고 음수를 사용하여 비디오의 아래쪽을 기준으로 배치합니다. "-0"(문자열)을 사용하여 하단에 고정합니다.

기본적으로 위치는 패딩을 포함하지 않고 표시되는 내용 영역을 기반으로 합니다. 사용하다유래전체 출력을 기준으로 워터 마크 위치를 설정합니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          "와이": 320
        }
      }
    ]
  }

또한보십시오:엑스과유래

폭

width:Number or String

API 버전: V2

부모의:출력 / 워터 마크

기본: 확장신장 , 또는 원본 이미지 너비.

유효한 값 : 양수 또는 백분율

호환 가능한 작업 유형: VOD

설명:

워터 마크의 너비로, 픽셀 수 (예 : 64) 또는 비디오 너비의 백분율 (예 : 10 %)로 표시됩니다. 만약신장제공되지만 너비가 아닌 경우 워터 마크 이미지는 비례 적으로 조정됩니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          “ 너비”: 100
        }
      }
    ]
  }

또한보십시오:신장

신장

height:Number or String

API 버전: V2

부모의:출력 / 워터 마크

기본: 확장폭 , 또는 원본 이미지 높이.

유효한 값 : 양수 또는 백분율

호환 가능한 작업 유형: VOD

설명:

워터 마크의 높이로, 픽셀 수 (예 : 64) 또는 비디오 높이의 백분율 (예 : 10 %)로 표시됩니다. 만약폭제공되지만 높이가 아닌 경우 워터 마크 이미지는 비례 적으로 크기가 조정됩니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          “높이”: 100
        }
      }
    ]
  }

또한보십시오:폭

유래

origin:String

API 버전: V2

부모의:출력 / 워터 마크

기본:함유량

유효한 값 :내용 또는 프레임

호환 가능한 작업 유형: VOD

예:틀

설명:

워터 마크 위치의 기준이되는 비디오 부분입니다. 이것은 aspect_mode가 'pad'인 작업에만 영향을 미칩니다.

  • 'frame'은 패딩을 포함하여 출력의 전체 해상도를 기준으로 배치합니다.
  • 'content'는 패딩을 포함하지 않고 보이는 콘텐츠 영역을 기반으로 배치됩니다.
  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          "origin": "내용"
        }
      }
    ]
  }

또한보십시오:엑스 , 와이 , 및 aspect_mode

불투명

opacity:Float

API 버전: V2

부모의:출력 / 워터 마크

기본: 1.0

유효한 값 : 0.0에서 1.0

호환 가능한 작업 유형: 주문형 비디오

예: 0.5

설명:

0.0 (투명)과 1.0 (불투명) 사이의 불투명도 값을 설정하여 워터 마크를 투명하게 만듭니다.

  {
    “입력”: “S3: //zencodertesting/test.mov”,
    “출력”: [
      {
        “워터마크”: {
          "불투명": 0.5
        }
      }
    ]
  }

또한보십시오: URL