save_decoration
Save a decoration's content, depth, mode, material, and processing pipeline to the library for reuse on future models.
Instructions
Save a proven decoration to the library for reuse on future models.
Captures the content file (heightmap, SVG, image), settings
(depth, mode, material), and processing pipeline from the
``.kiln_recipe.json`` sidecar so the exact same decoration can
be applied to new models with ``apply_decoration``.
:param name: Human-readable name (e.g. "Ash Portrait").
:param model_path: Path to the model that was just decorated.
:param content_type: Content type — ``photo``, ``svg``, ``qr``,
``text``, or ``auto`` (detect from file extension).
:param source_path: Path to the original input file (photo, SVG).
:param content_data: For QR: the data string. For text: the text.
:param depth_mm: Decoration depth in mm (0 = auto from recipe).
:param mode: ``emboss`` or ``deboss``.
:param image_style: Image processing style (coin, portrait, etc.).
:param material: Material used (e.g. PLA, PETG).
:param tags: Comma-separated tags for filtering.
:returns: Dict with saved decoration details and library path.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | emboss | |
| name | Yes | ||
| tags | No | ||
| depth_mm | No | ||
| material | No | PLA | |
| model_path | Yes | ||
| image_style | No | auto | |
| source_path | No | ||
| content_data | No | ||
| content_type | No | auto |