---
url: "/pt/tinyimage/automation/parameters.md"
description: "Execute as Quick Actions do TinyImage com campos nomeados simples e atalhos para a seleção atual."
---

# Quick Actions do TinyImage

> Execute as Quick Actions do TinyImage com campos nomeados simples e atalhos para a seleção atual.

Execute tarefas comuns do TinyImage pelas Quick Actions do Figma sem abrir o painel do plugin. Escolha um dos atalhos nomeados abaixo. Use o painel normal do plugin para configurações detalhadas e para criar conteúdo.

## Executar uma Quick Action {#run-a-quick-action}

Os controles do Figma Motion mantidos apenas no painel aberto não são preservados entre execuções; esses controles usam campos explícitos do atalho ou as alternativas documentadas.

Todo atalho exige uma licença válida verificada ou testes restantes. Se a verificação falhar ou seus testes tiverem acabado, abra o painel normal do plugin para ativar sua licença. Abrir o painel continua disponível.

1. Selecione as camadas com que você quer trabalhar, se o atalho usar uma seleção.
2. Abra as Quick Actions do Figma com **Command + /** no Mac ou **Ctrl + /** no Windows.
3. Pesquise o plugin e escolha o atalho nomeado abaixo.
4. Preencha os campos exibidos. Os campos opcionais podem ser ignorados; use Tab para editá-los. Execute o atalho e confira o resultado ou conclua a caixa de diálogo de salvamento.

Os atalhos de criação pedem nomes ou dimensões diretamente. Os atalhos de camadas selecionadas usam a seleção atual automaticamente. Esses atalhos do dia a dia não pedem Target nem JSON. Escolha **Open TinyImage** para abrir o painel normal do plugin.

| Atalho | Campos |
| --- | --- |
| **Compress Selected Layers (Custom Settings…)** | Quality (1–100) (optional) |
| **Convert Selected Layers (Custom Settings…)** | Convert format, Quality (1–100) (optional) |
| **Export Selected Layers as PDF** | Nenhum; é executado na hora |
| **Export Selected Figma Motion (Custom Settings…)** | Format (optional), Frames per second (optional) |
| **Arrange Selected Layers (Custom Settings…)** | Layout (optional), Horizontal gap (px) (optional), Vertical gap (px) (optional) |

Os campos de opções fixas usam rótulos legíveis. Pesquise pelo rótulo exibido ou pelo valor correspondente; as entradas de agentes continuam usando os valores mostrados na referência de comandos.

## Executar pelo menu de contexto {#run-from-the-context-menu}

Selecione as camadas desejadas, clique com o botão direito e escolha **Plugins → TinyImage** (os plugins em desenvolvimento aparecem em **Development**). Escolha uma ação e o formato ou a predefinição dela. Uma predefinição é executada na hora quando não precisa de nenhum campo obrigatório; conclua a caixa de diálogo de salvamento quando ela aparecer.

Cada predefinição define a opção indicada no nome. As opções compatíveis omitidas herdam as configurações salvas do plugin; uma ação ou opção explícita tem prioridade sobre um comportamento salvo conflitante. Somente os campos preenchidos explicitamente ou a opção escolhida no menu substituem essas configurações naquela execução. Se uma configuração nunca foi salva, vale a configuração normal ou a alternativa documentada. As substituições de exportação não são salvas nas suas preferências. Se um formato salvo não estiver disponível como atalho, escolha explicitamente um formato compatível ou use o painel normal. Para combinar opções, escolha **Custom Settings…** dentro da ação e preencha os parâmetros. As ações que precisam de textos, URLs, nomes ou dimensões continuam pedindo esses campos obrigatórios. **Open TinyImage** abre o painel normal.

**Compress Selected Layers** sempre mantém os formatos de exportação originais, mesmo quando uma conversão está salva no painel normal. Use **Convert Selected Layers** para escolher WebP, AVIF ou Tiny SVG. A conversão exige um formato explícito; a qualidade omitida e as outras preferências de compressão continuam herdando as configurações salvas. Uma qualidade explícita desativa os modos salvos sem perdas e de tamanho alvo naquela execução; chamadores avançados podem ativar esses modos explicitamente. Os atalhos de exportação nunca reduzem os preenchimentos de imagem das camadas de origem no Figma. **Arrange Selected Layers** sempre organiza as camadas, herdando apenas o layout e o espaçamento. Ele não renomeia, ordena, envolve instâncias nem atualiza o texto de paginação; solicite essas operações explicitamente pelas opções avançadas, se necessário. Crie canvas de impressão e ajuste as configurações de impressão no painel normal. A taxa de quadros do Motion continua disponível em Custom Settings.

| Opção do menu | Próximo passo |
| --- | --- |
| **Compress Selected Layers → Use Saved Settings** | É executada na hora |
| **Compress Selected Layers → Compress Selected Layers (Custom Settings…)** | Preencha Quality (1–100) (optional) |
| **Convert Selected Layers → JPG and PNG to WebP** | É executada na hora |
| **Convert Selected Layers → Only JPG to WebP** | É executada na hora |
| **Convert Selected Layers → Only PNG to WebP** | É executada na hora |
| **Convert Selected Layers → JPG and PNG to AVIF** | É executada na hora |
| **Convert Selected Layers → SVG to Tiny 1.2 SVG** | É executada na hora |
| **Convert Selected Layers → Convert Selected Layers (Custom Settings…)** | Preencha Convert format, Quality (1–100) (optional) |
| **Export Selected Layers as PDF** | É executada na hora |
| **Export Selected Figma Motion → Use Default Settings** | É executada na hora |
| **Export Selected Figma Motion → Animated GIF** | É executada na hora |
| **Export Selected Figma Motion → MP4 Video** | É executada na hora |
| **Export Selected Figma Motion → WebM Video** | É executada na hora |
| **Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…)** | Preencha Format (optional), Frames per second (optional) |
| **Arrange Selected Layers → Use Saved Layout and Spacing** | É executada na hora |
| **Arrange Selected Layers → Automatic** | É executada na hora |
| **Arrange Selected Layers → Rows** | É executada na hora |
| **Arrange Selected Layers → Columns** | É executada na hora |
| **Arrange Selected Layers → Arrange Selected Layers (Custom Settings…)** | Preencha Layout (optional), Horizontal gap (px) (optional), Vertical gap (px) (optional) |

## Edição detalhada {#detailed-editing}

Use o painel normal do plugin para configurações detalhadas, conteúdos mais longos, criação em massa e navegação por componentes ou templates. O menu de atalhos contém apenas os comandos do dia a dia listados acima.

Mantenha cada campo colado com menos de 150 caracteres: o app para desktop do Figma pode cortar o texto colado nesse limite. Entradas mais longas devem ser feitas no painel normal.

Se um plugin mais antigo mostrar Action, Target e Options, atualize-o para usar estes atalhos nomeados. Um valor de Target é um ID de camada ou uma seleção, nunca o nome de um novo item.

## Ações do TinyImage {#tinyimage-actions}

| Ação | O que faz | Target |
| --- | --- | --- |
| [`compress`](#compress) | Comprime as camadas selecionadas sem alterar os formatos de exportação delas no Figma | Uma ou mais camadas elegíveis |
| [`pdf`](#pdf) | Junta os frames selecionados em um PDF para tela | Uma ou mais camadas elegíveis |
| [`motion`](#motion) | Exporta o Figma Motion nativo de uma única origem | Exatamente uma camada elegível |
| [`convert`](#convert) | Converte as camadas selecionadas para um formato de saída escolhido explicitamente | Uma ou mais camadas elegíveis |
| [`tidy`](#tidy) | Organiza camadas irmãs explícitas; ordenar, envolver, renomear e atualizar a paginação exigem opções explícitas | Uma ou mais camadas elegíveis |

### compress {#compress}

Comprime as camadas selecionadas sem alterar os formatos de exportação delas no Figma. Selecione uma ou mais camadas elegíveis.

| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
| --- | --- | --- | --- |
| `quality` | number | Alternativa: `90` | Qualidade da compressão. Mínimo 1; máximo 100 |

Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.

Escolha **Compress Selected Layers (Custom Settings…)**. Preencha estes campos simples; nenhum JSON é necessário:

- **Quality (1–100)**: `90`

Entrada para o host do agente

```json
{"command":"shortcut-compress","parameters":{"quality":"90"}}
```

### pdf {#pdf}

Junta os frames selecionados em um PDF para tela. Selecione uma ou mais camadas elegíveis.

Este atalho não tem campos.

Escolha **Export Selected Layers as PDF**. O atalho é executado na hora com a seleção atual.

Entrada para o host do agente

```json
{"command":"shortcut-pdf","parameters":{}}
```

### motion {#motion}

Exporta o Figma Motion nativo de uma única origem. Selecione exatamente uma camada elegível.

| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
| --- | --- | --- | --- |
| `format` | string | Alternativa: `"GIF"` | Formato da animação. `GIF`, `MP4`, `WEBM` |
| `fps` | number | Alternativa: `30` | Quadros por segundo; as restrições nativas do plano continuam valendo. `10`, `15`, `24`, `25`, `30`, `60` |

Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.

Escolha **Export Selected Figma Motion (Custom Settings…)**. Preencha estes campos simples; nenhum JSON é necessário:

- **Format**: **Animated GIF**
- **Frames per second**: **30 fps**

Entrada para o host do agente

```json
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}
```

### convert {#convert}

Converte as camadas selecionadas para um formato de saída escolhido explicitamente. Selecione uma ou mais camadas elegíveis.

| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
| --- | --- | --- | --- |
| `convert` | string | Obrigatória | Conversão de saída; use compress para manter os formatos originais. `webp`, `webpjpg`, `webppng`, `avif`, `tinysvg` |
| `quality` | number | Alternativa: `90` | Qualidade da compressão. Mínimo 1; máximo 100 |

Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.

Escolha **Convert Selected Layers (Custom Settings…)**. Preencha estes campos simples; nenhum JSON é necessário:

- **Convert format**: **JPG and PNG to WebP**
- **Quality (1–100)**: `90`

Entrada para o host do agente

```json
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}
```

### tidy {#tidy}

Organiza camadas irmãs explícitas; ordenar, envolver, renomear e atualizar a paginação exigem opções explícitas. Selecione uma ou mais camadas elegíveis.

| Opção | Tipo | Obrigatória / padrão | Significado e valores aceitos |
| --- | --- | --- | --- |
| `layout` | string | Alternativa: `"auto"` | Direção do layout. `auto`, `rows`, `columns` |
| `horizontalSpacing` | number | Alternativa: `100` | Espaçamento horizontal em pixels. Mínimo 0; máximo 10000 |
| `verticalSpacing` | number | Alternativa: `100` | Espaçamento vertical em pixels. Mínimo 0; máximo 10000 |

Os campos obrigatórios aninhados valem quando o objeto pai ou o item do array correspondente é informado. Os valores opcionais omitidos usam o comportamento atual da operação, a menos que um padrão esteja indicado.

Escolha **Arrange Selected Layers (Custom Settings…)**. Preencha estes campos simples; nenhum JSON é necessário:

- **Layout**: **Automatic**
- **Horizontal gap (px)**: `100`
- **Vertical gap (px)**: `100`

Entrada para o host do agente

```json
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}
```

## Usar os atalhos com um agente {#using-shortcuts-with-an-agent}

Leia o registro legível por máquina indicado abaixo e escolha uma ação oferecida na lista de Quick Actions do plugin instalado. O registro usa as definições de opções da Hypermatic, e não o JSON Schema padrão: `min` e `max` limitam o tamanho da string, o tamanho do array ou o valor numérico, conforme o tipo do campo; as definições aninhadas usam `fields` e `item`. Campos desconhecidos são rejeitados.

O agente precisa de um host capaz de acionar as Quick Actions do Figma e acompanhar o resultado normal do plugin. Os parâmetros não adicionam um disparador REST ou MCP. Os exemplos expansíveis são dados de entrada para um host compatível, não chamadas de API executáveis; as entradas dos atalhos usam strings simples em `parameters`, incluindo números e escolhas de formato. Nunca afirme que um atalho foi executado só com base na entrada preparada.

Confira o resultado visível: as camadas do Figma alteradas, a exportação salva ou a página publicada. Leia a notificação normal de sucesso/erro e qualquer aviso de exportação parcial. Conclua as caixas de diálogo de salvamento nativas quando necessário; o início de um download não prova que o arquivo foi salvo. Os usuários não precisam abrir as ferramentas de desenvolvedor nem ler um console.

## Solução de problemas {#troubleshooting}

| Sintoma | Próximo passo |
| --- | --- |
| A ação não está disponível | Atualize o plugin e confira a lista de Quick Actions dele; use o painel normal se a ação não estiver disponível. |
| As opções são inválidas ou podem ter sido cortadas | Use valores simples em campos individuais, com menos de 150 caracteres, e apenas os campos aceitos por aquele atalho. |
| O Target está ausente ou não é elegível | Abra a página correta, confira os requisitos de camadas da ação e selecione de novo as camadas desejadas. |
| Aparece um erro de licença ou de teste | Conclua o fluxo normal de ativação do plugin antes de executar de novo. |
| O download foi solicitado, mas nenhum arquivo salvo aparece | Confira a caixa de diálogo de salvamento nativa e o local de download. Inspecione o arquivo em si. |
| Um comando falha, excede o tempo limite ou é cancelado | Confira o documento e o destino remoto antes de tentar de novo; alterações ou uploads anteriores podem já existir. |

Os comandos têm um prazo de cinco minutos. Os erros não implicam a reversão completa. Repetir automaticamente uma criação, substituição ou upload pode duplicar ou sobrescrever trabalho.

O [registro de comandos legível por máquina](/automation/parameters/tinyimage.json) contém os mesmos IDs de ação e definições de opções.

## Limites atuais {#current-limits}

A compressão usa os formatos de exportação do Figma definidos nas camadas selecionadas; a conversão exige um formato escolhido. Os atalhos de exportação não reduzem os preenchimentos de imagem de origem. O Motion aceita uma única origem; defina a taxa de quadros em Custom Settings. O Arrange altera apenas o layout e o espaçamento. Canvas de impressão, canvas de logotipos, montagem de vídeos em lote e os controles detalhados do Tidy usam o painel normal.

## Documentação relacionada {#related-documentation}

- [Instalar e executar o TinyImage](/pt/tinyimage/overview/install)
- [Parâmetros de plugins do Figma](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Opções de UI oculta do Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)