> ## Documentation Index
> Fetch the complete documentation index at: https://docs.aliengh.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Entourage

> People and trees drawn at true size for elevations, sections and plans.

Scale and life for your drawings. An image model draws the figure or tree, and Alien traces it into clean outlines, fills and hatches at true size.

| Component | What it's for |
| - | - |
| [Scale figure](#scale-figure) | A person as a true-height silhouette for elevations and sections. |
| [Scale tree](#scale-tree) | A tree silhouette at true size, in elevation or plan, with the gaps in its canopy kept. |

***

## Scale figure

`scale_figure`

A person as a true-height silhouette for elevations and sections. Say who (“a woman pushing a pram”) and from which side.

**Cost:** About US\$0.034 per drawing; free from the cache.

### Inputs

| Input | Type | On the component | Default | What it does |
| - | - | - | - | - |
| `who` | Text | Text field | `an adult walking` | who, doing what |
| `height` | Number | Slider 0.3–2.5 | `1.75` | figure height (m) |
| `view` | Text | Dropdown | `side` | which way the figure faces. One of `side`, `front`, `back`, `three-quarter` |
| `variant` | Integer | Slider 0–50 | `0` | another drawing of the same request |
| `generate` | Boolean | Button | — | draw it with the image model (paid); a drawing made before comes back free |
| `detail` | Number | Slider 0–1 | `0.5` | outline detail, 0-1 |
| `smooth` | Boolean | Switch | on | smooth curves (off: straight segments) |
| `plane` | Plane | Wire | — | where the figure stands (default: the XZ elevation plane at the origin) |

### Outputs

| Output | Type | What it gives you |
| - | - | - |
| `outline` | list of Curve | silhouette outlines, holes included |
| `fill` | list of Brep | filled silhouette |
| `hatch` | Data | solid hatch, for baking |
| `info` | Text | prompt, model, cost, scale |
| `image` | Text | the generated image file |

<AccordionGroup>
  <Accordion title="How it works">
    * Only the generate button calls the image model: a new who, view or variant waits for it; drawings made before come back free. Height, detail, smooth and plane only re-trace or re-place the drawing.
    * Tracing: marching squares with sub-pixel edges, small islands and gaps dropped by detail, Douglas-Peucker simplification, smooth closed curves with a polyline fallback.
    * A blank, cut-off or non-white drawing is redrawn once with a stricter prompt, only while Generate runs; the check uses a fixed detail so the detail slider never causes a redraw.
    * Stands in the XZ plane at the origin (Front view) unless a plane is wired.
    * Drawings are cached in \<repo>/.alien/cache/graphics and saved to the asset library.
  </Accordion>
</AccordionGroup>

***

## Scale tree

`scale_tree`

A tree silhouette at true size, in elevation or plan, with the gaps in its canopy kept.

**Cost:** About US\$0.034 per drawing; free from the cache.

### Inputs

| Input | Type | On the component | Default | What it does |
| - | - | - | - | - |
| `species` | Text | Text field | `mature deciduous street tree` | kind of tree |
| `height` | Number | Slider 0.5–60 | `8` | tree height in elevation (m) |
| `view` | Text | Dropdown | `elevation` | elevation or plan. One of `elevation`, `plan` |
| `spread` | Number | Slider 0–60 | `0` | canopy width in plan (m); 0 = 0.75 x height |
| `variant` | Integer | Slider 0–50 | `0` | another drawing of the same request |
| `generate` | Boolean | Button | — | draw it with the image model (paid); a drawing made before comes back free |
| `detail` | Number | Slider 0–1 | `0.5` | outline detail, 0-1 |
| `smooth` | Boolean | Switch | on | smooth curves (off: straight segments) |
| `plane` | Plane | Wire | — | where it stands (default: XZ elevation plane, or XY for plan) |

### Outputs

| Output | Type | What it gives you |
| - | - | - |
| `outline` | list of Curve | silhouette outlines, canopy gaps included |
| `fill` | list of Brep | filled silhouette |
| `hatch` | Data | solid hatch, for baking |
| `info` | Text | prompt, model, cost, scale |
| `image` | Text | the generated image file |

<AccordionGroup>
  <Accordion title="How it works">
    * Only the generate button calls the image model: a new species, view or variant waits for it.
    * Elevation: sized by height, standing in XZ. Plan: sized by spread (0 = 0.75 x height), lying in XY.
    * Same tracing, checks, cache and asset saving as scale\_figure; a detailed tree (183 loops) solves in 0.6 s.
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.