Saltar al contenido
Todas las herramientas

video_reframe

Pantalla, ventanas e interfaz · macOS · Windows

Efecto: escritura. Estado: disponibilidad controlada.

«Disponibilidad controlada» significa que la herramienta figura en los artefactos publicados y puede depender de versión, plataforma, permisos, cuenta o configuración. Esta referencia no promete que esté activa en todas las instalaciones. Que una herramienta figure para macOS no implica que esté disponible en Windows, ni al revés.

macOS

Propósito

Recorta un video a una relación de aspecto objetivo (p. ej. "9:16" vertical, "1:1" cuadrado, "4:5") alrededor de un punto de enfoque, para clips de redes sociales. Toma el recorte MÁS GRANDE de esa relación de aspecto que quepa, centrado en `focus` (x,y en píxeles de origen, origen arriba a la izquierda; por defecto = centro) y ajustado al encuadre. El audio se conserva. Devuelve la ruta de salida y las nuevas dimensiones. La primera llamada muestra una vista previa; confirm: true escribe el archivo.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para video_reframe. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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

Windows

Propósito

Recorta un video a una relación de aspecto objetivo (p. ej. "9:16" vertical, "1:1" cuadrado, "4:5") alrededor de un punto de enfoque, para clips de redes sociales. Toma el recorte MÁS GRANDE de esa relación de aspecto que quepa, centrado en `focus` (x,y en píxeles de origen, origen arriba a la izquierda; por defecto = centro) y ajustado al encuadre. El audio se conserva. Devuelve la ruta de salida y las nuevas dimensiones. La primera llamada devuelve una vista previa y no escribe nada; confirm=true exporta.

Entradas obligatorias

Los nombres se conservan exactamente como los exige la herramienta. Las definiciones técnicas canónicas, en inglés, están en el esquema expandible de abajo.

Permisos y confirmación

El esquema declara un parámetro explícito de confirmación. Revisa la vista previa y autoriza la operación real según el contrato de esta plataforma.

Esquema técnico canónico en inglés — 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"
}

Ejemplo documental

Ejemplo de documentación para video_reframe. No ejecutes este ejemplo. Los argumentos mostrados pertenecen a un conjunto de datos ficticio; resuelve identificadores reales y obtén autorización antes de una llamada real.

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