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

# View

```loft theme={"theme":{"light":"github-light","dark":"github-dark"},"languages":{"custom":["/languages/loft.json","/languages/loft-fragment.json"]}}
view plan L1-plan of level.L1 scale 1/4" cut 4'-0" name "L1 Floor Plan"
```

Project nothing and are projected off by nothing: a view is a declared
*query* (kind, level, scale, cut, range, crop) over the elements above,
never a container of them. `of <level>` is a dependency edge onto a
datum, and the crop's corners (`from (x, y) to (x, y)` — the view's
placement slot; Revit's crop region) are ordinary coordinates whose datum
references are edges too; a corner never anchors to a wall. The
**view range** (decision 74; revit-parity: View Range) is three viewtype
facts — `top` / `bottom` / `depth`, lengths relative to the level,
defaulted by the query (top = the level's top, bottom = the level,
depth = bottom) — and what a plan shows is classified against it: cut /
above / beyond / not drawn, computed per element, never authored;
openings follow their host. Inverted relationships (bottom above cut,
top below cut, depth above bottom) are errors with the fix written out,
not a dialog. The annotation body is reserved; `rcp` / `section` /
`elevation` are reserved kinds.

**Placement:** the query's target — `of level.L1` for a plan; `at grid.B to grid.A` for
a section or elevation, with an axis word when no grid in the stations
implies it. The crop, `from (x, y) to (x, y)`, is ordinary coordinates.

## Parameters

| Word                                      | Accepts                                        | Required                                                                                                                                                                    | Meaning                                                                                                                                                            |
| ----------------------------------------- | ---------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| `type`<br />`A-PLAN`                      | a viewtype or `plan` · `section` · `elevation` | instance · required                                                                                                                                                         | a viewtype, or a bare kind word for an untyped view — the kind is the language's, never a template's name                                                          |
| `of`<br />`of level.L1`                   | a level                                        | instance · required · plans only                                                                                                                                            | the level a plan looks at                                                                                                                                          |
| `from`<br />`from (0', 0') to (40', 30')` | line (direction z)                             | instance · optional · plans only                                                                                                                                            | the crop — `from (x, y) to (x, y)`, lower-left to upper-right (Revit's crop region); ordinary coordinates, never anchored to a wall                                |
| `axis`<br />`vertical`                    | `vertical` · `horizontal`                      | instance · optional · sections only                                                                                                                                         | which way the plane runs — written bare before `at`; inferred from a grid in the stations when unwritten (D0267 when neither)                                      |
| `at`<br />`at grid.B`                     | plane (normal x) or plane (normal y)           | instance · required · sections only                                                                                                                                         | the cut plane's station — on the axis the plane is normal to                                                                                                       |
| `to`<br />`to grid.A`                     | plane (normal x) or plane (normal y)           | instance · required · sections only                                                                                                                                         | the far clip's station — the pair's order is the gaze                                                                                                              |
| `scale`<br />`scale 1/4"`                 | length                                         | either · required · default: 1/8"<br />**practice** — decision 76(a) — the language default a view falls to when neither it nor its viewtype writes one                     | paper inches per model foot — the sheet scale                                                                                                                      |
| `cut`<br />`cut 4'-0"`                    | length                                         | either · required · default: 4'-0" · plans only<br />**revit-parity** — View Range: Cut plane, Associated Level + 4'-0"                                                     | the cut plane's height above the level                                                                                                                             |
| `top`<br />`top 8'-0"`                    | length or a level ± offset                     | either<br />plans: required · default: the level's top<br />sections: optional<br />**revit-parity** — View Range: Top — the level's story is where a plan stops looking up | the range top above the level<br />on a section or elevation, an optional level trim (`top level.L3 + 2'`) with no default                                         |
| `bottom`<br />`bottom 0'`                 | length or a level ± offset                     | either<br />plans: required · default: the level + 0'<br />sections: optional<br />**revit-parity** — View Range: Bottom, Associated Level + 0'-0"                          | the range bottom relative to the level (a leading `-` reads below it)<br />on a section or elevation, an optional level trim (`top level.L3 + 2'`) with no default |
| `depth`<br />`depth -2'-0"`               | length                                         | either · required · default: the range bottom · plans only<br />**revit-parity** — View Range: View Depth, Associated Level + 0'-0" — what it reaches draws beyond          | how far below the bottom the plan still shows, as beyond                                                                                                           |
| `name`<br />`name "L1 Floor Plan"`        | text                                           | instance · optional                                                                                                                                                         | the printed title — the id references, the name prints                                                                                                             |

### Reserved

| Word         | Rung     | Meaning                                                                                                                                    | Arrives with                                                                                                                                                                      |
| ------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `units`      | type     | how derived quantities display on this sheet — units are presentation, never a fact about the model                                        | the metric / areas era — a tier on the view ?? viewtype ?? project cascade                                                                                                        |
| `phase`      | instance | the phase the query looks at the model as of                                                                                               | the phasing era — the phase filter, discipline's twin (a filter on the query, never a kind)                                                                                       |
| `discipline` | instance | the discipline the view reads the model as (structural, mechanical…) — a filter on the query, and the graphic standard's cell beside scale | the views/filters era — phase's twin (a filter on the query, never a kind); object styles stay one standard, the view's discipline picks the resolver cell the way its scale does |

## Datums

| Datum                | Shape | Status      | Resolution | Rule                                                                                                                                                                                                         |
| -------------------- | ----- | ----------- | ---------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| *(the target)*       | plane | core        | intrinsic  | The level a plan is `of`, or the cut plane a section stands `at`, looking `to` its far clip. A dependency edge onto a datum — never onto an element (a wall edit must not move the drawing, decision 76(c)). |
| *(the cut plane)*    | plane | core · plan | intrinsic  | `cut` above the level a plan is `of`; a section's plane IS its cut (D0265).                                                                                                                                  |
| *(the range top)*    | plane | core · plan | intrinsic  | `top` above the level — what a plan classifies as above stops here (decision 74).                                                                                                                            |
| *(the range bottom)* | plane | core · plan | intrinsic  | `bottom` relative to the level — the cut must sit between it and the top (D0522).                                                                                                                            |
| *(the view depth)*   | plane | core · plan | intrinsic  | `depth` relative to the level, at or below the bottom — what it reaches draws as beyond.                                                                                                                     |
| *(the sheet scale)*  | —     | core        | —          | The one non-geometric view fact: `scale`, required with a default like every other.                                                                                                                          |

## Roles

None — this category draws no parts of its own.
