Ir para o conteúdo
Todas as ferramentas

video_reframe

Ecrã, janelas e interface · macOS · Windows

Efeito: escrita. Estado: disponibilidade condicionada.

«Disponibilidade condicionada» significa que a ferramenta pode depender da versão, plataforma, permissões, conta ou configuração. Não significa que esteja ativa em todas as instalações.

macOS

Finalidade

Recorta um vídeo para uma proporção alvo (por exemplo "9:16" vertical, "1:1" quadrado, "4:5") em torno de um ponto de foco — para clipes de redes sociais. Usa o MAIOR recorte dessa proporção que couber, centralizado em `focus` (x,y em pixels da origem, origem no canto superior esquerdo; padrão = centro) e limitado ao quadro. O áudio é mantido. Retorna o caminho de saída + as novas dimensões. A primeira chamada mostra uma prévia; confirm: true grava o arquivo.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para video_reframe. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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

Windows

Finalidade

Recorta um vídeo para uma proporção alvo (por exemplo "9:16" vertical, "1:1" quadrado, "4:5") em torno de um ponto de foco — para clipes de redes sociais. Usa o MAIOR recorte dessa proporção que caiba, centrado em `focus` (x,y em pixels da origem, origem no canto superior esquerdo; por padrão = centro) e limitado ao quadro. O áudio é mantido. Retorna o caminho de saída + as novas dimensões. A primeira chamada retorna uma prévia e não escreve nada; confirm=true exporta.

Entradas obrigatórias

Os nomes são mantidos exatamente como a ferramenta exige. As definições técnicas canónicas em inglês estão no esquema expansível abaixo.

Permissões e confirmação

O esquema declara um parâmetro explícito de confirmação. Reveja a pré-visualização e autorize a operação real de acordo com o contrato da plataforma.

Esquema técnico canónico em 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"
}

Exemplo documental

Exemplo de documentação para video_reframe. Não execute este exemplo. Os argumentos apresentados pertencem a um conjunto de dados fictício; resolva identificadores reais e obtenha autorização antes de uma chamada real.

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