video_reframe

Écran, fenêtres et interface · macOS · Windows

Effet: écriture. État: disponibilité conditionnelle.

«Disponibilité conditionnelle» signifie que l’outil peut dépendre de la version, de la plateforme, des autorisations, du compte ou de la configuration. Il n’est pas forcément actif partout.

macOS

Objectif

Recadre une vidéo selon un format cible (p. ex. "9:16" vertical, "1:1" carré, "4:5") autour d’un point de focalisation — pour les clips destinés aux réseaux sociaux. Prend le PLUS GRAND recadrage de ce format qui tient dans l’image, centré sur `focus` (x,y en pixels source, origine en haut à gauche ; par défaut = centre) et borné à l’image. L’audio est conservé. Renvoie le chemin de sortie et les nouvelles dimensions. Le premier appel affiche un aperçu ; confirm: true écrit le fichier.

Entrées requises

input
aspect

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

Exemple de documentation pour video_reframe. N’exécutez pas cet exemple. Les arguments présentés appartiennent à un jeu de données fictif ; résolvez les identifiants réels et obtenez une autorisation avant tout appel réel.

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

Windows

Objectif

Recadre une vidéo selon un format cible (p. ex. "9:16" vertical, "1:1" carré, "4:5") autour d’un point de focalisation — pour les clips destinés aux réseaux sociaux. Prend le PLUS GRAND recadrage de ce format qui tient dans l’image, centré sur `focus` (x,y en pixels source, origine en haut à gauche ; par défaut = centre) et borné à l’image. L’audio est conservé. Renvoie le chemin de sortie et les nouvelles dimensions. Le premier appel renvoie un aperçu et n’écrit rien ; confirm=true exporte.

Entrées requises

input
aspect

Les noms restent exactement ceux exigés par l’outil. Les définitions techniques canoniques en anglais figurent dans le schéma dépliable ci-dessous.

Autorisations et confirmation

Le schéma déclare un paramètre de confirmation explicite. Vérifiez l’aperçu et autorisez l’opération réelle conformément au contrat de la plateforme.

Utilisez uniquement les applications, comptes et ressources autorisés par l'utilisateur sur cette plateforme. Consultez la description spécifique à la plate-forme de cet outil pour connaître ses exigences de connexion et d'autorisation ; ce catalogue ne revendique pas d'étendues OAuth ou de droits d'exploitation supplémentaires pour le système d'exploitation.

Schéma technique canonique en anglais — 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"
}

Exemple documentaire

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