Claude
39 lines
2.2 KiB
Markdown
39 lines
2.2 KiB
Markdown
# `pdf_stamp_interactive` — Interaktive Stempelplatzierung
|
||
|
||
**Zweck:** Zeigt dem Bearbeiter eine PDF-Vorschau, in der er per Doppelklick (Desktop) bzw. langem Drücken (Tablet) die Stempelposition setzt; ein Schieberegler skaliert den Stempel live (30–300 %). Der Workflow wartet, bis platziert wurde; dann wird das Stempelbild dauerhaft eingebrannt. **Keine** kryptografische Signatur — dafür ist `pdf_sign` zuständig.
|
||
|
||
**Parameter**
|
||
|
||
| Name | Pflicht? | Default | Beschreibung |
|
||
|---|---|---|---|
|
||
| `file` | ja | — | Eingabe-PDF. |
|
||
| `vorlage` | ja¹ | — | Vordefinierter Stempelgenerator: `posteingang`, `postausgang` oder `bau`. |
|
||
| `vorlage_params` | nein | — | Query-Parameter für den Stempelgenerator (nur mit `vorlage`). |
|
||
| `stempel` | ja¹ | — | Pfad zu einer fertigen Stempelbild-Datei (PNG/JPG). |
|
||
| `stempel_text` | ja¹ | — | Text, aus dem automatisch ein Stempelbild erzeugt wird (dunkelblau, zentriert). |
|
||
| `breite_mm` / `hoehe_mm` | nein | `auto` | Stempelmaße in **mm**. `auto` = aus der Bildgröße abgeleitet; ist nur eine Achse `auto`, bleibt das Seitenverhältnis erhalten. Text-Stempel ohne Bild: Fallback 60 × 25 mm. |
|
||
| `output_var` | nein | — | Zusätzlicher Variablenname für den Ergebnispfad (setzt auch `<output_var>_url`). |
|
||
|
||
¹ Genau **eine** Stempelquelle angeben; Priorität bei Mehrfachangabe: `vorlage` → `stempel` → `stempel_text`.
|
||
|
||
Die geklickte Position ist der **Mittelpunkt** des Stempels; der Task rechnet auf die Seitengröße um und begrenzt den Stempel auf den Seitenrand. Das Ergebnis wird als **neue Datei** im Arbeitsverzeichnis abgelegt.
|
||
|
||
**Eingangswerte:** `{{latest_pdf_path}}` bzw. PDF-Pfad-Variable; `{{temp_dir}}`.
|
||
|
||
**Ausgangswerte:**
|
||
- `latest_pdf_path`, `latest_pdf_url` (gestempeltes PDF)
|
||
- `<task_id>_page`, `<task_id>_x_mm`, `<task_id>_y_mm` (Position obere linke Ecke in mm), `<task_id>_breite`, `<task_id>_hoehe` (finale Maße in mm), `<task_id>_scale_pct`
|
||
- optional `<output_var>` und `<output_var>_url`
|
||
|
||
```xml
|
||
<task type="pdf_stamp_interactive" id="eingangsstempel">
|
||
<assign_to>{{registratur_mail}}</assign_to>
|
||
<config>
|
||
<file>{{latest_pdf_path}}</file>
|
||
<vorlage>posteingang</vorlage>
|
||
<breite_mm>50</breite_mm>
|
||
<hoehe_mm>auto</hoehe_mm>
|
||
</config>
|
||
</task>
|
||
```
|