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

# Quick Actions d’HyperCrop

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

Lancez les tâches courantes d’HyperCrop 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}

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 HyperCrop** pour ouvrir le panneau habituel du plugin.

| Raccourci | Champs |
| --- | --- |
| **Crop Selected Images (Custom Settings…)** | Name, Width (px), Height (px), Format (facultatif), Image fit (facultatif), Horizontal alignment (facultatif), Vertical alignment (facultatif), Content-aware cropping (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.

Choisissez **Crop to Fill…**, **Fit Inside…** ou **Content-aware Crop…**, puis saisissez le nom et les dimensions de sortie. Crop to Fill et Fit Inside désactivent le positionnement intelligent ou par détection des visages hérité des réglages enregistrés ; Content-aware Crop sélectionne Crop to Fill même si Fit Inside était enregistré. Custom Settings donne accès à **Crop to Fill / Fit Inside**, à l’alignement horizontal et vertical, et au recadrage intelligent. Un alignement explicite désactive le recadrage intelligent ou par détection des visages hérité ; choisir explicitement le recadrage intelligent l’emporte sur l’alignement.

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

Sélectionnez les calques voulus, faites un clic droit et choisissez **Plugins → HyperCrop** (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 HyperCrop** ouvre le panneau habituel.

Un alignement horizontal ou vertical explicite désactive, pour cette exécution, le recadrage intelligent et la détection des visages enregistrés. Pour utiliser plutôt le recadrage intelligent, demandez-le explicitement.

| Choix de menu | Étape suivante |
| --- | --- |
| **Crop Selected Images → Crop to Fill…** | Saisissez Name, Width (px), Height (px) |
| **Crop Selected Images → Fit Inside…** | Saisissez Name, Width (px), Height (px) |
| **Crop Selected Images → Content-aware Crop…** | Saisissez Name, Width (px), Height (px) |
| **Crop Selected Images → Crop Selected Images (Custom Settings…)** | Saisissez Name, Width (px), Height (px), Format (facultatif), Image fit (facultatif), Horizontal alignment (facultatif), Vertical alignment (facultatif), Content-aware cropping (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 d’HyperCrop {#hypercrop-actions}

| Action | Ce qu’elle fait | Target |
| --- | --- | --- |
| [`crop`](#crop) | Recadre les calques sélectionnés aux tailles nommées et télécharge un ZIP | Un ou plusieurs calques compatibles |

### crop {#crop}

Recadre les calques sélectionnés aux tailles nommées et télécharge un ZIP. Sélectionnez un ou plusieurs calques compatibles.

| Option | Type | Obligatoire / par défaut | Signification et valeurs acceptées |
| --- | --- | --- | --- |
| `name` | string | Obligatoire | Nom du nouvel élément. 1 caractère minimum ; 120 caractères maximum |
| `width` | number | Obligatoire | Largeur en pixels. Minimum 1 ; maximum 8192 |
| `height` | number | Obligatoire | Hauteur en pixels. Minimum 1 ; maximum 8192 |
| `format` | string | Valeur de repli : `"jpg"` | Format d’image. `jpg`, `png` |
| `fill` | string | Valeur de repli : `"cover"` | Recadrer la source ou la contenir entièrement. `cover`, `contain` |
| `horizontal` | string | Valeur de repli : `"center"` | Alignement horizontal. `left`, `center`, `right` |
| `vertical` | string | Valeur de repli : `"center"` | Alignement vertical. `top`, `center`, `bottom` |
| `smart` | boolean | Valeur de repli : `false` | Utiliser le recadrage intelligent sans détection des visages |

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 **Crop Selected Images (Custom Settings…)**. Saisissez ces champs simples ; aucun JSON n’est nécessaire :

- **Name** : `Square`
- **Width (px)** : `1080`
- **Height (px)** : `1080`
- **Format** : **JPG Image**
- **Image fit** : **Crop to Fill**
- **Horizontal alignment** : **Centre**
- **Vertical alignment** : **Centre**
- **Content-aware cropping** : **Use Alignment**

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

```json
{"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}}
```

## 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/hypercrop.json) contient les mêmes identifiants d’action et les mêmes définitions d’options.

## Limites actuelles {#current-limits}

Les raccourcis de recadrage exportent les images sélectionnées à une seule taille nommée. Le format, l’alignement et les autres choix détaillés passent par Custom Settings ; enregistrez les tailles de recadrage réutilisables dans le panneau habituel.

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

- [Installer et lancer HyperCrop](/fr/hypercrop/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/)