# allyhub inspect layout

> One version's layout measured now, at its measured moments or at --at / --every; --texts lists every text block with its fonts

Source: https://allyhub.com/docs/reference/cli/inspect-layout · AllyHub 0.10.0
Index of all docs: https://allyhub.com/llms.txt

## Usage

```bash
allyhub inspect layout [item] [options]
```

## Arguments

| Argument | Type | What it is |
| --- | --- | --- |
| `<item>` | string | The piece: its id (its file without its extension) or its file; default the project's only one |

## Options

| Option | Type | Default | What it does |
| --- | --- | --- | --- |
| `--combo` | list of string |  | The first combo matching name=value pairs joined with commas (lang=zh-cn,hook=b), or a combo's id (c03); default the first combo |
| `--at` | list of string |  | At these moments: seconds (from --part's start when given) or anchors (@press, @/map, @press+0.2) |
| `--every` | number |  | Every this many seconds through the stretch (--part, or --from to --to, else all of it) |
| `--part` | string |  | Only this part |
| `--from` | number |  | From this second of the video |
| `--to` | number |  | Up to this second of the video |
| `--texts` | boolean | `false` | List every text block at every moment, with its box and fonts |
| `--within` | number |  | A deck: lines up to this many points apart and not in line are near-alignment (default 8) |
| `--drift` | number |  | A deck: places further apart than this, in points, are placement-drift (default 1) |
| `--level` | list of `master`, `layout`, `slide` |  | A deck: measure only shapes of these levels (default every one): slide leaves out what a master or a layout draws on every slide |
| `--except` | list of string |  | A deck: leave shapes of these names out of every fact, * for any letters (tick-*) |
| `--room` | string |  | A deck's read-size: a room as its screen's width and its farthest seat, in metres (3,12); without it no room is measured |
| `--kind` | list of string |  | Only facts of these kinds: scenery-contact, scenery-support, scenery-bake, mesh-health, camera-clearance, camera-motion, scenery-screen, scenery-screen-fidelity, page-fill, page-split, page-heading, page-short-line, page-overflow, page-kinsoku, page-figure, page-picture, page-grid, page-contents, board, board-consistency, picture-scale, overset, sheet-error, sheet-number, sheet-unlike, sheet-exception, sheet-unused, sheet-invalid, sheet-typed, sheet-ordinary, sheet-iteration, text-speaker, text-off-frame, text-contrast, text-covered, text-overlap, text-overlap-own, text-outside, text-time, words-on-screen, speech-on-screen, footage-scale, graphic-picture-scale, free-bands, graphics-under-footage, flat-frames, still-picture, cut-seam, flash, music-length, join-loudness, matrix-coverage, generated, gen-mismatch, fallback, cut-in-word, text-overflow, text-off-slide, shape-off-slide, shape-overlap, near-alignment, placement-drift, type-in-use, read-size, words-on-slide, picture-resolution, shape-hidden, chart-data, line-ends, table-grown, deck-fonts, allyhub.x/post, allyhub.x/article |
| `--all` | boolean | `false` | Every finding on a line of its own |

## Global options

`--dir <value>`: the project's folder; default the one around where it is run. `--json`: print the result as JSON.

## Examples

```bash
allyhub inspect layout launch/film --at 1.5,@press --texts
allyhub inspect layout launch/film --every 0.5 --part hook
allyhub inspect layout launch/deck --kind near-alignment --within 10
allyhub inspect layout launch/deck --level slide --except 'tick-*'
```

## Exit codes

`0` when it succeeds; the others are listed in [Exit codes](https://allyhub.com/docs/reference/cli/exit-codes.md).

## In the work

**video**: Making a video (one piece, or a batch of ads in combos)

[`check`](https://allyhub.com/docs/reference/cli/check.md) → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → [`inspect`](https://allyhub.com/docs/reference/cli/inspect.md) → `inspect layout` → [`inspect timeline`](https://allyhub.com/docs/reference/cli/inspect-timeline.md) → [`inspect motion`](https://allyhub.com/docs/reference/cli/inspect-motion.md) → [`inspect still`](https://allyhub.com/docs/reference/cli/inspect-still.md) → [`inspect contrast`](https://allyhub.com/docs/reference/cli/inspect-contrast.md) → [`inspect seams`](https://allyhub.com/docs/reference/cli/inspect-seams.md) → [`inspect flash`](https://allyhub.com/docs/reference/cli/inspect-flash.md) → [`inspect loop`](https://allyhub.com/docs/reference/cli/inspect-loop.md) → [`inspect combos`](https://allyhub.com/docs/reference/cli/inspect-combos.md) → [`audio`](https://allyhub.com/docs/reference/cli/audio.md) → [`add search`](https://allyhub.com/docs/reference/cli/add-search.md) → [`add`](https://allyhub.com/docs/reference/cli/add.md) → [`dev`](https://allyhub.com/docs/reference/cli/dev.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)

**decks**: Making a deck

[`slides capabilities`](https://allyhub.com/docs/reference/cli/slides-capabilities.md) → [`slides import`](https://allyhub.com/docs/reference/cli/slides-import.md) → [`check`](https://allyhub.com/docs/reference/cli/check.md) → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → [`frames compare`](https://allyhub.com/docs/reference/cli/frames-compare.md) → `inspect layout` → [`inspect contrast`](https://allyhub.com/docs/reference/cli/inspect-contrast.md) → [`dev`](https://allyhub.com/docs/reference/cli/dev.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)

**images**: Making an image: boards of Photoshop's layers, a PSD in and out

[`image import`](https://allyhub.com/docs/reference/cli/image-import.md) → [`check`](https://allyhub.com/docs/reference/cli/check.md) → [`frames`](https://allyhub.com/docs/reference/cli/frames.md) → `inspect layout` → [`inspect contrast`](https://allyhub.com/docs/reference/cli/inspect-contrast.md) → [`dev`](https://allyhub.com/docs/reference/cli/dev.md) → [`render`](https://allyhub.com/docs/reference/cli/render.md)
