プラグインのパネルを開かずに、FigmaのQuick ActionsからHyperCropのよく使うタスクを実行できます。下の名前付きショートカットから選んでください。詳細な設定や作成作業には、通常のプラグインパネルを使います。
Quick Actionを実行する
どのショートカットも、有効なライセンスの確認が取れているか、トライアル回数が残っている必要があります。確認に失敗した場合やトライアル回数を使い切った場合は、通常のプラグインパネルを開いてライセンスを有効にしてください。パネルはいつでも開けます。
- ショートカットが選択範囲を使う場合は、対象のレイヤーを選択します。
- MacではCommand + /、WindowsではCtrl + / でFigmaのQuick Actionsを開きます。
- プラグインを検索し、下の名前付きショートカットを選びます。
- 表示されたフィールドに入力します。オプションのフィールドは省略できます。編集するにはTabキーを使います。ショートカットを実行し、結果を確認するか、保存ダイアログを完了します。
作成用のショートカットでは、名前やサイズを直接入力します。選択したレイヤー用のショートカットは、現在の選択を自動的に使います。これらの日常的なショートカットでは、TargetやJSONの入力は求められません。通常のプラグインパネルを開くにはOpen HyperCropを選びます。
| ショートカット | 入力項目 |
|---|---|
| Crop Selected Images (Custom Settings…) | Name、Width (px)、Height (px)、Format（オプション）、Image fit（オプション）、Horizontal alignment（オプション）、Vertical alignment（オプション）、Content-aware cropping（オプション） |
選択式のフィールドには、わかりやすいラベルが表示されます。表示されたラベルでも、内部の値でも検索できます。エージェントの入力には、引き続きコマンドリファレンスに記載された値を使います。
Crop to Fill…、Fit Inside…、Content-aware Crop… のいずれかを選び、出力の名前とサイズを入力します。Crop to FillとFit Insideでは、保存済み設定から引き継いだコンテンツ認識・顔検出による位置決めが無効になります。Content-aware Cropは、保存済みの設定がFit InsideでもCrop to Fillを選択します。Custom Settingsでは、Crop to Fill / Fit Inside、水平・垂直方向の配置、コンテンツ認識トリミングを指定できます。配置を明示的に指定すると、引き継いだスマートトリミングと顔検出トリミングは無効になります。コンテンツ認識トリミングを明示的に選んだ場合は、配置よりも優先されます。
コンテキストメニューから実行する
対象のレイヤーを選択して右クリックし、Plugins → HyperCropを選びます（開発中のプラグインはDevelopmentの下に表示されます）。アクションと、その形式またはプリセットを選びます。必須の入力がないプリセットはすぐに実行されます。保存ダイアログが表示された場合は完了してください。
各プリセットは、その名前のオプションを設定します。省略された互換オプションは、プラグインに保存された設定を引き継ぎます。明示的に指定したアクションやオプションは、矛盾する保存済みの動作より優先されます。その回の実行で保存済みの設定を上書きするのは、明示的に入力したフィールドか、選択したメニュー項目だけです。一度も保存されていない設定には、通常の設定またはドキュメントに記載されたフォールバックが適用されます。エクスポート時の上書き設定は、環境設定には保存されません。保存済みの形式がショートカットで使えない場合は、対応している形式を明示的に選ぶか、通常のパネルを使ってください。複数のオプションを組み合わせるには、アクション内のCustom Settings… を選んでパラメーターを入力します。テキスト、URL、名前、サイズが必要なアクションでは、引き続きそれらの必須フィールドの入力を求められます。Open HyperCropでは通常のパネルが開きます。
水平または垂直方向の配置を明示的に指定すると、その回の実行では保存済みのスマートトリミングと顔検出が無効になります。代わりにコンテンツ認識トリミングを使うには、スマートトリミングを明示的に指定してください。
| メニュー項目 | 次の手順 |
|---|---|
| Crop Selected Images → Crop to Fill… | Name、Width (px)、Height (px)を入力 |
| Crop Selected Images → Fit Inside… | Name、Width (px)、Height (px)を入力 |
| Crop Selected Images → Content-aware Crop… | Name、Width (px)、Height (px)を入力 |
| Crop Selected Images → Crop Selected Images (Custom Settings…) | Name、Width (px)、Height (px)、Format（オプション）、Image fit（オプション）、Horizontal alignment（オプション）、Vertical alignment（オプション）、Content-aware cropping（オプション）を入力 |
詳細な編集
詳細な設定、長いコンテンツ、まとめての作成、コンポーネントやテンプレートの閲覧には、通常のプラグインパネルを使います。ショートカットメニューには、上に記載した日常的なコマンドだけが含まれます。
貼り付ける各フィールドは150文字未満にしてください。Figmaデスクトップアプリでは、貼り付けた入力がその文字数で切り捨てられることがあります。それより長い入力は、通常のパネルで行ってください。
古いプラグインでAction、Target、Optionsが表示される場合は、プラグインを更新してこれらの名前付きショートカットを使ってください。Targetの値はレイヤーIDまたは選択範囲で、新しく作成する項目の名前ではありません。
HyperCropのアクション
| アクション | 内容 | 対象 |
|---|---|---|
crop | 選択したレイヤーを指定した名前のサイズにトリミングし、ZIPをダウンロードします | 対象となる1つ以上のレイヤー |
crop
選択したレイヤーを指定した名前のサイズにトリミングし、ZIPをダウンロードします。対象となるレイヤーを1つ以上選択します。
| オプション | 型 | 必須 / デフォルト | 意味と使用できる値 |
|---|---|---|---|
name | string | 必須 | 新しい項目の名前。最小1文字、最大120文字 |
width | number | 必須 | 幅（ピクセル）。最小1、最大8192 |
height | number | 必須 | 高さ（ピクセル）。最小1、最大8192 |
format | string | フォールバック："jpg" | 画像形式。jpg、png |
fill | string | フォールバック："cover" | 元画像をトリミングするか、枠内に収めるか。cover、contain |
horizontal | string | フォールバック："center" | 水平方向の配置。left、center、right |
vertical | string | フォールバック："center" | 垂直方向の配置。top、center、bottom |
smart | boolean | フォールバック：false | 顔検出なしでコンテンツ認識トリミングを使う |
ネストされた必須フィールドは、親のオブジェクトまたは配列の項目を指定した場合に適用されます。省略したオプションの値は、デフォルトが記載されていない限り、既存の処理の動作に従います。
Crop Selected Images (Custom Settings…) を選びます。次のプレーンなフィールドを入力します。JSONは不要です。
- 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
エージェントホスト用の入力
{"command":"shortcut-crop","parameters":{"name":"Square","width":"1080","height":"1080","format":"jpg","fill":"cover","horizontal":"center","vertical":"center","smart":"false"}}エージェントでショートカットを使う
下にリンクした機械可読なレジストリを読み、インストール済みのプラグインのQuick Actionsの一覧にあるアクションを選びます。レジストリは標準のJSON Schemaではなく、Hypermatic独自のオプション定義を使います。minとmaxは、フィールドの型に応じて文字列の長さ、配列の長さ、または数値を制限します。ネストされた定義にはfieldsとitemを使います。不明なフィールドは拒否されます。
エージェントには、FigmaのQuick Actionsを呼び出し、通常のプラグインの結果を確認できるホストが必要です。パラメーターによって、RESTやMCPの起動手段が追加されるわけではありません。展開できる例は対応ホスト向けの入力データで、実行可能なAPI呼び出しではありません。ショートカットの入力では、数値や形式の選択も含め、parametersにプレーンな文字列を使います。準備した入力があるだけで、ショートカットが実行されたと主張してはいけません。
目に見える結果を確認してください。変更されたFigmaのレイヤー、保存されたエクスポート、公開されたページなどです。通常の成功・エラー通知と、一部のエクスポートに関する警告を読みます。必要に応じてOSの保存ダイアログを完了してください。ダウンロードが始まっただけでは、ファイルが保存されたことの証明にはなりません。ユーザーが開発者ツールを開いたり、コンソールを読んだりする必要はありません。
トラブルシューティング
| 症状 | 次の手順 |
|---|---|
| アクションが使えない | プラグインを更新し、Quick Actionsの一覧を確認します。アクションが使えない場合は通常のパネルを使います。 |
| オプションが無効、または切り捨てられた可能性がある | そのショートカットが受け付けるフィールドだけを使い、それぞれ150文字未満のプレーンな値を入力します。 |
| 対象がない、または対象外 | 正しいページを開き、アクションのレイヤー要件を確認して、対象のレイヤーを選択し直します。 |
| ライセンスまたはトライアルのエラーが表示される | 再実行する前に、プラグインの通常の有効化手順を完了します。 |
| ダウンロードを要求したのに、保存されたファイルが見当たらない | OSの保存ダイアログとダウンロード先を確認します。実際のファイルを確認してください。 |
| コマンドが失敗した、タイムアウトした、またはキャンセルされた | 再試行する前に、ドキュメントとリモートの送信先を確認します。それまでの変更やアップロードがすでに反映されている場合があります。 |
コマンドの制限時間は5分です。エラーが発生しても、すべてが元に戻るとは限りません。作成、置き換え、アップロードを自動で再試行すると、作業が重複したり上書きされたりすることがあります。
機械可読なコマンドレジストリには、同じアクションIDとオプション定義が含まれています。
現在の制限
トリミングのショートカットは、選択した画像を指定した名前の1つのサイズでエクスポートします。形式、配置などの詳細な選択にはCustom Settingsを使います。繰り返し使うトリミングサイズは、通常のパネルで保存してください。