video_reframe

Экран, окна и интерфейс · macOS · Windows

Эффект: запись. Статус: условно доступен.

«Условная доступность» означает, что инструмент может зависеть от версии, платформы, разрешений, учётной записи или настроек. Он доступен не во всех установках.

macOS

Назначение

Обрезает видео до нужного соотношения сторон (например, "9:16" вертикальное, "1:1" квадрат, "4:5") вокруг точки фокуса — для клипов в соцсетях. Берёт НАИБОЛЬШУЮ обрезку этого формата, которая помещается в кадр, с центром в `focus` (x,y в пикселях источника, начало в левом верхнем углу; по умолчанию — центр) и ограничивается границами кадра. Звук сохраняется. Возвращает путь к результату и новые размеры. Первый вызов показывает предпросмотр; confirm: true записывает файл.

Обязательные входные данные

input
aspect

Имена сохранены в точности как их требует инструмент. Канонические технические определения на английском находятся в раскрываемой схеме ниже.

Разрешения и подтверждение

Схема объявляет явный параметр подтверждения. Проверьте предварительный результат и разрешите реальную операцию согласно контракту платформы.

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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 выполняет экспорт.

Обязательные входные данные

input
aspect

Разрешения и подтверждение

Используйте на этой платформе только приложения, учетные записи и ресурсы, разрешенные пользователем. Требования к подключению и разрешениям приведены в описании инструмента для конкретной платформы; этот каталог не заявляет о дополнительных областях OAuth или разрешениях OS.

Каноническая техническая схема на английском — 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"
}

Пример для документации

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