wehub-resource-sync
63 lines
3.2 KiB
Markdown
63 lines
3.2 KiB
Markdown
---
|
|
title: Blueprint Panel
|
|
order: 1
|
|
---
|
|
|
|
The Blueprint Panel shows the hierarchical structure of your current blueprint and provides controls for modifying the Viewer layout.
|
|
|
|
For a complete understanding of blueprints, see [Blueprints](../../concepts/visualization/blueprints.md). For hands-on tutorials on configuring the Viewer, see [Configure the Viewer](../../getting-started/configure-the-viewer.md).
|
|
|
|
<picture>
|
|
<img src="https://static.rerun.io/blueprint-example/24fe3f15c15dc8c74e1feec879cab624a34136e6/full.png" alt="Blueprint panel showing view hierarchy">
|
|
<source media="(max-width: 480px)" srcset="https://static.rerun.io/blueprint-example/24fe3f15c15dc8c74e1feec879cab624a34136e6/480w.png">
|
|
</picture>
|
|
|
|
## Panel header controls
|
|
|
|
### Reset button
|
|
The reset button in the blueprint panel header provides two reset options:
|
|
|
|
- **Reset to Default Blueprint**: Returns to your programmatically specified blueprint (sent from code via `rr.send_blueprint()`) or a loaded blueprint file (`.rbl`). This becomes the "default" whenever you send or load a blueprint.
|
|
|
|
- **Reset to Heuristic Blueprint**: Generates a new blueprint automatically based on your current data. The Viewer analyzes your logged data and creates an appropriate layout using built-in heuristics.
|
|
|
|
If no default blueprint has been set, the reset button uses the heuristic blueprint. See [Reset Behavior](../../concepts/visualization/blueprints.md#reset-behavior-heuristic-vs-default) for more details.
|
|
|
|
### Add view
|
|
The "+" button allows you to add new views or containers.
|
|
|
|
## Blueprint tree
|
|
|
|
The blueprint panel displays a tree view showing:
|
|
- The viewport (root container)
|
|
- Nested containers (Horizontal, Vertical, Grid, Tabs)
|
|
- Views within containers
|
|
- Entities displayed in each view
|
|
|
|
### Interaction
|
|
|
|
Hovering over any item reveals controls for:
|
|
- **Eye icon**: Show or hide the item
|
|
- **"-" button**: Remove the item from the blueprint
|
|
|
|
Right-click any item for a context menu with additional operations. See [Configure the Viewer](../../getting-started/configure-the-viewer/navigating-the-viewer.md#interactive-configuration) for details on all interactive operations.
|
|
|
|
### Data blueprints
|
|
|
|
Entities shown in the blueprint panel refer to their *data blueprints* — the entity plus its associated blueprint settings. Changes made here apply only to the specific view where the entity appears.
|
|
|
|
### Groups
|
|
|
|
When entities are added to a view (manually or automatically), hierarchical groupings are created based on [Entity Paths](../../concepts/logging-and-ingestion/entity-path.md). These groups help organize large views and enable hierarchical manipulation of blueprints. Groups are independent of logged data and exist purely for blueprint organization.
|
|
|
|
## Adding entities to views
|
|
|
|
To add or re-add an entity to a view:
|
|
1. Select the target view in the blueprint panel
|
|
2. Click the button in the [Selection Panel](selection.md) to open the entity picker
|
|
3. Select entities to add (only compatible entities for that view type are shown)
|
|
|
|
See [Entity Queries](../../concepts/visualization/entity-queries.md) for information on how view content is determined.
|
|
|
|
For more information about configuring the viewer, see [Configure the Viewer](../../getting-started/configure-the-viewer.md).
|