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
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.
- Selecione as camadas com que você quer trabalhar, se o atalho usar uma seleção.
- Abra as Quick Actions do Figma com Command + / no Mac ou Ctrl + / no Windows.
- Pesquise o plugin e escolha o atalho nomeado abaixo.
- 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
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
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
| Ação | O que faz | Target |
|---|---|---|
compress | Comprime as camadas selecionadas sem alterar os formatos de exportação delas no Figma | Uma ou mais camadas elegíveis |
pdf | Junta os frames selecionados em um PDF para tela | Uma ou mais camadas elegíveis |
motion | Exporta o Figma Motion nativo de uma única origem | Exatamente uma camada elegível |
convert | Converte as camadas selecionadas para um formato de saída escolhido explicitamente | Uma ou mais camadas elegíveis |
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
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
{"command":"shortcut-compress","parameters":{"quality":"90"}}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
{"command":"shortcut-pdf","parameters":{}}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
{"command":"shortcut-motion","parameters":{"format":"GIF","fps":"30"}}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
{"command":"shortcut-convert","parameters":{"convert":"webp","quality":"90"}}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
{"command":"shortcut-tidy","parameters":{"layout":"auto","horizontalSpacing":"100","verticalSpacing":"100"}}Usar os atalhos com um agente
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
| 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 contém os mesmos IDs de ação e definições de opções.
Limites atuais
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.