---
url: "/fr/tinyimage/automation/parameters.md"
description: "Lancez les Quick Actions de TinyImage avec des champs simples et nommés, et des raccourcis qui agissent sur la sélection en cours."
---

# Quick Actions de TinyImage

> Lancez les Quick Actions de TinyImage avec des champs simples et nommés, et des raccourcis qui agissent sur la sélection en cours.

Lancez les tâches courantes de TinyImage depuis les Quick Actions de Figma, sans ouvrir le panneau du plugin. Choisissez un raccourci nommé ci-dessous. Utilisez le panneau habituel du plugin pour les réglages détaillés et la création de contenu.

## Lancer une Quick Action {#run-a-quick-action}

Les réglages Figma Motion conservés uniquement dans le panneau ouvert ne sont pas mémorisés d’une exécution à l’autre ; ces réglages utilisent les champs explicites du raccourci ou les valeurs de repli documentées.

Chaque raccourci exige une licence valide et vérifiée, ou des essais restants. Si la vérification échoue ou si vos essais ont expiré, ouvrez le panneau habituel du plugin pour activer votre licence. Le panneau reste toujours accessible.

1. Sélectionnez les calques sur lesquels vous voulez travailler, si le raccourci utilise une sélection.
2. Ouvrez les Quick Actions de Figma avec **Command + /** sur Mac ou **Ctrl + /** sous Windows.
3. Recherchez le plugin et choisissez le raccourci nommé ci-dessous.
4. Remplissez les champs affichés. Les champs facultatifs peuvent être ignorés ; utilisez la touche Tab pour les modifier. Lancez le raccourci, puis vérifiez le résultat ou terminez sa boîte de dialogue d’enregistrement.

Les raccourcis de création demandent directement des noms ou des dimensions. Les raccourcis qui agissent sur les calques sélectionnés utilisent automatiquement la sélection en cours. Ces raccourcis du quotidien ne demandent ni Target ni JSON. Choisissez **Open TinyImage** pour ouvrir le panneau habituel du plugin.

| Raccourci | Champs |
| --- | --- |
| **Compress Selected Layers (Custom Settings…)** | Quality (1–100) (facultatif) |
| **Convert Selected Layers (Custom Settings…)** | Convert format, Quality (1–100) (facultatif) |
| **Export Selected Layers as PDF** | Aucun ; s’exécute immédiatement |
| **Export Selected Figma Motion (Custom Settings…)** | Format (facultatif), Frames per second (facultatif) |
| **Arrange Selected Layers (Custom Settings…)** | Layout (facultatif), Horizontal gap (px) (facultatif), Vertical gap (px) (facultatif) |

Les champs à choix fixes utilisent des libellés lisibles. Recherchez par le libellé affiché ou par la valeur sous-jacente ; les entrées des agents continuent d’utiliser les valeurs indiquées dans la référence des commandes.

## Lancer depuis le menu contextuel {#run-from-the-context-menu}

Sélectionnez les calques voulus, faites un clic droit et choisissez **Plugins → TinyImage** (les plugins en développement apparaissent sous **Development**). Choisissez une action, puis son format ou son préréglage. Un préréglage s’exécute immédiatement s’il ne demande aucun champ obligatoire ; terminez la boîte de dialogue d’enregistrement si elle apparaît.

Chaque préréglage définit l’option qu’il nomme. Les options compatibles omises reprennent les réglages enregistrés du plugin ; une action ou une option explicite l’emporte sur un comportement enregistré contradictoire. Seuls les champs saisis explicitement ou le choix de menu sélectionné les remplacent, et uniquement pour cette exécution. Si un réglage n’a jamais été enregistré, le réglage habituel ou la valeur de repli documentée s’applique. Les remplacements d’export ne sont pas enregistrés dans vos préférences. Si un format enregistré n’est pas disponible en raccourci, choisissez explicitement un format pris en charge ou utilisez le panneau habituel. Pour combiner des options, choisissez **Custom Settings…** dans l’action et saisissez les paramètres. Les actions qui ont besoin de texte, d’URL, de noms ou de dimensions demandent toujours ces champs obligatoires. **Open TinyImage** ouvre le panneau habituel.

**Compress Selected Layers** conserve toujours les formats d’export d’origine, même si une conversion est enregistrée dans le panneau habituel. Utilisez **Convert Selected Layers** pour choisir WebP, AVIF ou Tiny SVG. La conversion exige un format explicite ; si la qualité et les autres préférences de compression sont omises, elles reprennent toujours les réglages enregistrés. Une qualité explicite désactive, pour cette exécution, les modes sans perte et à poids cible enregistrés ; les appels avancés peuvent activer explicitement ces modes. Les raccourcis d’export ne réduisent jamais les remplissages d’image de vos calques Figma source. **Arrange Selected Layers** se contente toujours d’organiser, en ne reprenant que la mise en page et l’espacement. Il ne renomme pas, ne trie pas, n’encapsule pas les instances et ne met pas à jour le texte de pagination ; demandez explicitement ces opérations via les options avancées si nécessaire. Créez les canevas d’impression et ajustez les réglages d’impression dans le panneau habituel. La fréquence d’images de Motion reste disponible dans Custom Settings.

| Choix de menu | Étape suivante |
| --- | --- |
| **Compress Selected Layers → Use Saved Settings** | S’exécute immédiatement |
| **Compress Selected Layers → Compress Selected Layers (Custom Settings…)** | Saisissez Quality (1–100) (facultatif) |
| **Convert Selected Layers → JPG and PNG to WebP** | S’exécute immédiatement |
| **Convert Selected Layers → Only JPG to WebP** | S’exécute immédiatement |
| **Convert Selected Layers → Only PNG to WebP** | S’exécute immédiatement |
| **Convert Selected Layers → JPG and PNG to AVIF** | S’exécute immédiatement |
| **Convert Selected Layers → SVG to Tiny 1.2 SVG** | S’exécute immédiatement |
| **Convert Selected Layers → Convert Selected Layers (Custom Settings…)** | Saisissez Convert format, Quality (1–100) (facultatif) |
| **Export Selected Layers as PDF** | S’exécute immédiatement |
| **Export Selected Figma Motion → Use Default Settings** | S’exécute immédiatement |
| **Export Selected Figma Motion → Animated GIF** | S’exécute immédiatement |
| **Export Selected Figma Motion → MP4 Video** | S’exécute immédiatement |
| **Export Selected Figma Motion → WebM Video** | S’exécute immédiatement |
| **Export Selected Figma Motion → Export Selected Figma Motion (Custom Settings…)** | Saisissez Format (facultatif), Frames per second (facultatif) |
| **Arrange Selected Layers → Use Saved Layout and Spacing** | S’exécute immédiatement |
| **Arrange Selected Layers → Automatic** | S’exécute immédiatement |
| **Arrange Selected Layers → Rows** | S’exécute immédiatement |
| **Arrange Selected Layers → Columns** | S’exécute immédiatement |
| **Arrange Selected Layers → Arrange Selected Layers (Custom Settings…)** | Saisissez Layout (facultatif), Horizontal gap (px) (facultatif), Vertical gap (px) (facultatif) |

## Modifications détaillées {#detailed-editing}

Utilisez le panneau habituel du plugin pour les réglages détaillés, les contenus longs, la création en masse et la navigation dans les composants ou les modèles. Le menu des raccourcis ne contient que les commandes du quotidien listées ci-dessus.

Limitez chaque champ collé à moins de 150 caractères : l’application de bureau Figma peut tronquer le texte collé à cette limite. Les saisies plus longues se font dans le panneau habituel.

Si une ancienne version d’un plugin affiche plutôt Action, Target et Options, mettez-la à jour pour utiliser ces raccourcis nommés. Une valeur Target est un identifiant de calque ou une sélection, jamais le nom d’un nouvel élément.

## Actions de TinyImage {#tinyimage-actions}

| Action | Ce qu’elle fait | Target |
| --- | --- | --- |
| [`compress`](#compress) | Compresse les calques sélectionnés sans modifier leurs formats d’export Figma | Un ou plusieurs calques compatibles |
| [`pdf`](#pdf) | Fusionne les frames sélectionnés en un PDF pour écran | Un ou plusieurs calques compatibles |
| [`motion`](#motion) | Exporte une animation Figma Motion native à partir d’une seule source | Exactement un calque compatible |
| [`convert`](#convert) | Convertit les calques sélectionnés dans un format de sortie choisi explicitement | Un ou plusieurs calques compatibles |
| [`tidy`](#tidy) | Organise des calques frères explicites ; le tri, l’encapsulation, le renommage et la mise à jour de la pagination exigent des options explicites | Un ou plusieurs calques compatibles |

### compress {#compress}

Compresse les calques sélectionnés sans modifier leurs formats d’export Figma. Sélectionnez un ou plusieurs calques compatibles.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `quality` | number | Valeur de repli : `90` | Qualité de compression. Minimum 1 ; maximum 100 |

Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises conservent le comportement existant de l’opération, sauf si une valeur par défaut est indiquée.

Choisissez **Compress Selected Layers (Custom Settings…)**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

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

Entrée pour l’hôte de l’agent

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

### pdf {#pdf}

Fusionne les frames sélectionnés en un PDF pour écran. Sélectionnez un ou plusieurs calques compatibles.

Ce raccourci n’a aucun champ de saisie.

Choisissez **Export Selected Layers as PDF**. Le raccourci s’exécute immédiatement sur la sélection en cours.

Entrée pour l’hôte de l’agent

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

### motion {#motion}

Exporte une animation Figma Motion native à partir d’une seule source. Sélectionnez exactement un calque compatible.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `format` | string | Valeur de repli : `"GIF"` | Format d’animation. `GIF`, `MP4`, `WEBM` |
| `fps` | number | Valeur de repli : `30` | Images par seconde ; les restrictions natives de l’offre s’appliquent toujours. `10`, `15`, `24`, `25`, `30`, `60` |

Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises conservent le comportement existant de l’opération, sauf si une valeur par défaut est indiquée.

Choisissez **Export Selected Figma Motion (Custom Settings…)**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

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

Entrée pour l’hôte de l’agent

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

### convert {#convert}

Convertit les calques sélectionnés dans un format de sortie choisi explicitement. Sélectionnez un ou plusieurs calques compatibles.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `convert` | string | Obligatoire | Conversion de sortie ; utilisez compress pour conserver les formats d’origine. `webp`, `webpjpg`, `webppng`, `avif`, `tinysvg` |
| `quality` | number | Valeur de repli : `90` | Qualité de compression. Minimum 1 ; maximum 100 |

Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises conservent le comportement existant de l’opération, sauf si une valeur par défaut est indiquée.

Choisissez **Convert Selected Layers (Custom Settings…)**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

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

Entrée pour l’hôte de l’agent

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

### tidy {#tidy}

Organise des calques frères explicites ; le tri, l’encapsulation, le renommage et la mise à jour de la pagination exigent des options explicites. Sélectionnez un ou plusieurs calques compatibles.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `layout` | string | Valeur de repli : `"auto"` | Direction de la mise en page. `auto`, `rows`, `columns` |
| `horizontalSpacing` | number | Valeur de repli : `100` | Espacement horizontal en pixels. Minimum 0 ; maximum 10000 |
| `verticalSpacing` | number | Valeur de repli : `100` | Espacement vertical en pixels. Minimum 0 ; maximum 10000 |

Les champs obligatoires imbriqués s’appliquent lorsque leur objet parent ou leur élément de tableau est fourni. Les valeurs facultatives omises conservent le comportement existant de l’opération, sauf si une valeur par défaut est indiquée.

Choisissez **Arrange Selected Layers (Custom Settings…)**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

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

Entrée pour l’hôte de l’agent

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

## Utiliser les raccourcis avec un agent {#using-shortcuts-with-an-agent}

Lisez le registre lisible par une machine indiqué ci-dessous et choisissez une action proposée dans la liste des Quick Actions du plugin installé. Le registre utilise les définitions d’options d’Hypermatic plutôt que le JSON Schema standard : `min` et `max` limitent la longueur d’une chaîne, la longueur d’un tableau ou une valeur numérique selon le type du champ ; les définitions imbriquées utilisent `fields` et `item`. Les champs inconnus sont refusés.

L’agent a besoin d’un hôte capable d’appeler les Quick Actions de Figma et d’observer le résultat habituel du plugin. Les paramètres n’ajoutent aucun lanceur REST ou MCP. Les exemples dépliables sont des données d’entrée pour un hôte compatible, pas des appels d’API exécutables ; les entrées des raccourcis utilisent des chaînes simples dans `parameters`, y compris pour les nombres et les choix de format. N’affirmez jamais qu’un raccourci s’est exécuté sur la seule base de l’entrée préparée.

Vérifiez le résultat visible : les calques Figma modifiés, l’export enregistré ou la page publiée. Lisez la notification habituelle de réussite ou d’erreur, ainsi que tout avertissement d’export partiel. Terminez les boîtes de dialogue d’enregistrement natives si nécessaire ; le début d’un téléchargement ne prouve pas que le fichier a été enregistré. Les utilisateurs n’ont pas besoin d’ouvrir les outils de développement ni de lire une console.

## Dépannage {#troubleshooting}

| Symptôme | Étape suivante |
| --- | --- |
| L’action n’est pas disponible | Mettez à jour le plugin et vérifiez sa liste de Quick Actions ; utilisez le panneau habituel si l’action n’est pas disponible. |
| Les options sont invalides ou ont pu être tronquées | Utilisez des valeurs simples, champ par champ, de moins de 150 caractères, avec uniquement les champs acceptés par ce raccourci. |
| La cible est absente ou incompatible | Ouvrez la bonne page, vérifiez les conditions de l’action sur les calques et sélectionnez à nouveau les calques voulus. |
| Une erreur de licence ou d’essai apparaît | Terminez le processus d’activation habituel du plugin avant de relancer. |
| Un téléchargement a été demandé, mais aucun fichier enregistré n’est visible | Vérifiez la boîte de dialogue d’enregistrement native et l’emplacement des téléchargements. Examinez le fichier lui-même. |
| Une commande échoue, expire ou est annulée | Vérifiez le document et la destination distante avant de réessayer ; des modifications ou des envois antérieurs existent peut-être déjà. |

Les commandes ont un délai de cinq minutes. Une erreur n’implique pas une annulation complète. Relancer automatiquement une création, un remplacement ou un envoi peut dupliquer ou écraser du travail.

Le [registre des commandes lisible par une machine](/automation/parameters/tinyimage.json) contient les mêmes identifiants d’action et les mêmes définitions d’options.

## Limites actuelles {#current-limits}

La compression utilise les formats d’export Figma des calques sélectionnés ; la conversion exige un format choisi. Les raccourcis d’export ne réduisent pas les remplissages d’image source. Motion accepte une seule source ; définissez la fréquence d’images dans Custom Settings. Arrange ne modifie que la mise en page et l’espacement. Les canevas d’impression, les canevas de logo, l’assemblage vidéo en masse et les réglages détaillés de Tidy passent par le panneau habituel.

## Documentation associée {#related-documentation}

- [Installer et lancer TinyImage](/fr/tinyimage/overview/install)
- [Paramètres des plugins Figma](https://developers.figma.com/docs/plugins/plugin-parameters/)
- [Options d’interface masquée de Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)