Skip to content

Update info about Canvas and Scene models - #1083

Merged
jni merged 15 commits into
napari:mainfrom
brisvag:feature/canvas-model
Aug 10, 2026
Merged

Update info about Canvas and Scene models#1083
jni merged 15 commits into
napari:mainfrom
brisvag:feature/canvas-model

Conversation

@brisvag

@brisvag brisvag commented Jul 25, 2026

Copy link
Copy Markdown
Contributor

References and relevant issues

Description

Updates the information about the overlays, camera, and grid to the new locations, and adds some info about the canvas and scene models.

@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Jul 25, 2026
@brisvag

brisvag commented Jul 25, 2026

Copy link
Copy Markdown
Contributor Author

@jni

@brisvag brisvag added this to the 0.9.0 milestone Aug 6, 2026
Czaki and others added 10 commits August 7, 2026 15:04
# References and relevant issues

follow-up napari#1031

# Description

Fix condition to use the current label name.
<!--pre-commit.ci start-->
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.15.22 →
v0.16.0](astral-sh/ruff-pre-commit@v0.15.22...v0.16.0)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
# Description
NAPs are supposed to be Accepted, Widthdrawn or made Final when
appropriate. We haven't been on top of this and several NAPs that have
_effectively_ changed status were never formally changed. This PR does
that, for those naps whose informal status is hopefully obvious :P

Feel free to disagree below and I'll update accordingly, let's leave
this open for a while!

cc @napari/core-devs
<!--pre-commit.ci start-->
updates:
- [github.com/astral-sh/ruff-pre-commit: v0.16.0 →
v0.16.1](astral-sh/ruff-pre-commit@v0.16.0...v0.16.1)
<!--pre-commit.ci end-->

Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>
Co-authored-by: Tim Monko <timmonko@gmail.com>
@brisvag brisvag changed the title Update info about canvas model Update info about Canvas and Scene models Aug 7, 2026
@github-actions github-actions Bot added the maintenance CI, dependencies, and other maintenance label Aug 7, 2026

@TimMonko TimMonko left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Comment thread docs/getting_started/viewer.md Outdated
- Scale bar (canvas overlay, accessible via `viewer.scale_bar`): it displays distances in world coordinates for the displayed scene. The scale bar usually inherits layer units when they are set. If inference fails it can fall back to a dimensionless label, and if displayed axes mix dimensionalities it uses the last displayed axis unit with a warning. You can control its appearance and fixed length from the viewer. See the [units guide](units-guide) for more information.
- Axes (scene overlay, accessible via `viewer.axes`): displays basis axes at the origin.
- Text Overlay (canvas overlay, accessible via `viewer.text_overlay`): displays arbitrary text on the canvas.
Scene overlays live on `viewer.scene.overlays`:

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

can you comment about layer-scene overlays / cross-link to them (like the bounding box)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

There's already a comment just below here in line 664!

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

ahh the problem with reading only the changed diff 🤦 sorry for the noise. Hopefully it's noticeable enough there :)

Co-authored-by: Tim Monko <timmonko@gmail.com>

@jni jni left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I really love this whole changeset. 😊 Thanks @brisvag!

@jni
jni merged commit 6bb1867 into napari:main Aug 10, 2026
9 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation maintenance CI, dependencies, and other maintenance

Projects

Status: Done

Development

Successfully merging this pull request may close these issues.

4 participants