--- url: "/de/hypercrop/automation/parameters.md" description: "Führe Quick Actions von HyperCrop mit einfachen, benannten Eingaben und Kurzbefehlen für die aktuelle Auswahl aus." --- # Quick Actions von HyperCrop > Führe Quick Actions von HyperCrop mit einfachen, benannten Eingaben und Kurzbefehlen für die aktuelle Auswahl aus. Erledige häufige HyperCrop-Aufgaben über die Quick Actions von Figma, ohne das Plugin-Fenster zu öffnen. Wähle unten einen benannten Kurzbefehl. Für ausführliche Einstellungen und die Bearbeitung nutzt du das normale Plugin-Fenster. ## Eine Quick Action ausführen {#run-a-quick-action} Jeder Kurzbefehl setzt eine verifizierte, gültige Lizenz oder verbleibende Testläufe voraus. Schlägt die Verifizierung fehl oder sind deine Testläufe abgelaufen, öffne das normale Plugin-Fenster, um deine Lizenz zu aktivieren. Das Fenster lässt sich weiterhin öffnen. 1. Wähle die Ebenen aus, mit denen du arbeiten willst, falls der Kurzbefehl eine Auswahl nutzt. 2. Öffne die Quick Actions von Figma mit **Command + /** auf dem Mac oder **Ctrl + /** unter Windows. 3. Such nach dem Plugin und wähle unten den benannten Kurzbefehl. 4. Fülle die angezeigten Felder aus. Optionale Felder kannst du überspringen; mit der Tabulatortaste bearbeitest du sie. Führe den Kurzbefehl aus und prüfe das Ergebnis oder schließ den Speichern-Dialog ab. Kurzbefehle zum Erstellen fragen Namen oder Abmessungen direkt ab. Kurzbefehle für ausgewählte Ebenen nutzen automatisch die aktuelle Auswahl. Diese alltäglichen Kurzbefehle fragen weder Target noch JSON ab. Wähle **Open HyperCrop**, um das normale Plugin-Fenster zu öffnen. | Kurzbefehl | Eingaben | | --- | --- | | **Crop Selected Images (Custom Settings…)** | Name, Width (px), Height (px), Format (optional), Image fit (optional), Horizontal alignment (optional), Vertical alignment (optional), Content-aware cropping (optional) | Felder mit festen Auswahlmöglichkeiten verwenden lesbare Beschriftungen. Du kannst nach der angezeigten Beschriftung oder dem zugrunde liegenden Wert suchen; Eingaben von Agenten verwenden weiterhin die Werte aus der Befehlsreferenz. Wähle **Crop to Fill…**, **Fit Inside…** oder **Content-aware Crop…** und gib den Ausgabenamen und die Abmessungen ein. Crop to Fill und Fit Inside deaktivieren eine übernommene inhaltsbasierte Positionierung bzw. Gesichtspositionierung; Content-aware Crop wählt Crop to Fill, auch wenn Fit Inside gespeichert war. Custom Settings bietet **Crop to Fill / Fit Inside**, die horizontale und vertikale Ausrichtung und den inhaltsbasierten Zuschnitt. Eine ausdrücklich gewählte Ausrichtung deaktiviert übernommenes Smart Cropping bzw. den Zuschnitt mit Gesichtserkennung; ein ausdrücklich gewählter inhaltsbasierter Zuschnitt hat Vorrang vor der Ausrichtung. ## Über das Kontextmenü ausführen {#run-from-the-context-menu} Wähle die gewünschten Ebenen aus, klick mit der rechten Maustaste und wähle **Plugins → HyperCrop** (Entwicklungs-Plugins erscheinen unter **Development**). Wähle eine Aktion und ihr Format oder ihre Voreinstellung. Eine Voreinstellung wird sofort ausgeführt, wenn sie keine Pflichteingabe braucht; schließ den Speichern-Dialog ab, falls einer erscheint. Jede Voreinstellung setzt ihre benannte Option. Weggelassene kompatible Optionen übernehmen die gespeicherten Einstellungen des Plugins; eine ausdrücklich gewählte Aktion oder Option hat Vorrang vor widersprüchlichem gespeichertem Verhalten. Nur ausdrücklich eingegebene Felder oder die gewählte Menüoption überschreiben sie für diesen Durchlauf. Wurde eine Einstellung nie gespeichert, gilt die normale Einstellung oder der dokumentierte Fallback. Export-Überschreibungen werden nicht in deine Einstellungen zurückgespeichert. Ist ein gespeichertes Format nicht als Kurzbefehl verfügbar, wähle ausdrücklich ein unterstütztes Format oder nutze das normale Fenster. Um Optionen zu kombinieren, wähle innerhalb der Aktion **Custom Settings…** und gib die Parameter ein. Aktionen, die Text, URLs, Namen oder Abmessungen brauchen, fragen diese Pflichtfelder weiterhin ab. **Open HyperCrop** öffnet das normale Fenster. Eine ausdrücklich gewählte horizontale oder vertikale Ausrichtung deaktiviert für diesen Durchlauf das gespeicherte Smart Cropping und die Gesichtserkennung. Wenn du stattdessen den inhaltsbasierten Zuschnitt nutzen möchtest, fordere Smart Cropping ausdrücklich an. | Menüoption | Nächster Schritt | | --- | --- | | **Crop Selected Images → Crop to Fill…** | Name, Width (px), Height (px) eingeben | | **Crop Selected Images → Fit Inside…** | Name, Width (px), Height (px) eingeben | | **Crop Selected Images → Content-aware Crop…** | Name, Width (px), Height (px) eingeben | | **Crop Selected Images → Crop Selected Images (Custom Settings…)** | Name, Width (px), Height (px), Format (optional), Image fit (optional), Horizontal alignment (optional), Vertical alignment (optional), Content-aware cropping (optional) eingeben | ## Ausführliche Bearbeitung {#detailed-editing} Nutze das normale Plugin-Fenster für ausführliche Einstellungen, längere Inhalte, die Bearbeitung in großen Mengen und das Durchsuchen von Komponenten oder Vorlagen. Das Kurzbefehlsmenü enthält nur die oben aufgeführten alltäglichen Befehle. Halte jedes eingefügte Feld unter 150 Zeichen: Figma Desktop kann eingefügte Eingaben an dieser Grenze abschneiden. Längere Eingaben gehören ins normale Fenster. Zeigt ein älteres Plugin stattdessen Action, Target und Options an, aktualisiere es, um diese benannten Kurzbefehle zu nutzen. Ein Target-Wert ist eine Ebenen-ID oder eine Auswahl, nie der Name eines neuen Elements. ## Aktionen von HyperCrop {#hypercrop-actions} | Aktion | Was sie tut | Target | | --- | --- | --- | | [`crop`](#crop) | Schneidet ausgewählte Ebenen auf benannte Größen zu und lädt eine ZIP-Datei herunter | Eine oder mehrere geeignete Ebenen | ### crop {#crop} Schneidet ausgewählte Ebenen auf benannte Größen zu und lädt eine ZIP-Datei herunter. Wähle eine oder mehrere geeignete Ebenen aus. | Option | Typ | Pflicht / Standard | Bedeutung und zulässige Werte | | --- | --- | --- | --- | | `name` | string | Pflicht | Name des neuen Elements. Mindestens 1 Zeichen; höchstens 120 Zeichen | | `width` | number | Pflicht | Breite in Pixeln. Mindestens 1; höchstens 8192 | | `height` | number | Pflicht | Höhe in Pixeln. Mindestens 1; höchstens 8192 | | `format` | string | Fallback: `"jpg"` | Bildformat. `jpg`, `png` | | `fill` | string | Fallback: `"cover"` | Ausgangsbild zuschneiden oder einpassen. `cover`, `contain` | | `horizontal` | string | Fallback: `"center"` | Horizontale Ausrichtung. `left`, `center`, `right` | | `vertical` | string | Fallback: `"center"` | Vertikale Ausrichtung. `top`, `center`, `bottom` | | `smart` | boolean | Fallback: `false` | Inhaltsbasierten Zuschnitt ohne Gesichtserkennung verwenden | Verschachtelte Pflichtfelder gelten, wenn ihr übergeordnetes Objekt oder Array-Element angegeben wird. Weggelassene optionale Werte folgen dem Verhalten des bestehenden Vorgangs, sofern kein Standard angegeben ist. Wähle **Crop Selected Images (Custom Settings…)**. Gib diese einfachen Felder ein; JSON ist nicht nötig: - **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** Eingabe für den Agent-Host ```json {"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}} ``` ## Kurzbefehle mit einem Agenten nutzen {#using-shortcuts-with-an-agent} Lies das unten verlinkte maschinenlesbare Verzeichnis und wähle eine Aktion, die in der Quick-Actions-Liste des installierten Plugins angeboten wird. Das Verzeichnis nutzt Optionsdefinitionen von Hypermatic statt des Standards JSON Schema: `min` und `max` begrenzen je nach Feldtyp die Länge einer Zeichenkette, die Länge eines Arrays oder einen Zahlenwert; verschachtelte Definitionen verwenden `fields` und `item`. Unbekannte Felder werden abgelehnt. Der Agent braucht einen Host, der Quick Actions in Figma aufrufen und das normale Ergebnis des Plugins beobachten kann. Parameter fügen keinen REST- oder MCP-Starter hinzu. Die ausklappbaren Beispiele sind Eingabedaten für einen kompatiblen Host, keine ausführbaren API-Aufrufe; Eingaben für Kurzbefehle verwenden in `parameters` einfache Zeichenketten, auch für Zahlen und Formatauswahlen. Behaupte nie, dass ein Kurzbefehl allein aufgrund seiner vorbereiteten Eingabe ausgeführt wurde. Prüfe das sichtbare Ergebnis: die geänderten Figma-Ebenen, den gespeicherten Export oder die veröffentlichte Seite. Lies die normale Erfolgs- oder Fehlermeldung und jede Warnung zu einem unvollständigen Export. Schließ native Speichern-Dialoge bei Bedarf ab; ein gestarteter Download beweist nicht, dass die Datei gespeichert wurde. Nutzer müssen weder Entwicklertools öffnen noch eine Konsole lesen. ## Fehlerbehebung {#troubleshooting} | Symptom | Nächster Schritt | | --- | --- | | Die Aktion ist nicht verfügbar | Aktualisiere das Plugin und prüfe seine Quick-Actions-Liste; nutze das normale Fenster, wenn die Aktion nicht verfügbar ist. | | Optionen sind ungültig oder wurden womöglich abgeschnitten | Verwende einzelne, einfache Feldwerte unter 150 Zeichen und nur Felder, die dieser Kurzbefehl akzeptiert. | | Target fehlt oder ist nicht geeignet | Öffne die richtige Seite, prüfe die Anforderungen der Aktion an die Ebenen und wähle die gewünschten Ebenen erneut aus. | | Ein Lizenz- oder Testlauffehler erscheint | Schließ die normale Aktivierung des Plugins ab, bevor du den Befehl erneut ausführst. | | Ein Download wurde angefordert, aber keine gespeicherte Datei ist zu sehen | Prüfe den nativen Speichern-Dialog und den Download-Speicherort. Sieh dir die tatsächliche Datei an. | | Ein Befehl schlägt fehl, überschreitet das Zeitlimit oder wird abgebrochen | Prüfe das Dokument und das Remote-Ziel, bevor du es erneut versuchst; frühere Änderungen oder Uploads sind möglicherweise schon vorhanden. | Befehle haben ein Zeitlimit von fünf Minuten. Fehler bedeuten kein vollständiges Rückgängigmachen. Ein automatisch wiederholtes Erstellen, Ersetzen oder Hochladen kann Arbeit duplizieren oder überschreiben. Das [maschinenlesbare Befehlsverzeichnis](/automation/parameters/hypercrop.json) enthält dieselben Aktions-IDs und Optionsdefinitionen. ## Aktuelle Grenzen {#current-limits} Die Zuschnitt-Kurzbefehle exportieren ausgewählte Bilder in einer benannten Größe. Format, Ausrichtung und andere Detailoptionen laufen über Custom Settings; wiederverwendbare Zuschnittgrößen speicherst du im normalen Fenster. ## Verwandte Dokumentation {#related-documentation} - [HyperCrop installieren und ausführen](/de/hypercrop/overview/install) - [Parameter für Figma-Plugins](https://developers.figma.com/docs/plugins/plugin-parameters/) - [Optionen für ausgeblendete UI in Figma](https://developers.figma.com/docs/plugins/api/properties/figma-showui/)