---
title: "pyrofx obstacles: solids the gas flows around"
description: "[[obstacles]] are solids the gas flows around: spheres, boxes, cylinders, capsules, carved holes and moving solids, with holdout and shadow in the sheets."
canonical: https://appliedmanifold.com/docs/pyrofx/obstacles/
site: "Applied Manifold: The spatial compute cloud for 3D reality"
---

[Home](https://appliedmanifold.com/) / [Docs](https://appliedmanifold.com/docs/) / [pyrofx](https://appliedmanifold.com/docs/pyrofx/) / Obstacles

DOCS // pyrofx

# Obstacles

`[[obstacles]]` are solids the gas flows around: spheres, boxes, cylinders and capsules. `carve = true` cuts holes. Keys move them; `holdout` and `shadow` hide and shade the gas.

## Example

The window fire: a block, a room carved out of it and a window carved through the front.

window\_fire.pyro.toml (excerpt)

```
# The building: fills the back of the box from the floor to the top. Its front is at Z = -0.5,
# which leaves 3 m of open air in front for the flame to roll out into.
[[obstacles]]
shape = "box"
position_m = [0, 4, -1.5]
size_m = [2.5, 4, 1.0]

# The room inside it, with a wall 0.2 m thick in front.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.3, -1.5]
size_m = [1.3, 1.1, 0.8]

# The window through that wall.
[[obstacles]]
shape = "box"
carve = true
position_m = [0, 1.5, -0.6]
size_m = [0.7, 0.65, 0.25]
```

**Bake: Window fire** (`window_fire.pyro.toml`, final, pyro), up to 3.9 x 4.7 m. Plays at true speed: [preview video (mp4)](https://appliedmanifold.com/bakes/window_fire/preview.mp4), [webm](https://appliedmanifold.com/bakes/window_fire/preview.webm). Still: [poster.webp](https://appliedmanifold.com/bakes/window_fire/poster.webp). [Spec](https://appliedmanifold.com/docs/pyrofx/examples/#ex-window_fire).

## Drop a ball through smoke

Compare the same smoke with the obstacle present and absent. To capture more of its fall, set a frame rate in the [export settings](https://appliedmanifold.com/docs/pyrofx/spec/#pacing).

Compiled with Spatial Compiler. [View the source spec](https://appliedmanifold.com/showcase/ball_drop-without-final/ball_drop.pyro.toml) `obstacles.start_s=999`

## Fields

| Field | Meaning | Default |
| --- | --- | --- |
| `shape` | `sphere`, `box`, `cylinder` or `capsule`; a cylinder and a capsule stand along their own Y | `sphere` |
| `position_m` | Center (t). A moving solid pushes the gas. | `[0, 1, 0]` |
| `size_m` | Radius of a sphere, cylinder or capsule; half-extents of a box (t) | 0.5 |
| `height_m` | Full length of a cylinder; length of the straight part of a capsule (t) | 1.0 |
| `rotation_deg` | Rotation (t). Spinning drags gas at the surface. | `[0, 0, 0]` |
| `carve` | Cuts its shape from earlier obstacles; the first cannot carve | false |
| `holdout` | Hides gas behind it in the sheets | true |
| `shadow` | Blocks the light, so gas in its shade is darker | true |
| `start_s`, `end_s` | When it is there; `end_s = 0` never leaves | 0, 0 |

## Combining solids

-   Spec order applies: later solids fill earlier carves; later carves cut every earlier solid.
-   Solids are at least one cell thick, which stops gas at any angle.
-   Solids outside the camera frame still hide and shade.
-   Solids are not drawn. They stand in for your engine’s model; `holdout` leaves a clean hole for it.
-   Keep emitters clear of solids.

See [Model-shaped obstacles](https://appliedmanifold.com/docs/pyrofx/models/).

## Questions

### How do I carve a room or window out of a pyrofx obstacle?

Add a later obstacle with carve set to true to cut its shape from earlier obstacles.

### What do holdout and shadow do on a pyrofx obstacle?

Holdout hides gas behind the solid in the output sheets, while shadow darkens gas in its shade.

### Do pyrofx obstacles appear as visible meshes in the output sheets?

No, solids are not drawn because they stand in for your engine model and leave a clean hole.
