본문으로 건너뛰기
모든 도구

video_reframe

화면, 윈도우 및 인터페이스 · macOS · Windows

효과: 쓰기. 상태: 조건부 제공.

‘조건부 제공’은 도구가 버전, 플랫폼, 권한, 계정 또는 설정에 따라 달라질 수 있음을 뜻하며 모든 설치에서 활성화되었다는 의미는 아닙니다.

macOS

목적

영상을 초점 주변의 목표 화면 비율(예: "9:16" 세로, "1:1" 정사각형, "4:5")로 자릅니다. 소셜 클립용입니다. 해당 비율로 들어가는 가장 큰 영역을 `focus`(원본 픽셀의 x,y, 좌상단 기준, 기본값 = 중앙)를 중심으로 잡고 프레임 안으로 맞춥니다. 오디오는 그대로 유지됩니다. 출력 경로와 새 크기를 반환합니다. 첫 번째 호출은 미리보기를 반환하며, confirm: true로 설정하면 파일을 씁니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — macOS
{
  "properties": {
    "aspect": {
      "description": "Target aspect \"W:H\", e.g. 9:16, 1:1, 4:5, 16:9.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to write the output. Without it the call returns a preview and writes nothing.",
      "type": "boolean"
    },
    "focus": {
      "description": "{x,y} center of interest in source pixels (top-left). Default: frame center.",
      "type": "object"
    },
    "input": {
      "description": "Path to the source video file.",
      "type": "string"
    },
    "output": {
      "description": "Default: <input>_<aspect>.mov. Missing parent folders are created.",
      "type": "string"
    },
    "overwrite": {
      "description": "Replace an existing file at output. Without it an existing output is refused. The input is never overwritten.",
      "type": "boolean"
    }
  },
  "required": [
    "input",
    "aspect"
  ],
  "type": "object"
}

문서 예시

video_reframe 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "aspect": "9:16",
  "confirm": false,
  "input": "/Users/demo/Documents/meeting.mov"
}

Windows

목적

영상을 초점 주변의 목표 화면 비율(예: "9:16" 세로, "1:1" 정사각형, "4:5")로 자릅니다. 소셜 클립용입니다. 해당 비율로 들어가는 가장 큰 영역을 `focus`(원본 픽셀의 x,y, 좌상단 기준, 기본값 = 중앙)를 중심으로 잡고 프레임 안으로 맞춥니다. 오디오는 그대로 유지됩니다. 출력 경로와 새 크기를 반환합니다. 첫 번째 호출은 미리보기를 반환하며 아무것도 쓰지 않고, confirm=true로 설정하면 내보냅니다.

필수 입력

입력 이름은 도구가 요구하는 정확한 형태로 유지됩니다. 영문 정식 기술 정의는 아래 펼칠 수 있는 스키마에 있습니다.

권한 및 확인

스키마에 명시적 확인 매개변수가 있습니다. 미리보기를 검토하고 플랫폼 계약에 따라 실제 작업을 승인하세요.

영문 정식 기술 스키마 — Windows
{
  "properties": {
    "aspect": {
      "description": "Target aspect \"W:H\", e.g. 9:16, 1:1, 4:5, 16:9.",
      "type": "string"
    },
    "confirm": {
      "description": "Must be true to export. Without it, returns a preview.",
      "type": "boolean"
    },
    "focus": {
      "description": "{x,y} center of interest in source pixels (top-left). Default: frame center.",
      "type": "object"
    },
    "input": {
      "description": "Path to the source video.",
      "type": "string"
    },
    "output": {
      "description": "Output path (default: <input>_<aspect>.mov).",
      "type": "string"
    }
  },
  "required": [
    "input",
    "aspect"
  ],
  "type": "object"
}

문서 예시

video_reframe 문서 예시입니다. 이 예시를 실행하지 마세요. 표시된 인수는 가상 데이터 세트에 속합니다. 실제 호출 전에 실제 식별자를 확인하고 승인을 받으세요.

{
  "aspect": "9:16",
  "confirm": false,
  "input": "C:\\Users\\demo\\Documents\\meeting.mov"
}