Commands › › Snap To Wall
Snap To Wall
Coming soon
Before you run this
Active document; one or more family instances selected.
After it runs
Selected family instances moved to nearest wall face and rotated to face wall normal. Z height unchanged.
When to use this
- After importing blocks via ImportCommand, select wall-mounted items and snap them to walls.
Don't use this when
Snapping elements to floors, ceilings, or other surfaces. Not for elements that aren't family instances. Not for creating new elements.
Inputs
| Name | Kind | Type | Required | Default | Description |
|---|---|---|---|---|---|
FamilyInstances |
selection | FamilyInstance |
yes | — | Family instances to snap to nearest wall "Select family instances to snap to walls" |
Returns
| Name | Type | Description |
|---|---|---|
snapped | int | Number of elements snapped to walls |
skipped | int | Number of elements with no wall nearby |
failed | int | Number of elements that failed to snap |
What you'll see in the chat
on start
Snapping selected elements to nearest walls...
Aligning family instances to wall faces...
Aligning family instances to wall faces...
thinking
Collecting all walls from host and linked models...
Finding room for each element...
Calculating nearest wall face position...
Moving and rotating elements to wall face...
Finding room for each element...
Calculating nearest wall face position...
Moving and rotating elements to wall face...
on success
Snapped {snapped} of {total} elements to walls.
on failure
Snap to wall failed: {error}
REST API
Not yet exposed
This command does not carry a [RestApi] attribute today. Once tagged, this section will auto-populate with:
POST /api/v1/commands/snap_to_wall- Request body schema (from
[RestApiParam]) - Response schema (from
[RestApiResponse]) - curl / JS / Python code examples
Keywords & intent patterns
snap to wall · wall snap · snap family · wall mount · align to wall · move to wall face
Related
| Related commands | SelectByRoomCommand · SelectByLocationCommand |
|---|---|
| Pillar |